From 8ed738b072242f0123f543410747bf6e2a38da64 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Fri, 20 Nov 2020 21:02:00 +0000
Subject: [PATCH 001/246] Simplified by removing token.

---
 docs/images/qsimcirq_gcp/connection.png | Bin 0 -> 169758 bytes
 docs/images/qsimcirq_gcp/container.png  | Bin 0 -> 158370 bytes
 docs/tutorials/qsimcirq_gcp.md          |  69 +++++-------------------
 jupyter/Dockerfile                      |   5 +-
 4 files changed, 14 insertions(+), 60 deletions(-)
 create mode 100644 docs/images/qsimcirq_gcp/connection.png
 create mode 100644 docs/images/qsimcirq_gcp/container.png

diff --git a/docs/images/qsimcirq_gcp/connection.png b/docs/images/qsimcirq_gcp/connection.png
new file mode 100644
index 0000000000000000000000000000000000000000..ca66bc8aae25c78c166f2acc35df62810b95dcb8
GIT binary patch
literal 169758
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

literal 0
HcmV?d00001

diff --git a/docs/images/qsimcirq_gcp/container.png b/docs/images/qsimcirq_gcp/container.png
new file mode 100644
index 0000000000000000000000000000000000000000..61ef9c077d69196de1579bf08a3a8cec0944f0c7
GIT binary patch
literal 158370
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

literal 0
HcmV?d00001

diff --git a/docs/tutorials/qsimcirq_gcp.md b/docs/tutorials/qsimcirq_gcp.md
index f204785c..4e292b3f 100644
--- a/docs/tutorials/qsimcirq_gcp.md
+++ b/docs/tutorials/qsimcirq_gcp.md
@@ -53,7 +53,7 @@ Then click on *Create* for a new VM instance:
 
 ![alt_text](../images/qsimcirq_gcp/image7.png )
 
-### Build a Container Optimized VM
+### Build a Container Optimized VM with container deployed
 
 To create the VM use the steps in sequence below:
 
@@ -72,14 +72,17 @@ To create the VM use the steps in sequence below:
 *   Choose the [Machine Type](https://cloud.google.com/blog/products/compute/choose-the-right-google-compute-engine-machine-type-for-you): n2-standard-16
     * 16 CPUs
     * 64GB memory
-*   Choose the Boot Disk image:[ Container-Optimized OS](https://cloud.google.com/container-optimized-os/docs/concepts/features-and-benefits)
     * Leave the remaining as defaults.
 
 ![alt_text](../images/qsimcirq_gcp/image10.png )
+> Select `Deploy a container image to this VM instance`.
 
-Finally, enable HTTP access and click *Create*.
-
-![alt_text](../images/qsimcirq_gcp/image8.png )
+For the container image enter:
+```
+gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
+```
+![alt_text](../images/qsimcirq_gcp/container.png )
+> This may take a few minutes to complete, even after the VM is created, the container will take some time to complete.
 
 
 ## Preparing your local system to connect to Colab
@@ -145,32 +148,7 @@ You should now see the command line prompt from your VM:
 wellhello@qsim-1 ~ $ 
 ```
 
-### Run the Jupyter / qsim container on your VM 
-
-At the command prompt you can now start a Docker container with all the required
-code to run simulations. Start the container:
-
-```
-$ docker run -v `pwd`:/homedir -p 8888:8888 gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
-```
-
-You should see several lines of output ending with lines like below. (If you get
-an error about `permission denied` you may need to run docker with `sudo` as
-[described here](https://docs.docker.com/engine/reference/run/#general-form)).
-
-
-```
-To access the notebook, open this file in a browser:
-    file:///root/.local/share/jupyter/runtime/nbserver-1-open.html
-Or copy and paste one of these URLs:
-    http://e1f7a7cca9fa:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
-    or http://127.0.0.1:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
-```
-
-Copy the last URL in the output. Edit the URL to replace `127.0.0.1` with
-`localhost`. Save this URL for the next step. This URL points to your local
-runtime, running as a Docker container on your VM.
-
+The container port is now forwarded to your local machine.
 
 ## Connect Colab to your local runtime
 
@@ -185,9 +163,9 @@ get the UI:
 
 Select *Connect to local runtime*. You will see the UI:
 
-<img src="../images/qsimcirq_gcp/colab_settings.png" width="500"/>
+<img src="../images/qsimcirq_gcp/connection.png" width="500"/>
 
-Pass the edited URL from the previous section, then click *Connect*:
+Type in the URL `http://localhost:8888/` , then click *Connect*:
 
 <img src="../images/qsimcirq_gcp/colab_success.png" width="300"/>
 
@@ -213,7 +191,7 @@ In the previous step, you copied a URL like below. It is easy to just copy that
 URL and paste it directly into a browser running on your local machine.
 
 ```
-http://127.0.0.1:8888/?token=7191178ae9aa4ebe1698b07bb67dea1d289cfd0e0b960373
+http://127.0.0.1:8888/
 ```
 
 In the browser you should now see the Jupyter UI:
@@ -230,11 +208,6 @@ You can now run these cells as you would in any notebook.
 
 ![alt_text](../images/qsimcirq_gcp/image1.png)
 
-If you choose to modify the notebook, you can save it on the *qsim-1* VM from *File* -> *Save As*, and saving to `/homedir/mynotebook.ipynb`.  This will save in your home directory on your VM. If you intend to destroy the VM after this tutorial, either download the notebooks from the VM or save directly from your browser.
-
-![alt_text](../images/qsimcirq_gcp/image4.png)
-
-
 ## Run interactively
 
 To run interactively within the container, you can open a second shell window to
@@ -312,24 +285,6 @@ output vector: (0.5+0.5j)|0⟩ + (0.5-0.5j)|1⟩
 You have successfully simulated a quantum circuit on Google Cloud Platform using
 a Singularity container.
 
-### Running your own script
-
-If you want to run a Python script, you can locate a file in the home directory
-on your VM, then run something like the following in the container shell:
-
-```
-$ python3 /homedir/myscript.py
-```
-
-### Exit the container
-
-Exit the container by typing ctrl-d twice. You will see the output like:
-
-```
-[root@79804d33f250 /]# exit
-```
-
-
 ## Clean up
 
 To avoid incurring charges to your Google Cloud Platform account for the
diff --git a/jupyter/Dockerfile b/jupyter/Dockerfile
index 29043611..2019390c 100644
--- a/jupyter/Dockerfile
+++ b/jupyter/Dockerfile
@@ -22,6 +22,5 @@ RUN  jupyter serverextension enable --py jupyter_http_over_ws
 CMD ["jupyter-notebook", "--port=8888", "--no-browser",\
       "--ip=0.0.0.0", "--allow-root", \
 	  "--NotebookApp.allow_origin='*'", \
-      "--NotebookApp.port_retries=0"]
-
-	  #"--NotebookApp.allow_origin='https://colab.research.google.com'", \
\ No newline at end of file
+      "--NotebookApp.port_retries=0", \
+	  "--NotebookApp.token=''"]

From a12577c73207688b3673515393fad0d7c443f958 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Wed, 12 May 2021 19:14:09 +0000
Subject: [PATCH 002/246] Added multinode directory

---
 docs/tutorials/multinode/terraform/Makefile   |    7 +
 docs/tutorials/multinode/terraform/README.md  |   50 +
 .../tutorials/multinode/terraform/circuit_q24 | 6325 +++++++++++++++++
 .../multinode/terraform/htcondor/resources.tf |  325 +
 .../htcondor/startup-centos-noinstall.sh      |   72 +
 .../terraform/htcondor/startup-centos.sh      |  169 +
 docs/tutorials/multinode/terraform/init.tf    |    3 +
 docs/tutorials/multinode/terraform/main.tf    |   19 +
 docs/tutorials/multinode/test.txt             |    0
 9 files changed, 6970 insertions(+)
 create mode 100644 docs/tutorials/multinode/terraform/Makefile
 create mode 100644 docs/tutorials/multinode/terraform/README.md
 create mode 100644 docs/tutorials/multinode/terraform/circuit_q24
 create mode 100644 docs/tutorials/multinode/terraform/htcondor/resources.tf
 create mode 100644 docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh
 create mode 100644 docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
 create mode 100644 docs/tutorials/multinode/terraform/init.tf
 create mode 100644 docs/tutorials/multinode/terraform/main.tf
 create mode 100644 docs/tutorials/multinode/test.txt

diff --git a/docs/tutorials/multinode/terraform/Makefile b/docs/tutorials/multinode/terraform/Makefile
new file mode 100644
index 00000000..ebd5018d
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/Makefile
@@ -0,0 +1,7 @@
+.PHONY: apply destroy 
+
+apply: 
+	terraform apply -auto-approve
+
+destroy:
+	terraform destroy -auto-approve
diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
new file mode 100644
index 00000000..bbcec480
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -0,0 +1,50 @@
+# HTCondor on GCP
+
+```
+gcloud config set project [[PROJECT_ID]]
+gcloud config set compute/region [[YOUR_REGION]]
+gcloud config set compute/zone [[YOUR_ZONE]]
+```
+
+```
+git clone https://github.com/lsst-dm/google-poc-2020.git
+cd google-poc-2020
+```
+
+```
+gcloud iam service-accounts create htcondor
+```
+
+```
+gcloud projects add-iam-policy-binding \
+       --member serviceAccount:htcondor@[[PROJECT]]  \
+       --role roles/iam.serviceAccountUser
+```
+
+
+## Updating the main.tf Terraform file
+
+The as-is file from the git repository will not work without modifying the _main.tf_ to the values relevant to your project. 
+
+```
+variable "cluster_name" {
+  type = string
+  default = "condor"
+  description = "Name used to prefix resources in cluster."
+  
+}
+
+module "htcondor" {
+  source = "./htcondor/"
+  cluster_name = var.cluster_name
+  osimage = "lsst"
+  osversion = "7"
+  bucket_name = "[[GCS_FUSE_BUCKET]]"
+  zone="[[YOUR_ZONE]]"
+  project="[[PROJECT_ID]]"
+  max_replicas=20
+  min_replicas=1
+  service_account="htcondor@[[PROJECT_ID]].iam.gserviceaccount.com"
+  use_preemptibles=true
+}
+```
diff --git a/docs/tutorials/multinode/terraform/circuit_q24 b/docs/tutorials/multinode/terraform/circuit_q24
new file mode 100644
index 00000000..757895d7
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/circuit_q24
@@ -0,0 +1,6325 @@
+
+
+
+
+
+
+<!DOCTYPE html>
+<html lang="en" data-color-mode="auto" data-light-theme="light" data-dark-theme="dark">
+  <head>
+    <meta charset="utf-8">
+  <link rel="dns-prefetch" href="https://github.githubassets.com">
+  <link rel="dns-prefetch" href="https://avatars.githubusercontent.com">
+  <link rel="dns-prefetch" href="https://github-cloud.s3.amazonaws.com">
+  <link rel="dns-prefetch" href="https://user-images.githubusercontent.com/">
+
+
+
+  <link crossorigin="anonymous" media="all" integrity="sha512-sf1Ppoo8CVx+YA47iIi2IUMYtjH17Errad0dPA+lo7DVd6VW1Mdy+TBcpD06Z6FN8MKI7TH5fpYU33+DhP25kg==" rel="stylesheet" href="https://github.githubassets.com/assets/frameworks-b1fd4fa68a3c095c7e600e3b8888b621.css" />
+    <link crossorigin="anonymous" media="all" integrity="sha512-LhF+q2/lZfX1qKIAoHwzUmZ1eN3zI6Hgm96RmuK+fILZRBtO51EiVC8nQ9e5QDRdbJeTMoawW6SNbOiHRWewLg==" rel="stylesheet" href="https://github.githubassets.com/assets/behaviors-2e117eab6fe565f5f5a8a200a07c3352.css" />
+    
+    
+    
+    <link crossorigin="anonymous" media="all" integrity="sha512-IwoajEOel02eeTohMnWahFUlLFlQR2D7ze3SyG2bEzVQ/BE62mymz1R2v9S2LQgaduGAMOG8Zf05OpGuu7Kh7Q==" rel="stylesheet" href="https://github.githubassets.com/assets/github-230a1a8c439e974d9e793a2132759a84.css" />
+
+  <script crossorigin="anonymous" defer="defer" integrity="sha512-CzeY4A6TiG4fGZSWZU8FxmzFFmcQFoPpArF0hkH0/J/S7UL4eed/LKEXMQXfTwiG5yEJBI+9BdKG8KQJNbhcIQ==" type="application/javascript" src="https://github.githubassets.com/assets/environment-0b3798e0.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-xD/II79VugfUBs1ZVmd0ea7wmmLeCyIkPkWprb/jviEdWsOc5n7pJ7Wbn6h70b5CEvAQ5rp9EG3EKBfV34Cqxg==" type="application/javascript" src="https://github.githubassets.com/assets/chunk-frameworks-c43fc823.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-N6FZA172tiL7uDaWQ5DGlKS2MS0ZuYf9n2kkRRfntFnGdL89nWudZXRok+pLWRQd2xLfiSALG5NQ2KCGKP2UtQ==" type="application/javascript" src="https://github.githubassets.com/assets/chunk-vendor-37a15903.js"></script>
+  
+  <script crossorigin="anonymous" defer="defer" integrity="sha512-soTfiFmFphcLCq12ot5mqPZoNEPYwXXy11/urmmYHmJ5Oau+2XYC26hZafLR7yDLCgaD4cwYUetDTxL1/eewBw==" type="application/javascript" src="https://github.githubassets.com/assets/behaviors-b284df88.js"></script>
+  
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-tjuNQcwhEIXGvVIG4XM/Aj4z+Od+NBRkbgWNwEMjGL3nsnAmdoBdbzsn/WTvl3hk+TPt1D0BvBLHLBPgiwvT2w==" type="application/javascript" data-module-id="./chunk-animate-on-scroll.js" data-src="https://github.githubassets.com/assets/chunk-animate-on-scroll-b63b8d41.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-+BKEtK9JkmJ52jKSoX6+SBrGV6kJxB8J/iAPkFQ/oeq8YekNcz7IZlJgM5Tddyx1RrkL3+sdG0tAy3YuFbYqfA==" type="application/javascript" data-module-id="./chunk-codemirror.js" data-src="https://github.githubassets.com/assets/chunk-codemirror-f81284b4.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-EKOvqJ9uTatAt87WxU+OSS4mi7gMUszFbGo4aPErQkjpWLXnrPSeZvK5ngU8OYoIoiVOq+v8dA3C6MF/z2d/kA==" type="application/javascript" data-module-id="./chunk-color-modes.js" data-src="https://github.githubassets.com/assets/chunk-color-modes-10a3afa8.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-zkYZSjUFqSifB+Lt76jclFMrfqpcPqevT801RZcoBNCZHRTBKcFrW9OyJoPOzKFv+fZVDRnqdqGsuIv5KOIgZg==" type="application/javascript" data-module-id="./chunk-contributions-spider-graph.js" data-src="https://github.githubassets.com/assets/chunk-contributions-spider-graph-ce46194a.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-6j/oSF+kbW+yetNPvI684VzAu9pzug6Vj2h+3u1LdCuRhR4jnuiHZfeQKls3nxcT/S3H+oIt7FtigE/aeoj+gg==" type="application/javascript" data-module-id="./chunk-drag-drop.js" data-src="https://github.githubassets.com/assets/chunk-drag-drop-ea3fe848.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-VSSd+Yzi2iMS+pibY6hD/WdypxAEdob5F2RMKxuKcAHS2EpFYJPeTXoVxt0NXg03tfj2dka2mEtHS+vjpYSaDw==" type="application/javascript" data-module-id="./chunk-edit-hook-secret-element.js" data-src="https://github.githubassets.com/assets/chunk-edit-hook-secret-element-55249df9.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-N+ziqJjVMfWiqeVHdayDHpNRlG5HsF+cgV+pFnMDoTJuvBzgw+ndsepe4NcKAxIS3WMvzMaQcYmd2vrIaoAJVg==" type="application/javascript" data-module-id="./chunk-edit.js" data-src="https://github.githubassets.com/assets/chunk-edit-37ece2a8.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-aiqMIGGZGo8AQMjcoImKPMTsZVVRl6htCSY7BpRmpGPG/AF+Wq+P/Oj/dthWQOIk9cCNMPEas7O2zAR6oqn0tA==" type="application/javascript" data-module-id="./chunk-emoji-picker-element.js" data-src="https://github.githubassets.com/assets/chunk-emoji-picker-element-6a2a8c20.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-7o8WoXZcP71e0YBbF1az3Rj9iGr3Irk3kb7Yq1/ZQETySta8pQLfupQJ7yiswg+sN1HTqszDMbp1vcPHFgp7gw==" type="application/javascript" data-module-id="./chunk-filter-input.js" data-src="https://github.githubassets.com/assets/chunk-filter-input-ee8f16a1.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-XwuQdORq1W9Z+a/i72pH+NfR1rhwlGdxIlaIBbTciscGc/+McxMNLixGBp8e6Td4W1zzHvQ1Jyryl5gUfEr76g==" type="application/javascript" data-module-id="./chunk-insights-graph.js" data-src="https://github.githubassets.com/assets/chunk-insights-graph-5f0b9074.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-Y+VVFzGHo9J5bf4Mrn+RGrh1+IExdybA3C1QqPha3UwkV9RZ75jZgV4DsujViAF0iT9OrLYYHvPk9V6QiXjp3g==" type="application/javascript" data-module-id="./chunk-invitations.js" data-src="https://github.githubassets.com/assets/chunk-invitations-63e55517.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-mMOvER8Uml4WMYbXv8BaahVq9eF1v5Hu7M9/3oPlOFPmTJGH+TmvcRPt8fddj86urb+Ri+vlqotFspA/4STDsQ==" type="application/javascript" data-module-id="./chunk-jump-to.js" data-src="https://github.githubassets.com/assets/chunk-jump-to-98c3af11.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-supZkxo+OPYLNtLXxI+e1dkCqVySu4FOWX1fiVVFs2ZggygppNsEz4F9wVp4YtH2TjFsZW8r/75uDUhPneO2sA==" type="application/javascript" data-module-id="./chunk-notification-list-focus.js" data-src="https://github.githubassets.com/assets/chunk-notification-list-focus-b2ea5993.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-ma0OOy3nj0c1cqBx0BkcmIFsLqcSZ+MIukQxyEFM/OWTzZpG+QMgOoWPAHZz43M6fyjAUG1jH6c/6LPiiKPCyw==" type="application/javascript" data-module-id="./chunk-profile-pins-element.js" data-src="https://github.githubassets.com/assets/chunk-profile-pins-element-99ad0e3b.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-zh+tYYvd4W00us1O4PkhmKsl/CzInIyrdoMqV2xqC7XPu06UEHfEMJfOiwidJ5f80SwrdGWogWFuJzLHwRbRgA==" type="application/javascript" data-module-id="./chunk-ref-selector.js" data-src="https://github.githubassets.com/assets/chunk-ref-selector-ce1fad61.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-Zii9oRdZ6q2QDNjL5A+me7jwJjMLvs1NiQNHmajUZnn4t9shcBDb4F8l/PQZW26eYfe5065oM7lIOSmbMinA7Q==" type="application/javascript" data-module-id="./chunk-responsive-underlinenav.js" data-src="https://github.githubassets.com/assets/chunk-responsive-underlinenav-6628bda1.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-9WNXtB07IyWypiPmkuucspwog4mme9q5GKGMSgd7FI0DPimmg/pEw+aaAofFV1vuWMt9I8H5QpsVtlbHGg1YBA==" type="application/javascript" data-module-id="./chunk-runner-groups.js" data-src="https://github.githubassets.com/assets/chunk-runner-groups-f56357b4.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-fIq9Mn7jY/bHQXnsmh+VejpDnaO+d/FDxsp+4CuZtdNLrLuO+dQCjh+m6Yd8GCYD2Cy6DWbCEyM+mH2dkB2H9A==" type="application/javascript" data-module-id="./chunk-sortable-behavior.js" data-src="https://github.githubassets.com/assets/chunk-sortable-behavior-7c8abd32.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-WK8VXw3lfUQ/VRW0zlgKPhcMUqH0uTnB/KzePUPdZhCm/HpxfXXHKTGvj5C0Oex7+zbIM2ECzULbtTCT4ug3yg==" type="application/javascript" data-module-id="./chunk-toast.js" data-src="https://github.githubassets.com/assets/chunk-toast-58af155f.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-vgHJEmEJxNmHucGbVY8bEUoOYo5/ZwpQ69rU8Dld89daWJ54uad9lNptxq32F8pnbHhdngw9lohNEbMbjmj5AQ==" type="application/javascript" data-module-id="./chunk-tweetsodium.js" data-src="https://github.githubassets.com/assets/chunk-tweetsodium-be01c912.js"></script>
+    <script crossorigin="anonymous" defer="defer" integrity="sha512-aSxfTHAZj9wv7n08DxgAKkNg7jhiTo4yKKbDqLGxcDxUk/al571Y2ZSsOmLJ0Vh8cuAL8tW+JgX1t0JeKfyfaA==" type="application/javascript" data-module-id="./chunk-user-status-submit.js" data-src="https://github.githubassets.com/assets/chunk-user-status-submit-692c5f4c.js"></script>
+  
+  <script crossorigin="anonymous" defer="defer" integrity="sha512-/8DIYpYCJFF0xg5QFDVdVJdBQfagC8hDC0Bi5TnoOpswGkZt/Byv4P8wmMYm3r4m6eB8WzeGngZvzA30b8kxiw==" type="application/javascript" src="https://github.githubassets.com/assets/repositories-ffc0c862.js"></script>
+<script crossorigin="anonymous" defer="defer" integrity="sha512-UcfDdsCeeCSVRNSMU527vY80XN0rUQJguclfm0k2nNEfQwzsf8VYtNyiQJZ3YDCOzhMd6AYCl0Bm7Q8JunZMBw==" type="application/javascript" src="https://github.githubassets.com/assets/diffs-51c7c376.js"></script>
+
+  <meta name="viewport" content="width=device-width">
+  
+  <title>qsim/circuit_q24 at master · quantumlib/qsim · GitHub</title>
+    <meta name="description" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim">
+    <link rel="search" type="application/opensearchdescription+xml" href="/opensearch.xml" title="GitHub">
+  <link rel="fluid-icon" href="https://github.com/fluidicon.png" title="GitHub">
+  <meta property="fb:app_id" content="1401488693436528">
+  <meta name="apple-itunes-app" content="app-id=1477376905" />
+    <meta name="twitter:image:src" content="https://opengraph.githubassets.com/8a2f1c7d6b7cef5db1329630ea3d1357bf53f0ebd28d4219a8a78e749eb52269/quantumlib/qsim" /><meta name="twitter:site" content="@github" /><meta name="twitter:card" content="summary_large_image" /><meta name="twitter:title" content="quantumlib/qsim" /><meta name="twitter:description" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim" />
+    <meta property="og:image" content="https://opengraph.githubassets.com/8a2f1c7d6b7cef5db1329630ea3d1357bf53f0ebd28d4219a8a78e749eb52269/quantumlib/qsim" /><meta property="og:image:alt" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim" /><meta property="og:image:width" content="1200" /><meta property="og:image:height" content="600" /><meta property="og:site_name" content="GitHub" /><meta property="og:type" content="object" /><meta property="og:title" content="quantumlib/qsim" /><meta property="og:url" content="https://github.com/quantumlib/qsim" /><meta property="og:description" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim" />
+
+
+
+    
+
+  <link rel="assets" href="https://github.githubassets.com/">
+  
+
+  <meta name="request-id" content="6CA7:5CF8:705A14:B343A1:609BF6B7" data-pjax-transient="true"/><meta name="html-safe-nonce" content="8654840eab26630d55bd2cf1be837d0b0914f5e95130fb027f15e289cdbeb3e6" data-pjax-transient="true"/><meta name="visitor-payload" content="eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI2Q0E3OjVDRjg6NzA1QTE0OkIzNDNBMTo2MDlCRjZCNyIsInZpc2l0b3JfaWQiOiIzNzI3MjEwMTg5MTY4NTcyMDg3IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=" data-pjax-transient="true"/><meta name="visitor-hmac" content="a4b71250d375351b8f7bb98946f4879ef8c1d7fe0a2e75706683747ce13ab4ee" data-pjax-transient="true"/>
+
+    <meta name="hovercard-subject-tag" content="repository:236547448" data-pjax-transient>
+
+
+  <meta name="github-keyboard-shortcuts" content="repository,source-code" data-pjax-transient="true" />
+
+  
+
+  <meta name="selected-link" value="repo_source" data-pjax-transient>
+
+    <meta name="google-site-verification" content="c1kuD-K2HIVF635lypcsWPoD4kilo5-jA_wBFyT4uMY">
+  <meta name="google-site-verification" content="KT5gs8h0wvaagLKAVWq8bbeNwnZZK1r1XQysX3xurLU">
+  <meta name="google-site-verification" content="ZzhVyEFwb7w3e0-uOTltm8Jsck2F5StVihD0exw2fsA">
+  <meta name="google-site-verification" content="GXs5KoUUkNCoaAZn7wPN-t01Pywp9M3sEjnt_3_ZWPc">
+
+  <meta name="octolytics-host" content="collector.githubapp.com" /><meta name="octolytics-app-id" content="github" /><meta name="octolytics-event-url" content="https://collector.githubapp.com/github-external/browser_event" />
+
+  <meta name="analytics-location" content="/&lt;user-name&gt;/&lt;repo-name&gt;/blob/show" data-pjax-transient="true" />
+
+  
+
+
+
+  <meta name="optimizely-datafile" content="{&quot;version&quot;: &quot;4&quot;, &quot;rollouts&quot;: [], &quot;typedAudiences&quot;: [], &quot;anonymizeIP&quot;: true, &quot;projectId&quot;: &quot;16737760170&quot;, &quot;variables&quot;: [], &quot;featureFlags&quot;: [], &quot;experiments&quot;: [{&quot;status&quot;: &quot;Running&quot;, &quot;audienceIds&quot;: [], &quot;variations&quot;: [{&quot;variables&quot;: [], &quot;id&quot;: &quot;20106410318&quot;, &quot;key&quot;: &quot;en&quot;}, {&quot;variables&quot;: [], &quot;id&quot;: &quot;20122000362&quot;, &quot;key&quot;: &quot;ko&quot;}], &quot;id&quot;: &quot;20121990335&quot;, &quot;key&quot;: &quot;ko_homepage_translation&quot;, &quot;layerId&quot;: &quot;20100420349&quot;, &quot;trafficAllocation&quot;: [{&quot;entityId&quot;: &quot;20106410318&quot;, &quot;endOfRange&quot;: 5000}, {&quot;entityId&quot;: &quot;20122000362&quot;, &quot;endOfRange&quot;: 10000}], &quot;forcedVariations&quot;: {}}, {&quot;status&quot;: &quot;Running&quot;, &quot;audienceIds&quot;: [], &quot;variations&quot;: [{&quot;variables&quot;: [], &quot;id&quot;: &quot;20233300304&quot;, &quot;key&quot;: &quot;launch_code_variation&quot;}, {&quot;variables&quot;: [], &quot;id&quot;: &quot;20227370325&quot;, &quot;key&quot;: &quot;control&quot;}], &quot;id&quot;: &quot;20206000276&quot;, &quot;key&quot;: &quot;launch_code_verification&quot;, &quot;layerId&quot;: &quot;20233240262&quot;, &quot;trafficAllocation&quot;: [{&quot;entityId&quot;: &quot;20233300304&quot;, &quot;endOfRange&quot;: 5000}, {&quot;entityId&quot;: &quot;20233300304&quot;, &quot;endOfRange&quot;: 10000}], &quot;forcedVariations&quot;: {}}, {&quot;status&quot;: &quot;Running&quot;, &quot;audienceIds&quot;: [], &quot;variations&quot;: [{&quot;variables&quot;: [], &quot;id&quot;: &quot;20236992340&quot;, &quot;key&quot;: &quot;usd&quot;}, {&quot;variables&quot;: [], &quot;id&quot;: &quot;20184442182&quot;, &quot;key&quot;: &quot;localized_currency&quot;}], &quot;id&quot;: &quot;20233233507&quot;, &quot;key&quot;: &quot;local_currency_pricing&quot;, &quot;layerId&quot;: &quot;20212472765&quot;, &quot;trafficAllocation&quot;: [{&quot;entityId&quot;: &quot;20184442182&quot;, &quot;endOfRange&quot;: 5000}, {&quot;entityId&quot;: &quot;20236992340&quot;, &quot;endOfRange&quot;: 10000}], &quot;forcedVariations&quot;: {&quot;667685045.1617740930&quot;: &quot;localized_currency&quot;}}], &quot;audiences&quot;: [{&quot;conditions&quot;: &quot;[\&quot;or\&quot;, {\&quot;match\&quot;: \&quot;exact\&quot;, \&quot;name\&quot;: \&quot;$opt_dummy_attribute\&quot;, \&quot;type\&quot;: \&quot;custom_attribute\&quot;, \&quot;value\&quot;: \&quot;$opt_dummy_value\&quot;}]&quot;, &quot;id&quot;: &quot;$opt_dummy_audience&quot;, &quot;name&quot;: &quot;Optimizely-Generated Audience for Backwards Compatibility&quot;}], &quot;groups&quot;: [], &quot;attributes&quot;: [{&quot;id&quot;: &quot;16822470375&quot;, &quot;key&quot;: &quot;user_id&quot;}, {&quot;id&quot;: &quot;17143601254&quot;, &quot;key&quot;: &quot;spammy&quot;}, {&quot;id&quot;: &quot;18175660309&quot;, &quot;key&quot;: &quot;organization_plan&quot;}, {&quot;id&quot;: &quot;18813001570&quot;, &quot;key&quot;: &quot;is_logged_in&quot;}, {&quot;id&quot;: &quot;19073851829&quot;, &quot;key&quot;: &quot;geo&quot;}, {&quot;id&quot;: &quot;20175462351&quot;, &quot;key&quot;: &quot;requestedCurrency&quot;}], &quot;botFiltering&quot;: false, &quot;accountId&quot;: &quot;16737760170&quot;, &quot;events&quot;: [{&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;17911811441&quot;, &quot;key&quot;: &quot;hydro_click.dashboard.teacher_toolbox_cta&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18124116703&quot;, &quot;key&quot;: &quot;submit.organizations.complete_sign_up&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18145892387&quot;, &quot;key&quot;: &quot;no_metric.tracked_outside_of_optimizely&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18178755568&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.add_repo&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18180553241&quot;, &quot;key&quot;: &quot;submit.repository_imports.create&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18186103728&quot;, &quot;key&quot;: &quot;click.help.learn_more_about_repository_creation&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18188530140&quot;, &quot;key&quot;: &quot;test_event.do_not_use_in_production&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18191963644&quot;, &quot;key&quot;: &quot;click.empty_org_repo_cta.transfer_repository&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18195612788&quot;, &quot;key&quot;: &quot;click.empty_org_repo_cta.import_repository&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18210945499&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.invite_members&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18211063248&quot;, &quot;key&quot;: &quot;click.empty_org_repo_cta.create_repository&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18215721889&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.update_profile&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18224360785&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.dismiss&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18234832286&quot;, &quot;key&quot;: &quot;submit.organization_activation.complete&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18252392383&quot;, &quot;key&quot;: &quot;submit.org_repository.create&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18257551537&quot;, &quot;key&quot;: &quot;submit.org_member_invitation.create&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18259522260&quot;, &quot;key&quot;: &quot;submit.organization_profile.update&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18564603625&quot;, &quot;key&quot;: &quot;view.classroom_select_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18568612016&quot;, &quot;key&quot;: &quot;click.classroom_sign_in_click&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18572592540&quot;, &quot;key&quot;: &quot;view.classroom_name&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18574203855&quot;, &quot;key&quot;: &quot;click.classroom_create_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18582053415&quot;, &quot;key&quot;: &quot;click.classroom_select_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18589463420&quot;, &quot;key&quot;: &quot;click.classroom_create_classroom&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18591323364&quot;, &quot;key&quot;: &quot;click.classroom_create_first_classroom&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18591652321&quot;, &quot;key&quot;: &quot;click.classroom_grant_access&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18607131425&quot;, &quot;key&quot;: &quot;view.classroom_creation&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18831680583&quot;, &quot;key&quot;: &quot;upgrade_account_plan&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19064064515&quot;, &quot;key&quot;: &quot;click.signup&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19075373687&quot;, &quot;key&quot;: &quot;click.view_account_billing_page&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19077355841&quot;, &quot;key&quot;: &quot;click.dismiss_signup_prompt&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19079713938&quot;, &quot;key&quot;: &quot;click.contact_sales&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19120963070&quot;, &quot;key&quot;: &quot;click.compare_account_plans&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;19151690317&quot;, &quot;key&quot;: &quot;click.upgrade_account_cta&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19424193129&quot;, &quot;key&quot;: &quot;click.open_account_switcher&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19520330825&quot;, &quot;key&quot;: &quot;click.visit_account_profile&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19540970635&quot;, &quot;key&quot;: &quot;click.switch_account_context&quot;}, {&quot;experimentIds&quot;: [&quot;20121990335&quot;], &quot;id&quot;: &quot;19730198868&quot;, &quot;key&quot;: &quot;submit.homepage_signup&quot;}, {&quot;experimentIds&quot;: [&quot;20121990335&quot;], &quot;id&quot;: &quot;19820830627&quot;, &quot;key&quot;: &quot;click.homepage_signup&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19988571001&quot;, &quot;key&quot;: &quot;click.create_enterprise_trial&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20036538294&quot;, &quot;key&quot;: &quot;click.create_organization_team&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20040653299&quot;, &quot;key&quot;: &quot;click.input_enterprise_trial_form&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20062030003&quot;, &quot;key&quot;: &quot;click.continue_with_team&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20068947153&quot;, &quot;key&quot;: &quot;click.create_organization_free&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20086636658&quot;, &quot;key&quot;: &quot;click.signup_continue.username&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20091648988&quot;, &quot;key&quot;: &quot;click.signup_continue.create_account&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20103637615&quot;, &quot;key&quot;: &quot;click.signup_continue.email&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20111574253&quot;, &quot;key&quot;: &quot;click.signup_continue.password&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20120044111&quot;, &quot;key&quot;: &quot;view.pricing_page&quot;}, {&quot;experimentIds&quot;: [&quot;20121990335&quot;, &quot;20233233507&quot;], &quot;id&quot;: &quot;20152062109&quot;, &quot;key&quot;: &quot;submit.create_account&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20165800992&quot;, &quot;key&quot;: &quot;submit.upgrade_payment_form&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20171520319&quot;, &quot;key&quot;: &quot;submit.create_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20222645674&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.discuss_your_needs&quot;}, {&quot;experimentIds&quot;: [&quot;20206000276&quot;], &quot;id&quot;: &quot;20227443657&quot;, &quot;key&quot;: &quot;submit.verify_primary_user_email&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20234607160&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.try_enterprise&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20238175784&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.team&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20239847212&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.continue_free&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20251097193&quot;, &quot;key&quot;: &quot;recommended_plan&quot;}], &quot;revision&quot;: &quot;674&quot;}" />
+  <!-- To prevent page flashing, the optimizely JS needs to be loaded in the
+    <head> tag before the DOM renders -->
+  <script crossorigin="anonymous" defer="defer" integrity="sha512-KjDXI2MZJ6BWlcZ1MwvbvGb03Wdwyy9MkAaQI950EjxF4sk+HdRSqJZQ/7RuUGqP55DBAsUY9DJ4APahsReJ/g==" type="application/javascript" src="https://github.githubassets.com/assets/optimizely-2a30d723.js"></script>
+
+
+
+  
+
+      <meta name="hostname" content="github.com">
+    <meta name="user-login" content="">
+
+
+      <meta name="expected-hostname" content="github.com">
+
+
+    <meta name="enabled-features" content="MARKETPLACE_PENDING_INSTALLATIONS,AUTOCOMPLETE_EMOJIS_IN_MARKDOWN_EDITOR,ACTIONS_CONCURRENCY_UI">
+
+  <meta http-equiv="x-pjax-version" content="ff84d8f1624c8c51a2eec95279965c3706b6129c8d785ff1055762e5d9765f7a">
+  
+
+    
+  <meta name="go-import" content="github.com/quantumlib/qsim git https://github.com/quantumlib/qsim.git">
+
+  <meta name="octolytics-dimension-user_id" content="31279789" /><meta name="octolytics-dimension-user_login" content="quantumlib" /><meta name="octolytics-dimension-repository_id" content="236547448" /><meta name="octolytics-dimension-repository_nwo" content="quantumlib/qsim" /><meta name="octolytics-dimension-repository_public" content="true" /><meta name="octolytics-dimension-repository_is_fork" content="false" /><meta name="octolytics-dimension-repository_network_root_id" content="236547448" /><meta name="octolytics-dimension-repository_network_root_nwo" content="quantumlib/qsim" />
+
+
+
+    <link rel="canonical" href="https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24" data-pjax-transient>
+
+
+  <meta name="browser-stats-url" content="https://api.github.com/_private/browser/stats">
+
+  <meta name="browser-errors-url" content="https://api.github.com/_private/browser/errors">
+
+  <meta name="browser-optimizely-client-errors-url" content="https://api.github.com/_private/browser/optimizely_client/errors">
+
+  <link rel="mask-icon" href="https://github.githubassets.com/pinned-octocat.svg" color="#000000">
+  <link rel="alternate icon" class="js-site-favicon" type="image/png" href="https://github.githubassets.com/favicons/favicon.png">
+  <link rel="icon" class="js-site-favicon" type="image/svg+xml" href="https://github.githubassets.com/favicons/favicon.svg">
+
+<meta name="theme-color" content="#1e2327">
+<meta name="color-scheme" content="light dark" />
+
+
+  <link rel="manifest" href="/manifest.json" crossOrigin="use-credentials">
+
+<meta name="enabled-homepage-translation-languages" content="ko">
+
+  </head>
+
+  <body class="logged-out env-production page-responsive page-blob" style="word-wrap: break-word;">
+    
+
+    <div class="position-relative js-header-wrapper ">
+      <a href="#start-of-content" class="px-2 py-4 color-bg-info-inverse color-text-white show-on-focus js-skip-to-content">Skip to content</a>
+      <span class="progress-pjax-loader width-full js-pjax-loader-bar Progress position-fixed">
+    <span style="background-color: #79b8ff;width: 0%;" class="Progress-item progress-pjax-loader-bar"></span>
+</span>      
+      
+
+
+            <header class="Header-old header-logged-out js-details-container Details position-relative f4 py-2" role="banner">
+  <div class="container-xl d-lg-flex flex-items-center p-responsive">
+    <div class="d-flex flex-justify-between flex-items-center">
+        <a class="mr-4" href="https://github.com/" aria-label="Homepage" data-ga-click="(Logged out) Header, go to homepage, icon:logo-wordmark">
+          <svg height="32" class="octicon octicon-mark-github color-text-white" viewBox="0 0 16 16" version="1.1" width="32" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg>
+        </a>
+
+          <div class="d-lg-none css-truncate css-truncate-target width-fit p-2">
+            
+
+          </div>
+
+        <div class="d-flex flex-items-center">
+              <nux-signup-candidates
+                data-attribute-name="href"
+                data-candidate-url="/join_next?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo"
+                data-action="loaded:nux-signup-candidates#determineSignupAction"
+                
+              >
+                <a href="/join?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo"
+                  class="d-inline-block d-lg-none f5 color-text-white no-underline border color-border-tertiary rounded-2 px-2 py-1 mr-3 mr-sm-5"
+                  data-target="nux-signup-candidates.signupAction"
+                  data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;site header&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;SIGN_UP&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="17e93c2b4c85efa02ea09a6c137f6ff2f8f00a1ccb8ac8f931d637b46394bfa3"
+                >
+                  Sign&nbsp;up
+                </a>
+              </nux-signup-candidates>
+
+          <button class="btn-link d-lg-none mt-1 js-details-target" type="button" aria-label="Toggle navigation" aria-expanded="false">
+            <svg height="24" class="octicon octicon-three-bars color-text-white" viewBox="0 0 16 16" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M1 2.75A.75.75 0 011.75 2h12.5a.75.75 0 110 1.5H1.75A.75.75 0 011 2.75zm0 5A.75.75 0 011.75 7h12.5a.75.75 0 110 1.5H1.75A.75.75 0 011 7.75zM1.75 12a.75.75 0 100 1.5h12.5a.75.75 0 100-1.5H1.75z"></path></svg>
+          </button>
+        </div>
+    </div>
+
+    <div class="HeaderMenu HeaderMenu--logged-out position-fixed top-0 right-0 bottom-0 height-fit position-lg-relative d-lg-flex flex-justify-between flex-items-center flex-auto">
+      <div class="d-flex d-lg-none flex-justify-end border-bottom color-bg-secondary p-3">
+        <button class="btn-link js-details-target" type="button" aria-label="Toggle navigation" aria-expanded="false">
+          <svg height="24" class="octicon octicon-x color-text-secondary" viewBox="0 0 24 24" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M5.72 5.72a.75.75 0 011.06 0L12 10.94l5.22-5.22a.75.75 0 111.06 1.06L13.06 12l5.22 5.22a.75.75 0 11-1.06 1.06L12 13.06l-5.22 5.22a.75.75 0 01-1.06-1.06L10.94 12 5.72 6.78a.75.75 0 010-1.06z"></path></svg>
+        </button>
+      </div>
+
+        <nav class="mt-0 px-3 px-lg-0 mb-5 mb-lg-0" aria-label="Global">
+          <ul class="d-lg-flex list-style-none">
+              <li class="d-block d-lg-flex flex-lg-nowrap flex-lg-items-center border-bottom border-lg-bottom-0 mr-0 mr-lg-3 edge-item-fix position-relative flex-wrap flex-justify-between d-flex flex-items-center ">
+                <details class="HeaderMenu-details details-overlay details-reset width-full">
+                  <summary class="HeaderMenu-summary HeaderMenu-link px-0 py-3 border-0 no-wrap d-block d-lg-inline-block">
+                    Why GitHub?
+                    <svg x="0px" y="0px" viewBox="0 0 14 8" xml:space="preserve" fill="none" class="icon-chevon-down-mktg position-absolute position-lg-relative">
+                      <path d="M1,1l6.2,6L13,1"></path>
+                    </svg>
+                  </summary>
+                  <div class="dropdown-menu flex-auto rounded px-0 mt-0 pb-4 p-lg-4 position-relative position-lg-absolute left-0 left-lg-n4">
+                    <a href="/features" class="py-2 lh-condensed-ultra d-block Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Features">Features <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a>
+                    <ul class="list-style-none f5 pb-3">
+                        <li class="edge-item-fix"><a href="/mobile" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Mobile <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/features/actions" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Actions <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/features/codespaces" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Codespaces <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/features/packages" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Packages <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/features/security" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Security <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/features/code-review/" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Code review <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/features/project-management/" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Project management <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/features/integrations" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Integrations <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                    </ul>
+
+                    <ul class="list-style-none mb-0 border-lg-top pt-lg-3">
+                      <li class="edge-item-fix"><a href="/sponsors" class="py-2 lh-condensed-ultra d-block no-underline Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Sponsors">GitHub Sponsors <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="/customer-stories" class="py-2 lh-condensed-ultra d-block no-underline Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Customer stories">Customer stories<span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                    </ul>
+                  </div>
+                </details>
+              </li>
+              <li class="border-bottom border-lg-bottom-0 mr-0 mr-lg-3">
+                <a href="/team" class="HeaderMenu-link no-underline py-3 d-block d-lg-inline-block" data-ga-click="(Logged out) Header, go to Team">Team</a>
+              </li>
+              <li class="border-bottom border-lg-bottom-0 mr-0 mr-lg-3">
+                <a href="/enterprise" class="HeaderMenu-link no-underline py-3 d-block d-lg-inline-block" data-ga-click="(Logged out) Header, go to Enterprise">Enterprise</a>
+              </li>
+
+              <li class="d-block d-lg-flex flex-lg-nowrap flex-lg-items-center border-bottom border-lg-bottom-0 mr-0 mr-lg-3 edge-item-fix position-relative flex-wrap flex-justify-between d-flex flex-items-center ">
+                <details class="HeaderMenu-details details-overlay details-reset width-full">
+                  <summary class="HeaderMenu-summary HeaderMenu-link px-0 py-3 border-0 no-wrap d-block d-lg-inline-block">
+                    Explore
+                    <svg x="0px" y="0px" viewBox="0 0 14 8" xml:space="preserve" fill="none" class="icon-chevon-down-mktg position-absolute position-lg-relative">
+                      <path d="M1,1l6.2,6L13,1"></path>
+                    </svg>
+                  </summary>
+
+                  <div class="dropdown-menu flex-auto rounded px-0 pt-2 pb-0 mt-0 pb-4 p-lg-4 position-relative position-lg-absolute left-0 left-lg-n4">
+                    <ul class="list-style-none mb-3">
+                      <li class="edge-item-fix"><a href="/explore" class="py-2 lh-condensed-ultra d-block Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Explore">Explore GitHub <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                    </ul>
+
+                    <h4 class="color-text-tertiary text-normal text-mono f5 mb-2 border-lg-top pt-lg-3">Learn and contribute</h4>
+                    <ul class="list-style-none mb-3">
+                      <li class="edge-item-fix"><a href="/topics" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Topics">Topics <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                        <li class="edge-item-fix"><a href="/collections" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Collections">Collections <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="/trending" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Trending">Trending <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="https://lab.github.com/" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Learning lab">Learning Lab <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="https://opensource.guide" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Open source guides">Open source guides <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                    </ul>
+
+                    <h4 class="color-text-tertiary text-normal text-mono f5 mb-2 border-lg-top pt-lg-3">Connect with others</h4>
+                    <ul class="list-style-none mb-0">
+                      <li class="edge-item-fix"><a href="https://github.com/readme" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">The ReadME Project <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="https://github.com/events" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Events">Events <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="https://github.community" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Community forum">Community forum <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="https://education.github.com" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to GitHub Education">GitHub Education <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="https://stars.github.com" class="py-2 pb-0 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to GitHub Stars Program">GitHub Stars program <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                    </ul>
+                  </div>
+                </details>
+              </li>
+
+              <li class="border-bottom border-lg-bottom-0 mr-0 mr-lg-3">
+                <a href="/marketplace" class="HeaderMenu-link no-underline py-3 d-block d-lg-inline-block" data-ga-click="(Logged out) Header, go to Marketplace">Marketplace</a>
+              </li>
+
+              <li class="d-block d-lg-flex flex-lg-nowrap flex-lg-items-center border-bottom border-lg-bottom-0 mr-0 mr-lg-3 edge-item-fix position-relative flex-wrap flex-justify-between d-flex flex-items-center ">
+                <details class="HeaderMenu-details details-overlay details-reset width-full">
+                  <summary class="HeaderMenu-summary HeaderMenu-link px-0 py-3 border-0 no-wrap d-block d-lg-inline-block">
+                    Pricing
+                    <svg x="0px" y="0px" viewBox="0 0 14 8" xml:space="preserve" fill="none" class="icon-chevon-down-mktg position-absolute position-lg-relative">
+                       <path d="M1,1l6.2,6L13,1"></path>
+                    </svg>
+                  </summary>
+
+                  <div class="dropdown-menu flex-auto rounded px-0 pt-2 pb-4 mt-0 p-lg-4 position-relative position-lg-absolute left-0 left-lg-n4">
+                    <a href="/pricing" class="pb-2 lh-condensed-ultra d-block Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Pricing">Plans <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a>
+
+                    <ul class="list-style-none mb-3">
+                      <li class="edge-item-fix"><a href="/pricing#feature-comparison" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Compare plans">Compare plans <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                      <li class="edge-item-fix"><a href="https://enterprise.github.com/contact" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Contact Sales">Contact Sales <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                    </ul>
+
+                    <ul class="list-style-none mb-0 border-lg-top pt-lg-3">
+                      <li class="edge-item-fix"><a href="https://education.github.com" class="py-2 pb-0 lh-condensed-ultra d-block no-underline Link--primary no-underline h5 Bump-link--hover"  data-ga-click="(Logged out) Header, go to Education">Education <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
+                    </ul>
+                  </div>
+                </details>
+              </li>
+          </ul>
+        </nav>
+
+      <div class="d-lg-flex flex-items-center px-3 px-lg-0 text-center text-lg-left">
+          <div class="d-lg-flex min-width-0 mb-3 mb-lg-0">
+            <div class="header-search flex-auto js-site-search position-relative flex-self-stretch flex-md-self-auto mb-3 mb-md-0 mr-0 mr-md-3 scoped-search site-scoped-search js-jump-to"
+  role="combobox"
+  aria-owns="jump-to-results"
+  aria-label="Search or jump to"
+  aria-haspopup="listbox"
+  aria-expanded="false"
+>
+  <div class="position-relative">
+    <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="js-site-search-form" role="search" aria-label="Site" data-scope-type="Repository" data-scope-id="236547448" data-scoped-search-url="/quantumlib/qsim/search" data-owner-scoped-search-url="/orgs/quantumlib/search" data-unscoped-search-url="/search" action="/quantumlib/qsim/search" accept-charset="UTF-8" method="get">
+      <label class="form-control input-sm header-search-wrapper p-0 js-chromeless-input-container header-search-wrapper-jump-to position-relative d-flex flex-justify-between flex-items-center">
+        <input type="text"
+          class="form-control input-sm header-search-input jump-to-field js-jump-to-field js-site-search-focus js-site-search-field is-clearable"
+          data-hotkey="s,/"
+          name="q"
+          value=""
+          placeholder="Search"
+          data-unscoped-placeholder="Search GitHub"
+          data-scoped-placeholder="Search"
+          autocapitalize="off"
+          aria-autocomplete="list"
+          aria-controls="jump-to-results"
+          aria-label="Search"
+          data-jump-to-suggestions-path="/_graphql/GetSuggestedNavigationDestinations"
+          spellcheck="false"
+          autocomplete="off"
+          >
+          <input type="hidden" data-csrf="true" class="js-data-jump-to-suggestions-path-csrf" value="/iVDYbLCFDho82JlvMg5TjYtK4vPmcXkH3LKJbB/jNhafAf+tUeBoF8werutEqR3vaEjGpqXrYn4Rol2xGNDcA==" />
+          <input type="hidden" class="js-site-search-type-field" name="type" >
+            <img src="https://github.githubassets.com/images/search-key-slash.svg" alt="" class="mr-2 header-search-key-slash">
+
+            <div class="Box position-absolute overflow-hidden d-none jump-to-suggestions js-jump-to-suggestions-container">
+              
+<ul class="d-none js-jump-to-suggestions-template-container">
+  
+
+<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-suggestion" role="option">
+  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="suggestion">
+    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
+      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
+    </div>
+
+    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
+
+    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
+    </div>
+
+    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
+      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository">
+        In this repository
+      </span>
+      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
+        All GitHub
+      </span>
+      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+
+    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
+      Jump to
+      <span class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+  </a>
+</li>
+
+</ul>
+
+<ul class="d-none js-jump-to-no-results-template-container">
+  <li class="d-flex flex-justify-center flex-items-center f5 d-none js-jump-to-suggestion p-2">
+    <span class="color-text-secondary">No suggested jump to results</span>
+  </li>
+</ul>
+
+<ul id="jump-to-results" role="listbox" class="p-0 m-0 js-navigation-container jump-to-suggestions-results-container js-jump-to-suggestions-results-container">
+  
+
+<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-scoped-search d-none" role="option">
+  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="scoped_search">
+    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
+      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
+    </div>
+
+    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
+
+    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
+    </div>
+
+    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
+      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository">
+        In this repository
+      </span>
+      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
+        All GitHub
+      </span>
+      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+
+    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
+      Jump to
+      <span class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+  </a>
+</li>
+
+  
+
+<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-owner-scoped-search d-none" role="option">
+  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="owner_scoped_search">
+    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
+      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
+    </div>
+
+    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
+
+    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
+    </div>
+
+    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
+      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this organization">
+        In this organization
+      </span>
+      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
+        All GitHub
+      </span>
+      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+
+    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
+      Jump to
+      <span class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+  </a>
+</li>
+
+  
+
+<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-global-search d-none" role="option">
+  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="global_search">
+    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
+      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
+      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
+    </div>
+
+    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
+
+    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
+    </div>
+
+    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
+      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository">
+        In this repository
+      </span>
+      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
+        All GitHub
+      </span>
+      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+
+    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
+      Jump to
+      <span class="d-inline-block ml-1 v-align-middle">↵</span>
+    </div>
+  </a>
+</li>
+
+
+</ul>
+
+            </div>
+      </label>
+</form>  </div>
+</div>
+
+          </div>
+
+        <a href="/login?return_to=%2Fquantumlib%2Fqsim%2Fblob%2Fmaster%2Fcircuits%2Fcircuit_q24"
+          class="HeaderMenu-link flex-shrink-0 no-underline mr-3"
+          data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;site header menu&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;SIGN_UP&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="0e109bf3a24ebce4c5abf1a03e2ae84137e33d67097c43f9d4802ddd06a1006e"
+          data-ga-click="(Logged out) Header, clicked Sign in, text:sign-in">
+          Sign in
+        </a>
+            <nux-signup-candidates
+              data-attribute-name="href"
+              data-candidate-url="/join_next?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo&amp;source_repo=quantumlib%2Fqsim"
+              data-action="loaded:nux-signup-candidates#determineSignupAction"
+              
+            >
+              <a href="/join?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo&amp;source_repo=quantumlib%2Fqsim"
+                class="HeaderMenu-link flex-shrink-0 d-inline-block no-underline border color-border-tertiary rounded px-2 py-1"
+                data-target="nux-signup-candidates.signupAction"
+                data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;site header menu&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;SIGN_UP&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="0e109bf3a24ebce4c5abf1a03e2ae84137e33d67097c43f9d4802ddd06a1006e"
+                data-hydro-click="{&quot;event_type&quot;:&quot;analytics.event&quot;,&quot;payload&quot;:{&quot;category&quot;:&quot;Sign up&quot;,&quot;action&quot;:&quot;click to sign up for account&quot;,&quot;label&quot;:&quot;ref_page:/&lt;user-name&gt;/&lt;repo-name&gt;/blob/show;ref_cta:Sign up;ref_loc:header logged out&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="8eca39af97e6f4b898c2d1996b269ab98520fbcd61eb97151881315fea38fc76"
+              >
+                Sign up
+              </a>
+            </nux-signup-candidates>
+      </div>
+    </div>
+  </div>
+</header>
+
+    </div>
+
+  <div id="start-of-content" class="show-on-focus"></div>
+
+
+
+
+
+    <div data-pjax-replace id="js-flash-container">
+
+
+  <template class="js-flash-template">
+    <div class="flash flash-full  {{ className }}">
+  <div class=" px-2" >
+    <button class="flash-close js-flash-close" type="button" aria-label="Dismiss this message">
+      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
+    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
+</svg>
+    </button>
+    
+      <div>{{ message }}</div>
+
+  </div>
+</div>
+  </template>
+</div>
+
+
+    
+
+  <include-fragment class="js-notification-shelf-include-fragment" data-base-src="https://github.com/notifications/beta/shelf"></include-fragment>
+
+
+
+
+  <div
+    class="application-main "
+    data-commit-hovercards-enabled
+    data-discussion-hovercards-enabled
+    data-issue-and-pr-hovercards-enabled
+  >
+        <div itemscope itemtype="http://schema.org/SoftwareSourceCode" class="">
+    <main id="js-repo-pjax-container" data-pjax-container >
+      
+
+      
+    
+
+
+
+
+
+
+  
+
+
+  <div class="color-bg-secondary pt-3 hide-full-screen mb-5">
+
+      <div class="d-flex mb-3 px-3 px-md-4 px-lg-5">
+
+        <div class="flex-auto min-width-0 width-fit mr-3">
+            <h1 class=" d-flex flex-wrap flex-items-center break-word f3 text-normal">
+    <svg class="octicon octicon-repo color-text-secondary mr-2" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
+  <span class="author flex-self-stretch" itemprop="author">
+    <a class="url fn" rel="author" data-hovercard-type="organization" data-hovercard-url="/orgs/quantumlib/hovercard" href="/quantumlib">quantumlib</a>
+  </span>
+  <span class="mx-1 flex-self-stretch color-text-secondary">/</span>
+  <strong itemprop="name" class="mr-2 flex-self-stretch">
+    <a data-pjax="#js-repo-pjax-container" href="/quantumlib/qsim">qsim</a>
+  </strong>
+  
+</h1>
+
+
+        </div>
+
+          <ul class="pagehead-actions flex-shrink-0 d-none d-md-inline" style="padding: 2px 0;">
+
+  <li>
+      <a class="tooltipped tooltipped-s btn btn-sm" aria-label="You must be signed in to change notification settings" rel="nofollow" data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;notification subscription menu watch&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;LOG_IN&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="f197f3a9c3aa1fe688c997cb5ee7a1cac54aa838665ff1b2b4dbe5984069f58c" href="/login?return_to=%2Fquantumlib%2Fqsim">
+    <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-bell">
+    <path d="M8 16a2 2 0 001.985-1.75c.017-.137-.097-.25-.235-.25h-3.5c-.138 0-.252.113-.235.25A2 2 0 008 16z"></path><path fill-rule="evenodd" d="M8 1.5A3.5 3.5 0 004.5 5v2.947c0 .346-.102.683-.294.97l-1.703 2.556a.018.018 0 00-.003.01l.001.006c0 .002.002.004.004.006a.017.017 0 00.006.004l.007.001h10.964l.007-.001a.016.016 0 00.006-.004.016.016 0 00.004-.006l.001-.007a.017.017 0 00-.003-.01l-1.703-2.554a1.75 1.75 0 01-.294-.97V5A3.5 3.5 0 008 1.5zM3 5a5 5 0 0110 0v2.947c0 .05.015.098.042.139l1.703 2.555A1.518 1.518 0 0113.482 13H2.518a1.518 1.518 0 01-1.263-2.36l1.703-2.554A.25.25 0 003 7.947V5z"></path>
+</svg>
+    Notifications
+</a>
+  </li>
+
+  <li>
+          <a class="btn btn-sm btn-with-count  tooltipped tooltipped-s" aria-label="You must be signed in to star a repository" rel="nofollow" data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;star button&quot;,&quot;repository_id&quot;:236547448,&quot;auth_type&quot;:&quot;LOG_IN&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="230a5fba514b19a9d0bf46e0f28fee134a31c7f74e000c92dfcc27543bec6bc4" href="/login?return_to=%2Fquantumlib%2Fqsim">
+      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-star v-align-text-bottom mr-1">
+    <path fill-rule="evenodd" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.75.75 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25zm0 2.445L6.615 5.5a.75.75 0 01-.564.41l-3.097.45 2.24 2.184a.75.75 0 01.216.664l-.528 3.084 2.769-1.456a.75.75 0 01.698 0l2.77 1.456-.53-3.084a.75.75 0 01.216-.664l2.24-2.183-3.096-.45a.75.75 0 01-.564-.41L8 2.694v.001z"></path>
+</svg>
+      <span>
+        Star
+</span></a>
+    <a class="social-count js-social-count" href="/quantumlib/qsim/stargazers"
+      aria-label="205 users starred this repository">
+      205
+    </a>
+
+  </li>
+
+  <li>
+        <a class="btn btn-sm btn-with-count tooltipped tooltipped-s" aria-label="You must be signed in to fork a repository" rel="nofollow" data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;repo details fork button&quot;,&quot;repository_id&quot;:236547448,&quot;auth_type&quot;:&quot;LOG_IN&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="f241901a9a14c4f841439fd6821dfe3bb89f66d0ad3cec50ef95be40848017e5" href="/login?return_to=%2Fquantumlib%2Fqsim">
+          <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-repo-forked">
+    <path fill-rule="evenodd" d="M5 3.25a.75.75 0 11-1.5 0 .75.75 0 011.5 0zm0 2.122a2.25 2.25 0 10-1.5 0v.878A2.25 2.25 0 005.75 8.5h1.5v2.128a2.251 2.251 0 101.5 0V8.5h1.5a2.25 2.25 0 002.25-2.25v-.878a2.25 2.25 0 10-1.5 0v.878a.75.75 0 01-.75.75h-4.5A.75.75 0 015 6.25v-.878zm3.75 7.378a.75.75 0 11-1.5 0 .75.75 0 011.5 0zm3-8.75a.75.75 0 100-1.5.75.75 0 000 1.5z"></path>
+</svg>
+          Fork
+</a>
+      <a href="/quantumlib/qsim/network/members" class="social-count"
+         aria-label="57 users forked this repository">
+        57
+      </a>
+  </li>
+</ul>
+
+      </div>
+        
+
+  <nav data-pjax="#js-repo-pjax-container" aria-label="Repository" class="js-repo-nav js-sidenav-container-pjax js-responsive-underlinenav overflow-hidden UnderlineNav px-3 px-md-4 px-lg-5 color-bg-secondary">
+
+    <ul class="UnderlineNav-body list-style-none">
+        <li class="d-flex">
+  <a href="/quantumlib/qsim" data-tab-item="i0code-tab" data-selected-links="repo_source repo_downloads repo_commits repo_releases repo_tags repo_branches repo_packages repo_deployments /quantumlib/qsim" data-hotkey="g c" data-ga-click="Repository, Navigation click, Code tab" aria-current="page" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item selected">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-code UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M4.72 3.22a.75.75 0 011.06 1.06L2.06 8l3.72 3.72a.75.75 0 11-1.06 1.06L.47 8.53a.75.75 0 010-1.06l4.25-4.25zm6.56 0a.75.75 0 10-1.06 1.06L13.94 8l-3.72 3.72a.75.75 0 101.06 1.06l4.25-4.25a.75.75 0 000-1.06l-4.25-4.25z"></path>
+</svg>
+          <span data-content="Code">Code</span>
+            <span title="Not available" class="Counter"></span>
+
+    
+</a></li>
+        <li class="d-flex">
+  <a href="/quantumlib/qsim/issues" data-tab-item="i1issues-tab" data-selected-links="repo_issues repo_labels repo_milestones /quantumlib/qsim/issues" data-hotkey="g i" data-ga-click="Repository, Navigation click, Issues tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-issue-opened UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M8 1.5a6.5 6.5 0 100 13 6.5 6.5 0 000-13zM0 8a8 8 0 1116 0A8 8 0 010 8zm9 3a1 1 0 11-2 0 1 1 0 012 0zm-.25-6.25a.75.75 0 00-1.5 0v3.5a.75.75 0 001.5 0v-3.5z"></path>
+</svg>
+          <span data-content="Issues">Issues</span>
+            <span title="19" class="Counter">19</span>
+
+    
+</a></li>
+        <li class="d-flex">
+  <a href="/quantumlib/qsim/pulls" data-tab-item="i2pull-requests-tab" data-selected-links="repo_pulls checks /quantumlib/qsim/pulls" data-hotkey="g p" data-ga-click="Repository, Navigation click, Pull requests tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-git-pull-request UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M7.177 3.073L9.573.677A.25.25 0 0110 .854v4.792a.25.25 0 01-.427.177L7.177 3.427a.25.25 0 010-.354zM3.75 2.5a.75.75 0 100 1.5.75.75 0 000-1.5zm-2.25.75a2.25 2.25 0 113 2.122v5.256a2.251 2.251 0 11-1.5 0V5.372A2.25 2.25 0 011.5 3.25zM11 2.5h-1V4h1a1 1 0 011 1v5.628a2.251 2.251 0 101.5 0V5A2.5 2.5 0 0011 2.5zm1 10.25a.75.75 0 111.5 0 .75.75 0 01-1.5 0zM3.75 12a.75.75 0 100 1.5.75.75 0 000-1.5z"></path>
+</svg>
+          <span data-content="Pull requests">Pull requests</span>
+            <span title="3" class="Counter">3</span>
+
+    
+</a></li>
+        <li class="d-flex">
+  <a href="/quantumlib/qsim/actions" data-tab-item="i3actions-tab" data-selected-links="repo_actions /quantumlib/qsim/actions" data-hotkey="g a" data-ga-click="Repository, Navigation click, Actions tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-play UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M1.5 8a6.5 6.5 0 1113 0 6.5 6.5 0 01-13 0zM8 0a8 8 0 100 16A8 8 0 008 0zM6.379 5.227A.25.25 0 006 5.442v5.117a.25.25 0 00.379.214l4.264-2.559a.25.25 0 000-.428L6.379 5.227z"></path>
+</svg>
+          <span data-content="Actions">Actions</span>
+            <span title="Not available" class="Counter"></span>
+
+    
+</a></li>
+        <li class="d-flex">
+  <a href="/quantumlib/qsim/projects" data-tab-item="i4projects-tab" data-selected-links="repo_projects new_repo_project repo_project /quantumlib/qsim/projects" data-hotkey="g b" data-ga-click="Repository, Navigation click, Projects tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-project UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path>
+</svg>
+          <span data-content="Projects">Projects</span>
+            <span title="0" hidden="hidden" class="Counter">0</span>
+
+    
+</a></li>
+        <li class="d-flex">
+  <a href="/quantumlib/qsim/wiki" data-tab-item="i5wiki-tab" data-selected-links="repo_wiki /quantumlib/qsim/wiki" data-hotkey="g w" data-ga-click="Repository, Navigation click, Wikis tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-book UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M0 1.75A.75.75 0 01.75 1h4.253c1.227 0 2.317.59 3 1.501A3.744 3.744 0 0111.006 1h4.245a.75.75 0 01.75.75v10.5a.75.75 0 01-.75.75h-4.507a2.25 2.25 0 00-1.591.659l-.622.621a.75.75 0 01-1.06 0l-.622-.621A2.25 2.25 0 005.258 13H.75a.75.75 0 01-.75-.75V1.75zm8.755 3a2.25 2.25 0 012.25-2.25H14.5v9h-3.757c-.71 0-1.4.201-1.992.572l.004-7.322zm-1.504 7.324l.004-5.073-.002-2.253A2.25 2.25 0 005.003 2.5H1.5v9h3.757a3.75 3.75 0 011.994.574z"></path>
+</svg>
+          <span data-content="Wiki">Wiki</span>
+            <span title="Not available" class="Counter"></span>
+
+    
+</a></li>
+        <li class="d-flex">
+  <a href="/quantumlib/qsim/security" data-tab-item="i6security-tab" data-selected-links="security overview alerts policy token_scanning code_scanning /quantumlib/qsim/security" data-hotkey="g s" data-ga-click="Repository, Navigation click, Security tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-shield UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M7.467.133a1.75 1.75 0 011.066 0l5.25 1.68A1.75 1.75 0 0115 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.7 1.7 0 01-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 011.217-1.667l5.25-1.68zm.61 1.429a.25.25 0 00-.153 0l-5.25 1.68a.25.25 0 00-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.2.2 0 00.154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.25.25 0 00-.174-.237l-5.25-1.68zM9 10.5a1 1 0 11-2 0 1 1 0 012 0zm-.25-5.75a.75.75 0 10-1.5 0v3a.75.75 0 001.5 0v-3z"></path>
+</svg>
+          <span data-content="Security">Security</span>
+            <include-fragment src="/quantumlib/qsim/security/overall-count" accept="text/fragment+html"></include-fragment>
+
+    
+</a></li>
+        <li class="d-flex">
+  <a href="/quantumlib/qsim/pulse" data-tab-item="i7insights-tab" data-selected-links="repo_graphs repo_contributors dependency_graph dependabot_updates pulse people community /quantumlib/qsim/pulse" data-ga-click="Repository, Navigation click, Insights tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
+    
+                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-graph UnderlineNav-octicon d-none d-sm-inline">
+    <path fill-rule="evenodd" d="M1.5 1.75a.75.75 0 00-1.5 0v12.5c0 .414.336.75.75.75h14.5a.75.75 0 000-1.5H1.5V1.75zm14.28 2.53a.75.75 0 00-1.06-1.06L10 7.94 7.53 5.47a.75.75 0 00-1.06 0L3.22 8.72a.75.75 0 001.06 1.06L7 7.06l2.47 2.47a.75.75 0 001.06 0l5.25-5.25z"></path>
+</svg>
+          <span data-content="Insights">Insights</span>
+            <span title="Not available" class="Counter"></span>
+
+    
+</a></li>
+</ul>
+      <div style="visibility:hidden;" class="UnderlineNav-actions  js-responsive-underlinenav-overflow position-absolute pr-3 pr-md-4 pr-lg-5 right-0">      <details class="details-overlay details-reset position-relative">
+  <summary role="button">          <div class="UnderlineNav-item mr-0 border-0">
+            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-kebab-horizontal">
+    <path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path>
+</svg>
+            <span class="sr-only">More</span>
+          </div>
+</summary>
+  <div>          <details-menu role="menu" class="dropdown-menu dropdown-menu-sw">
+  
+            <ul>
+                <li data-menu-item="i0code-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim" href="/quantumlib/qsim">
+                    Code
+</a>                </li>
+                <li data-menu-item="i1issues-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/issues" href="/quantumlib/qsim/issues">
+                    Issues
+</a>                </li>
+                <li data-menu-item="i2pull-requests-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/pulls" href="/quantumlib/qsim/pulls">
+                    Pull requests
+</a>                </li>
+                <li data-menu-item="i3actions-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/actions" href="/quantumlib/qsim/actions">
+                    Actions
+</a>                </li>
+                <li data-menu-item="i4projects-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/projects" href="/quantumlib/qsim/projects">
+                    Projects
+</a>                </li>
+                <li data-menu-item="i5wiki-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/wiki" href="/quantumlib/qsim/wiki">
+                    Wiki
+</a>                </li>
+                <li data-menu-item="i6security-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/security" href="/quantumlib/qsim/security">
+                    Security
+</a>                </li>
+                <li data-menu-item="i7insights-tab" hidden>
+                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/pulse" href="/quantumlib/qsim/pulse">
+                    Insights
+</a>                </li>
+            </ul>
+
+</details-menu></div>
+</details></div>
+</nav>
+
+  </div>
+
+
+<div class="container-xl clearfix new-discussion-timeline px-3 px-md-4 px-lg-5">
+  <div id="repo-content-pjax-container" class="repository-content " >
+
+    
+      
+    
+<div>
+  
+
+
+    <a class="d-none js-permalink-shortcut" data-hotkey="y" href="/quantumlib/qsim/blob/1d0965c9c27f735edeb2a18b7bf5a27e7592bd6f/circuits/circuit_q24">Permalink</a>
+
+    <!-- blob contrib key: blob_contributors:v22:015210a8b5806fde8e96e079906c704b5fefe5024be20c1a6014b6e1cd358ae8 -->
+
+    <div class="d-flex flex-items-start flex-shrink-0 pb-3 flex-wrap flex-md-nowrap flex-justify-between flex-md-justify-start">
+      
+<div class="position-relative">
+  <details class="details-reset details-overlay mr-0 mb-0 " id="branch-select-menu">
+    <summary class="btn css-truncate"
+            data-hotkey="w"
+            title="Switch branches or tags">
+      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-git-branch text-gray">
+    <path fill-rule="evenodd" d="M11.75 2.5a.75.75 0 100 1.5.75.75 0 000-1.5zm-2.25.75a2.25 2.25 0 113 2.122V6A2.5 2.5 0 0110 8.5H6a1 1 0 00-1 1v1.128a2.251 2.251 0 11-1.5 0V5.372a2.25 2.25 0 111.5 0v1.836A2.492 2.492 0 016 7h4a1 1 0 001-1v-.628A2.25 2.25 0 019.5 3.25zM4.25 12a.75.75 0 100 1.5.75.75 0 000-1.5zM3.5 3.25a.75.75 0 111.5 0 .75.75 0 01-1.5 0z"></path>
+</svg>
+      <span class="css-truncate-target" data-menu-button>master</span>
+      <span class="dropdown-caret"></span>
+    </summary>
+
+      
+<div class="SelectMenu">
+  <div class="SelectMenu-modal">
+    <header class="SelectMenu-header">
+      <span class="SelectMenu-title">Switch branches/tags</span>
+      <button class="SelectMenu-closeButton" type="button" data-toggle-for="branch-select-menu"><svg aria-label="Close menu" aria-hidden="false" role="img" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
+    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
+</svg></button>
+    </header>
+
+    <input-demux data-action="tab-container-change:input-demux#storeInput tab-container-changed:input-demux#updateInput">
+      <tab-container class="d-flex flex-column js-branches-tags-tabs" style="min-height: 0;">
+        <div class="SelectMenu-filter">
+          <input data-target="input-demux.source"
+                 id="context-commitish-filter-field"
+                 class="SelectMenu-input form-control"
+                 aria-owns="ref-list-branches"
+                 data-controls-ref-menu-id="ref-list-branches"
+                 autofocus
+                 autocomplete="off"
+                 aria-label="Filter branches/tags"
+                 placeholder="Filter branches/tags"
+                 type="text"
+          >
+        </div>
+
+        <div class="SelectMenu-tabs" role="tablist" data-target="input-demux.control" >
+          <button class="SelectMenu-tab" type="button" role="tab" aria-selected="true">Branches</button>
+          <button class="SelectMenu-tab" type="button" role="tab">Tags</button>
+        </div>
+
+        <div role="tabpanel" id="ref-list-branches" data-filter-placeholder="Filter branches/tags" class="d-flex flex-column flex-auto overflow-auto" tabindex="">
+          <ref-selector
+            type="branch"
+            data-targets="input-demux.sinks"
+            data-action="
+              input-entered:ref-selector#inputEntered
+              tab-selected:ref-selector#tabSelected
+              focus-list:ref-selector#focusFirstListMember
+            "
+            query-endpoint="/quantumlib/qsim/refs"
+            
+            cache-key="v0:1620746711.204412"
+            current-committish="bWFzdGVy"
+            default-branch="bWFzdGVy"
+            name-with-owner="cXVhbnR1bWxpYi9xc2lt"
+          >
+
+              <template data-target="ref-selector.noMatchTemplate">
+    <div class="SelectMenu-message">Nothing to show</div>
+</template>
+
+
+            <!-- TODO: this max-height is necessary or else the branch list won't scroll.  why? -->
+            <div data-target="ref-selector.listContainer" role="menu" class="SelectMenu-list " style="max-height: 330px">
+              <div class="SelectMenu-loading pt-3 pb-0" aria-label="Menu is loading">
+                <svg style="box-sizing: content-box; color: var(--color-icon-primary);" viewBox="0 0 16 16" fill="none" width="32" height="32" class="anim-rotate">
+  <circle cx="8" cy="8" r="7" stroke="currentColor" stroke-opacity="0.25" stroke-width="2" vector-effect="non-scaling-stroke" />
+  <path d="M15 8a7.002 7.002 0 00-7-7" stroke="currentColor" stroke-width="2" stroke-linecap="round" vector-effect="non-scaling-stroke" />
+</svg>
+              </div>
+            </div>
+
+              <template data-target="ref-selector.itemTemplate">
+  <a href="https://github.com/quantumlib/qsim/blob/{{ urlEncodedRefName }}/circuits/circuit_q24" class="SelectMenu-item" role="menuitemradio" rel="nofollow" aria-checked="{{ isCurrent }}" data-index="{{ index }}">
+    <svg class="octicon octicon-check SelectMenu-icon SelectMenu-icon--check" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M13.78 4.22a.75.75 0 010 1.06l-7.25 7.25a.75.75 0 01-1.06 0L2.22 9.28a.75.75 0 011.06-1.06L6 10.94l6.72-6.72a.75.75 0 011.06 0z"></path></svg>
+    <span class="flex-1 css-truncate css-truncate-overflow {{ isFilteringClass }}">{{ refName }}</span>
+    <span hidden="{{ isNotDefault }}" class="Label Label--secondary flex-self-start">default</span>
+  </a>
+</template>
+
+
+              <footer class="SelectMenu-footer"><a href="/quantumlib/qsim/branches">View all branches</a></footer>
+          </ref-selector>
+
+        </div>
+
+        <div role="tabpanel" id="tags-menu" data-filter-placeholder="Find a tag" class="d-flex flex-column flex-auto overflow-auto" tabindex="" hidden>
+          <ref-selector
+            type="tag"
+            data-action="
+              input-entered:ref-selector#inputEntered
+              tab-selected:ref-selector#tabSelected
+              focus-list:ref-selector#focusFirstListMember
+            "
+            data-targets="input-demux.sinks"
+            query-endpoint="/quantumlib/qsim/refs"
+            cache-key="v0:1620746711.204412"
+            current-committish="bWFzdGVy"
+            default-branch="bWFzdGVy"
+            name-with-owner="cXVhbnR1bWxpYi9xc2lt"
+          >
+
+            <template data-target="ref-selector.noMatchTemplate">
+              <div class="SelectMenu-message" data-index="{{ index }}">Nothing to show</div>
+            </template>
+
+              <template data-target="ref-selector.itemTemplate">
+  <a href="https://github.com/quantumlib/qsim/blob/{{ urlEncodedRefName }}/circuits/circuit_q24" class="SelectMenu-item" role="menuitemradio" rel="nofollow" aria-checked="{{ isCurrent }}" data-index="{{ index }}">
+    <svg class="octicon octicon-check SelectMenu-icon SelectMenu-icon--check" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M13.78 4.22a.75.75 0 010 1.06l-7.25 7.25a.75.75 0 01-1.06 0L2.22 9.28a.75.75 0 011.06-1.06L6 10.94l6.72-6.72a.75.75 0 011.06 0z"></path></svg>
+    <span class="flex-1 css-truncate css-truncate-overflow {{ isFilteringClass }}">{{ refName }}</span>
+    <span hidden="{{ isNotDefault }}" class="Label Label--secondary flex-self-start">default</span>
+  </a>
+</template>
+
+
+            <div data-target="ref-selector.listContainer" role="menu" class="SelectMenu-list" style="max-height: 330px">
+              <div class="SelectMenu-loading pt-3 pb-0" aria-label="Menu is loading">
+                <svg style="box-sizing: content-box; color: var(--color-icon-primary);" viewBox="0 0 16 16" fill="none" width="32" height="32" class="anim-rotate">
+  <circle cx="8" cy="8" r="7" stroke="currentColor" stroke-opacity="0.25" stroke-width="2" vector-effect="non-scaling-stroke" />
+  <path d="M15 8a7.002 7.002 0 00-7-7" stroke="currentColor" stroke-width="2" stroke-linecap="round" vector-effect="non-scaling-stroke" />
+</svg>
+              </div>
+            </div>
+              <footer class="SelectMenu-footer"><a href="/quantumlib/qsim/tags">View all tags</a></footer>
+          </ref-selector>
+        </div>
+      </tab-container>
+    </input-demux>
+  </div>
+</div>
+
+  </details>
+
+</div>
+
+      <h2 id="blob-path" class="breadcrumb flex-auto flex-self-center min-width-0 text-normal mx-2 width-full width-md-auto flex-order-1 flex-md-order-none mt-3 mt-md-0">
+        <span class="js-repo-root text-bold"><span class="js-path-segment d-inline-block wb-break-all"><a data-pjax="true" href="/quantumlib/qsim"><span>qsim</span></a></span></span><span class="separator">/</span><span class="js-path-segment d-inline-block wb-break-all"><a data-pjax="true" href="/quantumlib/qsim/tree/master/circuits"><span>circuits</span></a></span><span class="separator">/</span><strong class="final-path">circuit_q24</strong>
+      </h2>
+      <a href="/quantumlib/qsim/find/master"
+            class="js-pjax-capture-input btn mr-2 d-none d-md-block"
+            data-pjax
+            data-hotkey="t">
+        Go to file
+      </a>
+
+      <details id="blob-more-options-details" class="details-overlay details-reset position-relative">
+  <summary role="button" class="btn">
+  
+            <svg aria-label="More options" role="img" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-kebab-horizontal">
+    <path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path>
+</svg>
+
+  
+
+</summary>
+  <div>          <ul class="dropdown-menu dropdown-menu-sw">
+            <li class="d-block d-md-none">
+              <a class="dropdown-item d-flex flex-items-baseline" data-hydro-click="{&quot;event_type&quot;:&quot;repository.click&quot;,&quot;payload&quot;:{&quot;target&quot;:&quot;FIND_FILE_BUTTON&quot;,&quot;repository_id&quot;:236547448,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="e3859f32acd054d8f94869880124db148dd267228c790ef09f547ee94f089fbe" data-ga-click="Repository, find file, location:repo overview" data-hotkey="t" data-pjax="true" href="/quantumlib/qsim/find/master">
+                <span class="flex-auto">Go to file</span>
+                <span class="text-small color-text-secondary" aria-hidden="true">T</span>
+</a>            </li>
+            <li data-toggle-for="blob-more-options-details">
+              <button type="button" data-toggle-for="jumpto-line-details-dialog" class="btn-link dropdown-item">
+                <span class="d-flex flex-items-baseline">
+                  <span class="flex-auto">Go to line</span>
+                  <span class="text-small color-text-secondary" aria-hidden="true">L</span>
+                </span>
+              </button>
+            </li>
+            <li class="dropdown-divider" role="none"></li>
+            <li>
+              <clipboard-copy value="circuits/circuit_q24" class="dropdown-item cursor-pointer" data-toggle-for="blob-more-options-details">
+                Copy path
+              </clipboard-copy>
+            </li>
+            <li>
+              <clipboard-copy value="https://github.com/quantumlib/qsim/blob/1d0965c9c27f735edeb2a18b7bf5a27e7592bd6f/circuits/circuit_q24" class="dropdown-item cursor-pointer" data-toggle-for="blob-more-options-details" >
+                <span class="d-flex flex-items-baseline">
+                  <span class="flex-auto">Copy permalink</span>
+                </span>
+              </clipboard-copy>
+            </li>
+          </ul>
+</div>
+</details>    </div>
+
+
+
+    <div class="Box d-flex flex-column flex-shrink-0 mb-3">
+      
+  <div class="Box-header Box-header--blue Details js-details-container">
+      <div class="d-flex flex-items-center">
+        <span class="flex-shrink-0 ml-n1 mr-n1 mt-n1 mb-n1">
+          <a rel="contributor" data-skip-pjax="true" data-hovercard-type="user" data-hovercard-url="/users/sergeisakov/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="/sergeisakov"><img class="avatar avatar-user" src="https://avatars.githubusercontent.com/u/54642992?s=48&amp;v=4" width="24" height="24" alt="@sergeisakov" /></a>
+        </span>
+        <div class="flex-1 d-flex flex-items-center ml-3 min-width-0">
+          <div class="css-truncate css-truncate-overflow">
+            <a class="text-bold Link--primary" rel="contributor" data-hovercard-type="user" data-hovercard-url="/users/sergeisakov/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="/sergeisakov">sergeisakov</a>
+
+                <span class="markdown-title">
+                  <a data-pjax="true" title="Add qsim and qsimh simulators." class="Link--secondary" href="/quantumlib/qsim/commit/598c0b0a7dda9ccff31f7471c2714fedcb39f4c2">Add qsim and qsimh simulators.</a>
+                </span>
+          </div>
+
+
+          <span class="ml-2">
+            <include-fragment accept="text/fragment+html" src="/quantumlib/qsim/commit/598c0b0a7dda9ccff31f7471c2714fedcb39f4c2/rollup?direction=e" class="d-inline"></include-fragment>
+          </span>
+        </div>
+        <div class="ml-3 d-flex flex-shrink-0 flex-items-center flex-justify-end color-text-secondary no-wrap">
+          <span class="d-none d-md-inline">
+            <span>Latest commit</span>
+            <a class="text-small text-mono Link--secondary" href="/quantumlib/qsim/commit/598c0b0a7dda9ccff31f7471c2714fedcb39f4c2" data-pjax>598c0b0</a>
+            <span itemprop="dateModified"><relative-time datetime="2020-02-07T16:40:22Z" class="no-wrap">Feb 7, 2020</relative-time></span>
+          </span>
+
+          <a data-pjax href="/quantumlib/qsim/commits/master/circuits/circuit_q24" class="ml-3 no-wrap Link--primary no-underline">
+            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-history text-gray">
+    <path fill-rule="evenodd" d="M1.643 3.143L.427 1.927A.25.25 0 000 2.104V5.75c0 .138.112.25.25.25h3.646a.25.25 0 00.177-.427L2.715 4.215a6.5 6.5 0 11-1.18 4.458.75.75 0 10-1.493.154 8.001 8.001 0 101.6-5.684zM7.75 4a.75.75 0 01.75.75v2.992l2.028.812a.75.75 0 01-.557 1.392l-2.5-1A.75.75 0 017 8.25v-3.5A.75.75 0 017.75 4z"></path>
+</svg>
+            <span class="d-none d-sm-inline">
+              <strong>History</strong>
+            </span>
+          </a>
+        </div>
+      </div>
+
+  </div>
+
+  <div class="Box-body d-flex flex-items-center flex-auto border-bottom-0 flex-wrap" >
+    <details class="details-reset details-overlay details-overlay-dark lh-default color-text-primary float-left mr-3" id="blob_contributors_box">
+      <summary class="Link--primary">
+        <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-people text-gray">
+    <path fill-rule="evenodd" d="M5.5 3.5a2 2 0 100 4 2 2 0 000-4zM2 5.5a3.5 3.5 0 115.898 2.549 5.507 5.507 0 013.034 4.084.75.75 0 11-1.482.235 4.001 4.001 0 00-7.9 0 .75.75 0 01-1.482-.236A5.507 5.507 0 013.102 8.05 3.49 3.49 0 012 5.5zM11 4a.75.75 0 100 1.5 1.5 1.5 0 01.666 2.844.75.75 0 00-.416.672v.352a.75.75 0 00.574.73c1.2.289 2.162 1.2 2.522 2.372a.75.75 0 101.434-.44 5.01 5.01 0 00-2.56-3.012A3 3 0 0011 4z"></path>
+</svg>
+        <strong>1</strong>
+        
+        contributor
+      </summary>
+      <details-dialog
+        class="Box Box--overlay d-flex flex-column anim-fade-in fast"
+        aria-label="Users who have contributed to this file"
+        src="/quantumlib/qsim/contributors-list/master/circuits/circuit_q24" preload>
+        <div class="Box-header">
+          <button class="Box-btn-octicon btn-octicon float-right" type="button" aria-label="Close dialog" data-close-dialog>
+            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
+    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
+</svg>
+          </button>
+          <h3 class="Box-title">
+            Users who have contributed to this file
+          </h3>
+        </div>
+        <include-fragment>
+          <svg style="box-sizing: content-box; color: var(--color-icon-primary);" viewBox="0 0 16 16" fill="none" width="32" height="32" class="my-3 mx-auto d-block anim-rotate">
+  <circle cx="8" cy="8" r="7" stroke="currentColor" stroke-opacity="0.25" stroke-width="2" vector-effect="non-scaling-stroke" />
+  <path d="M15 8a7.002 7.002 0 00-7-7" stroke="currentColor" stroke-width="2" stroke-linecap="round" vector-effect="non-scaling-stroke" />
+</svg>
+        </include-fragment>
+      </details-dialog>
+    </details>
+  </div>
+    </div>
+
+
+
+
+
+
+
+
+  
+    <div data-target="readme-toc.content" class="Box mt-3 position-relative
+    ">
+      
+  <div
+    class="Box-header py-2 pr-2 d-flex flex-shrink-0 flex-md-row flex-items-center"
+    
+  >
+
+
+  <div class="text-mono f6 flex-auto pr-3 flex-order-2 flex-md-order-1">
+
+      1258 lines (1258 sloc)
+      <span class="file-info-divider"></span>
+    12.8 KB
+  </div>
+
+  <div class="d-flex py-1 py-md-0 flex-auto flex-order-1 flex-md-order-2 flex-sm-grow-0 flex-justify-between hide-sm hide-md">
+
+    <div class="BtnGroup">
+      <a href="/quantumlib/qsim/raw/master/circuits/circuit_q24" id="raw-url" role="button" class="btn-sm btn BtnGroup-item">
+  
+  Raw
+  
+
+</a>
+        <a href="/quantumlib/qsim/blame/master/circuits/circuit_q24" data-hotkey="b" role="button" class="js-update-url-with-hash btn-sm btn BtnGroup-item">
+  
+  Blame
+  
+
+</a>
+    </div>
+
+    <div>
+          <a class="btn-octicon tooltipped tooltipped-nw js-remove-unless-platform"
+             data-platforms="windows,mac"
+             href="https://desktop.github.com"
+             aria-label="Open this file in GitHub Desktop"
+             data-ga-click="Repository, open with desktop">
+              <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-device-desktop">
+    <path fill-rule="evenodd" d="M1.75 2.5h12.5a.25.25 0 01.25.25v7.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25v-7.5a.25.25 0 01.25-.25zM14.25 1H1.75A1.75 1.75 0 000 2.75v7.5C0 11.216.784 12 1.75 12h3.727c-.1 1.041-.52 1.872-1.292 2.757A.75.75 0 004.75 16h6.5a.75.75 0 00.565-1.243c-.772-.885-1.193-1.716-1.292-2.757h3.727A1.75 1.75 0 0016 10.25v-7.5A1.75 1.75 0 0014.25 1zM9.018 12H6.982a5.72 5.72 0 01-.765 2.5h3.566a5.72 5.72 0 01-.765-2.5z"></path>
+</svg>
+          </a>
+
+          <a href="/login?return_to=%2Fquantumlib%2Fqsim%2Fblob%2Fmaster%2Fcircuits%2Fcircuit_q24" class="btn-octicon disabled tooltipped tooltipped-nw"
+            aria-label="You must be signed in to make or propose changes">
+            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-pencil">
+    <path fill-rule="evenodd" d="M11.013 1.427a1.75 1.75 0 012.474 0l1.086 1.086a1.75 1.75 0 010 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 01-.927-.928l.929-3.25a1.75 1.75 0 01.445-.758l8.61-8.61zm1.414 1.06a.25.25 0 00-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 000-.354l-1.086-1.086zM11.189 6.25L9.75 4.81l-6.286 6.287a.25.25 0 00-.064.108l-.558 1.953 1.953-.558a.249.249 0 00.108-.064l6.286-6.286z"></path>
+</svg>
+          </a>
+          <a href="/login?return_to=%2Fquantumlib%2Fqsim%2Fblob%2Fmaster%2Fcircuits%2Fcircuit_q24" class="btn-octicon btn-octicon-danger disabled tooltipped tooltipped-nw"
+            aria-label="You must be signed in to make or propose changes">
+            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-trash">
+    <path fill-rule="evenodd" d="M6.5 1.75a.25.25 0 01.25-.25h2.5a.25.25 0 01.25.25V3h-3V1.75zm4.5 0V3h2.25a.75.75 0 010 1.5H2.75a.75.75 0 010-1.5H5V1.75C5 .784 5.784 0 6.75 0h2.5C10.216 0 11 .784 11 1.75zM4.496 6.675a.75.75 0 10-1.492.15l.66 6.6A1.75 1.75 0 005.405 15h5.19c.9 0 1.652-.681 1.741-1.576l.66-6.6a.75.75 0 00-1.492-.149l-.66 6.6a.25.25 0 01-.249.225h-5.19a.25.25 0 01-.249-.225l-.66-6.6z"></path>
+</svg>
+          </a>
+    </div>
+  </div>
+
+    <div class="d-flex hide-lg hide-xl flex-order-2 flex-grow-0">
+      <details class="dropdown details-reset details-overlay d-inline-block">
+        <summary class="btn-octicon" aria-haspopup="true" aria-label="possible actions">
+          <svg height="16" class="octicon octicon-kebab-horizontal" viewBox="0 0 16 16" version="1.1" width="16" aria-hidden="true"><path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path></svg>
+        </summary>
+
+        <ul class="dropdown-menu dropdown-menu-sw">
+            <li>
+                <a class="dropdown-item tooltipped tooltipped-nw js-remove-unless-platform"
+                   data-platforms="windows,mac"
+                   href="https://desktop.github.com"
+                   data-ga-click="Repository, open with desktop">
+                  Open with Desktop
+                </a>
+            </li>
+          <li>
+            <a class="dropdown-item" href="/quantumlib/qsim/raw/master/circuits/circuit_q24">
+              View raw
+            </a>
+          </li>
+            <li>
+              <a class="dropdown-item" href="/quantumlib/qsim/blame/master/circuits/circuit_q24">
+                View blame
+              </a>
+            </li>
+
+        </ul>
+      </details>
+    </div>
+</div>
+
+
+      
+  <div itemprop="text" class="Box-body p-0 blob-wrapper data type-text  gist-border-0">
+      
+<table class="highlight tab-size js-file-line-container" data-tab-size="8" data-paste-markdown-skip>
+      <tr>
+        <td id="L1" class="blob-num js-line-number" data-line-number="1"></td>
+        <td id="LC1" class="blob-code blob-code-inner js-file-line">24</td>
+      </tr>
+      <tr>
+        <td id="L2" class="blob-num js-line-number" data-line-number="2"></td>
+        <td id="LC2" class="blob-code blob-code-inner js-file-line">0 h 0</td>
+      </tr>
+      <tr>
+        <td id="L3" class="blob-num js-line-number" data-line-number="3"></td>
+        <td id="LC3" class="blob-code blob-code-inner js-file-line">0 h 1</td>
+      </tr>
+      <tr>
+        <td id="L4" class="blob-num js-line-number" data-line-number="4"></td>
+        <td id="LC4" class="blob-code blob-code-inner js-file-line">0 h 2</td>
+      </tr>
+      <tr>
+        <td id="L5" class="blob-num js-line-number" data-line-number="5"></td>
+        <td id="LC5" class="blob-code blob-code-inner js-file-line">0 h 3</td>
+      </tr>
+      <tr>
+        <td id="L6" class="blob-num js-line-number" data-line-number="6"></td>
+        <td id="LC6" class="blob-code blob-code-inner js-file-line">0 h 4</td>
+      </tr>
+      <tr>
+        <td id="L7" class="blob-num js-line-number" data-line-number="7"></td>
+        <td id="LC7" class="blob-code blob-code-inner js-file-line">0 h 5</td>
+      </tr>
+      <tr>
+        <td id="L8" class="blob-num js-line-number" data-line-number="8"></td>
+        <td id="LC8" class="blob-code blob-code-inner js-file-line">0 h 6</td>
+      </tr>
+      <tr>
+        <td id="L9" class="blob-num js-line-number" data-line-number="9"></td>
+        <td id="LC9" class="blob-code blob-code-inner js-file-line">0 h 7</td>
+      </tr>
+      <tr>
+        <td id="L10" class="blob-num js-line-number" data-line-number="10"></td>
+        <td id="LC10" class="blob-code blob-code-inner js-file-line">0 h 8</td>
+      </tr>
+      <tr>
+        <td id="L11" class="blob-num js-line-number" data-line-number="11"></td>
+        <td id="LC11" class="blob-code blob-code-inner js-file-line">0 h 9</td>
+      </tr>
+      <tr>
+        <td id="L12" class="blob-num js-line-number" data-line-number="12"></td>
+        <td id="LC12" class="blob-code blob-code-inner js-file-line">0 h 10</td>
+      </tr>
+      <tr>
+        <td id="L13" class="blob-num js-line-number" data-line-number="13"></td>
+        <td id="LC13" class="blob-code blob-code-inner js-file-line">0 h 11</td>
+      </tr>
+      <tr>
+        <td id="L14" class="blob-num js-line-number" data-line-number="14"></td>
+        <td id="LC14" class="blob-code blob-code-inner js-file-line">0 h 12</td>
+      </tr>
+      <tr>
+        <td id="L15" class="blob-num js-line-number" data-line-number="15"></td>
+        <td id="LC15" class="blob-code blob-code-inner js-file-line">0 h 13</td>
+      </tr>
+      <tr>
+        <td id="L16" class="blob-num js-line-number" data-line-number="16"></td>
+        <td id="LC16" class="blob-code blob-code-inner js-file-line">0 h 14</td>
+      </tr>
+      <tr>
+        <td id="L17" class="blob-num js-line-number" data-line-number="17"></td>
+        <td id="LC17" class="blob-code blob-code-inner js-file-line">0 h 15</td>
+      </tr>
+      <tr>
+        <td id="L18" class="blob-num js-line-number" data-line-number="18"></td>
+        <td id="LC18" class="blob-code blob-code-inner js-file-line">0 h 16</td>
+      </tr>
+      <tr>
+        <td id="L19" class="blob-num js-line-number" data-line-number="19"></td>
+        <td id="LC19" class="blob-code blob-code-inner js-file-line">0 h 17</td>
+      </tr>
+      <tr>
+        <td id="L20" class="blob-num js-line-number" data-line-number="20"></td>
+        <td id="LC20" class="blob-code blob-code-inner js-file-line">0 h 18</td>
+      </tr>
+      <tr>
+        <td id="L21" class="blob-num js-line-number" data-line-number="21"></td>
+        <td id="LC21" class="blob-code blob-code-inner js-file-line">0 h 19</td>
+      </tr>
+      <tr>
+        <td id="L22" class="blob-num js-line-number" data-line-number="22"></td>
+        <td id="LC22" class="blob-code blob-code-inner js-file-line">0 h 20</td>
+      </tr>
+      <tr>
+        <td id="L23" class="blob-num js-line-number" data-line-number="23"></td>
+        <td id="LC23" class="blob-code blob-code-inner js-file-line">0 h 21</td>
+      </tr>
+      <tr>
+        <td id="L24" class="blob-num js-line-number" data-line-number="24"></td>
+        <td id="LC24" class="blob-code blob-code-inner js-file-line">0 h 22</td>
+      </tr>
+      <tr>
+        <td id="L25" class="blob-num js-line-number" data-line-number="25"></td>
+        <td id="LC25" class="blob-code blob-code-inner js-file-line">0 h 23</td>
+      </tr>
+      <tr>
+        <td id="L26" class="blob-num js-line-number" data-line-number="26"></td>
+        <td id="LC26" class="blob-code blob-code-inner js-file-line">1 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L27" class="blob-num js-line-number" data-line-number="27"></td>
+        <td id="LC27" class="blob-code blob-code-inner js-file-line">1 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L28" class="blob-num js-line-number" data-line-number="28"></td>
+        <td id="LC28" class="blob-code blob-code-inner js-file-line">1 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L29" class="blob-num js-line-number" data-line-number="29"></td>
+        <td id="LC29" class="blob-code blob-code-inner js-file-line">1 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L30" class="blob-num js-line-number" data-line-number="30"></td>
+        <td id="LC30" class="blob-code blob-code-inner js-file-line">1 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L31" class="blob-num js-line-number" data-line-number="31"></td>
+        <td id="LC31" class="blob-code blob-code-inner js-file-line">1 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L32" class="blob-num js-line-number" data-line-number="32"></td>
+        <td id="LC32" class="blob-code blob-code-inner js-file-line">2 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L33" class="blob-num js-line-number" data-line-number="33"></td>
+        <td id="LC33" class="blob-code blob-code-inner js-file-line">2 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L34" class="blob-num js-line-number" data-line-number="34"></td>
+        <td id="LC34" class="blob-code blob-code-inner js-file-line">2 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L35" class="blob-num js-line-number" data-line-number="35"></td>
+        <td id="LC35" class="blob-code blob-code-inner js-file-line">2 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L36" class="blob-num js-line-number" data-line-number="36"></td>
+        <td id="LC36" class="blob-code blob-code-inner js-file-line">2 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L37" class="blob-num js-line-number" data-line-number="37"></td>
+        <td id="LC37" class="blob-code blob-code-inner js-file-line">2 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L38" class="blob-num js-line-number" data-line-number="38"></td>
+        <td id="LC38" class="blob-code blob-code-inner js-file-line">2 t 0</td>
+      </tr>
+      <tr>
+        <td id="L39" class="blob-num js-line-number" data-line-number="39"></td>
+        <td id="LC39" class="blob-code blob-code-inner js-file-line">2 t 1</td>
+      </tr>
+      <tr>
+        <td id="L40" class="blob-num js-line-number" data-line-number="40"></td>
+        <td id="LC40" class="blob-code blob-code-inner js-file-line">2 t 4</td>
+      </tr>
+      <tr>
+        <td id="L41" class="blob-num js-line-number" data-line-number="41"></td>
+        <td id="LC41" class="blob-code blob-code-inner js-file-line">2 t 5</td>
+      </tr>
+      <tr>
+        <td id="L42" class="blob-num js-line-number" data-line-number="42"></td>
+        <td id="LC42" class="blob-code blob-code-inner js-file-line">2 t 8</td>
+      </tr>
+      <tr>
+        <td id="L43" class="blob-num js-line-number" data-line-number="43"></td>
+        <td id="LC43" class="blob-code blob-code-inner js-file-line">2 t 9</td>
+      </tr>
+      <tr>
+        <td id="L44" class="blob-num js-line-number" data-line-number="44"></td>
+        <td id="LC44" class="blob-code blob-code-inner js-file-line">2 t 12</td>
+      </tr>
+      <tr>
+        <td id="L45" class="blob-num js-line-number" data-line-number="45"></td>
+        <td id="LC45" class="blob-code blob-code-inner js-file-line">2 t 13</td>
+      </tr>
+      <tr>
+        <td id="L46" class="blob-num js-line-number" data-line-number="46"></td>
+        <td id="LC46" class="blob-code blob-code-inner js-file-line">2 t 16</td>
+      </tr>
+      <tr>
+        <td id="L47" class="blob-num js-line-number" data-line-number="47"></td>
+        <td id="LC47" class="blob-code blob-code-inner js-file-line">2 t 17</td>
+      </tr>
+      <tr>
+        <td id="L48" class="blob-num js-line-number" data-line-number="48"></td>
+        <td id="LC48" class="blob-code blob-code-inner js-file-line">2 t 20</td>
+      </tr>
+      <tr>
+        <td id="L49" class="blob-num js-line-number" data-line-number="49"></td>
+        <td id="LC49" class="blob-code blob-code-inner js-file-line">2 t 21</td>
+      </tr>
+      <tr>
+        <td id="L50" class="blob-num js-line-number" data-line-number="50"></td>
+        <td id="LC50" class="blob-code blob-code-inner js-file-line">3 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L51" class="blob-num js-line-number" data-line-number="51"></td>
+        <td id="LC51" class="blob-code blob-code-inner js-file-line">3 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L52" class="blob-num js-line-number" data-line-number="52"></td>
+        <td id="LC52" class="blob-code blob-code-inner js-file-line">3 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L53" class="blob-num js-line-number" data-line-number="53"></td>
+        <td id="LC53" class="blob-code blob-code-inner js-file-line">3 t 2</td>
+      </tr>
+      <tr>
+        <td id="L54" class="blob-num js-line-number" data-line-number="54"></td>
+        <td id="LC54" class="blob-code blob-code-inner js-file-line">3 t 3</td>
+      </tr>
+      <tr>
+        <td id="L55" class="blob-num js-line-number" data-line-number="55"></td>
+        <td id="LC55" class="blob-code blob-code-inner js-file-line">3 t 7</td>
+      </tr>
+      <tr>
+        <td id="L56" class="blob-num js-line-number" data-line-number="56"></td>
+        <td id="LC56" class="blob-code blob-code-inner js-file-line">3 t 11</td>
+      </tr>
+      <tr>
+        <td id="L57" class="blob-num js-line-number" data-line-number="57"></td>
+        <td id="LC57" class="blob-code blob-code-inner js-file-line">3 t 15</td>
+      </tr>
+      <tr>
+        <td id="L58" class="blob-num js-line-number" data-line-number="58"></td>
+        <td id="LC58" class="blob-code blob-code-inner js-file-line">3 t 18</td>
+      </tr>
+      <tr>
+        <td id="L59" class="blob-num js-line-number" data-line-number="59"></td>
+        <td id="LC59" class="blob-code blob-code-inner js-file-line">3 t 19</td>
+      </tr>
+      <tr>
+        <td id="L60" class="blob-num js-line-number" data-line-number="60"></td>
+        <td id="LC60" class="blob-code blob-code-inner js-file-line">3 t 22</td>
+      </tr>
+      <tr>
+        <td id="L61" class="blob-num js-line-number" data-line-number="61"></td>
+        <td id="LC61" class="blob-code blob-code-inner js-file-line">3 t 23</td>
+      </tr>
+      <tr>
+        <td id="L62" class="blob-num js-line-number" data-line-number="62"></td>
+        <td id="LC62" class="blob-code blob-code-inner js-file-line">4 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L63" class="blob-num js-line-number" data-line-number="63"></td>
+        <td id="LC63" class="blob-code blob-code-inner js-file-line">4 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L64" class="blob-num js-line-number" data-line-number="64"></td>
+        <td id="LC64" class="blob-code blob-code-inner js-file-line">4 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L65" class="blob-num js-line-number" data-line-number="65"></td>
+        <td id="LC65" class="blob-code blob-code-inner js-file-line">4 t 6</td>
+      </tr>
+      <tr>
+        <td id="L66" class="blob-num js-line-number" data-line-number="66"></td>
+        <td id="LC66" class="blob-code blob-code-inner js-file-line">4 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L67" class="blob-num js-line-number" data-line-number="67"></td>
+        <td id="LC67" class="blob-code blob-code-inner js-file-line">4 t 10</td>
+      </tr>
+      <tr>
+        <td id="L68" class="blob-num js-line-number" data-line-number="68"></td>
+        <td id="LC68" class="blob-code blob-code-inner js-file-line">4 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L69" class="blob-num js-line-number" data-line-number="69"></td>
+        <td id="LC69" class="blob-code blob-code-inner js-file-line">4 t 14</td>
+      </tr>
+      <tr>
+        <td id="L70" class="blob-num js-line-number" data-line-number="70"></td>
+        <td id="LC70" class="blob-code blob-code-inner js-file-line">4 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L71" class="blob-num js-line-number" data-line-number="71"></td>
+        <td id="LC71" class="blob-code blob-code-inner js-file-line">5 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L72" class="blob-num js-line-number" data-line-number="72"></td>
+        <td id="LC72" class="blob-code blob-code-inner js-file-line">5 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L73" class="blob-num js-line-number" data-line-number="73"></td>
+        <td id="LC73" class="blob-code blob-code-inner js-file-line">5 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L74" class="blob-num js-line-number" data-line-number="74"></td>
+        <td id="LC74" class="blob-code blob-code-inner js-file-line">5 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L75" class="blob-num js-line-number" data-line-number="75"></td>
+        <td id="LC75" class="blob-code blob-code-inner js-file-line">5 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L76" class="blob-num js-line-number" data-line-number="76"></td>
+        <td id="LC76" class="blob-code blob-code-inner js-file-line">5 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L77" class="blob-num js-line-number" data-line-number="77"></td>
+        <td id="LC77" class="blob-code blob-code-inner js-file-line">5 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L78" class="blob-num js-line-number" data-line-number="78"></td>
+        <td id="LC78" class="blob-code blob-code-inner js-file-line">5 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L79" class="blob-num js-line-number" data-line-number="79"></td>
+        <td id="LC79" class="blob-code blob-code-inner js-file-line">6 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L80" class="blob-num js-line-number" data-line-number="80"></td>
+        <td id="LC80" class="blob-code blob-code-inner js-file-line">6 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L81" class="blob-num js-line-number" data-line-number="81"></td>
+        <td id="LC81" class="blob-code blob-code-inner js-file-line">6 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L82" class="blob-num js-line-number" data-line-number="82"></td>
+        <td id="LC82" class="blob-code blob-code-inner js-file-line">6 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L83" class="blob-num js-line-number" data-line-number="83"></td>
+        <td id="LC83" class="blob-code blob-code-inner js-file-line">6 y_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L84" class="blob-num js-line-number" data-line-number="84"></td>
+        <td id="LC84" class="blob-code blob-code-inner js-file-line">6 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L85" class="blob-num js-line-number" data-line-number="85"></td>
+        <td id="LC85" class="blob-code blob-code-inner js-file-line">6 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L86" class="blob-num js-line-number" data-line-number="86"></td>
+        <td id="LC86" class="blob-code blob-code-inner js-file-line">6 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L87" class="blob-num js-line-number" data-line-number="87"></td>
+        <td id="LC87" class="blob-code blob-code-inner js-file-line">6 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L88" class="blob-num js-line-number" data-line-number="88"></td>
+        <td id="LC88" class="blob-code blob-code-inner js-file-line">6 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L89" class="blob-num js-line-number" data-line-number="89"></td>
+        <td id="LC89" class="blob-code blob-code-inner js-file-line">6 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L90" class="blob-num js-line-number" data-line-number="90"></td>
+        <td id="LC90" class="blob-code blob-code-inner js-file-line">6 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L91" class="blob-num js-line-number" data-line-number="91"></td>
+        <td id="LC91" class="blob-code blob-code-inner js-file-line">7 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L92" class="blob-num js-line-number" data-line-number="92"></td>
+        <td id="LC92" class="blob-code blob-code-inner js-file-line">7 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L93" class="blob-num js-line-number" data-line-number="93"></td>
+        <td id="LC93" class="blob-code blob-code-inner js-file-line">7 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L94" class="blob-num js-line-number" data-line-number="94"></td>
+        <td id="LC94" class="blob-code blob-code-inner js-file-line">7 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L95" class="blob-num js-line-number" data-line-number="95"></td>
+        <td id="LC95" class="blob-code blob-code-inner js-file-line">7 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L96" class="blob-num js-line-number" data-line-number="96"></td>
+        <td id="LC96" class="blob-code blob-code-inner js-file-line">7 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L97" class="blob-num js-line-number" data-line-number="97"></td>
+        <td id="LC97" class="blob-code blob-code-inner js-file-line">7 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L98" class="blob-num js-line-number" data-line-number="98"></td>
+        <td id="LC98" class="blob-code blob-code-inner js-file-line">7 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L99" class="blob-num js-line-number" data-line-number="99"></td>
+        <td id="LC99" class="blob-code blob-code-inner js-file-line">7 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L100" class="blob-num js-line-number" data-line-number="100"></td>
+        <td id="LC100" class="blob-code blob-code-inner js-file-line">7 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L101" class="blob-num js-line-number" data-line-number="101"></td>
+        <td id="LC101" class="blob-code blob-code-inner js-file-line">8 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L102" class="blob-num js-line-number" data-line-number="102"></td>
+        <td id="LC102" class="blob-code blob-code-inner js-file-line">8 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L103" class="blob-num js-line-number" data-line-number="103"></td>
+        <td id="LC103" class="blob-code blob-code-inner js-file-line">8 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L104" class="blob-num js-line-number" data-line-number="104"></td>
+        <td id="LC104" class="blob-code blob-code-inner js-file-line">8 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L105" class="blob-num js-line-number" data-line-number="105"></td>
+        <td id="LC105" class="blob-code blob-code-inner js-file-line">8 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L106" class="blob-num js-line-number" data-line-number="106"></td>
+        <td id="LC106" class="blob-code blob-code-inner js-file-line">8 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L107" class="blob-num js-line-number" data-line-number="107"></td>
+        <td id="LC107" class="blob-code blob-code-inner js-file-line">8 y_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L108" class="blob-num js-line-number" data-line-number="108"></td>
+        <td id="LC108" class="blob-code blob-code-inner js-file-line">8 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L109" class="blob-num js-line-number" data-line-number="109"></td>
+        <td id="LC109" class="blob-code blob-code-inner js-file-line">8 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L110" class="blob-num js-line-number" data-line-number="110"></td>
+        <td id="LC110" class="blob-code blob-code-inner js-file-line">8 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L111" class="blob-num js-line-number" data-line-number="111"></td>
+        <td id="LC111" class="blob-code blob-code-inner js-file-line">8 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L112" class="blob-num js-line-number" data-line-number="112"></td>
+        <td id="LC112" class="blob-code blob-code-inner js-file-line">8 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L113" class="blob-num js-line-number" data-line-number="113"></td>
+        <td id="LC113" class="blob-code blob-code-inner js-file-line">8 t 13</td>
+      </tr>
+      <tr>
+        <td id="L114" class="blob-num js-line-number" data-line-number="114"></td>
+        <td id="LC114" class="blob-code blob-code-inner js-file-line">8 t 15</td>
+      </tr>
+      <tr>
+        <td id="L115" class="blob-num js-line-number" data-line-number="115"></td>
+        <td id="LC115" class="blob-code blob-code-inner js-file-line">8 t 17</td>
+      </tr>
+      <tr>
+        <td id="L116" class="blob-num js-line-number" data-line-number="116"></td>
+        <td id="LC116" class="blob-code blob-code-inner js-file-line">8 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L117" class="blob-num js-line-number" data-line-number="117"></td>
+        <td id="LC117" class="blob-code blob-code-inner js-file-line">8 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L118" class="blob-num js-line-number" data-line-number="118"></td>
+        <td id="LC118" class="blob-code blob-code-inner js-file-line">8 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L119" class="blob-num js-line-number" data-line-number="119"></td>
+        <td id="LC119" class="blob-code blob-code-inner js-file-line">9 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L120" class="blob-num js-line-number" data-line-number="120"></td>
+        <td id="LC120" class="blob-code blob-code-inner js-file-line">9 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L121" class="blob-num js-line-number" data-line-number="121"></td>
+        <td id="LC121" class="blob-code blob-code-inner js-file-line">9 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L122" class="blob-num js-line-number" data-line-number="122"></td>
+        <td id="LC122" class="blob-code blob-code-inner js-file-line">9 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L123" class="blob-num js-line-number" data-line-number="123"></td>
+        <td id="LC123" class="blob-code blob-code-inner js-file-line">9 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L124" class="blob-num js-line-number" data-line-number="124"></td>
+        <td id="LC124" class="blob-code blob-code-inner js-file-line">9 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L125" class="blob-num js-line-number" data-line-number="125"></td>
+        <td id="LC125" class="blob-code blob-code-inner js-file-line">9 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L126" class="blob-num js-line-number" data-line-number="126"></td>
+        <td id="LC126" class="blob-code blob-code-inner js-file-line">9 t 7</td>
+      </tr>
+      <tr>
+        <td id="L127" class="blob-num js-line-number" data-line-number="127"></td>
+        <td id="LC127" class="blob-code blob-code-inner js-file-line">9 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L128" class="blob-num js-line-number" data-line-number="128"></td>
+        <td id="LC128" class="blob-code blob-code-inner js-file-line">9 t 14</td>
+      </tr>
+      <tr>
+        <td id="L129" class="blob-num js-line-number" data-line-number="129"></td>
+        <td id="LC129" class="blob-code blob-code-inner js-file-line">9 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L130" class="blob-num js-line-number" data-line-number="130"></td>
+        <td id="LC130" class="blob-code blob-code-inner js-file-line">9 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L131" class="blob-num js-line-number" data-line-number="131"></td>
+        <td id="LC131" class="blob-code blob-code-inner js-file-line">10 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L132" class="blob-num js-line-number" data-line-number="132"></td>
+        <td id="LC132" class="blob-code blob-code-inner js-file-line">10 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L133" class="blob-num js-line-number" data-line-number="133"></td>
+        <td id="LC133" class="blob-code blob-code-inner js-file-line">10 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L134" class="blob-num js-line-number" data-line-number="134"></td>
+        <td id="LC134" class="blob-code blob-code-inner js-file-line">10 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L135" class="blob-num js-line-number" data-line-number="135"></td>
+        <td id="LC135" class="blob-code blob-code-inner js-file-line">10 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L136" class="blob-num js-line-number" data-line-number="136"></td>
+        <td id="LC136" class="blob-code blob-code-inner js-file-line">10 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L137" class="blob-num js-line-number" data-line-number="137"></td>
+        <td id="LC137" class="blob-code blob-code-inner js-file-line">10 t 0</td>
+      </tr>
+      <tr>
+        <td id="L138" class="blob-num js-line-number" data-line-number="138"></td>
+        <td id="LC138" class="blob-code blob-code-inner js-file-line">10 t 1</td>
+      </tr>
+      <tr>
+        <td id="L139" class="blob-num js-line-number" data-line-number="139"></td>
+        <td id="LC139" class="blob-code blob-code-inner js-file-line">10 x_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L140" class="blob-num js-line-number" data-line-number="140"></td>
+        <td id="LC140" class="blob-code blob-code-inner js-file-line">10 x_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L141" class="blob-num js-line-number" data-line-number="141"></td>
+        <td id="LC141" class="blob-code blob-code-inner js-file-line">10 t 8</td>
+      </tr>
+      <tr>
+        <td id="L142" class="blob-num js-line-number" data-line-number="142"></td>
+        <td id="LC142" class="blob-code blob-code-inner js-file-line">10 x_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L143" class="blob-num js-line-number" data-line-number="143"></td>
+        <td id="LC143" class="blob-code blob-code-inner js-file-line">10 t 12</td>
+      </tr>
+      <tr>
+        <td id="L144" class="blob-num js-line-number" data-line-number="144"></td>
+        <td id="LC144" class="blob-code blob-code-inner js-file-line">10 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L145" class="blob-num js-line-number" data-line-number="145"></td>
+        <td id="LC145" class="blob-code blob-code-inner js-file-line">10 t 16</td>
+      </tr>
+      <tr>
+        <td id="L146" class="blob-num js-line-number" data-line-number="146"></td>
+        <td id="LC146" class="blob-code blob-code-inner js-file-line">10 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L147" class="blob-num js-line-number" data-line-number="147"></td>
+        <td id="LC147" class="blob-code blob-code-inner js-file-line">10 t 20</td>
+      </tr>
+      <tr>
+        <td id="L148" class="blob-num js-line-number" data-line-number="148"></td>
+        <td id="LC148" class="blob-code blob-code-inner js-file-line">10 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L149" class="blob-num js-line-number" data-line-number="149"></td>
+        <td id="LC149" class="blob-code blob-code-inner js-file-line">11 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L150" class="blob-num js-line-number" data-line-number="150"></td>
+        <td id="LC150" class="blob-code blob-code-inner js-file-line">11 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L151" class="blob-num js-line-number" data-line-number="151"></td>
+        <td id="LC151" class="blob-code blob-code-inner js-file-line">11 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L152" class="blob-num js-line-number" data-line-number="152"></td>
+        <td id="LC152" class="blob-code blob-code-inner js-file-line">11 t 2</td>
+      </tr>
+      <tr>
+        <td id="L153" class="blob-num js-line-number" data-line-number="153"></td>
+        <td id="LC153" class="blob-code blob-code-inner js-file-line">11 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L154" class="blob-num js-line-number" data-line-number="154"></td>
+        <td id="LC154" class="blob-code blob-code-inner js-file-line">11 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L155" class="blob-num js-line-number" data-line-number="155"></td>
+        <td id="LC155" class="blob-code blob-code-inner js-file-line">11 t 11</td>
+      </tr>
+      <tr>
+        <td id="L156" class="blob-num js-line-number" data-line-number="156"></td>
+        <td id="LC156" class="blob-code blob-code-inner js-file-line">11 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L157" class="blob-num js-line-number" data-line-number="157"></td>
+        <td id="LC157" class="blob-code blob-code-inner js-file-line">11 t 18</td>
+      </tr>
+      <tr>
+        <td id="L158" class="blob-num js-line-number" data-line-number="158"></td>
+        <td id="LC158" class="blob-code blob-code-inner js-file-line">11 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L159" class="blob-num js-line-number" data-line-number="159"></td>
+        <td id="LC159" class="blob-code blob-code-inner js-file-line">11 t 22</td>
+      </tr>
+      <tr>
+        <td id="L160" class="blob-num js-line-number" data-line-number="160"></td>
+        <td id="LC160" class="blob-code blob-code-inner js-file-line">11 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L161" class="blob-num js-line-number" data-line-number="161"></td>
+        <td id="LC161" class="blob-code blob-code-inner js-file-line">12 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L162" class="blob-num js-line-number" data-line-number="162"></td>
+        <td id="LC162" class="blob-code blob-code-inner js-file-line">12 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L163" class="blob-num js-line-number" data-line-number="163"></td>
+        <td id="LC163" class="blob-code blob-code-inner js-file-line">12 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L164" class="blob-num js-line-number" data-line-number="164"></td>
+        <td id="LC164" class="blob-code blob-code-inner js-file-line">12 x_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L165" class="blob-num js-line-number" data-line-number="165"></td>
+        <td id="LC165" class="blob-code blob-code-inner js-file-line">12 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L166" class="blob-num js-line-number" data-line-number="166"></td>
+        <td id="LC166" class="blob-code blob-code-inner js-file-line">12 t 10</td>
+      </tr>
+      <tr>
+        <td id="L167" class="blob-num js-line-number" data-line-number="167"></td>
+        <td id="LC167" class="blob-code blob-code-inner js-file-line">12 x_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L168" class="blob-num js-line-number" data-line-number="168"></td>
+        <td id="LC168" class="blob-code blob-code-inner js-file-line">12 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L169" class="blob-num js-line-number" data-line-number="169"></td>
+        <td id="LC169" class="blob-code blob-code-inner js-file-line">12 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L170" class="blob-num js-line-number" data-line-number="170"></td>
+        <td id="LC170" class="blob-code blob-code-inner js-file-line">13 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L171" class="blob-num js-line-number" data-line-number="171"></td>
+        <td id="LC171" class="blob-code blob-code-inner js-file-line">13 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L172" class="blob-num js-line-number" data-line-number="172"></td>
+        <td id="LC172" class="blob-code blob-code-inner js-file-line">13 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L173" class="blob-num js-line-number" data-line-number="173"></td>
+        <td id="LC173" class="blob-code blob-code-inner js-file-line">13 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L174" class="blob-num js-line-number" data-line-number="174"></td>
+        <td id="LC174" class="blob-code blob-code-inner js-file-line">13 t 7</td>
+      </tr>
+      <tr>
+        <td id="L175" class="blob-num js-line-number" data-line-number="175"></td>
+        <td id="LC175" class="blob-code blob-code-inner js-file-line">13 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L176" class="blob-num js-line-number" data-line-number="176"></td>
+        <td id="LC176" class="blob-code blob-code-inner js-file-line">13 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L177" class="blob-num js-line-number" data-line-number="177"></td>
+        <td id="LC177" class="blob-code blob-code-inner js-file-line">13 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L178" class="blob-num js-line-number" data-line-number="178"></td>
+        <td id="LC178" class="blob-code blob-code-inner js-file-line">14 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L179" class="blob-num js-line-number" data-line-number="179"></td>
+        <td id="LC179" class="blob-code blob-code-inner js-file-line">14 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L180" class="blob-num js-line-number" data-line-number="180"></td>
+        <td id="LC180" class="blob-code blob-code-inner js-file-line">14 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L181" class="blob-num js-line-number" data-line-number="181"></td>
+        <td id="LC181" class="blob-code blob-code-inner js-file-line">14 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L182" class="blob-num js-line-number" data-line-number="182"></td>
+        <td id="LC182" class="blob-code blob-code-inner js-file-line">14 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L183" class="blob-num js-line-number" data-line-number="183"></td>
+        <td id="LC183" class="blob-code blob-code-inner js-file-line">14 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L184" class="blob-num js-line-number" data-line-number="184"></td>
+        <td id="LC184" class="blob-code blob-code-inner js-file-line">14 t 9</td>
+      </tr>
+      <tr>
+        <td id="L185" class="blob-num js-line-number" data-line-number="185"></td>
+        <td id="LC185" class="blob-code blob-code-inner js-file-line">14 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L186" class="blob-num js-line-number" data-line-number="186"></td>
+        <td id="LC186" class="blob-code blob-code-inner js-file-line">14 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L187" class="blob-num js-line-number" data-line-number="187"></td>
+        <td id="LC187" class="blob-code blob-code-inner js-file-line">14 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L188" class="blob-num js-line-number" data-line-number="188"></td>
+        <td id="LC188" class="blob-code blob-code-inner js-file-line">14 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L189" class="blob-num js-line-number" data-line-number="189"></td>
+        <td id="LC189" class="blob-code blob-code-inner js-file-line">14 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L190" class="blob-num js-line-number" data-line-number="190"></td>
+        <td id="LC190" class="blob-code blob-code-inner js-file-line">15 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L191" class="blob-num js-line-number" data-line-number="191"></td>
+        <td id="LC191" class="blob-code blob-code-inner js-file-line">15 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L192" class="blob-num js-line-number" data-line-number="192"></td>
+        <td id="LC192" class="blob-code blob-code-inner js-file-line">15 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L193" class="blob-num js-line-number" data-line-number="193"></td>
+        <td id="LC193" class="blob-code blob-code-inner js-file-line">15 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L194" class="blob-num js-line-number" data-line-number="194"></td>
+        <td id="LC194" class="blob-code blob-code-inner js-file-line">15 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L195" class="blob-num js-line-number" data-line-number="195"></td>
+        <td id="LC195" class="blob-code blob-code-inner js-file-line">15 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L196" class="blob-num js-line-number" data-line-number="196"></td>
+        <td id="LC196" class="blob-code blob-code-inner js-file-line">15 t 3</td>
+      </tr>
+      <tr>
+        <td id="L197" class="blob-num js-line-number" data-line-number="197"></td>
+        <td id="LC197" class="blob-code blob-code-inner js-file-line">15 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L198" class="blob-num js-line-number" data-line-number="198"></td>
+        <td id="LC198" class="blob-code blob-code-inner js-file-line">15 t 16</td>
+      </tr>
+      <tr>
+        <td id="L199" class="blob-num js-line-number" data-line-number="199"></td>
+        <td id="LC199" class="blob-code blob-code-inner js-file-line">15 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L200" class="blob-num js-line-number" data-line-number="200"></td>
+        <td id="LC200" class="blob-code blob-code-inner js-file-line">16 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L201" class="blob-num js-line-number" data-line-number="201"></td>
+        <td id="LC201" class="blob-code blob-code-inner js-file-line">16 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L202" class="blob-num js-line-number" data-line-number="202"></td>
+        <td id="LC202" class="blob-code blob-code-inner js-file-line">16 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L203" class="blob-num js-line-number" data-line-number="203"></td>
+        <td id="LC203" class="blob-code blob-code-inner js-file-line">16 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L204" class="blob-num js-line-number" data-line-number="204"></td>
+        <td id="LC204" class="blob-code blob-code-inner js-file-line">16 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L205" class="blob-num js-line-number" data-line-number="205"></td>
+        <td id="LC205" class="blob-code blob-code-inner js-file-line">16 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L206" class="blob-num js-line-number" data-line-number="206"></td>
+        <td id="LC206" class="blob-code blob-code-inner js-file-line">16 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L207" class="blob-num js-line-number" data-line-number="207"></td>
+        <td id="LC207" class="blob-code blob-code-inner js-file-line">16 t 2</td>
+      </tr>
+      <tr>
+        <td id="L208" class="blob-num js-line-number" data-line-number="208"></td>
+        <td id="LC208" class="blob-code blob-code-inner js-file-line">16 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L209" class="blob-num js-line-number" data-line-number="209"></td>
+        <td id="LC209" class="blob-code blob-code-inner js-file-line">16 t 6</td>
+      </tr>
+      <tr>
+        <td id="L210" class="blob-num js-line-number" data-line-number="210"></td>
+        <td id="LC210" class="blob-code blob-code-inner js-file-line">16 t 8</td>
+      </tr>
+      <tr>
+        <td id="L211" class="blob-num js-line-number" data-line-number="211"></td>
+        <td id="LC211" class="blob-code blob-code-inner js-file-line">16 t 10</td>
+      </tr>
+      <tr>
+        <td id="L212" class="blob-num js-line-number" data-line-number="212"></td>
+        <td id="LC212" class="blob-code blob-code-inner js-file-line">16 t 13</td>
+      </tr>
+      <tr>
+        <td id="L213" class="blob-num js-line-number" data-line-number="213"></td>
+        <td id="LC213" class="blob-code blob-code-inner js-file-line">16 t 15</td>
+      </tr>
+      <tr>
+        <td id="L214" class="blob-num js-line-number" data-line-number="214"></td>
+        <td id="LC214" class="blob-code blob-code-inner js-file-line">16 t 17</td>
+      </tr>
+      <tr>
+        <td id="L215" class="blob-num js-line-number" data-line-number="215"></td>
+        <td id="LC215" class="blob-code blob-code-inner js-file-line">16 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L216" class="blob-num js-line-number" data-line-number="216"></td>
+        <td id="LC216" class="blob-code blob-code-inner js-file-line">16 t 21</td>
+      </tr>
+      <tr>
+        <td id="L217" class="blob-num js-line-number" data-line-number="217"></td>
+        <td id="LC217" class="blob-code blob-code-inner js-file-line">16 t 23</td>
+      </tr>
+      <tr>
+        <td id="L218" class="blob-num js-line-number" data-line-number="218"></td>
+        <td id="LC218" class="blob-code blob-code-inner js-file-line">17 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L219" class="blob-num js-line-number" data-line-number="219"></td>
+        <td id="LC219" class="blob-code blob-code-inner js-file-line">17 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L220" class="blob-num js-line-number" data-line-number="220"></td>
+        <td id="LC220" class="blob-code blob-code-inner js-file-line">17 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L221" class="blob-num js-line-number" data-line-number="221"></td>
+        <td id="LC221" class="blob-code blob-code-inner js-file-line">17 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L222" class="blob-num js-line-number" data-line-number="222"></td>
+        <td id="LC222" class="blob-code blob-code-inner js-file-line">17 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L223" class="blob-num js-line-number" data-line-number="223"></td>
+        <td id="LC223" class="blob-code blob-code-inner js-file-line">17 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L224" class="blob-num js-line-number" data-line-number="224"></td>
+        <td id="LC224" class="blob-code blob-code-inner js-file-line">17 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L225" class="blob-num js-line-number" data-line-number="225"></td>
+        <td id="LC225" class="blob-code blob-code-inner js-file-line">17 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L226" class="blob-num js-line-number" data-line-number="226"></td>
+        <td id="LC226" class="blob-code blob-code-inner js-file-line">17 t 11</td>
+      </tr>
+      <tr>
+        <td id="L227" class="blob-num js-line-number" data-line-number="227"></td>
+        <td id="LC227" class="blob-code blob-code-inner js-file-line">17 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L228" class="blob-num js-line-number" data-line-number="228"></td>
+        <td id="LC228" class="blob-code blob-code-inner js-file-line">17 x_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L229" class="blob-num js-line-number" data-line-number="229"></td>
+        <td id="LC229" class="blob-code blob-code-inner js-file-line">17 t 22</td>
+      </tr>
+      <tr>
+        <td id="L230" class="blob-num js-line-number" data-line-number="230"></td>
+        <td id="LC230" class="blob-code blob-code-inner js-file-line">18 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L231" class="blob-num js-line-number" data-line-number="231"></td>
+        <td id="LC231" class="blob-code blob-code-inner js-file-line">18 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L232" class="blob-num js-line-number" data-line-number="232"></td>
+        <td id="LC232" class="blob-code blob-code-inner js-file-line">18 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L233" class="blob-num js-line-number" data-line-number="233"></td>
+        <td id="LC233" class="blob-code blob-code-inner js-file-line">18 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L234" class="blob-num js-line-number" data-line-number="234"></td>
+        <td id="LC234" class="blob-code blob-code-inner js-file-line">18 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L235" class="blob-num js-line-number" data-line-number="235"></td>
+        <td id="LC235" class="blob-code blob-code-inner js-file-line">18 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L236" class="blob-num js-line-number" data-line-number="236"></td>
+        <td id="LC236" class="blob-code blob-code-inner js-file-line">18 t 0</td>
+      </tr>
+      <tr>
+        <td id="L237" class="blob-num js-line-number" data-line-number="237"></td>
+        <td id="LC237" class="blob-code blob-code-inner js-file-line">18 y_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L238" class="blob-num js-line-number" data-line-number="238"></td>
+        <td id="LC238" class="blob-code blob-code-inner js-file-line">18 t 4</td>
+      </tr>
+      <tr>
+        <td id="L239" class="blob-num js-line-number" data-line-number="239"></td>
+        <td id="LC239" class="blob-code blob-code-inner js-file-line">18 y_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L240" class="blob-num js-line-number" data-line-number="240"></td>
+        <td id="LC240" class="blob-code blob-code-inner js-file-line">18 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L241" class="blob-num js-line-number" data-line-number="241"></td>
+        <td id="LC241" class="blob-code blob-code-inner js-file-line">18 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L242" class="blob-num js-line-number" data-line-number="242"></td>
+        <td id="LC242" class="blob-code blob-code-inner js-file-line">18 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L243" class="blob-num js-line-number" data-line-number="243"></td>
+        <td id="LC243" class="blob-code blob-code-inner js-file-line">18 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L244" class="blob-num js-line-number" data-line-number="244"></td>
+        <td id="LC244" class="blob-code blob-code-inner js-file-line">18 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L245" class="blob-num js-line-number" data-line-number="245"></td>
+        <td id="LC245" class="blob-code blob-code-inner js-file-line">18 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L246" class="blob-num js-line-number" data-line-number="246"></td>
+        <td id="LC246" class="blob-code blob-code-inner js-file-line">18 t 20</td>
+      </tr>
+      <tr>
+        <td id="L247" class="blob-num js-line-number" data-line-number="247"></td>
+        <td id="LC247" class="blob-code blob-code-inner js-file-line">18 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L248" class="blob-num js-line-number" data-line-number="248"></td>
+        <td id="LC248" class="blob-code blob-code-inner js-file-line">19 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L249" class="blob-num js-line-number" data-line-number="249"></td>
+        <td id="LC249" class="blob-code blob-code-inner js-file-line">19 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L250" class="blob-num js-line-number" data-line-number="250"></td>
+        <td id="LC250" class="blob-code blob-code-inner js-file-line">19 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L251" class="blob-num js-line-number" data-line-number="251"></td>
+        <td id="LC251" class="blob-code blob-code-inner js-file-line">19 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L252" class="blob-num js-line-number" data-line-number="252"></td>
+        <td id="LC252" class="blob-code blob-code-inner js-file-line">19 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L253" class="blob-num js-line-number" data-line-number="253"></td>
+        <td id="LC253" class="blob-code blob-code-inner js-file-line">19 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L254" class="blob-num js-line-number" data-line-number="254"></td>
+        <td id="LC254" class="blob-code blob-code-inner js-file-line">19 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L255" class="blob-num js-line-number" data-line-number="255"></td>
+        <td id="LC255" class="blob-code blob-code-inner js-file-line">19 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L256" class="blob-num js-line-number" data-line-number="256"></td>
+        <td id="LC256" class="blob-code blob-code-inner js-file-line">19 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L257" class="blob-num js-line-number" data-line-number="257"></td>
+        <td id="LC257" class="blob-code blob-code-inner js-file-line">19 t 19</td>
+      </tr>
+      <tr>
+        <td id="L258" class="blob-num js-line-number" data-line-number="258"></td>
+        <td id="LC258" class="blob-code blob-code-inner js-file-line">19 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L259" class="blob-num js-line-number" data-line-number="259"></td>
+        <td id="LC259" class="blob-code blob-code-inner js-file-line">19 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L260" class="blob-num js-line-number" data-line-number="260"></td>
+        <td id="LC260" class="blob-code blob-code-inner js-file-line">20 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L261" class="blob-num js-line-number" data-line-number="261"></td>
+        <td id="LC261" class="blob-code blob-code-inner js-file-line">20 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L262" class="blob-num js-line-number" data-line-number="262"></td>
+        <td id="LC262" class="blob-code blob-code-inner js-file-line">20 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L263" class="blob-num js-line-number" data-line-number="263"></td>
+        <td id="LC263" class="blob-code blob-code-inner js-file-line">20 x_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L264" class="blob-num js-line-number" data-line-number="264"></td>
+        <td id="LC264" class="blob-code blob-code-inner js-file-line">20 t 8</td>
+      </tr>
+      <tr>
+        <td id="L265" class="blob-num js-line-number" data-line-number="265"></td>
+        <td id="LC265" class="blob-code blob-code-inner js-file-line">20 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L266" class="blob-num js-line-number" data-line-number="266"></td>
+        <td id="LC266" class="blob-code blob-code-inner js-file-line">20 t 12</td>
+      </tr>
+      <tr>
+        <td id="L267" class="blob-num js-line-number" data-line-number="267"></td>
+        <td id="LC267" class="blob-code blob-code-inner js-file-line">20 t 14</td>
+      </tr>
+      <tr>
+        <td id="L268" class="blob-num js-line-number" data-line-number="268"></td>
+        <td id="LC268" class="blob-code blob-code-inner js-file-line">20 t 16</td>
+      </tr>
+      <tr>
+        <td id="L269" class="blob-num js-line-number" data-line-number="269"></td>
+        <td id="LC269" class="blob-code blob-code-inner js-file-line">21 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L270" class="blob-num js-line-number" data-line-number="270"></td>
+        <td id="LC270" class="blob-code blob-code-inner js-file-line">21 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L271" class="blob-num js-line-number" data-line-number="271"></td>
+        <td id="LC271" class="blob-code blob-code-inner js-file-line">21 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L272" class="blob-num js-line-number" data-line-number="272"></td>
+        <td id="LC272" class="blob-code blob-code-inner js-file-line">21 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L273" class="blob-num js-line-number" data-line-number="273"></td>
+        <td id="LC273" class="blob-code blob-code-inner js-file-line">21 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L274" class="blob-num js-line-number" data-line-number="274"></td>
+        <td id="LC274" class="blob-code blob-code-inner js-file-line">21 t 11</td>
+      </tr>
+      <tr>
+        <td id="L275" class="blob-num js-line-number" data-line-number="275"></td>
+        <td id="LC275" class="blob-code blob-code-inner js-file-line">21 t 15</td>
+      </tr>
+      <tr>
+        <td id="L276" class="blob-num js-line-number" data-line-number="276"></td>
+        <td id="LC276" class="blob-code blob-code-inner js-file-line">21 t 17</td>
+      </tr>
+      <tr>
+        <td id="L277" class="blob-num js-line-number" data-line-number="277"></td>
+        <td id="LC277" class="blob-code blob-code-inner js-file-line">22 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L278" class="blob-num js-line-number" data-line-number="278"></td>
+        <td id="LC278" class="blob-code blob-code-inner js-file-line">22 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L279" class="blob-num js-line-number" data-line-number="279"></td>
+        <td id="LC279" class="blob-code blob-code-inner js-file-line">22 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L280" class="blob-num js-line-number" data-line-number="280"></td>
+        <td id="LC280" class="blob-code blob-code-inner js-file-line">22 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L281" class="blob-num js-line-number" data-line-number="281"></td>
+        <td id="LC281" class="blob-code blob-code-inner js-file-line">22 t 1</td>
+      </tr>
+      <tr>
+        <td id="L282" class="blob-num js-line-number" data-line-number="282"></td>
+        <td id="LC282" class="blob-code blob-code-inner js-file-line">22 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L283" class="blob-num js-line-number" data-line-number="283"></td>
+        <td id="LC283" class="blob-code blob-code-inner js-file-line">22 t 9</td>
+      </tr>
+      <tr>
+        <td id="L284" class="blob-num js-line-number" data-line-number="284"></td>
+        <td id="LC284" class="blob-code blob-code-inner js-file-line">22 t 10</td>
+      </tr>
+      <tr>
+        <td id="L285" class="blob-num js-line-number" data-line-number="285"></td>
+        <td id="LC285" class="blob-code blob-code-inner js-file-line">22 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L286" class="blob-num js-line-number" data-line-number="286"></td>
+        <td id="LC286" class="blob-code blob-code-inner js-file-line">22 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L287" class="blob-num js-line-number" data-line-number="287"></td>
+        <td id="LC287" class="blob-code blob-code-inner js-file-line">22 t 21</td>
+      </tr>
+      <tr>
+        <td id="L288" class="blob-num js-line-number" data-line-number="288"></td>
+        <td id="LC288" class="blob-code blob-code-inner js-file-line">22 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L289" class="blob-num js-line-number" data-line-number="289"></td>
+        <td id="LC289" class="blob-code blob-code-inner js-file-line">23 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L290" class="blob-num js-line-number" data-line-number="290"></td>
+        <td id="LC290" class="blob-code blob-code-inner js-file-line">23 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L291" class="blob-num js-line-number" data-line-number="291"></td>
+        <td id="LC291" class="blob-code blob-code-inner js-file-line">23 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L292" class="blob-num js-line-number" data-line-number="292"></td>
+        <td id="LC292" class="blob-code blob-code-inner js-file-line">23 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L293" class="blob-num js-line-number" data-line-number="293"></td>
+        <td id="LC293" class="blob-code blob-code-inner js-file-line">23 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L294" class="blob-num js-line-number" data-line-number="294"></td>
+        <td id="LC294" class="blob-code blob-code-inner js-file-line">23 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L295" class="blob-num js-line-number" data-line-number="295"></td>
+        <td id="LC295" class="blob-code blob-code-inner js-file-line">23 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L296" class="blob-num js-line-number" data-line-number="296"></td>
+        <td id="LC296" class="blob-code blob-code-inner js-file-line">23 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L297" class="blob-num js-line-number" data-line-number="297"></td>
+        <td id="LC297" class="blob-code blob-code-inner js-file-line">23 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L298" class="blob-num js-line-number" data-line-number="298"></td>
+        <td id="LC298" class="blob-code blob-code-inner js-file-line">23 y_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L299" class="blob-num js-line-number" data-line-number="299"></td>
+        <td id="LC299" class="blob-code blob-code-inner js-file-line">24 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L300" class="blob-num js-line-number" data-line-number="300"></td>
+        <td id="LC300" class="blob-code blob-code-inner js-file-line">24 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L301" class="blob-num js-line-number" data-line-number="301"></td>
+        <td id="LC301" class="blob-code blob-code-inner js-file-line">24 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L302" class="blob-num js-line-number" data-line-number="302"></td>
+        <td id="LC302" class="blob-code blob-code-inner js-file-line">24 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L303" class="blob-num js-line-number" data-line-number="303"></td>
+        <td id="LC303" class="blob-code blob-code-inner js-file-line">24 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L304" class="blob-num js-line-number" data-line-number="304"></td>
+        <td id="LC304" class="blob-code blob-code-inner js-file-line">24 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L305" class="blob-num js-line-number" data-line-number="305"></td>
+        <td id="LC305" class="blob-code blob-code-inner js-file-line">24 y_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L306" class="blob-num js-line-number" data-line-number="306"></td>
+        <td id="LC306" class="blob-code blob-code-inner js-file-line">24 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L307" class="blob-num js-line-number" data-line-number="307"></td>
+        <td id="LC307" class="blob-code blob-code-inner js-file-line">24 x_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L308" class="blob-num js-line-number" data-line-number="308"></td>
+        <td id="LC308" class="blob-code blob-code-inner js-file-line">24 t 6</td>
+      </tr>
+      <tr>
+        <td id="L309" class="blob-num js-line-number" data-line-number="309"></td>
+        <td id="LC309" class="blob-code blob-code-inner js-file-line">24 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L310" class="blob-num js-line-number" data-line-number="310"></td>
+        <td id="LC310" class="blob-code blob-code-inner js-file-line">24 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L311" class="blob-num js-line-number" data-line-number="311"></td>
+        <td id="LC311" class="blob-code blob-code-inner js-file-line">24 t 13</td>
+      </tr>
+      <tr>
+        <td id="L312" class="blob-num js-line-number" data-line-number="312"></td>
+        <td id="LC312" class="blob-code blob-code-inner js-file-line">24 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L313" class="blob-num js-line-number" data-line-number="313"></td>
+        <td id="LC313" class="blob-code blob-code-inner js-file-line">24 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L314" class="blob-num js-line-number" data-line-number="314"></td>
+        <td id="LC314" class="blob-code blob-code-inner js-file-line">24 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L315" class="blob-num js-line-number" data-line-number="315"></td>
+        <td id="LC315" class="blob-code blob-code-inner js-file-line">24 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L316" class="blob-num js-line-number" data-line-number="316"></td>
+        <td id="LC316" class="blob-code blob-code-inner js-file-line">24 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L317" class="blob-num js-line-number" data-line-number="317"></td>
+        <td id="LC317" class="blob-code blob-code-inner js-file-line">25 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L318" class="blob-num js-line-number" data-line-number="318"></td>
+        <td id="LC318" class="blob-code blob-code-inner js-file-line">25 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L319" class="blob-num js-line-number" data-line-number="319"></td>
+        <td id="LC319" class="blob-code blob-code-inner js-file-line">25 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L320" class="blob-num js-line-number" data-line-number="320"></td>
+        <td id="LC320" class="blob-code blob-code-inner js-file-line">25 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L321" class="blob-num js-line-number" data-line-number="321"></td>
+        <td id="LC321" class="blob-code blob-code-inner js-file-line">25 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L322" class="blob-num js-line-number" data-line-number="322"></td>
+        <td id="LC322" class="blob-code blob-code-inner js-file-line">25 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L323" class="blob-num js-line-number" data-line-number="323"></td>
+        <td id="LC323" class="blob-code blob-code-inner js-file-line">25 t 3</td>
+      </tr>
+      <tr>
+        <td id="L324" class="blob-num js-line-number" data-line-number="324"></td>
+        <td id="LC324" class="blob-code blob-code-inner js-file-line">25 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L325" class="blob-num js-line-number" data-line-number="325"></td>
+        <td id="LC325" class="blob-code blob-code-inner js-file-line">25 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L326" class="blob-num js-line-number" data-line-number="326"></td>
+        <td id="LC326" class="blob-code blob-code-inner js-file-line">25 t 14</td>
+      </tr>
+      <tr>
+        <td id="L327" class="blob-num js-line-number" data-line-number="327"></td>
+        <td id="LC327" class="blob-code blob-code-inner js-file-line">25 t 18</td>
+      </tr>
+      <tr>
+        <td id="L328" class="blob-num js-line-number" data-line-number="328"></td>
+        <td id="LC328" class="blob-code blob-code-inner js-file-line">25 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L329" class="blob-num js-line-number" data-line-number="329"></td>
+        <td id="LC329" class="blob-code blob-code-inner js-file-line">26 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L330" class="blob-num js-line-number" data-line-number="330"></td>
+        <td id="LC330" class="blob-code blob-code-inner js-file-line">26 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L331" class="blob-num js-line-number" data-line-number="331"></td>
+        <td id="LC331" class="blob-code blob-code-inner js-file-line">26 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L332" class="blob-num js-line-number" data-line-number="332"></td>
+        <td id="LC332" class="blob-code blob-code-inner js-file-line">26 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L333" class="blob-num js-line-number" data-line-number="333"></td>
+        <td id="LC333" class="blob-code blob-code-inner js-file-line">26 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L334" class="blob-num js-line-number" data-line-number="334"></td>
+        <td id="LC334" class="blob-code blob-code-inner js-file-line">26 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L335" class="blob-num js-line-number" data-line-number="335"></td>
+        <td id="LC335" class="blob-code blob-code-inner js-file-line">26 t 0</td>
+      </tr>
+      <tr>
+        <td id="L336" class="blob-num js-line-number" data-line-number="336"></td>
+        <td id="LC336" class="blob-code blob-code-inner js-file-line">26 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L337" class="blob-num js-line-number" data-line-number="337"></td>
+        <td id="LC337" class="blob-code blob-code-inner js-file-line">26 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L338" class="blob-num js-line-number" data-line-number="338"></td>
+        <td id="LC338" class="blob-code blob-code-inner js-file-line">26 t 5</td>
+      </tr>
+      <tr>
+        <td id="L339" class="blob-num js-line-number" data-line-number="339"></td>
+        <td id="LC339" class="blob-code blob-code-inner js-file-line">26 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L340" class="blob-num js-line-number" data-line-number="340"></td>
+        <td id="LC340" class="blob-code blob-code-inner js-file-line">26 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L341" class="blob-num js-line-number" data-line-number="341"></td>
+        <td id="LC341" class="blob-code blob-code-inner js-file-line">26 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L342" class="blob-num js-line-number" data-line-number="342"></td>
+        <td id="LC342" class="blob-code blob-code-inner js-file-line">26 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L343" class="blob-num js-line-number" data-line-number="343"></td>
+        <td id="LC343" class="blob-code blob-code-inner js-file-line">26 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L344" class="blob-num js-line-number" data-line-number="344"></td>
+        <td id="LC344" class="blob-code blob-code-inner js-file-line">26 t 17</td>
+      </tr>
+      <tr>
+        <td id="L345" class="blob-num js-line-number" data-line-number="345"></td>
+        <td id="LC345" class="blob-code blob-code-inner js-file-line">26 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L346" class="blob-num js-line-number" data-line-number="346"></td>
+        <td id="LC346" class="blob-code blob-code-inner js-file-line">26 t 21</td>
+      </tr>
+      <tr>
+        <td id="L347" class="blob-num js-line-number" data-line-number="347"></td>
+        <td id="LC347" class="blob-code blob-code-inner js-file-line">27 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L348" class="blob-num js-line-number" data-line-number="348"></td>
+        <td id="LC348" class="blob-code blob-code-inner js-file-line">27 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L349" class="blob-num js-line-number" data-line-number="349"></td>
+        <td id="LC349" class="blob-code blob-code-inner js-file-line">27 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L350" class="blob-num js-line-number" data-line-number="350"></td>
+        <td id="LC350" class="blob-code blob-code-inner js-file-line">27 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L351" class="blob-num js-line-number" data-line-number="351"></td>
+        <td id="LC351" class="blob-code blob-code-inner js-file-line">27 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L352" class="blob-num js-line-number" data-line-number="352"></td>
+        <td id="LC352" class="blob-code blob-code-inner js-file-line">27 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L353" class="blob-num js-line-number" data-line-number="353"></td>
+        <td id="LC353" class="blob-code blob-code-inner js-file-line">27 t 11</td>
+      </tr>
+      <tr>
+        <td id="L354" class="blob-num js-line-number" data-line-number="354"></td>
+        <td id="LC354" class="blob-code blob-code-inner js-file-line">27 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L355" class="blob-num js-line-number" data-line-number="355"></td>
+        <td id="LC355" class="blob-code blob-code-inner js-file-line">27 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L356" class="blob-num js-line-number" data-line-number="356"></td>
+        <td id="LC356" class="blob-code blob-code-inner js-file-line">27 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L357" class="blob-num js-line-number" data-line-number="357"></td>
+        <td id="LC357" class="blob-code blob-code-inner js-file-line">27 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L358" class="blob-num js-line-number" data-line-number="358"></td>
+        <td id="LC358" class="blob-code blob-code-inner js-file-line">27 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L359" class="blob-num js-line-number" data-line-number="359"></td>
+        <td id="LC359" class="blob-code blob-code-inner js-file-line">28 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L360" class="blob-num js-line-number" data-line-number="360"></td>
+        <td id="LC360" class="blob-code blob-code-inner js-file-line">28 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L361" class="blob-num js-line-number" data-line-number="361"></td>
+        <td id="LC361" class="blob-code blob-code-inner js-file-line">28 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L362" class="blob-num js-line-number" data-line-number="362"></td>
+        <td id="LC362" class="blob-code blob-code-inner js-file-line">28 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L363" class="blob-num js-line-number" data-line-number="363"></td>
+        <td id="LC363" class="blob-code blob-code-inner js-file-line">28 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L364" class="blob-num js-line-number" data-line-number="364"></td>
+        <td id="LC364" class="blob-code blob-code-inner js-file-line">28 t 10</td>
+      </tr>
+      <tr>
+        <td id="L365" class="blob-num js-line-number" data-line-number="365"></td>
+        <td id="LC365" class="blob-code blob-code-inner js-file-line">28 x_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L366" class="blob-num js-line-number" data-line-number="366"></td>
+        <td id="LC366" class="blob-code blob-code-inner js-file-line">28 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L367" class="blob-num js-line-number" data-line-number="367"></td>
+        <td id="LC367" class="blob-code blob-code-inner js-file-line">28 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L368" class="blob-num js-line-number" data-line-number="368"></td>
+        <td id="LC368" class="blob-code blob-code-inner js-file-line">29 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L369" class="blob-num js-line-number" data-line-number="369"></td>
+        <td id="LC369" class="blob-code blob-code-inner js-file-line">29 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L370" class="blob-num js-line-number" data-line-number="370"></td>
+        <td id="LC370" class="blob-code blob-code-inner js-file-line">29 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L371" class="blob-num js-line-number" data-line-number="371"></td>
+        <td id="LC371" class="blob-code blob-code-inner js-file-line">29 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L372" class="blob-num js-line-number" data-line-number="372"></td>
+        <td id="LC372" class="blob-code blob-code-inner js-file-line">29 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L373" class="blob-num js-line-number" data-line-number="373"></td>
+        <td id="LC373" class="blob-code blob-code-inner js-file-line">29 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L374" class="blob-num js-line-number" data-line-number="374"></td>
+        <td id="LC374" class="blob-code blob-code-inner js-file-line">29 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L375" class="blob-num js-line-number" data-line-number="375"></td>
+        <td id="LC375" class="blob-code blob-code-inner js-file-line">29 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L376" class="blob-num js-line-number" data-line-number="376"></td>
+        <td id="LC376" class="blob-code blob-code-inner js-file-line">30 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L377" class="blob-num js-line-number" data-line-number="377"></td>
+        <td id="LC377" class="blob-code blob-code-inner js-file-line">30 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L378" class="blob-num js-line-number" data-line-number="378"></td>
+        <td id="LC378" class="blob-code blob-code-inner js-file-line">30 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L379" class="blob-num js-line-number" data-line-number="379"></td>
+        <td id="LC379" class="blob-code blob-code-inner js-file-line">30 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L380" class="blob-num js-line-number" data-line-number="380"></td>
+        <td id="LC380" class="blob-code blob-code-inner js-file-line">30 t 1</td>
+      </tr>
+      <tr>
+        <td id="L381" class="blob-num js-line-number" data-line-number="381"></td>
+        <td id="LC381" class="blob-code blob-code-inner js-file-line">30 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L382" class="blob-num js-line-number" data-line-number="382"></td>
+        <td id="LC382" class="blob-code blob-code-inner js-file-line">30 x_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L383" class="blob-num js-line-number" data-line-number="383"></td>
+        <td id="LC383" class="blob-code blob-code-inner js-file-line">30 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L384" class="blob-num js-line-number" data-line-number="384"></td>
+        <td id="LC384" class="blob-code blob-code-inner js-file-line">30 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L385" class="blob-num js-line-number" data-line-number="385"></td>
+        <td id="LC385" class="blob-code blob-code-inner js-file-line">30 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L386" class="blob-num js-line-number" data-line-number="386"></td>
+        <td id="LC386" class="blob-code blob-code-inner js-file-line">30 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L387" class="blob-num js-line-number" data-line-number="387"></td>
+        <td id="LC387" class="blob-code blob-code-inner js-file-line">30 t 22</td>
+      </tr>
+      <tr>
+        <td id="L388" class="blob-num js-line-number" data-line-number="388"></td>
+        <td id="LC388" class="blob-code blob-code-inner js-file-line">31 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L389" class="blob-num js-line-number" data-line-number="389"></td>
+        <td id="LC389" class="blob-code blob-code-inner js-file-line">31 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L390" class="blob-num js-line-number" data-line-number="390"></td>
+        <td id="LC390" class="blob-code blob-code-inner js-file-line">31 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L391" class="blob-num js-line-number" data-line-number="391"></td>
+        <td id="LC391" class="blob-code blob-code-inner js-file-line">31 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L392" class="blob-num js-line-number" data-line-number="392"></td>
+        <td id="LC392" class="blob-code blob-code-inner js-file-line">31 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L393" class="blob-num js-line-number" data-line-number="393"></td>
+        <td id="LC393" class="blob-code blob-code-inner js-file-line">31 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L394" class="blob-num js-line-number" data-line-number="394"></td>
+        <td id="LC394" class="blob-code blob-code-inner js-file-line">31 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L395" class="blob-num js-line-number" data-line-number="395"></td>
+        <td id="LC395" class="blob-code blob-code-inner js-file-line">31 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L396" class="blob-num js-line-number" data-line-number="396"></td>
+        <td id="LC396" class="blob-code blob-code-inner js-file-line">31 t 16</td>
+      </tr>
+      <tr>
+        <td id="L397" class="blob-num js-line-number" data-line-number="397"></td>
+        <td id="LC397" class="blob-code blob-code-inner js-file-line">31 y_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L398" class="blob-num js-line-number" data-line-number="398"></td>
+        <td id="LC398" class="blob-code blob-code-inner js-file-line">32 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L399" class="blob-num js-line-number" data-line-number="399"></td>
+        <td id="LC399" class="blob-code blob-code-inner js-file-line">32 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L400" class="blob-num js-line-number" data-line-number="400"></td>
+        <td id="LC400" class="blob-code blob-code-inner js-file-line">32 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L401" class="blob-num js-line-number" data-line-number="401"></td>
+        <td id="LC401" class="blob-code blob-code-inner js-file-line">32 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L402" class="blob-num js-line-number" data-line-number="402"></td>
+        <td id="LC402" class="blob-code blob-code-inner js-file-line">32 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L403" class="blob-num js-line-number" data-line-number="403"></td>
+        <td id="LC403" class="blob-code blob-code-inner js-file-line">32 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L404" class="blob-num js-line-number" data-line-number="404"></td>
+        <td id="LC404" class="blob-code blob-code-inner js-file-line">32 y_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L405" class="blob-num js-line-number" data-line-number="405"></td>
+        <td id="LC405" class="blob-code blob-code-inner js-file-line">32 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L406" class="blob-num js-line-number" data-line-number="406"></td>
+        <td id="LC406" class="blob-code blob-code-inner js-file-line">32 x_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L407" class="blob-num js-line-number" data-line-number="407"></td>
+        <td id="LC407" class="blob-code blob-code-inner js-file-line">32 t 6</td>
+      </tr>
+      <tr>
+        <td id="L408" class="blob-num js-line-number" data-line-number="408"></td>
+        <td id="LC408" class="blob-code blob-code-inner js-file-line">32 t 8</td>
+      </tr>
+      <tr>
+        <td id="L409" class="blob-num js-line-number" data-line-number="409"></td>
+        <td id="LC409" class="blob-code blob-code-inner js-file-line">32 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L410" class="blob-num js-line-number" data-line-number="410"></td>
+        <td id="LC410" class="blob-code blob-code-inner js-file-line">32 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L411" class="blob-num js-line-number" data-line-number="411"></td>
+        <td id="LC411" class="blob-code blob-code-inner js-file-line">32 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L412" class="blob-num js-line-number" data-line-number="412"></td>
+        <td id="LC412" class="blob-code blob-code-inner js-file-line">32 t 17</td>
+      </tr>
+      <tr>
+        <td id="L413" class="blob-num js-line-number" data-line-number="413"></td>
+        <td id="LC413" class="blob-code blob-code-inner js-file-line">32 t 19</td>
+      </tr>
+      <tr>
+        <td id="L414" class="blob-num js-line-number" data-line-number="414"></td>
+        <td id="LC414" class="blob-code blob-code-inner js-file-line">32 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L415" class="blob-num js-line-number" data-line-number="415"></td>
+        <td id="LC415" class="blob-code blob-code-inner js-file-line">32 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L416" class="blob-num js-line-number" data-line-number="416"></td>
+        <td id="LC416" class="blob-code blob-code-inner js-file-line">33 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L417" class="blob-num js-line-number" data-line-number="417"></td>
+        <td id="LC417" class="blob-code blob-code-inner js-file-line">33 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L418" class="blob-num js-line-number" data-line-number="418"></td>
+        <td id="LC418" class="blob-code blob-code-inner js-file-line">33 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L419" class="blob-num js-line-number" data-line-number="419"></td>
+        <td id="LC419" class="blob-code blob-code-inner js-file-line">33 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L420" class="blob-num js-line-number" data-line-number="420"></td>
+        <td id="LC420" class="blob-code blob-code-inner js-file-line">33 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L421" class="blob-num js-line-number" data-line-number="421"></td>
+        <td id="LC421" class="blob-code blob-code-inner js-file-line">33 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L422" class="blob-num js-line-number" data-line-number="422"></td>
+        <td id="LC422" class="blob-code blob-code-inner js-file-line">33 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L423" class="blob-num js-line-number" data-line-number="423"></td>
+        <td id="LC423" class="blob-code blob-code-inner js-file-line">33 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L424" class="blob-num js-line-number" data-line-number="424"></td>
+        <td id="LC424" class="blob-code blob-code-inner js-file-line">33 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L425" class="blob-num js-line-number" data-line-number="425"></td>
+        <td id="LC425" class="blob-code blob-code-inner js-file-line">33 t 14</td>
+      </tr>
+      <tr>
+        <td id="L426" class="blob-num js-line-number" data-line-number="426"></td>
+        <td id="LC426" class="blob-code blob-code-inner js-file-line">33 x_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L427" class="blob-num js-line-number" data-line-number="427"></td>
+        <td id="LC427" class="blob-code blob-code-inner js-file-line">33 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L428" class="blob-num js-line-number" data-line-number="428"></td>
+        <td id="LC428" class="blob-code blob-code-inner js-file-line">34 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L429" class="blob-num js-line-number" data-line-number="429"></td>
+        <td id="LC429" class="blob-code blob-code-inner js-file-line">34 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L430" class="blob-num js-line-number" data-line-number="430"></td>
+        <td id="LC430" class="blob-code blob-code-inner js-file-line">34 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L431" class="blob-num js-line-number" data-line-number="431"></td>
+        <td id="LC431" class="blob-code blob-code-inner js-file-line">34 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L432" class="blob-num js-line-number" data-line-number="432"></td>
+        <td id="LC432" class="blob-code blob-code-inner js-file-line">34 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L433" class="blob-num js-line-number" data-line-number="433"></td>
+        <td id="LC433" class="blob-code blob-code-inner js-file-line">34 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L434" class="blob-num js-line-number" data-line-number="434"></td>
+        <td id="LC434" class="blob-code blob-code-inner js-file-line">34 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L435" class="blob-num js-line-number" data-line-number="435"></td>
+        <td id="LC435" class="blob-code blob-code-inner js-file-line">34 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L436" class="blob-num js-line-number" data-line-number="436"></td>
+        <td id="LC436" class="blob-code blob-code-inner js-file-line">34 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L437" class="blob-num js-line-number" data-line-number="437"></td>
+        <td id="LC437" class="blob-code blob-code-inner js-file-line">34 y_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L438" class="blob-num js-line-number" data-line-number="438"></td>
+        <td id="LC438" class="blob-code blob-code-inner js-file-line">34 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L439" class="blob-num js-line-number" data-line-number="439"></td>
+        <td id="LC439" class="blob-code blob-code-inner js-file-line">34 t 9</td>
+      </tr>
+      <tr>
+        <td id="L440" class="blob-num js-line-number" data-line-number="440"></td>
+        <td id="LC440" class="blob-code blob-code-inner js-file-line">34 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L441" class="blob-num js-line-number" data-line-number="441"></td>
+        <td id="LC441" class="blob-code blob-code-inner js-file-line">34 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L442" class="blob-num js-line-number" data-line-number="442"></td>
+        <td id="LC442" class="blob-code blob-code-inner js-file-line">34 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L443" class="blob-num js-line-number" data-line-number="443"></td>
+        <td id="LC443" class="blob-code blob-code-inner js-file-line">34 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L444" class="blob-num js-line-number" data-line-number="444"></td>
+        <td id="LC444" class="blob-code blob-code-inner js-file-line">34 t 20</td>
+      </tr>
+      <tr>
+        <td id="L445" class="blob-num js-line-number" data-line-number="445"></td>
+        <td id="LC445" class="blob-code blob-code-inner js-file-line">34 t 21</td>
+      </tr>
+      <tr>
+        <td id="L446" class="blob-num js-line-number" data-line-number="446"></td>
+        <td id="LC446" class="blob-code blob-code-inner js-file-line">35 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L447" class="blob-num js-line-number" data-line-number="447"></td>
+        <td id="LC447" class="blob-code blob-code-inner js-file-line">35 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L448" class="blob-num js-line-number" data-line-number="448"></td>
+        <td id="LC448" class="blob-code blob-code-inner js-file-line">35 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L449" class="blob-num js-line-number" data-line-number="449"></td>
+        <td id="LC449" class="blob-code blob-code-inner js-file-line">35 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L450" class="blob-num js-line-number" data-line-number="450"></td>
+        <td id="LC450" class="blob-code blob-code-inner js-file-line">35 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L451" class="blob-num js-line-number" data-line-number="451"></td>
+        <td id="LC451" class="blob-code blob-code-inner js-file-line">35 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L452" class="blob-num js-line-number" data-line-number="452"></td>
+        <td id="LC452" class="blob-code blob-code-inner js-file-line">35 t 11</td>
+      </tr>
+      <tr>
+        <td id="L453" class="blob-num js-line-number" data-line-number="453"></td>
+        <td id="LC453" class="blob-code blob-code-inner js-file-line">35 t 15</td>
+      </tr>
+      <tr>
+        <td id="L454" class="blob-num js-line-number" data-line-number="454"></td>
+        <td id="LC454" class="blob-code blob-code-inner js-file-line">35 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L455" class="blob-num js-line-number" data-line-number="455"></td>
+        <td id="LC455" class="blob-code blob-code-inner js-file-line">35 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L456" class="blob-num js-line-number" data-line-number="456"></td>
+        <td id="LC456" class="blob-code blob-code-inner js-file-line">35 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L457" class="blob-num js-line-number" data-line-number="457"></td>
+        <td id="LC457" class="blob-code blob-code-inner js-file-line">35 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L458" class="blob-num js-line-number" data-line-number="458"></td>
+        <td id="LC458" class="blob-code blob-code-inner js-file-line">36 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L459" class="blob-num js-line-number" data-line-number="459"></td>
+        <td id="LC459" class="blob-code blob-code-inner js-file-line">36 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L460" class="blob-num js-line-number" data-line-number="460"></td>
+        <td id="LC460" class="blob-code blob-code-inner js-file-line">36 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L461" class="blob-num js-line-number" data-line-number="461"></td>
+        <td id="LC461" class="blob-code blob-code-inner js-file-line">36 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L462" class="blob-num js-line-number" data-line-number="462"></td>
+        <td id="LC462" class="blob-code blob-code-inner js-file-line">36 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L463" class="blob-num js-line-number" data-line-number="463"></td>
+        <td id="LC463" class="blob-code blob-code-inner js-file-line">36 t 10</td>
+      </tr>
+      <tr>
+        <td id="L464" class="blob-num js-line-number" data-line-number="464"></td>
+        <td id="LC464" class="blob-code blob-code-inner js-file-line">36 t 12</td>
+      </tr>
+      <tr>
+        <td id="L465" class="blob-num js-line-number" data-line-number="465"></td>
+        <td id="LC465" class="blob-code blob-code-inner js-file-line">36 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L466" class="blob-num js-line-number" data-line-number="466"></td>
+        <td id="LC466" class="blob-code blob-code-inner js-file-line">36 t 16</td>
+      </tr>
+      <tr>
+        <td id="L467" class="blob-num js-line-number" data-line-number="467"></td>
+        <td id="LC467" class="blob-code blob-code-inner js-file-line">37 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L468" class="blob-num js-line-number" data-line-number="468"></td>
+        <td id="LC468" class="blob-code blob-code-inner js-file-line">37 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L469" class="blob-num js-line-number" data-line-number="469"></td>
+        <td id="LC469" class="blob-code blob-code-inner js-file-line">37 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L470" class="blob-num js-line-number" data-line-number="470"></td>
+        <td id="LC470" class="blob-code blob-code-inner js-file-line">37 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L471" class="blob-num js-line-number" data-line-number="471"></td>
+        <td id="LC471" class="blob-code blob-code-inner js-file-line">37 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L472" class="blob-num js-line-number" data-line-number="472"></td>
+        <td id="LC472" class="blob-code blob-code-inner js-file-line">37 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L473" class="blob-num js-line-number" data-line-number="473"></td>
+        <td id="LC473" class="blob-code blob-code-inner js-file-line">37 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L474" class="blob-num js-line-number" data-line-number="474"></td>
+        <td id="LC474" class="blob-code blob-code-inner js-file-line">37 t 17</td>
+      </tr>
+      <tr>
+        <td id="L475" class="blob-num js-line-number" data-line-number="475"></td>
+        <td id="LC475" class="blob-code blob-code-inner js-file-line">38 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L476" class="blob-num js-line-number" data-line-number="476"></td>
+        <td id="LC476" class="blob-code blob-code-inner js-file-line">38 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L477" class="blob-num js-line-number" data-line-number="477"></td>
+        <td id="LC477" class="blob-code blob-code-inner js-file-line">38 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L478" class="blob-num js-line-number" data-line-number="478"></td>
+        <td id="LC478" class="blob-code blob-code-inner js-file-line">38 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L479" class="blob-num js-line-number" data-line-number="479"></td>
+        <td id="LC479" class="blob-code blob-code-inner js-file-line">38 t 1</td>
+      </tr>
+      <tr>
+        <td id="L480" class="blob-num js-line-number" data-line-number="480"></td>
+        <td id="LC480" class="blob-code blob-code-inner js-file-line">38 t 2</td>
+      </tr>
+      <tr>
+        <td id="L481" class="blob-num js-line-number" data-line-number="481"></td>
+        <td id="LC481" class="blob-code blob-code-inner js-file-line">38 x_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L482" class="blob-num js-line-number" data-line-number="482"></td>
+        <td id="LC482" class="blob-code blob-code-inner js-file-line">38 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L483" class="blob-num js-line-number" data-line-number="483"></td>
+        <td id="LC483" class="blob-code blob-code-inner js-file-line">38 t 13</td>
+      </tr>
+      <tr>
+        <td id="L484" class="blob-num js-line-number" data-line-number="484"></td>
+        <td id="LC484" class="blob-code blob-code-inner js-file-line">38 t 14</td>
+      </tr>
+      <tr>
+        <td id="L485" class="blob-num js-line-number" data-line-number="485"></td>
+        <td id="LC485" class="blob-code blob-code-inner js-file-line">38 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L486" class="blob-num js-line-number" data-line-number="486"></td>
+        <td id="LC486" class="blob-code blob-code-inner js-file-line">38 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L487" class="blob-num js-line-number" data-line-number="487"></td>
+        <td id="LC487" class="blob-code blob-code-inner js-file-line">39 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L488" class="blob-num js-line-number" data-line-number="488"></td>
+        <td id="LC488" class="blob-code blob-code-inner js-file-line">39 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L489" class="blob-num js-line-number" data-line-number="489"></td>
+        <td id="LC489" class="blob-code blob-code-inner js-file-line">39 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L490" class="blob-num js-line-number" data-line-number="490"></td>
+        <td id="LC490" class="blob-code blob-code-inner js-file-line">39 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L491" class="blob-num js-line-number" data-line-number="491"></td>
+        <td id="LC491" class="blob-code blob-code-inner js-file-line">39 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L492" class="blob-num js-line-number" data-line-number="492"></td>
+        <td id="LC492" class="blob-code blob-code-inner js-file-line">39 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L493" class="blob-num js-line-number" data-line-number="493"></td>
+        <td id="LC493" class="blob-code blob-code-inner js-file-line">39 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L494" class="blob-num js-line-number" data-line-number="494"></td>
+        <td id="LC494" class="blob-code blob-code-inner js-file-line">39 t 7</td>
+      </tr>
+      <tr>
+        <td id="L495" class="blob-num js-line-number" data-line-number="495"></td>
+        <td id="LC495" class="blob-code blob-code-inner js-file-line">39 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L496" class="blob-num js-line-number" data-line-number="496"></td>
+        <td id="LC496" class="blob-code blob-code-inner js-file-line">39 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L497" class="blob-num js-line-number" data-line-number="497"></td>
+        <td id="LC497" class="blob-code blob-code-inner js-file-line">40 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L498" class="blob-num js-line-number" data-line-number="498"></td>
+        <td id="LC498" class="blob-code blob-code-inner js-file-line">40 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L499" class="blob-num js-line-number" data-line-number="499"></td>
+        <td id="LC499" class="blob-code blob-code-inner js-file-line">40 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L500" class="blob-num js-line-number" data-line-number="500"></td>
+        <td id="LC500" class="blob-code blob-code-inner js-file-line">40 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L501" class="blob-num js-line-number" data-line-number="501"></td>
+        <td id="LC501" class="blob-code blob-code-inner js-file-line">40 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L502" class="blob-num js-line-number" data-line-number="502"></td>
+        <td id="LC502" class="blob-code blob-code-inner js-file-line">40 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L503" class="blob-num js-line-number" data-line-number="503"></td>
+        <td id="LC503" class="blob-code blob-code-inner js-file-line">40 y_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L504" class="blob-num js-line-number" data-line-number="504"></td>
+        <td id="LC504" class="blob-code blob-code-inner js-file-line">40 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L505" class="blob-num js-line-number" data-line-number="505"></td>
+        <td id="LC505" class="blob-code blob-code-inner js-file-line">40 t 4</td>
+      </tr>
+      <tr>
+        <td id="L506" class="blob-num js-line-number" data-line-number="506"></td>
+        <td id="LC506" class="blob-code blob-code-inner js-file-line">40 t 6</td>
+      </tr>
+      <tr>
+        <td id="L507" class="blob-num js-line-number" data-line-number="507"></td>
+        <td id="LC507" class="blob-code blob-code-inner js-file-line">40 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L508" class="blob-num js-line-number" data-line-number="508"></td>
+        <td id="LC508" class="blob-code blob-code-inner js-file-line">40 t 10</td>
+      </tr>
+      <tr>
+        <td id="L509" class="blob-num js-line-number" data-line-number="509"></td>
+        <td id="LC509" class="blob-code blob-code-inner js-file-line">40 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L510" class="blob-num js-line-number" data-line-number="510"></td>
+        <td id="LC510" class="blob-code blob-code-inner js-file-line">40 t 15</td>
+      </tr>
+      <tr>
+        <td id="L511" class="blob-num js-line-number" data-line-number="511"></td>
+        <td id="LC511" class="blob-code blob-code-inner js-file-line">40 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L512" class="blob-num js-line-number" data-line-number="512"></td>
+        <td id="LC512" class="blob-code blob-code-inner js-file-line">40 t 19</td>
+      </tr>
+      <tr>
+        <td id="L513" class="blob-num js-line-number" data-line-number="513"></td>
+        <td id="LC513" class="blob-code blob-code-inner js-file-line">40 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L514" class="blob-num js-line-number" data-line-number="514"></td>
+        <td id="LC514" class="blob-code blob-code-inner js-file-line">40 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L515" class="blob-num js-line-number" data-line-number="515"></td>
+        <td id="LC515" class="blob-code blob-code-inner js-file-line">41 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L516" class="blob-num js-line-number" data-line-number="516"></td>
+        <td id="LC516" class="blob-code blob-code-inner js-file-line">41 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L517" class="blob-num js-line-number" data-line-number="517"></td>
+        <td id="LC517" class="blob-code blob-code-inner js-file-line">41 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L518" class="blob-num js-line-number" data-line-number="518"></td>
+        <td id="LC518" class="blob-code blob-code-inner js-file-line">41 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L519" class="blob-num js-line-number" data-line-number="519"></td>
+        <td id="LC519" class="blob-code blob-code-inner js-file-line">41 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L520" class="blob-num js-line-number" data-line-number="520"></td>
+        <td id="LC520" class="blob-code blob-code-inner js-file-line">41 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L521" class="blob-num js-line-number" data-line-number="521"></td>
+        <td id="LC521" class="blob-code blob-code-inner js-file-line">41 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L522" class="blob-num js-line-number" data-line-number="522"></td>
+        <td id="LC522" class="blob-code blob-code-inner js-file-line">41 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L523" class="blob-num js-line-number" data-line-number="523"></td>
+        <td id="LC523" class="blob-code blob-code-inner js-file-line">41 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L524" class="blob-num js-line-number" data-line-number="524"></td>
+        <td id="LC524" class="blob-code blob-code-inner js-file-line">41 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L525" class="blob-num js-line-number" data-line-number="525"></td>
+        <td id="LC525" class="blob-code blob-code-inner js-file-line">41 x_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L526" class="blob-num js-line-number" data-line-number="526"></td>
+        <td id="LC526" class="blob-code blob-code-inner js-file-line">41 t 22</td>
+      </tr>
+      <tr>
+        <td id="L527" class="blob-num js-line-number" data-line-number="527"></td>
+        <td id="LC527" class="blob-code blob-code-inner js-file-line">42 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L528" class="blob-num js-line-number" data-line-number="528"></td>
+        <td id="LC528" class="blob-code blob-code-inner js-file-line">42 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L529" class="blob-num js-line-number" data-line-number="529"></td>
+        <td id="LC529" class="blob-code blob-code-inner js-file-line">42 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L530" class="blob-num js-line-number" data-line-number="530"></td>
+        <td id="LC530" class="blob-code blob-code-inner js-file-line">42 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L531" class="blob-num js-line-number" data-line-number="531"></td>
+        <td id="LC531" class="blob-code blob-code-inner js-file-line">42 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L532" class="blob-num js-line-number" data-line-number="532"></td>
+        <td id="LC532" class="blob-code blob-code-inner js-file-line">42 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L533" class="blob-num js-line-number" data-line-number="533"></td>
+        <td id="LC533" class="blob-code blob-code-inner js-file-line">42 t 0</td>
+      </tr>
+      <tr>
+        <td id="L534" class="blob-num js-line-number" data-line-number="534"></td>
+        <td id="LC534" class="blob-code blob-code-inner js-file-line">42 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L535" class="blob-num js-line-number" data-line-number="535"></td>
+        <td id="LC535" class="blob-code blob-code-inner js-file-line">42 x_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L536" class="blob-num js-line-number" data-line-number="536"></td>
+        <td id="LC536" class="blob-code blob-code-inner js-file-line">42 x_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L537" class="blob-num js-line-number" data-line-number="537"></td>
+        <td id="LC537" class="blob-code blob-code-inner js-file-line">42 t 8</td>
+      </tr>
+      <tr>
+        <td id="L538" class="blob-num js-line-number" data-line-number="538"></td>
+        <td id="LC538" class="blob-code blob-code-inner js-file-line">42 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L539" class="blob-num js-line-number" data-line-number="539"></td>
+        <td id="LC539" class="blob-code blob-code-inner js-file-line">42 x_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L540" class="blob-num js-line-number" data-line-number="540"></td>
+        <td id="LC540" class="blob-code blob-code-inner js-file-line">42 t 13</td>
+      </tr>
+      <tr>
+        <td id="L541" class="blob-num js-line-number" data-line-number="541"></td>
+        <td id="LC541" class="blob-code blob-code-inner js-file-line">42 t 16</td>
+      </tr>
+      <tr>
+        <td id="L542" class="blob-num js-line-number" data-line-number="542"></td>
+        <td id="LC542" class="blob-code blob-code-inner js-file-line">42 t 17</td>
+      </tr>
+      <tr>
+        <td id="L543" class="blob-num js-line-number" data-line-number="543"></td>
+        <td id="LC543" class="blob-code blob-code-inner js-file-line">42 t 20</td>
+      </tr>
+      <tr>
+        <td id="L544" class="blob-num js-line-number" data-line-number="544"></td>
+        <td id="LC544" class="blob-code blob-code-inner js-file-line">42 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L545" class="blob-num js-line-number" data-line-number="545"></td>
+        <td id="LC545" class="blob-code blob-code-inner js-file-line">43 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L546" class="blob-num js-line-number" data-line-number="546"></td>
+        <td id="LC546" class="blob-code blob-code-inner js-file-line">43 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L547" class="blob-num js-line-number" data-line-number="547"></td>
+        <td id="LC547" class="blob-code blob-code-inner js-file-line">43 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L548" class="blob-num js-line-number" data-line-number="548"></td>
+        <td id="LC548" class="blob-code blob-code-inner js-file-line">43 t 2</td>
+      </tr>
+      <tr>
+        <td id="L549" class="blob-num js-line-number" data-line-number="549"></td>
+        <td id="LC549" class="blob-code blob-code-inner js-file-line">43 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L550" class="blob-num js-line-number" data-line-number="550"></td>
+        <td id="LC550" class="blob-code blob-code-inner js-file-line">43 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L551" class="blob-num js-line-number" data-line-number="551"></td>
+        <td id="LC551" class="blob-code blob-code-inner js-file-line">43 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L552" class="blob-num js-line-number" data-line-number="552"></td>
+        <td id="LC552" class="blob-code blob-code-inner js-file-line">43 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L553" class="blob-num js-line-number" data-line-number="553"></td>
+        <td id="LC553" class="blob-code blob-code-inner js-file-line">43 t 18</td>
+      </tr>
+      <tr>
+        <td id="L554" class="blob-num js-line-number" data-line-number="554"></td>
+        <td id="LC554" class="blob-code blob-code-inner js-file-line">43 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L555" class="blob-num js-line-number" data-line-number="555"></td>
+        <td id="LC555" class="blob-code blob-code-inner js-file-line">43 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L556" class="blob-num js-line-number" data-line-number="556"></td>
+        <td id="LC556" class="blob-code blob-code-inner js-file-line">43 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L557" class="blob-num js-line-number" data-line-number="557"></td>
+        <td id="LC557" class="blob-code blob-code-inner js-file-line">44 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L558" class="blob-num js-line-number" data-line-number="558"></td>
+        <td id="LC558" class="blob-code blob-code-inner js-file-line">44 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L559" class="blob-num js-line-number" data-line-number="559"></td>
+        <td id="LC559" class="blob-code blob-code-inner js-file-line">44 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L560" class="blob-num js-line-number" data-line-number="560"></td>
+        <td id="LC560" class="blob-code blob-code-inner js-file-line">44 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L561" class="blob-num js-line-number" data-line-number="561"></td>
+        <td id="LC561" class="blob-code blob-code-inner js-file-line">44 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L562" class="blob-num js-line-number" data-line-number="562"></td>
+        <td id="LC562" class="blob-code blob-code-inner js-file-line">44 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L563" class="blob-num js-line-number" data-line-number="563"></td>
+        <td id="LC563" class="blob-code blob-code-inner js-file-line">44 t 12</td>
+      </tr>
+      <tr>
+        <td id="L564" class="blob-num js-line-number" data-line-number="564"></td>
+        <td id="LC564" class="blob-code blob-code-inner js-file-line">44 t 14</td>
+      </tr>
+      <tr>
+        <td id="L565" class="blob-num js-line-number" data-line-number="565"></td>
+        <td id="LC565" class="blob-code blob-code-inner js-file-line">44 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L566" class="blob-num js-line-number" data-line-number="566"></td>
+        <td id="LC566" class="blob-code blob-code-inner js-file-line">45 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L567" class="blob-num js-line-number" data-line-number="567"></td>
+        <td id="LC567" class="blob-code blob-code-inner js-file-line">45 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L568" class="blob-num js-line-number" data-line-number="568"></td>
+        <td id="LC568" class="blob-code blob-code-inner js-file-line">45 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L569" class="blob-num js-line-number" data-line-number="569"></td>
+        <td id="LC569" class="blob-code blob-code-inner js-file-line">45 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L570" class="blob-num js-line-number" data-line-number="570"></td>
+        <td id="LC570" class="blob-code blob-code-inner js-file-line">45 t 7</td>
+      </tr>
+      <tr>
+        <td id="L571" class="blob-num js-line-number" data-line-number="571"></td>
+        <td id="LC571" class="blob-code blob-code-inner js-file-line">45 t 11</td>
+      </tr>
+      <tr>
+        <td id="L572" class="blob-num js-line-number" data-line-number="572"></td>
+        <td id="LC572" class="blob-code blob-code-inner js-file-line">45 t 15</td>
+      </tr>
+      <tr>
+        <td id="L573" class="blob-num js-line-number" data-line-number="573"></td>
+        <td id="LC573" class="blob-code blob-code-inner js-file-line">45 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L574" class="blob-num js-line-number" data-line-number="574"></td>
+        <td id="LC574" class="blob-code blob-code-inner js-file-line">46 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L575" class="blob-num js-line-number" data-line-number="575"></td>
+        <td id="LC575" class="blob-code blob-code-inner js-file-line">46 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L576" class="blob-num js-line-number" data-line-number="576"></td>
+        <td id="LC576" class="blob-code blob-code-inner js-file-line">46 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L577" class="blob-num js-line-number" data-line-number="577"></td>
+        <td id="LC577" class="blob-code blob-code-inner js-file-line">46 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L578" class="blob-num js-line-number" data-line-number="578"></td>
+        <td id="LC578" class="blob-code blob-code-inner js-file-line">46 y_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L579" class="blob-num js-line-number" data-line-number="579"></td>
+        <td id="LC579" class="blob-code blob-code-inner js-file-line">46 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L580" class="blob-num js-line-number" data-line-number="580"></td>
+        <td id="LC580" class="blob-code blob-code-inner js-file-line">46 t 9</td>
+      </tr>
+      <tr>
+        <td id="L581" class="blob-num js-line-number" data-line-number="581"></td>
+        <td id="LC581" class="blob-code blob-code-inner js-file-line">46 t 10</td>
+      </tr>
+      <tr>
+        <td id="L582" class="blob-num js-line-number" data-line-number="582"></td>
+        <td id="LC582" class="blob-code blob-code-inner js-file-line">46 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L583" class="blob-num js-line-number" data-line-number="583"></td>
+        <td id="LC583" class="blob-code blob-code-inner js-file-line">46 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L584" class="blob-num js-line-number" data-line-number="584"></td>
+        <td id="LC584" class="blob-code blob-code-inner js-file-line">46 t 21</td>
+      </tr>
+      <tr>
+        <td id="L585" class="blob-num js-line-number" data-line-number="585"></td>
+        <td id="LC585" class="blob-code blob-code-inner js-file-line">46 t 22</td>
+      </tr>
+      <tr>
+        <td id="L586" class="blob-num js-line-number" data-line-number="586"></td>
+        <td id="LC586" class="blob-code blob-code-inner js-file-line">47 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L587" class="blob-num js-line-number" data-line-number="587"></td>
+        <td id="LC587" class="blob-code blob-code-inner js-file-line">47 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L588" class="blob-num js-line-number" data-line-number="588"></td>
+        <td id="LC588" class="blob-code blob-code-inner js-file-line">47 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L589" class="blob-num js-line-number" data-line-number="589"></td>
+        <td id="LC589" class="blob-code blob-code-inner js-file-line">47 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L590" class="blob-num js-line-number" data-line-number="590"></td>
+        <td id="LC590" class="blob-code blob-code-inner js-file-line">47 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L591" class="blob-num js-line-number" data-line-number="591"></td>
+        <td id="LC591" class="blob-code blob-code-inner js-file-line">47 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L592" class="blob-num js-line-number" data-line-number="592"></td>
+        <td id="LC592" class="blob-code blob-code-inner js-file-line">47 t 3</td>
+      </tr>
+      <tr>
+        <td id="L593" class="blob-num js-line-number" data-line-number="593"></td>
+        <td id="LC593" class="blob-code blob-code-inner js-file-line">47 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L594" class="blob-num js-line-number" data-line-number="594"></td>
+        <td id="LC594" class="blob-code blob-code-inner js-file-line">47 t 16</td>
+      </tr>
+      <tr>
+        <td id="L595" class="blob-num js-line-number" data-line-number="595"></td>
+        <td id="LC595" class="blob-code blob-code-inner js-file-line">47 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L596" class="blob-num js-line-number" data-line-number="596"></td>
+        <td id="LC596" class="blob-code blob-code-inner js-file-line">48 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L597" class="blob-num js-line-number" data-line-number="597"></td>
+        <td id="LC597" class="blob-code blob-code-inner js-file-line">48 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L598" class="blob-num js-line-number" data-line-number="598"></td>
+        <td id="LC598" class="blob-code blob-code-inner js-file-line">48 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L599" class="blob-num js-line-number" data-line-number="599"></td>
+        <td id="LC599" class="blob-code blob-code-inner js-file-line">48 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L600" class="blob-num js-line-number" data-line-number="600"></td>
+        <td id="LC600" class="blob-code blob-code-inner js-file-line">48 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L601" class="blob-num js-line-number" data-line-number="601"></td>
+        <td id="LC601" class="blob-code blob-code-inner js-file-line">48 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L602" class="blob-num js-line-number" data-line-number="602"></td>
+        <td id="LC602" class="blob-code blob-code-inner js-file-line">48 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L603" class="blob-num js-line-number" data-line-number="603"></td>
+        <td id="LC603" class="blob-code blob-code-inner js-file-line">48 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L604" class="blob-num js-line-number" data-line-number="604"></td>
+        <td id="LC604" class="blob-code blob-code-inner js-file-line">48 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L605" class="blob-num js-line-number" data-line-number="605"></td>
+        <td id="LC605" class="blob-code blob-code-inner js-file-line">48 t 6</td>
+      </tr>
+      <tr>
+        <td id="L606" class="blob-num js-line-number" data-line-number="606"></td>
+        <td id="LC606" class="blob-code blob-code-inner js-file-line">48 t 8</td>
+      </tr>
+      <tr>
+        <td id="L607" class="blob-num js-line-number" data-line-number="607"></td>
+        <td id="LC607" class="blob-code blob-code-inner js-file-line">48 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L608" class="blob-num js-line-number" data-line-number="608"></td>
+        <td id="LC608" class="blob-code blob-code-inner js-file-line">48 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L609" class="blob-num js-line-number" data-line-number="609"></td>
+        <td id="LC609" class="blob-code blob-code-inner js-file-line">48 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L610" class="blob-num js-line-number" data-line-number="610"></td>
+        <td id="LC610" class="blob-code blob-code-inner js-file-line">48 t 17</td>
+      </tr>
+      <tr>
+        <td id="L611" class="blob-num js-line-number" data-line-number="611"></td>
+        <td id="LC611" class="blob-code blob-code-inner js-file-line">48 t 19</td>
+      </tr>
+      <tr>
+        <td id="L612" class="blob-num js-line-number" data-line-number="612"></td>
+        <td id="LC612" class="blob-code blob-code-inner js-file-line">48 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L613" class="blob-num js-line-number" data-line-number="613"></td>
+        <td id="LC613" class="blob-code blob-code-inner js-file-line">48 t 23</td>
+      </tr>
+      <tr>
+        <td id="L614" class="blob-num js-line-number" data-line-number="614"></td>
+        <td id="LC614" class="blob-code blob-code-inner js-file-line">49 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L615" class="blob-num js-line-number" data-line-number="615"></td>
+        <td id="LC615" class="blob-code blob-code-inner js-file-line">49 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L616" class="blob-num js-line-number" data-line-number="616"></td>
+        <td id="LC616" class="blob-code blob-code-inner js-file-line">49 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L617" class="blob-num js-line-number" data-line-number="617"></td>
+        <td id="LC617" class="blob-code blob-code-inner js-file-line">49 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L618" class="blob-num js-line-number" data-line-number="618"></td>
+        <td id="LC618" class="blob-code blob-code-inner js-file-line">49 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L619" class="blob-num js-line-number" data-line-number="619"></td>
+        <td id="LC619" class="blob-code blob-code-inner js-file-line">49 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L620" class="blob-num js-line-number" data-line-number="620"></td>
+        <td id="LC620" class="blob-code blob-code-inner js-file-line">49 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L621" class="blob-num js-line-number" data-line-number="621"></td>
+        <td id="LC621" class="blob-code blob-code-inner js-file-line">49 t 7</td>
+      </tr>
+      <tr>
+        <td id="L622" class="blob-num js-line-number" data-line-number="622"></td>
+        <td id="LC622" class="blob-code blob-code-inner js-file-line">49 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L623" class="blob-num js-line-number" data-line-number="623"></td>
+        <td id="LC623" class="blob-code blob-code-inner js-file-line">49 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L624" class="blob-num js-line-number" data-line-number="624"></td>
+        <td id="LC624" class="blob-code blob-code-inner js-file-line">49 x_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L625" class="blob-num js-line-number" data-line-number="625"></td>
+        <td id="LC625" class="blob-code blob-code-inner js-file-line">49 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L626" class="blob-num js-line-number" data-line-number="626"></td>
+        <td id="LC626" class="blob-code blob-code-inner js-file-line">50 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L627" class="blob-num js-line-number" data-line-number="627"></td>
+        <td id="LC627" class="blob-code blob-code-inner js-file-line">50 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L628" class="blob-num js-line-number" data-line-number="628"></td>
+        <td id="LC628" class="blob-code blob-code-inner js-file-line">50 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L629" class="blob-num js-line-number" data-line-number="629"></td>
+        <td id="LC629" class="blob-code blob-code-inner js-file-line">50 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L630" class="blob-num js-line-number" data-line-number="630"></td>
+        <td id="LC630" class="blob-code blob-code-inner js-file-line">50 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L631" class="blob-num js-line-number" data-line-number="631"></td>
+        <td id="LC631" class="blob-code blob-code-inner js-file-line">50 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L632" class="blob-num js-line-number" data-line-number="632"></td>
+        <td id="LC632" class="blob-code blob-code-inner js-file-line">50 t 0</td>
+      </tr>
+      <tr>
+        <td id="L633" class="blob-num js-line-number" data-line-number="633"></td>
+        <td id="LC633" class="blob-code blob-code-inner js-file-line">50 t 1</td>
+      </tr>
+      <tr>
+        <td id="L634" class="blob-num js-line-number" data-line-number="634"></td>
+        <td id="LC634" class="blob-code blob-code-inner js-file-line">50 x_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L635" class="blob-num js-line-number" data-line-number="635"></td>
+        <td id="LC635" class="blob-code blob-code-inner js-file-line">50 t 5</td>
+      </tr>
+      <tr>
+        <td id="L636" class="blob-num js-line-number" data-line-number="636"></td>
+        <td id="LC636" class="blob-code blob-code-inner js-file-line">50 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L637" class="blob-num js-line-number" data-line-number="637"></td>
+        <td id="LC637" class="blob-code blob-code-inner js-file-line">50 x_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L638" class="blob-num js-line-number" data-line-number="638"></td>
+        <td id="LC638" class="blob-code blob-code-inner js-file-line">50 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L639" class="blob-num js-line-number" data-line-number="639"></td>
+        <td id="LC639" class="blob-code blob-code-inner js-file-line">50 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L640" class="blob-num js-line-number" data-line-number="640"></td>
+        <td id="LC640" class="blob-code blob-code-inner js-file-line">50 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L641" class="blob-num js-line-number" data-line-number="641"></td>
+        <td id="LC641" class="blob-code blob-code-inner js-file-line">50 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L642" class="blob-num js-line-number" data-line-number="642"></td>
+        <td id="LC642" class="blob-code blob-code-inner js-file-line">50 t 20</td>
+      </tr>
+      <tr>
+        <td id="L643" class="blob-num js-line-number" data-line-number="643"></td>
+        <td id="LC643" class="blob-code blob-code-inner js-file-line">50 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L644" class="blob-num js-line-number" data-line-number="644"></td>
+        <td id="LC644" class="blob-code blob-code-inner js-file-line">51 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L645" class="blob-num js-line-number" data-line-number="645"></td>
+        <td id="LC645" class="blob-code blob-code-inner js-file-line">51 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L646" class="blob-num js-line-number" data-line-number="646"></td>
+        <td id="LC646" class="blob-code blob-code-inner js-file-line">51 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L647" class="blob-num js-line-number" data-line-number="647"></td>
+        <td id="LC647" class="blob-code blob-code-inner js-file-line">51 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L648" class="blob-num js-line-number" data-line-number="648"></td>
+        <td id="LC648" class="blob-code blob-code-inner js-file-line">51 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L649" class="blob-num js-line-number" data-line-number="649"></td>
+        <td id="LC649" class="blob-code blob-code-inner js-file-line">51 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L650" class="blob-num js-line-number" data-line-number="650"></td>
+        <td id="LC650" class="blob-code blob-code-inner js-file-line">51 t 11</td>
+      </tr>
+      <tr>
+        <td id="L651" class="blob-num js-line-number" data-line-number="651"></td>
+        <td id="LC651" class="blob-code blob-code-inner js-file-line">51 t 15</td>
+      </tr>
+      <tr>
+        <td id="L652" class="blob-num js-line-number" data-line-number="652"></td>
+        <td id="LC652" class="blob-code blob-code-inner js-file-line">51 t 18</td>
+      </tr>
+      <tr>
+        <td id="L653" class="blob-num js-line-number" data-line-number="653"></td>
+        <td id="LC653" class="blob-code blob-code-inner js-file-line">51 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L654" class="blob-num js-line-number" data-line-number="654"></td>
+        <td id="LC654" class="blob-code blob-code-inner js-file-line">51 t 22</td>
+      </tr>
+      <tr>
+        <td id="L655" class="blob-num js-line-number" data-line-number="655"></td>
+        <td id="LC655" class="blob-code blob-code-inner js-file-line">51 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L656" class="blob-num js-line-number" data-line-number="656"></td>
+        <td id="LC656" class="blob-code blob-code-inner js-file-line">52 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L657" class="blob-num js-line-number" data-line-number="657"></td>
+        <td id="LC657" class="blob-code blob-code-inner js-file-line">52 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L658" class="blob-num js-line-number" data-line-number="658"></td>
+        <td id="LC658" class="blob-code blob-code-inner js-file-line">52 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L659" class="blob-num js-line-number" data-line-number="659"></td>
+        <td id="LC659" class="blob-code blob-code-inner js-file-line">52 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L660" class="blob-num js-line-number" data-line-number="660"></td>
+        <td id="LC660" class="blob-code blob-code-inner js-file-line">52 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L661" class="blob-num js-line-number" data-line-number="661"></td>
+        <td id="LC661" class="blob-code blob-code-inner js-file-line">52 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L662" class="blob-num js-line-number" data-line-number="662"></td>
+        <td id="LC662" class="blob-code blob-code-inner js-file-line">52 x_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L663" class="blob-num js-line-number" data-line-number="663"></td>
+        <td id="LC663" class="blob-code blob-code-inner js-file-line">52 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L664" class="blob-num js-line-number" data-line-number="664"></td>
+        <td id="LC664" class="blob-code blob-code-inner js-file-line">52 t 16</td>
+      </tr>
+      <tr>
+        <td id="L665" class="blob-num js-line-number" data-line-number="665"></td>
+        <td id="LC665" class="blob-code blob-code-inner js-file-line">53 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L666" class="blob-num js-line-number" data-line-number="666"></td>
+        <td id="LC666" class="blob-code blob-code-inner js-file-line">53 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L667" class="blob-num js-line-number" data-line-number="667"></td>
+        <td id="LC667" class="blob-code blob-code-inner js-file-line">53 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L668" class="blob-num js-line-number" data-line-number="668"></td>
+        <td id="LC668" class="blob-code blob-code-inner js-file-line">53 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L669" class="blob-num js-line-number" data-line-number="669"></td>
+        <td id="LC669" class="blob-code blob-code-inner js-file-line">53 t 7</td>
+      </tr>
+      <tr>
+        <td id="L670" class="blob-num js-line-number" data-line-number="670"></td>
+        <td id="LC670" class="blob-code blob-code-inner js-file-line">53 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L671" class="blob-num js-line-number" data-line-number="671"></td>
+        <td id="LC671" class="blob-code blob-code-inner js-file-line">53 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L672" class="blob-num js-line-number" data-line-number="672"></td>
+        <td id="LC672" class="blob-code blob-code-inner js-file-line">53 t 17</td>
+      </tr>
+      <tr>
+        <td id="L673" class="blob-num js-line-number" data-line-number="673"></td>
+        <td id="LC673" class="blob-code blob-code-inner js-file-line">54 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L674" class="blob-num js-line-number" data-line-number="674"></td>
+        <td id="LC674" class="blob-code blob-code-inner js-file-line">54 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L675" class="blob-num js-line-number" data-line-number="675"></td>
+        <td id="LC675" class="blob-code blob-code-inner js-file-line">54 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L676" class="blob-num js-line-number" data-line-number="676"></td>
+        <td id="LC676" class="blob-code blob-code-inner js-file-line">54 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L677" class="blob-num js-line-number" data-line-number="677"></td>
+        <td id="LC677" class="blob-code blob-code-inner js-file-line">54 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L678" class="blob-num js-line-number" data-line-number="678"></td>
+        <td id="LC678" class="blob-code blob-code-inner js-file-line">54 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L679" class="blob-num js-line-number" data-line-number="679"></td>
+        <td id="LC679" class="blob-code blob-code-inner js-file-line">54 t 9</td>
+      </tr>
+      <tr>
+        <td id="L680" class="blob-num js-line-number" data-line-number="680"></td>
+        <td id="LC680" class="blob-code blob-code-inner js-file-line">54 t 10</td>
+      </tr>
+      <tr>
+        <td id="L681" class="blob-num js-line-number" data-line-number="681"></td>
+        <td id="LC681" class="blob-code blob-code-inner js-file-line">54 t 13</td>
+      </tr>
+      <tr>
+        <td id="L682" class="blob-num js-line-number" data-line-number="682"></td>
+        <td id="LC682" class="blob-code blob-code-inner js-file-line">54 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L683" class="blob-num js-line-number" data-line-number="683"></td>
+        <td id="LC683" class="blob-code blob-code-inner js-file-line">54 t 21</td>
+      </tr>
+      <tr>
+        <td id="L684" class="blob-num js-line-number" data-line-number="684"></td>
+        <td id="LC684" class="blob-code blob-code-inner js-file-line">54 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L685" class="blob-num js-line-number" data-line-number="685"></td>
+        <td id="LC685" class="blob-code blob-code-inner js-file-line">55 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L686" class="blob-num js-line-number" data-line-number="686"></td>
+        <td id="LC686" class="blob-code blob-code-inner js-file-line">55 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L687" class="blob-num js-line-number" data-line-number="687"></td>
+        <td id="LC687" class="blob-code blob-code-inner js-file-line">55 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L688" class="blob-num js-line-number" data-line-number="688"></td>
+        <td id="LC688" class="blob-code blob-code-inner js-file-line">55 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L689" class="blob-num js-line-number" data-line-number="689"></td>
+        <td id="LC689" class="blob-code blob-code-inner js-file-line">55 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L690" class="blob-num js-line-number" data-line-number="690"></td>
+        <td id="LC690" class="blob-code blob-code-inner js-file-line">55 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L691" class="blob-num js-line-number" data-line-number="691"></td>
+        <td id="LC691" class="blob-code blob-code-inner js-file-line">55 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L692" class="blob-num js-line-number" data-line-number="692"></td>
+        <td id="LC692" class="blob-code blob-code-inner js-file-line">55 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L693" class="blob-num js-line-number" data-line-number="693"></td>
+        <td id="LC693" class="blob-code blob-code-inner js-file-line">55 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L694" class="blob-num js-line-number" data-line-number="694"></td>
+        <td id="LC694" class="blob-code blob-code-inner js-file-line">55 y_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L695" class="blob-num js-line-number" data-line-number="695"></td>
+        <td id="LC695" class="blob-code blob-code-inner js-file-line">56 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L696" class="blob-num js-line-number" data-line-number="696"></td>
+        <td id="LC696" class="blob-code blob-code-inner js-file-line">56 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L697" class="blob-num js-line-number" data-line-number="697"></td>
+        <td id="LC697" class="blob-code blob-code-inner js-file-line">56 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L698" class="blob-num js-line-number" data-line-number="698"></td>
+        <td id="LC698" class="blob-code blob-code-inner js-file-line">56 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L699" class="blob-num js-line-number" data-line-number="699"></td>
+        <td id="LC699" class="blob-code blob-code-inner js-file-line">56 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L700" class="blob-num js-line-number" data-line-number="700"></td>
+        <td id="LC700" class="blob-code blob-code-inner js-file-line">56 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L701" class="blob-num js-line-number" data-line-number="701"></td>
+        <td id="LC701" class="blob-code blob-code-inner js-file-line">56 y_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L702" class="blob-num js-line-number" data-line-number="702"></td>
+        <td id="LC702" class="blob-code blob-code-inner js-file-line">56 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L703" class="blob-num js-line-number" data-line-number="703"></td>
+        <td id="LC703" class="blob-code blob-code-inner js-file-line">56 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L704" class="blob-num js-line-number" data-line-number="704"></td>
+        <td id="LC704" class="blob-code blob-code-inner js-file-line">56 t 6</td>
+      </tr>
+      <tr>
+        <td id="L705" class="blob-num js-line-number" data-line-number="705"></td>
+        <td id="LC705" class="blob-code blob-code-inner js-file-line">56 t 8</td>
+      </tr>
+      <tr>
+        <td id="L706" class="blob-num js-line-number" data-line-number="706"></td>
+        <td id="LC706" class="blob-code blob-code-inner js-file-line">56 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L707" class="blob-num js-line-number" data-line-number="707"></td>
+        <td id="LC707" class="blob-code blob-code-inner js-file-line">56 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L708" class="blob-num js-line-number" data-line-number="708"></td>
+        <td id="LC708" class="blob-code blob-code-inner js-file-line">56 t 15</td>
+      </tr>
+      <tr>
+        <td id="L709" class="blob-num js-line-number" data-line-number="709"></td>
+        <td id="LC709" class="blob-code blob-code-inner js-file-line">56 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L710" class="blob-num js-line-number" data-line-number="710"></td>
+        <td id="LC710" class="blob-code blob-code-inner js-file-line">56 t 19</td>
+      </tr>
+      <tr>
+        <td id="L711" class="blob-num js-line-number" data-line-number="711"></td>
+        <td id="LC711" class="blob-code blob-code-inner js-file-line">56 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L712" class="blob-num js-line-number" data-line-number="712"></td>
+        <td id="LC712" class="blob-code blob-code-inner js-file-line">56 t 23</td>
+      </tr>
+      <tr>
+        <td id="L713" class="blob-num js-line-number" data-line-number="713"></td>
+        <td id="LC713" class="blob-code blob-code-inner js-file-line">57 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L714" class="blob-num js-line-number" data-line-number="714"></td>
+        <td id="LC714" class="blob-code blob-code-inner js-file-line">57 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L715" class="blob-num js-line-number" data-line-number="715"></td>
+        <td id="LC715" class="blob-code blob-code-inner js-file-line">57 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L716" class="blob-num js-line-number" data-line-number="716"></td>
+        <td id="LC716" class="blob-code blob-code-inner js-file-line">57 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L717" class="blob-num js-line-number" data-line-number="717"></td>
+        <td id="LC717" class="blob-code blob-code-inner js-file-line">57 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L718" class="blob-num js-line-number" data-line-number="718"></td>
+        <td id="LC718" class="blob-code blob-code-inner js-file-line">57 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L719" class="blob-num js-line-number" data-line-number="719"></td>
+        <td id="LC719" class="blob-code blob-code-inner js-file-line">57 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L720" class="blob-num js-line-number" data-line-number="720"></td>
+        <td id="LC720" class="blob-code blob-code-inner js-file-line">57 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L721" class="blob-num js-line-number" data-line-number="721"></td>
+        <td id="LC721" class="blob-code blob-code-inner js-file-line">57 t 11</td>
+      </tr>
+      <tr>
+        <td id="L722" class="blob-num js-line-number" data-line-number="722"></td>
+        <td id="LC722" class="blob-code blob-code-inner js-file-line">57 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L723" class="blob-num js-line-number" data-line-number="723"></td>
+        <td id="LC723" class="blob-code blob-code-inner js-file-line">57 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L724" class="blob-num js-line-number" data-line-number="724"></td>
+        <td id="LC724" class="blob-code blob-code-inner js-file-line">57 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L725" class="blob-num js-line-number" data-line-number="725"></td>
+        <td id="LC725" class="blob-code blob-code-inner js-file-line">58 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L726" class="blob-num js-line-number" data-line-number="726"></td>
+        <td id="LC726" class="blob-code blob-code-inner js-file-line">58 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L727" class="blob-num js-line-number" data-line-number="727"></td>
+        <td id="LC727" class="blob-code blob-code-inner js-file-line">58 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L728" class="blob-num js-line-number" data-line-number="728"></td>
+        <td id="LC728" class="blob-code blob-code-inner js-file-line">58 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L729" class="blob-num js-line-number" data-line-number="729"></td>
+        <td id="LC729" class="blob-code blob-code-inner js-file-line">58 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L730" class="blob-num js-line-number" data-line-number="730"></td>
+        <td id="LC730" class="blob-code blob-code-inner js-file-line">58 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L731" class="blob-num js-line-number" data-line-number="731"></td>
+        <td id="LC731" class="blob-code blob-code-inner js-file-line">58 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L732" class="blob-num js-line-number" data-line-number="732"></td>
+        <td id="LC732" class="blob-code blob-code-inner js-file-line">58 t 1</td>
+      </tr>
+      <tr>
+        <td id="L733" class="blob-num js-line-number" data-line-number="733"></td>
+        <td id="LC733" class="blob-code blob-code-inner js-file-line">58 t 4</td>
+      </tr>
+      <tr>
+        <td id="L734" class="blob-num js-line-number" data-line-number="734"></td>
+        <td id="LC734" class="blob-code blob-code-inner js-file-line">58 y_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L735" class="blob-num js-line-number" data-line-number="735"></td>
+        <td id="LC735" class="blob-code blob-code-inner js-file-line">58 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L736" class="blob-num js-line-number" data-line-number="736"></td>
+        <td id="LC736" class="blob-code blob-code-inner js-file-line">58 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L737" class="blob-num js-line-number" data-line-number="737"></td>
+        <td id="LC737" class="blob-code blob-code-inner js-file-line">58 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L738" class="blob-num js-line-number" data-line-number="738"></td>
+        <td id="LC738" class="blob-code blob-code-inner js-file-line">58 t 13</td>
+      </tr>
+      <tr>
+        <td id="L739" class="blob-num js-line-number" data-line-number="739"></td>
+        <td id="LC739" class="blob-code blob-code-inner js-file-line">58 t 16</td>
+      </tr>
+      <tr>
+        <td id="L740" class="blob-num js-line-number" data-line-number="740"></td>
+        <td id="LC740" class="blob-code blob-code-inner js-file-line">58 t 17</td>
+      </tr>
+      <tr>
+        <td id="L741" class="blob-num js-line-number" data-line-number="741"></td>
+        <td id="LC741" class="blob-code blob-code-inner js-file-line">58 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L742" class="blob-num js-line-number" data-line-number="742"></td>
+        <td id="LC742" class="blob-code blob-code-inner js-file-line">58 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L743" class="blob-num js-line-number" data-line-number="743"></td>
+        <td id="LC743" class="blob-code blob-code-inner js-file-line">59 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L744" class="blob-num js-line-number" data-line-number="744"></td>
+        <td id="LC744" class="blob-code blob-code-inner js-file-line">59 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L745" class="blob-num js-line-number" data-line-number="745"></td>
+        <td id="LC745" class="blob-code blob-code-inner js-file-line">59 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L746" class="blob-num js-line-number" data-line-number="746"></td>
+        <td id="LC746" class="blob-code blob-code-inner js-file-line">59 t 2</td>
+      </tr>
+      <tr>
+        <td id="L747" class="blob-num js-line-number" data-line-number="747"></td>
+        <td id="LC747" class="blob-code blob-code-inner js-file-line">59 t 3</td>
+      </tr>
+      <tr>
+        <td id="L748" class="blob-num js-line-number" data-line-number="748"></td>
+        <td id="LC748" class="blob-code blob-code-inner js-file-line">59 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L749" class="blob-num js-line-number" data-line-number="749"></td>
+        <td id="LC749" class="blob-code blob-code-inner js-file-line">59 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L750" class="blob-num js-line-number" data-line-number="750"></td>
+        <td id="LC750" class="blob-code blob-code-inner js-file-line">59 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L751" class="blob-num js-line-number" data-line-number="751"></td>
+        <td id="LC751" class="blob-code blob-code-inner js-file-line">59 t 18</td>
+      </tr>
+      <tr>
+        <td id="L752" class="blob-num js-line-number" data-line-number="752"></td>
+        <td id="LC752" class="blob-code blob-code-inner js-file-line">59 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L753" class="blob-num js-line-number" data-line-number="753"></td>
+        <td id="LC753" class="blob-code blob-code-inner js-file-line">59 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L754" class="blob-num js-line-number" data-line-number="754"></td>
+        <td id="LC754" class="blob-code blob-code-inner js-file-line">59 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L755" class="blob-num js-line-number" data-line-number="755"></td>
+        <td id="LC755" class="blob-code blob-code-inner js-file-line">60 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L756" class="blob-num js-line-number" data-line-number="756"></td>
+        <td id="LC756" class="blob-code blob-code-inner js-file-line">60 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L757" class="blob-num js-line-number" data-line-number="757"></td>
+        <td id="LC757" class="blob-code blob-code-inner js-file-line">60 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L758" class="blob-num js-line-number" data-line-number="758"></td>
+        <td id="LC758" class="blob-code blob-code-inner js-file-line">60 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L759" class="blob-num js-line-number" data-line-number="759"></td>
+        <td id="LC759" class="blob-code blob-code-inner js-file-line">60 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L760" class="blob-num js-line-number" data-line-number="760"></td>
+        <td id="LC760" class="blob-code blob-code-inner js-file-line">60 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L761" class="blob-num js-line-number" data-line-number="761"></td>
+        <td id="LC761" class="blob-code blob-code-inner js-file-line">60 x_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L762" class="blob-num js-line-number" data-line-number="762"></td>
+        <td id="LC762" class="blob-code blob-code-inner js-file-line">60 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L763" class="blob-num js-line-number" data-line-number="763"></td>
+        <td id="LC763" class="blob-code blob-code-inner js-file-line">60 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L764" class="blob-num js-line-number" data-line-number="764"></td>
+        <td id="LC764" class="blob-code blob-code-inner js-file-line">61 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L765" class="blob-num js-line-number" data-line-number="765"></td>
+        <td id="LC765" class="blob-code blob-code-inner js-file-line">61 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L766" class="blob-num js-line-number" data-line-number="766"></td>
+        <td id="LC766" class="blob-code blob-code-inner js-file-line">61 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L767" class="blob-num js-line-number" data-line-number="767"></td>
+        <td id="LC767" class="blob-code blob-code-inner js-file-line">61 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L768" class="blob-num js-line-number" data-line-number="768"></td>
+        <td id="LC768" class="blob-code blob-code-inner js-file-line">61 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L769" class="blob-num js-line-number" data-line-number="769"></td>
+        <td id="LC769" class="blob-code blob-code-inner js-file-line">61 t 11</td>
+      </tr>
+      <tr>
+        <td id="L770" class="blob-num js-line-number" data-line-number="770"></td>
+        <td id="LC770" class="blob-code blob-code-inner js-file-line">61 t 15</td>
+      </tr>
+      <tr>
+        <td id="L771" class="blob-num js-line-number" data-line-number="771"></td>
+        <td id="LC771" class="blob-code blob-code-inner js-file-line">61 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L772" class="blob-num js-line-number" data-line-number="772"></td>
+        <td id="LC772" class="blob-code blob-code-inner js-file-line">62 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L773" class="blob-num js-line-number" data-line-number="773"></td>
+        <td id="LC773" class="blob-code blob-code-inner js-file-line">62 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L774" class="blob-num js-line-number" data-line-number="774"></td>
+        <td id="LC774" class="blob-code blob-code-inner js-file-line">62 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L775" class="blob-num js-line-number" data-line-number="775"></td>
+        <td id="LC775" class="blob-code blob-code-inner js-file-line">62 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L776" class="blob-num js-line-number" data-line-number="776"></td>
+        <td id="LC776" class="blob-code blob-code-inner js-file-line">62 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L777" class="blob-num js-line-number" data-line-number="777"></td>
+        <td id="LC777" class="blob-code blob-code-inner js-file-line">62 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L778" class="blob-num js-line-number" data-line-number="778"></td>
+        <td id="LC778" class="blob-code blob-code-inner js-file-line">62 t 9</td>
+      </tr>
+      <tr>
+        <td id="L779" class="blob-num js-line-number" data-line-number="779"></td>
+        <td id="LC779" class="blob-code blob-code-inner js-file-line">62 t 10</td>
+      </tr>
+      <tr>
+        <td id="L780" class="blob-num js-line-number" data-line-number="780"></td>
+        <td id="LC780" class="blob-code blob-code-inner js-file-line">62 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L781" class="blob-num js-line-number" data-line-number="781"></td>
+        <td id="LC781" class="blob-code blob-code-inner js-file-line">62 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L782" class="blob-num js-line-number" data-line-number="782"></td>
+        <td id="LC782" class="blob-code blob-code-inner js-file-line">62 t 21</td>
+      </tr>
+      <tr>
+        <td id="L783" class="blob-num js-line-number" data-line-number="783"></td>
+        <td id="LC783" class="blob-code blob-code-inner js-file-line">62 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L784" class="blob-num js-line-number" data-line-number="784"></td>
+        <td id="LC784" class="blob-code blob-code-inner js-file-line">63 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L785" class="blob-num js-line-number" data-line-number="785"></td>
+        <td id="LC785" class="blob-code blob-code-inner js-file-line">63 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L786" class="blob-num js-line-number" data-line-number="786"></td>
+        <td id="LC786" class="blob-code blob-code-inner js-file-line">63 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L787" class="blob-num js-line-number" data-line-number="787"></td>
+        <td id="LC787" class="blob-code blob-code-inner js-file-line">63 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L788" class="blob-num js-line-number" data-line-number="788"></td>
+        <td id="LC788" class="blob-code blob-code-inner js-file-line">63 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L789" class="blob-num js-line-number" data-line-number="789"></td>
+        <td id="LC789" class="blob-code blob-code-inner js-file-line">63 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L790" class="blob-num js-line-number" data-line-number="790"></td>
+        <td id="LC790" class="blob-code blob-code-inner js-file-line">63 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L791" class="blob-num js-line-number" data-line-number="791"></td>
+        <td id="LC791" class="blob-code blob-code-inner js-file-line">63 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L792" class="blob-num js-line-number" data-line-number="792"></td>
+        <td id="LC792" class="blob-code blob-code-inner js-file-line">63 t 16</td>
+      </tr>
+      <tr>
+        <td id="L793" class="blob-num js-line-number" data-line-number="793"></td>
+        <td id="LC793" class="blob-code blob-code-inner js-file-line">63 t 20</td>
+      </tr>
+      <tr>
+        <td id="L794" class="blob-num js-line-number" data-line-number="794"></td>
+        <td id="LC794" class="blob-code blob-code-inner js-file-line">64 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L795" class="blob-num js-line-number" data-line-number="795"></td>
+        <td id="LC795" class="blob-code blob-code-inner js-file-line">64 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L796" class="blob-num js-line-number" data-line-number="796"></td>
+        <td id="LC796" class="blob-code blob-code-inner js-file-line">64 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L797" class="blob-num js-line-number" data-line-number="797"></td>
+        <td id="LC797" class="blob-code blob-code-inner js-file-line">64 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L798" class="blob-num js-line-number" data-line-number="798"></td>
+        <td id="LC798" class="blob-code blob-code-inner js-file-line">64 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L799" class="blob-num js-line-number" data-line-number="799"></td>
+        <td id="LC799" class="blob-code blob-code-inner js-file-line">64 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L800" class="blob-num js-line-number" data-line-number="800"></td>
+        <td id="LC800" class="blob-code blob-code-inner js-file-line">64 t 0</td>
+      </tr>
+      <tr>
+        <td id="L801" class="blob-num js-line-number" data-line-number="801"></td>
+        <td id="LC801" class="blob-code blob-code-inner js-file-line">64 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L802" class="blob-num js-line-number" data-line-number="802"></td>
+        <td id="LC802" class="blob-code blob-code-inner js-file-line">64 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L803" class="blob-num js-line-number" data-line-number="803"></td>
+        <td id="LC803" class="blob-code blob-code-inner js-file-line">64 x_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L804" class="blob-num js-line-number" data-line-number="804"></td>
+        <td id="LC804" class="blob-code blob-code-inner js-file-line">64 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L805" class="blob-num js-line-number" data-line-number="805"></td>
+        <td id="LC805" class="blob-code blob-code-inner js-file-line">64 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L806" class="blob-num js-line-number" data-line-number="806"></td>
+        <td id="LC806" class="blob-code blob-code-inner js-file-line">64 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L807" class="blob-num js-line-number" data-line-number="807"></td>
+        <td id="LC807" class="blob-code blob-code-inner js-file-line">64 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L808" class="blob-num js-line-number" data-line-number="808"></td>
+        <td id="LC808" class="blob-code blob-code-inner js-file-line">64 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L809" class="blob-num js-line-number" data-line-number="809"></td>
+        <td id="LC809" class="blob-code blob-code-inner js-file-line">64 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L810" class="blob-num js-line-number" data-line-number="810"></td>
+        <td id="LC810" class="blob-code blob-code-inner js-file-line">64 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L811" class="blob-num js-line-number" data-line-number="811"></td>
+        <td id="LC811" class="blob-code blob-code-inner js-file-line">64 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L812" class="blob-num js-line-number" data-line-number="812"></td>
+        <td id="LC812" class="blob-code blob-code-inner js-file-line">65 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L813" class="blob-num js-line-number" data-line-number="813"></td>
+        <td id="LC813" class="blob-code blob-code-inner js-file-line">65 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L814" class="blob-num js-line-number" data-line-number="814"></td>
+        <td id="LC814" class="blob-code blob-code-inner js-file-line">65 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L815" class="blob-num js-line-number" data-line-number="815"></td>
+        <td id="LC815" class="blob-code blob-code-inner js-file-line">65 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L816" class="blob-num js-line-number" data-line-number="816"></td>
+        <td id="LC816" class="blob-code blob-code-inner js-file-line">65 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L817" class="blob-num js-line-number" data-line-number="817"></td>
+        <td id="LC817" class="blob-code blob-code-inner js-file-line">65 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L818" class="blob-num js-line-number" data-line-number="818"></td>
+        <td id="LC818" class="blob-code blob-code-inner js-file-line">65 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L819" class="blob-num js-line-number" data-line-number="819"></td>
+        <td id="LC819" class="blob-code blob-code-inner js-file-line">65 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L820" class="blob-num js-line-number" data-line-number="820"></td>
+        <td id="LC820" class="blob-code blob-code-inner js-file-line">65 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L821" class="blob-num js-line-number" data-line-number="821"></td>
+        <td id="LC821" class="blob-code blob-code-inner js-file-line">65 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L822" class="blob-num js-line-number" data-line-number="822"></td>
+        <td id="LC822" class="blob-code blob-code-inner js-file-line">65 x_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L823" class="blob-num js-line-number" data-line-number="823"></td>
+        <td id="LC823" class="blob-code blob-code-inner js-file-line">65 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L824" class="blob-num js-line-number" data-line-number="824"></td>
+        <td id="LC824" class="blob-code blob-code-inner js-file-line">66 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L825" class="blob-num js-line-number" data-line-number="825"></td>
+        <td id="LC825" class="blob-code blob-code-inner js-file-line">66 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L826" class="blob-num js-line-number" data-line-number="826"></td>
+        <td id="LC826" class="blob-code blob-code-inner js-file-line">66 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L827" class="blob-num js-line-number" data-line-number="827"></td>
+        <td id="LC827" class="blob-code blob-code-inner js-file-line">66 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L828" class="blob-num js-line-number" data-line-number="828"></td>
+        <td id="LC828" class="blob-code blob-code-inner js-file-line">66 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L829" class="blob-num js-line-number" data-line-number="829"></td>
+        <td id="LC829" class="blob-code blob-code-inner js-file-line">66 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L830" class="blob-num js-line-number" data-line-number="830"></td>
+        <td id="LC830" class="blob-code blob-code-inner js-file-line">66 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L831" class="blob-num js-line-number" data-line-number="831"></td>
+        <td id="LC831" class="blob-code blob-code-inner js-file-line">66 y_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L832" class="blob-num js-line-number" data-line-number="832"></td>
+        <td id="LC832" class="blob-code blob-code-inner js-file-line">66 t 4</td>
+      </tr>
+      <tr>
+        <td id="L833" class="blob-num js-line-number" data-line-number="833"></td>
+        <td id="LC833" class="blob-code blob-code-inner js-file-line">66 x_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L834" class="blob-num js-line-number" data-line-number="834"></td>
+        <td id="LC834" class="blob-code blob-code-inner js-file-line">66 t 8</td>
+      </tr>
+      <tr>
+        <td id="L835" class="blob-num js-line-number" data-line-number="835"></td>
+        <td id="LC835" class="blob-code blob-code-inner js-file-line">66 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L836" class="blob-num js-line-number" data-line-number="836"></td>
+        <td id="LC836" class="blob-code blob-code-inner js-file-line">66 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L837" class="blob-num js-line-number" data-line-number="837"></td>
+        <td id="LC837" class="blob-code blob-code-inner js-file-line">66 t 13</td>
+      </tr>
+      <tr>
+        <td id="L838" class="blob-num js-line-number" data-line-number="838"></td>
+        <td id="LC838" class="blob-code blob-code-inner js-file-line">66 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L839" class="blob-num js-line-number" data-line-number="839"></td>
+        <td id="LC839" class="blob-code blob-code-inner js-file-line">66 t 17</td>
+      </tr>
+      <tr>
+        <td id="L840" class="blob-num js-line-number" data-line-number="840"></td>
+        <td id="LC840" class="blob-code blob-code-inner js-file-line">66 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L841" class="blob-num js-line-number" data-line-number="841"></td>
+        <td id="LC841" class="blob-code blob-code-inner js-file-line">66 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L842" class="blob-num js-line-number" data-line-number="842"></td>
+        <td id="LC842" class="blob-code blob-code-inner js-file-line">67 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L843" class="blob-num js-line-number" data-line-number="843"></td>
+        <td id="LC843" class="blob-code blob-code-inner js-file-line">67 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L844" class="blob-num js-line-number" data-line-number="844"></td>
+        <td id="LC844" class="blob-code blob-code-inner js-file-line">67 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L845" class="blob-num js-line-number" data-line-number="845"></td>
+        <td id="LC845" class="blob-code blob-code-inner js-file-line">67 t 2</td>
+      </tr>
+      <tr>
+        <td id="L846" class="blob-num js-line-number" data-line-number="846"></td>
+        <td id="LC846" class="blob-code blob-code-inner js-file-line">67 t 3</td>
+      </tr>
+      <tr>
+        <td id="L847" class="blob-num js-line-number" data-line-number="847"></td>
+        <td id="LC847" class="blob-code blob-code-inner js-file-line">67 t 7</td>
+      </tr>
+      <tr>
+        <td id="L848" class="blob-num js-line-number" data-line-number="848"></td>
+        <td id="LC848" class="blob-code blob-code-inner js-file-line">67 t 11</td>
+      </tr>
+      <tr>
+        <td id="L849" class="blob-num js-line-number" data-line-number="849"></td>
+        <td id="LC849" class="blob-code blob-code-inner js-file-line">67 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L850" class="blob-num js-line-number" data-line-number="850"></td>
+        <td id="LC850" class="blob-code blob-code-inner js-file-line">67 t 18</td>
+      </tr>
+      <tr>
+        <td id="L851" class="blob-num js-line-number" data-line-number="851"></td>
+        <td id="LC851" class="blob-code blob-code-inner js-file-line">67 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L852" class="blob-num js-line-number" data-line-number="852"></td>
+        <td id="LC852" class="blob-code blob-code-inner js-file-line">67 t 22</td>
+      </tr>
+      <tr>
+        <td id="L853" class="blob-num js-line-number" data-line-number="853"></td>
+        <td id="LC853" class="blob-code blob-code-inner js-file-line">67 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L854" class="blob-num js-line-number" data-line-number="854"></td>
+        <td id="LC854" class="blob-code blob-code-inner js-file-line">68 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L855" class="blob-num js-line-number" data-line-number="855"></td>
+        <td id="LC855" class="blob-code blob-code-inner js-file-line">68 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L856" class="blob-num js-line-number" data-line-number="856"></td>
+        <td id="LC856" class="blob-code blob-code-inner js-file-line">68 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L857" class="blob-num js-line-number" data-line-number="857"></td>
+        <td id="LC857" class="blob-code blob-code-inner js-file-line">68 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L858" class="blob-num js-line-number" data-line-number="858"></td>
+        <td id="LC858" class="blob-code blob-code-inner js-file-line">68 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L859" class="blob-num js-line-number" data-line-number="859"></td>
+        <td id="LC859" class="blob-code blob-code-inner js-file-line">68 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L860" class="blob-num js-line-number" data-line-number="860"></td>
+        <td id="LC860" class="blob-code blob-code-inner js-file-line">68 t 12</td>
+      </tr>
+      <tr>
+        <td id="L861" class="blob-num js-line-number" data-line-number="861"></td>
+        <td id="LC861" class="blob-code blob-code-inner js-file-line">68 t 14</td>
+      </tr>
+      <tr>
+        <td id="L862" class="blob-num js-line-number" data-line-number="862"></td>
+        <td id="LC862" class="blob-code blob-code-inner js-file-line">68 t 16</td>
+      </tr>
+      <tr>
+        <td id="L863" class="blob-num js-line-number" data-line-number="863"></td>
+        <td id="LC863" class="blob-code blob-code-inner js-file-line">69 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L864" class="blob-num js-line-number" data-line-number="864"></td>
+        <td id="LC864" class="blob-code blob-code-inner js-file-line">69 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L865" class="blob-num js-line-number" data-line-number="865"></td>
+        <td id="LC865" class="blob-code blob-code-inner js-file-line">69 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L866" class="blob-num js-line-number" data-line-number="866"></td>
+        <td id="LC866" class="blob-code blob-code-inner js-file-line">69 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L867" class="blob-num js-line-number" data-line-number="867"></td>
+        <td id="LC867" class="blob-code blob-code-inner js-file-line">69 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L868" class="blob-num js-line-number" data-line-number="868"></td>
+        <td id="LC868" class="blob-code blob-code-inner js-file-line">69 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L869" class="blob-num js-line-number" data-line-number="869"></td>
+        <td id="LC869" class="blob-code blob-code-inner js-file-line">69 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L870" class="blob-num js-line-number" data-line-number="870"></td>
+        <td id="LC870" class="blob-code blob-code-inner js-file-line">69 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L871" class="blob-num js-line-number" data-line-number="871"></td>
+        <td id="LC871" class="blob-code blob-code-inner js-file-line">70 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L872" class="blob-num js-line-number" data-line-number="872"></td>
+        <td id="LC872" class="blob-code blob-code-inner js-file-line">70 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L873" class="blob-num js-line-number" data-line-number="873"></td>
+        <td id="LC873" class="blob-code blob-code-inner js-file-line">70 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L874" class="blob-num js-line-number" data-line-number="874"></td>
+        <td id="LC874" class="blob-code blob-code-inner js-file-line">70 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L875" class="blob-num js-line-number" data-line-number="875"></td>
+        <td id="LC875" class="blob-code blob-code-inner js-file-line">70 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L876" class="blob-num js-line-number" data-line-number="876"></td>
+        <td id="LC876" class="blob-code blob-code-inner js-file-line">70 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L877" class="blob-num js-line-number" data-line-number="877"></td>
+        <td id="LC877" class="blob-code blob-code-inner js-file-line">70 x_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L878" class="blob-num js-line-number" data-line-number="878"></td>
+        <td id="LC878" class="blob-code blob-code-inner js-file-line">70 t 10</td>
+      </tr>
+      <tr>
+        <td id="L879" class="blob-num js-line-number" data-line-number="879"></td>
+        <td id="LC879" class="blob-code blob-code-inner js-file-line">70 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L880" class="blob-num js-line-number" data-line-number="880"></td>
+        <td id="LC880" class="blob-code blob-code-inner js-file-line">70 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L881" class="blob-num js-line-number" data-line-number="881"></td>
+        <td id="LC881" class="blob-code blob-code-inner js-file-line">70 t 21</td>
+      </tr>
+      <tr>
+        <td id="L882" class="blob-num js-line-number" data-line-number="882"></td>
+        <td id="LC882" class="blob-code blob-code-inner js-file-line">70 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L883" class="blob-num js-line-number" data-line-number="883"></td>
+        <td id="LC883" class="blob-code blob-code-inner js-file-line">71 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L884" class="blob-num js-line-number" data-line-number="884"></td>
+        <td id="LC884" class="blob-code blob-code-inner js-file-line">71 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L885" class="blob-num js-line-number" data-line-number="885"></td>
+        <td id="LC885" class="blob-code blob-code-inner js-file-line">71 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L886" class="blob-num js-line-number" data-line-number="886"></td>
+        <td id="LC886" class="blob-code blob-code-inner js-file-line">71 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L887" class="blob-num js-line-number" data-line-number="887"></td>
+        <td id="LC887" class="blob-code blob-code-inner js-file-line">71 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L888" class="blob-num js-line-number" data-line-number="888"></td>
+        <td id="LC888" class="blob-code blob-code-inner js-file-line">71 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L889" class="blob-num js-line-number" data-line-number="889"></td>
+        <td id="LC889" class="blob-code blob-code-inner js-file-line">71 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L890" class="blob-num js-line-number" data-line-number="890"></td>
+        <td id="LC890" class="blob-code blob-code-inner js-file-line">71 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L891" class="blob-num js-line-number" data-line-number="891"></td>
+        <td id="LC891" class="blob-code blob-code-inner js-file-line">71 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L892" class="blob-num js-line-number" data-line-number="892"></td>
+        <td id="LC892" class="blob-code blob-code-inner js-file-line">71 t 20</td>
+      </tr>
+      <tr>
+        <td id="L893" class="blob-num js-line-number" data-line-number="893"></td>
+        <td id="LC893" class="blob-code blob-code-inner js-file-line">72 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L894" class="blob-num js-line-number" data-line-number="894"></td>
+        <td id="LC894" class="blob-code blob-code-inner js-file-line">72 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L895" class="blob-num js-line-number" data-line-number="895"></td>
+        <td id="LC895" class="blob-code blob-code-inner js-file-line">72 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L896" class="blob-num js-line-number" data-line-number="896"></td>
+        <td id="LC896" class="blob-code blob-code-inner js-file-line">72 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L897" class="blob-num js-line-number" data-line-number="897"></td>
+        <td id="LC897" class="blob-code blob-code-inner js-file-line">72 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L898" class="blob-num js-line-number" data-line-number="898"></td>
+        <td id="LC898" class="blob-code blob-code-inner js-file-line">72 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L899" class="blob-num js-line-number" data-line-number="899"></td>
+        <td id="LC899" class="blob-code blob-code-inner js-file-line">72 t 0</td>
+      </tr>
+      <tr>
+        <td id="L900" class="blob-num js-line-number" data-line-number="900"></td>
+        <td id="LC900" class="blob-code blob-code-inner js-file-line">72 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L901" class="blob-num js-line-number" data-line-number="901"></td>
+        <td id="LC901" class="blob-code blob-code-inner js-file-line">72 x_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L902" class="blob-num js-line-number" data-line-number="902"></td>
+        <td id="LC902" class="blob-code blob-code-inner js-file-line">72 t 6</td>
+      </tr>
+      <tr>
+        <td id="L903" class="blob-num js-line-number" data-line-number="903"></td>
+        <td id="LC903" class="blob-code blob-code-inner js-file-line">72 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L904" class="blob-num js-line-number" data-line-number="904"></td>
+        <td id="LC904" class="blob-code blob-code-inner js-file-line">72 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L905" class="blob-num js-line-number" data-line-number="905"></td>
+        <td id="LC905" class="blob-code blob-code-inner js-file-line">72 t 13</td>
+      </tr>
+      <tr>
+        <td id="L906" class="blob-num js-line-number" data-line-number="906"></td>
+        <td id="LC906" class="blob-code blob-code-inner js-file-line">72 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L907" class="blob-num js-line-number" data-line-number="907"></td>
+        <td id="LC907" class="blob-code blob-code-inner js-file-line">72 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L908" class="blob-num js-line-number" data-line-number="908"></td>
+        <td id="LC908" class="blob-code blob-code-inner js-file-line">72 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L909" class="blob-num js-line-number" data-line-number="909"></td>
+        <td id="LC909" class="blob-code blob-code-inner js-file-line">72 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L910" class="blob-num js-line-number" data-line-number="910"></td>
+        <td id="LC910" class="blob-code blob-code-inner js-file-line">72 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L911" class="blob-num js-line-number" data-line-number="911"></td>
+        <td id="LC911" class="blob-code blob-code-inner js-file-line">73 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L912" class="blob-num js-line-number" data-line-number="912"></td>
+        <td id="LC912" class="blob-code blob-code-inner js-file-line">73 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L913" class="blob-num js-line-number" data-line-number="913"></td>
+        <td id="LC913" class="blob-code blob-code-inner js-file-line">73 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L914" class="blob-num js-line-number" data-line-number="914"></td>
+        <td id="LC914" class="blob-code blob-code-inner js-file-line">73 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L915" class="blob-num js-line-number" data-line-number="915"></td>
+        <td id="LC915" class="blob-code blob-code-inner js-file-line">73 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L916" class="blob-num js-line-number" data-line-number="916"></td>
+        <td id="LC916" class="blob-code blob-code-inner js-file-line">73 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L917" class="blob-num js-line-number" data-line-number="917"></td>
+        <td id="LC917" class="blob-code blob-code-inner js-file-line">73 t 3</td>
+      </tr>
+      <tr>
+        <td id="L918" class="blob-num js-line-number" data-line-number="918"></td>
+        <td id="LC918" class="blob-code blob-code-inner js-file-line">73 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L919" class="blob-num js-line-number" data-line-number="919"></td>
+        <td id="LC919" class="blob-code blob-code-inner js-file-line">73 t 11</td>
+      </tr>
+      <tr>
+        <td id="L920" class="blob-num js-line-number" data-line-number="920"></td>
+        <td id="LC920" class="blob-code blob-code-inner js-file-line">73 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L921" class="blob-num js-line-number" data-line-number="921"></td>
+        <td id="LC921" class="blob-code blob-code-inner js-file-line">73 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L922" class="blob-num js-line-number" data-line-number="922"></td>
+        <td id="LC922" class="blob-code blob-code-inner js-file-line">73 t 22</td>
+      </tr>
+      <tr>
+        <td id="L923" class="blob-num js-line-number" data-line-number="923"></td>
+        <td id="LC923" class="blob-code blob-code-inner js-file-line">74 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L924" class="blob-num js-line-number" data-line-number="924"></td>
+        <td id="LC924" class="blob-code blob-code-inner js-file-line">74 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L925" class="blob-num js-line-number" data-line-number="925"></td>
+        <td id="LC925" class="blob-code blob-code-inner js-file-line">74 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L926" class="blob-num js-line-number" data-line-number="926"></td>
+        <td id="LC926" class="blob-code blob-code-inner js-file-line">74 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L927" class="blob-num js-line-number" data-line-number="927"></td>
+        <td id="LC927" class="blob-code blob-code-inner js-file-line">74 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L928" class="blob-num js-line-number" data-line-number="928"></td>
+        <td id="LC928" class="blob-code blob-code-inner js-file-line">74 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L929" class="blob-num js-line-number" data-line-number="929"></td>
+        <td id="LC929" class="blob-code blob-code-inner js-file-line">74 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L930" class="blob-num js-line-number" data-line-number="930"></td>
+        <td id="LC930" class="blob-code blob-code-inner js-file-line">74 y_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L931" class="blob-num js-line-number" data-line-number="931"></td>
+        <td id="LC931" class="blob-code blob-code-inner js-file-line">74 t 4</td>
+      </tr>
+      <tr>
+        <td id="L932" class="blob-num js-line-number" data-line-number="932"></td>
+        <td id="LC932" class="blob-code blob-code-inner js-file-line">74 y_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L933" class="blob-num js-line-number" data-line-number="933"></td>
+        <td id="LC933" class="blob-code blob-code-inner js-file-line">74 t 8</td>
+      </tr>
+      <tr>
+        <td id="L934" class="blob-num js-line-number" data-line-number="934"></td>
+        <td id="LC934" class="blob-code blob-code-inner js-file-line">74 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L935" class="blob-num js-line-number" data-line-number="935"></td>
+        <td id="LC935" class="blob-code blob-code-inner js-file-line">74 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L936" class="blob-num js-line-number" data-line-number="936"></td>
+        <td id="LC936" class="blob-code blob-code-inner js-file-line">74 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L937" class="blob-num js-line-number" data-line-number="937"></td>
+        <td id="LC937" class="blob-code blob-code-inner js-file-line">74 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L938" class="blob-num js-line-number" data-line-number="938"></td>
+        <td id="LC938" class="blob-code blob-code-inner js-file-line">74 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L939" class="blob-num js-line-number" data-line-number="939"></td>
+        <td id="LC939" class="blob-code blob-code-inner js-file-line">74 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L940" class="blob-num js-line-number" data-line-number="940"></td>
+        <td id="LC940" class="blob-code blob-code-inner js-file-line">74 t 21</td>
+      </tr>
+      <tr>
+        <td id="L941" class="blob-num js-line-number" data-line-number="941"></td>
+        <td id="LC941" class="blob-code blob-code-inner js-file-line">75 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L942" class="blob-num js-line-number" data-line-number="942"></td>
+        <td id="LC942" class="blob-code blob-code-inner js-file-line">75 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L943" class="blob-num js-line-number" data-line-number="943"></td>
+        <td id="LC943" class="blob-code blob-code-inner js-file-line">75 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L944" class="blob-num js-line-number" data-line-number="944"></td>
+        <td id="LC944" class="blob-code blob-code-inner js-file-line">75 t 2</td>
+      </tr>
+      <tr>
+        <td id="L945" class="blob-num js-line-number" data-line-number="945"></td>
+        <td id="LC945" class="blob-code blob-code-inner js-file-line">75 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L946" class="blob-num js-line-number" data-line-number="946"></td>
+        <td id="LC946" class="blob-code blob-code-inner js-file-line">75 t 7</td>
+      </tr>
+      <tr>
+        <td id="L947" class="blob-num js-line-number" data-line-number="947"></td>
+        <td id="LC947" class="blob-code blob-code-inner js-file-line">75 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L948" class="blob-num js-line-number" data-line-number="948"></td>
+        <td id="LC948" class="blob-code blob-code-inner js-file-line">75 t 15</td>
+      </tr>
+      <tr>
+        <td id="L949" class="blob-num js-line-number" data-line-number="949"></td>
+        <td id="LC949" class="blob-code blob-code-inner js-file-line">75 t 18</td>
+      </tr>
+      <tr>
+        <td id="L950" class="blob-num js-line-number" data-line-number="950"></td>
+        <td id="LC950" class="blob-code blob-code-inner js-file-line">75 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L951" class="blob-num js-line-number" data-line-number="951"></td>
+        <td id="LC951" class="blob-code blob-code-inner js-file-line">75 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L952" class="blob-num js-line-number" data-line-number="952"></td>
+        <td id="LC952" class="blob-code blob-code-inner js-file-line">75 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L953" class="blob-num js-line-number" data-line-number="953"></td>
+        <td id="LC953" class="blob-code blob-code-inner js-file-line">76 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L954" class="blob-num js-line-number" data-line-number="954"></td>
+        <td id="LC954" class="blob-code blob-code-inner js-file-line">76 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L955" class="blob-num js-line-number" data-line-number="955"></td>
+        <td id="LC955" class="blob-code blob-code-inner js-file-line">76 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L956" class="blob-num js-line-number" data-line-number="956"></td>
+        <td id="LC956" class="blob-code blob-code-inner js-file-line">76 x_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L957" class="blob-num js-line-number" data-line-number="957"></td>
+        <td id="LC957" class="blob-code blob-code-inner js-file-line">76 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L958" class="blob-num js-line-number" data-line-number="958"></td>
+        <td id="LC958" class="blob-code blob-code-inner js-file-line">76 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L959" class="blob-num js-line-number" data-line-number="959"></td>
+        <td id="LC959" class="blob-code blob-code-inner js-file-line">76 x_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L960" class="blob-num js-line-number" data-line-number="960"></td>
+        <td id="LC960" class="blob-code blob-code-inner js-file-line">76 t 14</td>
+      </tr>
+      <tr>
+        <td id="L961" class="blob-num js-line-number" data-line-number="961"></td>
+        <td id="LC961" class="blob-code blob-code-inner js-file-line">76 t 16</td>
+      </tr>
+      <tr>
+        <td id="L962" class="blob-num js-line-number" data-line-number="962"></td>
+        <td id="LC962" class="blob-code blob-code-inner js-file-line">77 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L963" class="blob-num js-line-number" data-line-number="963"></td>
+        <td id="LC963" class="blob-code blob-code-inner js-file-line">77 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L964" class="blob-num js-line-number" data-line-number="964"></td>
+        <td id="LC964" class="blob-code blob-code-inner js-file-line">77 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L965" class="blob-num js-line-number" data-line-number="965"></td>
+        <td id="LC965" class="blob-code blob-code-inner js-file-line">77 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L966" class="blob-num js-line-number" data-line-number="966"></td>
+        <td id="LC966" class="blob-code blob-code-inner js-file-line">77 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L967" class="blob-num js-line-number" data-line-number="967"></td>
+        <td id="LC967" class="blob-code blob-code-inner js-file-line">77 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L968" class="blob-num js-line-number" data-line-number="968"></td>
+        <td id="LC968" class="blob-code blob-code-inner js-file-line">77 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L969" class="blob-num js-line-number" data-line-number="969"></td>
+        <td id="LC969" class="blob-code blob-code-inner js-file-line">77 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L970" class="blob-num js-line-number" data-line-number="970"></td>
+        <td id="LC970" class="blob-code blob-code-inner js-file-line">78 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L971" class="blob-num js-line-number" data-line-number="971"></td>
+        <td id="LC971" class="blob-code blob-code-inner js-file-line">78 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L972" class="blob-num js-line-number" data-line-number="972"></td>
+        <td id="LC972" class="blob-code blob-code-inner js-file-line">78 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L973" class="blob-num js-line-number" data-line-number="973"></td>
+        <td id="LC973" class="blob-code blob-code-inner js-file-line">78 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L974" class="blob-num js-line-number" data-line-number="974"></td>
+        <td id="LC974" class="blob-code blob-code-inner js-file-line">78 t 1</td>
+      </tr>
+      <tr>
+        <td id="L975" class="blob-num js-line-number" data-line-number="975"></td>
+        <td id="LC975" class="blob-code blob-code-inner js-file-line">78 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L976" class="blob-num js-line-number" data-line-number="976"></td>
+        <td id="LC976" class="blob-code blob-code-inner js-file-line">78 x_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L977" class="blob-num js-line-number" data-line-number="977"></td>
+        <td id="LC977" class="blob-code blob-code-inner js-file-line">78 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L978" class="blob-num js-line-number" data-line-number="978"></td>
+        <td id="LC978" class="blob-code blob-code-inner js-file-line">78 t 13</td>
+      </tr>
+      <tr>
+        <td id="L979" class="blob-num js-line-number" data-line-number="979"></td>
+        <td id="LC979" class="blob-code blob-code-inner js-file-line">78 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L980" class="blob-num js-line-number" data-line-number="980"></td>
+        <td id="LC980" class="blob-code blob-code-inner js-file-line">78 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L981" class="blob-num js-line-number" data-line-number="981"></td>
+        <td id="LC981" class="blob-code blob-code-inner js-file-line">78 t 22</td>
+      </tr>
+      <tr>
+        <td id="L982" class="blob-num js-line-number" data-line-number="982"></td>
+        <td id="LC982" class="blob-code blob-code-inner js-file-line">79 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L983" class="blob-num js-line-number" data-line-number="983"></td>
+        <td id="LC983" class="blob-code blob-code-inner js-file-line">79 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L984" class="blob-num js-line-number" data-line-number="984"></td>
+        <td id="LC984" class="blob-code blob-code-inner js-file-line">79 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L985" class="blob-num js-line-number" data-line-number="985"></td>
+        <td id="LC985" class="blob-code blob-code-inner js-file-line">79 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L986" class="blob-num js-line-number" data-line-number="986"></td>
+        <td id="LC986" class="blob-code blob-code-inner js-file-line">79 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L987" class="blob-num js-line-number" data-line-number="987"></td>
+        <td id="LC987" class="blob-code blob-code-inner js-file-line">79 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L988" class="blob-num js-line-number" data-line-number="988"></td>
+        <td id="LC988" class="blob-code blob-code-inner js-file-line">79 t 3</td>
+      </tr>
+      <tr>
+        <td id="L989" class="blob-num js-line-number" data-line-number="989"></td>
+        <td id="LC989" class="blob-code blob-code-inner js-file-line">79 t 7</td>
+      </tr>
+      <tr>
+        <td id="L990" class="blob-num js-line-number" data-line-number="990"></td>
+        <td id="LC990" class="blob-code blob-code-inner js-file-line">79 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L991" class="blob-num js-line-number" data-line-number="991"></td>
+        <td id="LC991" class="blob-code blob-code-inner js-file-line">79 t 20</td>
+      </tr>
+      <tr>
+        <td id="L992" class="blob-num js-line-number" data-line-number="992"></td>
+        <td id="LC992" class="blob-code blob-code-inner js-file-line">80 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L993" class="blob-num js-line-number" data-line-number="993"></td>
+        <td id="LC993" class="blob-code blob-code-inner js-file-line">80 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L994" class="blob-num js-line-number" data-line-number="994"></td>
+        <td id="LC994" class="blob-code blob-code-inner js-file-line">80 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L995" class="blob-num js-line-number" data-line-number="995"></td>
+        <td id="LC995" class="blob-code blob-code-inner js-file-line">80 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L996" class="blob-num js-line-number" data-line-number="996"></td>
+        <td id="LC996" class="blob-code blob-code-inner js-file-line">80 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L997" class="blob-num js-line-number" data-line-number="997"></td>
+        <td id="LC997" class="blob-code blob-code-inner js-file-line">80 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L998" class="blob-num js-line-number" data-line-number="998"></td>
+        <td id="LC998" class="blob-code blob-code-inner js-file-line">80 t 0</td>
+      </tr>
+      <tr>
+        <td id="L999" class="blob-num js-line-number" data-line-number="999"></td>
+        <td id="LC999" class="blob-code blob-code-inner js-file-line">80 t 2</td>
+      </tr>
+      <tr>
+        <td id="L1000" class="blob-num js-line-number" data-line-number="1000"></td>
+        <td id="LC1000" class="blob-code blob-code-inner js-file-line">80 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L1001" class="blob-num js-line-number" data-line-number="1001"></td>
+        <td id="LC1001" class="blob-code blob-code-inner js-file-line">80 t 6</td>
+      </tr>
+      <tr>
+        <td id="L1002" class="blob-num js-line-number" data-line-number="1002"></td>
+        <td id="LC1002" class="blob-code blob-code-inner js-file-line">80 t 8</td>
+      </tr>
+      <tr>
+        <td id="L1003" class="blob-num js-line-number" data-line-number="1003"></td>
+        <td id="LC1003" class="blob-code blob-code-inner js-file-line">80 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L1004" class="blob-num js-line-number" data-line-number="1004"></td>
+        <td id="LC1004" class="blob-code blob-code-inner js-file-line">80 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L1005" class="blob-num js-line-number" data-line-number="1005"></td>
+        <td id="LC1005" class="blob-code blob-code-inner js-file-line">80 t 15</td>
+      </tr>
+      <tr>
+        <td id="L1006" class="blob-num js-line-number" data-line-number="1006"></td>
+        <td id="LC1006" class="blob-code blob-code-inner js-file-line">80 t 17</td>
+      </tr>
+      <tr>
+        <td id="L1007" class="blob-num js-line-number" data-line-number="1007"></td>
+        <td id="LC1007" class="blob-code blob-code-inner js-file-line">80 t 19</td>
+      </tr>
+      <tr>
+        <td id="L1008" class="blob-num js-line-number" data-line-number="1008"></td>
+        <td id="LC1008" class="blob-code blob-code-inner js-file-line">80 t 21</td>
+      </tr>
+      <tr>
+        <td id="L1009" class="blob-num js-line-number" data-line-number="1009"></td>
+        <td id="LC1009" class="blob-code blob-code-inner js-file-line">80 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L1010" class="blob-num js-line-number" data-line-number="1010"></td>
+        <td id="LC1010" class="blob-code blob-code-inner js-file-line">81 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L1011" class="blob-num js-line-number" data-line-number="1011"></td>
+        <td id="LC1011" class="blob-code blob-code-inner js-file-line">81 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L1012" class="blob-num js-line-number" data-line-number="1012"></td>
+        <td id="LC1012" class="blob-code blob-code-inner js-file-line">81 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L1013" class="blob-num js-line-number" data-line-number="1013"></td>
+        <td id="LC1013" class="blob-code blob-code-inner js-file-line">81 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L1014" class="blob-num js-line-number" data-line-number="1014"></td>
+        <td id="LC1014" class="blob-code blob-code-inner js-file-line">81 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L1015" class="blob-num js-line-number" data-line-number="1015"></td>
+        <td id="LC1015" class="blob-code blob-code-inner js-file-line">81 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L1016" class="blob-num js-line-number" data-line-number="1016"></td>
+        <td id="LC1016" class="blob-code blob-code-inner js-file-line">81 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L1017" class="blob-num js-line-number" data-line-number="1017"></td>
+        <td id="LC1017" class="blob-code blob-code-inner js-file-line">81 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L1018" class="blob-num js-line-number" data-line-number="1018"></td>
+        <td id="LC1018" class="blob-code blob-code-inner js-file-line">81 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L1019" class="blob-num js-line-number" data-line-number="1019"></td>
+        <td id="LC1019" class="blob-code blob-code-inner js-file-line">81 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L1020" class="blob-num js-line-number" data-line-number="1020"></td>
+        <td id="LC1020" class="blob-code blob-code-inner js-file-line">81 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L1021" class="blob-num js-line-number" data-line-number="1021"></td>
+        <td id="LC1021" class="blob-code blob-code-inner js-file-line">81 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L1022" class="blob-num js-line-number" data-line-number="1022"></td>
+        <td id="LC1022" class="blob-code blob-code-inner js-file-line">82 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L1023" class="blob-num js-line-number" data-line-number="1023"></td>
+        <td id="LC1023" class="blob-code blob-code-inner js-file-line">82 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L1024" class="blob-num js-line-number" data-line-number="1024"></td>
+        <td id="LC1024" class="blob-code blob-code-inner js-file-line">82 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L1025" class="blob-num js-line-number" data-line-number="1025"></td>
+        <td id="LC1025" class="blob-code blob-code-inner js-file-line">82 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L1026" class="blob-num js-line-number" data-line-number="1026"></td>
+        <td id="LC1026" class="blob-code blob-code-inner js-file-line">82 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L1027" class="blob-num js-line-number" data-line-number="1027"></td>
+        <td id="LC1027" class="blob-code blob-code-inner js-file-line">82 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L1028" class="blob-num js-line-number" data-line-number="1028"></td>
+        <td id="LC1028" class="blob-code blob-code-inner js-file-line">82 y_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L1029" class="blob-num js-line-number" data-line-number="1029"></td>
+        <td id="LC1029" class="blob-code blob-code-inner js-file-line">82 x_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L1030" class="blob-num js-line-number" data-line-number="1030"></td>
+        <td id="LC1030" class="blob-code blob-code-inner js-file-line">82 t 4</td>
+      </tr>
+      <tr>
+        <td id="L1031" class="blob-num js-line-number" data-line-number="1031"></td>
+        <td id="LC1031" class="blob-code blob-code-inner js-file-line">82 x_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L1032" class="blob-num js-line-number" data-line-number="1032"></td>
+        <td id="LC1032" class="blob-code blob-code-inner js-file-line">82 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L1033" class="blob-num js-line-number" data-line-number="1033"></td>
+        <td id="LC1033" class="blob-code blob-code-inner js-file-line">82 t 9</td>
+      </tr>
+      <tr>
+        <td id="L1034" class="blob-num js-line-number" data-line-number="1034"></td>
+        <td id="LC1034" class="blob-code blob-code-inner js-file-line">82 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L1035" class="blob-num js-line-number" data-line-number="1035"></td>
+        <td id="LC1035" class="blob-code blob-code-inner js-file-line">82 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L1036" class="blob-num js-line-number" data-line-number="1036"></td>
+        <td id="LC1036" class="blob-code blob-code-inner js-file-line">82 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L1037" class="blob-num js-line-number" data-line-number="1037"></td>
+        <td id="LC1037" class="blob-code blob-code-inner js-file-line">82 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L1038" class="blob-num js-line-number" data-line-number="1038"></td>
+        <td id="LC1038" class="blob-code blob-code-inner js-file-line">82 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L1039" class="blob-num js-line-number" data-line-number="1039"></td>
+        <td id="LC1039" class="blob-code blob-code-inner js-file-line">82 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L1040" class="blob-num js-line-number" data-line-number="1040"></td>
+        <td id="LC1040" class="blob-code blob-code-inner js-file-line">83 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L1041" class="blob-num js-line-number" data-line-number="1041"></td>
+        <td id="LC1041" class="blob-code blob-code-inner js-file-line">83 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L1042" class="blob-num js-line-number" data-line-number="1042"></td>
+        <td id="LC1042" class="blob-code blob-code-inner js-file-line">83 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L1043" class="blob-num js-line-number" data-line-number="1043"></td>
+        <td id="LC1043" class="blob-code blob-code-inner js-file-line">83 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L1044" class="blob-num js-line-number" data-line-number="1044"></td>
+        <td id="LC1044" class="blob-code blob-code-inner js-file-line">83 t 3</td>
+      </tr>
+      <tr>
+        <td id="L1045" class="blob-num js-line-number" data-line-number="1045"></td>
+        <td id="LC1045" class="blob-code blob-code-inner js-file-line">83 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L1046" class="blob-num js-line-number" data-line-number="1046"></td>
+        <td id="LC1046" class="blob-code blob-code-inner js-file-line">83 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L1047" class="blob-num js-line-number" data-line-number="1047"></td>
+        <td id="LC1047" class="blob-code blob-code-inner js-file-line">83 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L1048" class="blob-num js-line-number" data-line-number="1048"></td>
+        <td id="LC1048" class="blob-code blob-code-inner js-file-line">83 t 18</td>
+      </tr>
+      <tr>
+        <td id="L1049" class="blob-num js-line-number" data-line-number="1049"></td>
+        <td id="LC1049" class="blob-code blob-code-inner js-file-line">83 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L1050" class="blob-num js-line-number" data-line-number="1050"></td>
+        <td id="LC1050" class="blob-code blob-code-inner js-file-line">83 t 22</td>
+      </tr>
+      <tr>
+        <td id="L1051" class="blob-num js-line-number" data-line-number="1051"></td>
+        <td id="LC1051" class="blob-code blob-code-inner js-file-line">83 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L1052" class="blob-num js-line-number" data-line-number="1052"></td>
+        <td id="LC1052" class="blob-code blob-code-inner js-file-line">84 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L1053" class="blob-num js-line-number" data-line-number="1053"></td>
+        <td id="LC1053" class="blob-code blob-code-inner js-file-line">84 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L1054" class="blob-num js-line-number" data-line-number="1054"></td>
+        <td id="LC1054" class="blob-code blob-code-inner js-file-line">84 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L1055" class="blob-num js-line-number" data-line-number="1055"></td>
+        <td id="LC1055" class="blob-code blob-code-inner js-file-line">84 x_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L1056" class="blob-num js-line-number" data-line-number="1056"></td>
+        <td id="LC1056" class="blob-code blob-code-inner js-file-line">84 t 8</td>
+      </tr>
+      <tr>
+        <td id="L1057" class="blob-num js-line-number" data-line-number="1057"></td>
+        <td id="LC1057" class="blob-code blob-code-inner js-file-line">84 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L1058" class="blob-num js-line-number" data-line-number="1058"></td>
+        <td id="LC1058" class="blob-code blob-code-inner js-file-line">84 t 12</td>
+      </tr>
+      <tr>
+        <td id="L1059" class="blob-num js-line-number" data-line-number="1059"></td>
+        <td id="LC1059" class="blob-code blob-code-inner js-file-line">84 t 14</td>
+      </tr>
+      <tr>
+        <td id="L1060" class="blob-num js-line-number" data-line-number="1060"></td>
+        <td id="LC1060" class="blob-code blob-code-inner js-file-line">84 t 16</td>
+      </tr>
+      <tr>
+        <td id="L1061" class="blob-num js-line-number" data-line-number="1061"></td>
+        <td id="LC1061" class="blob-code blob-code-inner js-file-line">85 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L1062" class="blob-num js-line-number" data-line-number="1062"></td>
+        <td id="LC1062" class="blob-code blob-code-inner js-file-line">85 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L1063" class="blob-num js-line-number" data-line-number="1063"></td>
+        <td id="LC1063" class="blob-code blob-code-inner js-file-line">85 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L1064" class="blob-num js-line-number" data-line-number="1064"></td>
+        <td id="LC1064" class="blob-code blob-code-inner js-file-line">85 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L1065" class="blob-num js-line-number" data-line-number="1065"></td>
+        <td id="LC1065" class="blob-code blob-code-inner js-file-line">85 t 7</td>
+      </tr>
+      <tr>
+        <td id="L1066" class="blob-num js-line-number" data-line-number="1066"></td>
+        <td id="LC1066" class="blob-code blob-code-inner js-file-line">85 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L1067" class="blob-num js-line-number" data-line-number="1067"></td>
+        <td id="LC1067" class="blob-code blob-code-inner js-file-line">85 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L1068" class="blob-num js-line-number" data-line-number="1068"></td>
+        <td id="LC1068" class="blob-code blob-code-inner js-file-line">85 t 17</td>
+      </tr>
+      <tr>
+        <td id="L1069" class="blob-num js-line-number" data-line-number="1069"></td>
+        <td id="LC1069" class="blob-code blob-code-inner js-file-line">86 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L1070" class="blob-num js-line-number" data-line-number="1070"></td>
+        <td id="LC1070" class="blob-code blob-code-inner js-file-line">86 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L1071" class="blob-num js-line-number" data-line-number="1071"></td>
+        <td id="LC1071" class="blob-code blob-code-inner js-file-line">86 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L1072" class="blob-num js-line-number" data-line-number="1072"></td>
+        <td id="LC1072" class="blob-code blob-code-inner js-file-line">86 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L1073" class="blob-num js-line-number" data-line-number="1073"></td>
+        <td id="LC1073" class="blob-code blob-code-inner js-file-line">86 y_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L1074" class="blob-num js-line-number" data-line-number="1074"></td>
+        <td id="LC1074" class="blob-code blob-code-inner js-file-line">86 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L1075" class="blob-num js-line-number" data-line-number="1075"></td>
+        <td id="LC1075" class="blob-code blob-code-inner js-file-line">86 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L1076" class="blob-num js-line-number" data-line-number="1076"></td>
+        <td id="LC1076" class="blob-code blob-code-inner js-file-line">86 t 10</td>
+      </tr>
+      <tr>
+        <td id="L1077" class="blob-num js-line-number" data-line-number="1077"></td>
+        <td id="LC1077" class="blob-code blob-code-inner js-file-line">86 t 13</td>
+      </tr>
+      <tr>
+        <td id="L1078" class="blob-num js-line-number" data-line-number="1078"></td>
+        <td id="LC1078" class="blob-code blob-code-inner js-file-line">86 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L1079" class="blob-num js-line-number" data-line-number="1079"></td>
+        <td id="LC1079" class="blob-code blob-code-inner js-file-line">86 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L1080" class="blob-num js-line-number" data-line-number="1080"></td>
+        <td id="LC1080" class="blob-code blob-code-inner js-file-line">86 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L1081" class="blob-num js-line-number" data-line-number="1081"></td>
+        <td id="LC1081" class="blob-code blob-code-inner js-file-line">87 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L1082" class="blob-num js-line-number" data-line-number="1082"></td>
+        <td id="LC1082" class="blob-code blob-code-inner js-file-line">87 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L1083" class="blob-num js-line-number" data-line-number="1083"></td>
+        <td id="LC1083" class="blob-code blob-code-inner js-file-line">87 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L1084" class="blob-num js-line-number" data-line-number="1084"></td>
+        <td id="LC1084" class="blob-code blob-code-inner js-file-line">87 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L1085" class="blob-num js-line-number" data-line-number="1085"></td>
+        <td id="LC1085" class="blob-code blob-code-inner js-file-line">87 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L1086" class="blob-num js-line-number" data-line-number="1086"></td>
+        <td id="LC1086" class="blob-code blob-code-inner js-file-line">87 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L1087" class="blob-num js-line-number" data-line-number="1087"></td>
+        <td id="LC1087" class="blob-code blob-code-inner js-file-line">87 y_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L1088" class="blob-num js-line-number" data-line-number="1088"></td>
+        <td id="LC1088" class="blob-code blob-code-inner js-file-line">87 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L1089" class="blob-num js-line-number" data-line-number="1089"></td>
+        <td id="LC1089" class="blob-code blob-code-inner js-file-line">87 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L1090" class="blob-num js-line-number" data-line-number="1090"></td>
+        <td id="LC1090" class="blob-code blob-code-inner js-file-line">87 t 20</td>
+      </tr>
+      <tr>
+        <td id="L1091" class="blob-num js-line-number" data-line-number="1091"></td>
+        <td id="LC1091" class="blob-code blob-code-inner js-file-line">88 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L1092" class="blob-num js-line-number" data-line-number="1092"></td>
+        <td id="LC1092" class="blob-code blob-code-inner js-file-line">88 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L1093" class="blob-num js-line-number" data-line-number="1093"></td>
+        <td id="LC1093" class="blob-code blob-code-inner js-file-line">88 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L1094" class="blob-num js-line-number" data-line-number="1094"></td>
+        <td id="LC1094" class="blob-code blob-code-inner js-file-line">88 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L1095" class="blob-num js-line-number" data-line-number="1095"></td>
+        <td id="LC1095" class="blob-code blob-code-inner js-file-line">88 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L1096" class="blob-num js-line-number" data-line-number="1096"></td>
+        <td id="LC1096" class="blob-code blob-code-inner js-file-line">88 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L1097" class="blob-num js-line-number" data-line-number="1097"></td>
+        <td id="LC1097" class="blob-code blob-code-inner js-file-line">88 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L1098" class="blob-num js-line-number" data-line-number="1098"></td>
+        <td id="LC1098" class="blob-code blob-code-inner js-file-line">88 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L1099" class="blob-num js-line-number" data-line-number="1099"></td>
+        <td id="LC1099" class="blob-code blob-code-inner js-file-line">88 x_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L1100" class="blob-num js-line-number" data-line-number="1100"></td>
+        <td id="LC1100" class="blob-code blob-code-inner js-file-line">88 t 6</td>
+      </tr>
+      <tr>
+        <td id="L1101" class="blob-num js-line-number" data-line-number="1101"></td>
+        <td id="LC1101" class="blob-code blob-code-inner js-file-line">88 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L1102" class="blob-num js-line-number" data-line-number="1102"></td>
+        <td id="LC1102" class="blob-code blob-code-inner js-file-line">88 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L1103" class="blob-num js-line-number" data-line-number="1103"></td>
+        <td id="LC1103" class="blob-code blob-code-inner js-file-line">88 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L1104" class="blob-num js-line-number" data-line-number="1104"></td>
+        <td id="LC1104" class="blob-code blob-code-inner js-file-line">88 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L1105" class="blob-num js-line-number" data-line-number="1105"></td>
+        <td id="LC1105" class="blob-code blob-code-inner js-file-line">88 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L1106" class="blob-num js-line-number" data-line-number="1106"></td>
+        <td id="LC1106" class="blob-code blob-code-inner js-file-line">88 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L1107" class="blob-num js-line-number" data-line-number="1107"></td>
+        <td id="LC1107" class="blob-code blob-code-inner js-file-line">88 y_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L1108" class="blob-num js-line-number" data-line-number="1108"></td>
+        <td id="LC1108" class="blob-code blob-code-inner js-file-line">88 t 23</td>
+      </tr>
+      <tr>
+        <td id="L1109" class="blob-num js-line-number" data-line-number="1109"></td>
+        <td id="LC1109" class="blob-code blob-code-inner js-file-line">89 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L1110" class="blob-num js-line-number" data-line-number="1110"></td>
+        <td id="LC1110" class="blob-code blob-code-inner js-file-line">89 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L1111" class="blob-num js-line-number" data-line-number="1111"></td>
+        <td id="LC1111" class="blob-code blob-code-inner js-file-line">89 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L1112" class="blob-num js-line-number" data-line-number="1112"></td>
+        <td id="LC1112" class="blob-code blob-code-inner js-file-line">89 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L1113" class="blob-num js-line-number" data-line-number="1113"></td>
+        <td id="LC1113" class="blob-code blob-code-inner js-file-line">89 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L1114" class="blob-num js-line-number" data-line-number="1114"></td>
+        <td id="LC1114" class="blob-code blob-code-inner js-file-line">89 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L1115" class="blob-num js-line-number" data-line-number="1115"></td>
+        <td id="LC1115" class="blob-code blob-code-inner js-file-line">89 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L1116" class="blob-num js-line-number" data-line-number="1116"></td>
+        <td id="LC1116" class="blob-code blob-code-inner js-file-line">89 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L1117" class="blob-num js-line-number" data-line-number="1117"></td>
+        <td id="LC1117" class="blob-code blob-code-inner js-file-line">89 y_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L1118" class="blob-num js-line-number" data-line-number="1118"></td>
+        <td id="LC1118" class="blob-code blob-code-inner js-file-line">89 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L1119" class="blob-num js-line-number" data-line-number="1119"></td>
+        <td id="LC1119" class="blob-code blob-code-inner js-file-line">89 x_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L1120" class="blob-num js-line-number" data-line-number="1120"></td>
+        <td id="LC1120" class="blob-code blob-code-inner js-file-line">89 t 22</td>
+      </tr>
+      <tr>
+        <td id="L1121" class="blob-num js-line-number" data-line-number="1121"></td>
+        <td id="LC1121" class="blob-code blob-code-inner js-file-line">90 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L1122" class="blob-num js-line-number" data-line-number="1122"></td>
+        <td id="LC1122" class="blob-code blob-code-inner js-file-line">90 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L1123" class="blob-num js-line-number" data-line-number="1123"></td>
+        <td id="LC1123" class="blob-code blob-code-inner js-file-line">90 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L1124" class="blob-num js-line-number" data-line-number="1124"></td>
+        <td id="LC1124" class="blob-code blob-code-inner js-file-line">90 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L1125" class="blob-num js-line-number" data-line-number="1125"></td>
+        <td id="LC1125" class="blob-code blob-code-inner js-file-line">90 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L1126" class="blob-num js-line-number" data-line-number="1126"></td>
+        <td id="LC1126" class="blob-code blob-code-inner js-file-line">90 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L1127" class="blob-num js-line-number" data-line-number="1127"></td>
+        <td id="LC1127" class="blob-code blob-code-inner js-file-line">90 t 0</td>
+      </tr>
+      <tr>
+        <td id="L1128" class="blob-num js-line-number" data-line-number="1128"></td>
+        <td id="LC1128" class="blob-code blob-code-inner js-file-line">90 t 1</td>
+      </tr>
+      <tr>
+        <td id="L1129" class="blob-num js-line-number" data-line-number="1129"></td>
+        <td id="LC1129" class="blob-code blob-code-inner js-file-line">90 t 4</td>
+      </tr>
+      <tr>
+        <td id="L1130" class="blob-num js-line-number" data-line-number="1130"></td>
+        <td id="LC1130" class="blob-code blob-code-inner js-file-line">90 t 5</td>
+      </tr>
+      <tr>
+        <td id="L1131" class="blob-num js-line-number" data-line-number="1131"></td>
+        <td id="LC1131" class="blob-code blob-code-inner js-file-line">90 t 8</td>
+      </tr>
+      <tr>
+        <td id="L1132" class="blob-num js-line-number" data-line-number="1132"></td>
+        <td id="LC1132" class="blob-code blob-code-inner js-file-line">90 t 9</td>
+      </tr>
+      <tr>
+        <td id="L1133" class="blob-num js-line-number" data-line-number="1133"></td>
+        <td id="LC1133" class="blob-code blob-code-inner js-file-line">90 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L1134" class="blob-num js-line-number" data-line-number="1134"></td>
+        <td id="LC1134" class="blob-code blob-code-inner js-file-line">90 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L1135" class="blob-num js-line-number" data-line-number="1135"></td>
+        <td id="LC1135" class="blob-code blob-code-inner js-file-line">90 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L1136" class="blob-num js-line-number" data-line-number="1136"></td>
+        <td id="LC1136" class="blob-code blob-code-inner js-file-line">90 x_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L1137" class="blob-num js-line-number" data-line-number="1137"></td>
+        <td id="LC1137" class="blob-code blob-code-inner js-file-line">90 x_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L1138" class="blob-num js-line-number" data-line-number="1138"></td>
+        <td id="LC1138" class="blob-code blob-code-inner js-file-line">90 t 21</td>
+      </tr>
+      <tr>
+        <td id="L1139" class="blob-num js-line-number" data-line-number="1139"></td>
+        <td id="LC1139" class="blob-code blob-code-inner js-file-line">91 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L1140" class="blob-num js-line-number" data-line-number="1140"></td>
+        <td id="LC1140" class="blob-code blob-code-inner js-file-line">91 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L1141" class="blob-num js-line-number" data-line-number="1141"></td>
+        <td id="LC1141" class="blob-code blob-code-inner js-file-line">91 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L1142" class="blob-num js-line-number" data-line-number="1142"></td>
+        <td id="LC1142" class="blob-code blob-code-inner js-file-line">91 t 2</td>
+      </tr>
+      <tr>
+        <td id="L1143" class="blob-num js-line-number" data-line-number="1143"></td>
+        <td id="LC1143" class="blob-code blob-code-inner js-file-line">91 t 3</td>
+      </tr>
+      <tr>
+        <td id="L1144" class="blob-num js-line-number" data-line-number="1144"></td>
+        <td id="LC1144" class="blob-code blob-code-inner js-file-line">91 t 7</td>
+      </tr>
+      <tr>
+        <td id="L1145" class="blob-num js-line-number" data-line-number="1145"></td>
+        <td id="LC1145" class="blob-code blob-code-inner js-file-line">91 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L1146" class="blob-num js-line-number" data-line-number="1146"></td>
+        <td id="LC1146" class="blob-code blob-code-inner js-file-line">91 t 15</td>
+      </tr>
+      <tr>
+        <td id="L1147" class="blob-num js-line-number" data-line-number="1147"></td>
+        <td id="LC1147" class="blob-code blob-code-inner js-file-line">91 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L1148" class="blob-num js-line-number" data-line-number="1148"></td>
+        <td id="LC1148" class="blob-code blob-code-inner js-file-line">91 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L1149" class="blob-num js-line-number" data-line-number="1149"></td>
+        <td id="LC1149" class="blob-code blob-code-inner js-file-line">91 y_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L1150" class="blob-num js-line-number" data-line-number="1150"></td>
+        <td id="LC1150" class="blob-code blob-code-inner js-file-line">91 y_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L1151" class="blob-num js-line-number" data-line-number="1151"></td>
+        <td id="LC1151" class="blob-code blob-code-inner js-file-line">92 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L1152" class="blob-num js-line-number" data-line-number="1152"></td>
+        <td id="LC1152" class="blob-code blob-code-inner js-file-line">92 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L1153" class="blob-num js-line-number" data-line-number="1153"></td>
+        <td id="LC1153" class="blob-code blob-code-inner js-file-line">92 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L1154" class="blob-num js-line-number" data-line-number="1154"></td>
+        <td id="LC1154" class="blob-code blob-code-inner js-file-line">92 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L1155" class="blob-num js-line-number" data-line-number="1155"></td>
+        <td id="LC1155" class="blob-code blob-code-inner js-file-line">92 x_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L1156" class="blob-num js-line-number" data-line-number="1156"></td>
+        <td id="LC1156" class="blob-code blob-code-inner js-file-line">92 t 10</td>
+      </tr>
+      <tr>
+        <td id="L1157" class="blob-num js-line-number" data-line-number="1157"></td>
+        <td id="LC1157" class="blob-code blob-code-inner js-file-line">92 t 12</td>
+      </tr>
+      <tr>
+        <td id="L1158" class="blob-num js-line-number" data-line-number="1158"></td>
+        <td id="LC1158" class="blob-code blob-code-inner js-file-line">92 t 14</td>
+      </tr>
+      <tr>
+        <td id="L1159" class="blob-num js-line-number" data-line-number="1159"></td>
+        <td id="LC1159" class="blob-code blob-code-inner js-file-line">92 x_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L1160" class="blob-num js-line-number" data-line-number="1160"></td>
+        <td id="LC1160" class="blob-code blob-code-inner js-file-line">93 cz 1 2</td>
+      </tr>
+      <tr>
+        <td id="L1161" class="blob-num js-line-number" data-line-number="1161"></td>
+        <td id="LC1161" class="blob-code blob-code-inner js-file-line">93 cz 9 10</td>
+      </tr>
+      <tr>
+        <td id="L1162" class="blob-num js-line-number" data-line-number="1162"></td>
+        <td id="LC1162" class="blob-code blob-code-inner js-file-line">93 cz 13 14</td>
+      </tr>
+      <tr>
+        <td id="L1163" class="blob-num js-line-number" data-line-number="1163"></td>
+        <td id="LC1163" class="blob-code blob-code-inner js-file-line">93 cz 21 22</td>
+      </tr>
+      <tr>
+        <td id="L1164" class="blob-num js-line-number" data-line-number="1164"></td>
+        <td id="LC1164" class="blob-code blob-code-inner js-file-line">93 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L1165" class="blob-num js-line-number" data-line-number="1165"></td>
+        <td id="LC1165" class="blob-code blob-code-inner js-file-line">93 t 11</td>
+      </tr>
+      <tr>
+        <td id="L1166" class="blob-num js-line-number" data-line-number="1166"></td>
+        <td id="LC1166" class="blob-code blob-code-inner js-file-line">93 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L1167" class="blob-num js-line-number" data-line-number="1167"></td>
+        <td id="LC1167" class="blob-code blob-code-inner js-file-line">93 t 17</td>
+      </tr>
+      <tr>
+        <td id="L1168" class="blob-num js-line-number" data-line-number="1168"></td>
+        <td id="LC1168" class="blob-code blob-code-inner js-file-line">94 cz 3 4</td>
+      </tr>
+      <tr>
+        <td id="L1169" class="blob-num js-line-number" data-line-number="1169"></td>
+        <td id="LC1169" class="blob-code blob-code-inner js-file-line">94 cz 7 8</td>
+      </tr>
+      <tr>
+        <td id="L1170" class="blob-num js-line-number" data-line-number="1170"></td>
+        <td id="LC1170" class="blob-code blob-code-inner js-file-line">94 cz 15 16</td>
+      </tr>
+      <tr>
+        <td id="L1171" class="blob-num js-line-number" data-line-number="1171"></td>
+        <td id="LC1171" class="blob-code blob-code-inner js-file-line">94 cz 19 20</td>
+      </tr>
+      <tr>
+        <td id="L1172" class="blob-num js-line-number" data-line-number="1172"></td>
+        <td id="LC1172" class="blob-code blob-code-inner js-file-line">94 y_1_2 1</td>
+      </tr>
+      <tr>
+        <td id="L1173" class="blob-num js-line-number" data-line-number="1173"></td>
+        <td id="LC1173" class="blob-code blob-code-inner js-file-line">94 x_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L1174" class="blob-num js-line-number" data-line-number="1174"></td>
+        <td id="LC1174" class="blob-code blob-code-inner js-file-line">94 x_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L1175" class="blob-num js-line-number" data-line-number="1175"></td>
+        <td id="LC1175" class="blob-code blob-code-inner js-file-line">94 y_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L1176" class="blob-num js-line-number" data-line-number="1176"></td>
+        <td id="LC1176" class="blob-code blob-code-inner js-file-line">94 y_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L1177" class="blob-num js-line-number" data-line-number="1177"></td>
+        <td id="LC1177" class="blob-code blob-code-inner js-file-line">94 x_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L1178" class="blob-num js-line-number" data-line-number="1178"></td>
+        <td id="LC1178" class="blob-code blob-code-inner js-file-line">94 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L1179" class="blob-num js-line-number" data-line-number="1179"></td>
+        <td id="LC1179" class="blob-code blob-code-inner js-file-line">94 t 22</td>
+      </tr>
+      <tr>
+        <td id="L1180" class="blob-num js-line-number" data-line-number="1180"></td>
+        <td id="LC1180" class="blob-code blob-code-inner js-file-line">95 cz 0 6</td>
+      </tr>
+      <tr>
+        <td id="L1181" class="blob-num js-line-number" data-line-number="1181"></td>
+        <td id="LC1181" class="blob-code blob-code-inner js-file-line">95 cz 2 8</td>
+      </tr>
+      <tr>
+        <td id="L1182" class="blob-num js-line-number" data-line-number="1182"></td>
+        <td id="LC1182" class="blob-code blob-code-inner js-file-line">95 cz 4 10</td>
+      </tr>
+      <tr>
+        <td id="L1183" class="blob-num js-line-number" data-line-number="1183"></td>
+        <td id="LC1183" class="blob-code blob-code-inner js-file-line">95 cz 13 19</td>
+      </tr>
+      <tr>
+        <td id="L1184" class="blob-num js-line-number" data-line-number="1184"></td>
+        <td id="LC1184" class="blob-code blob-code-inner js-file-line">95 cz 15 21</td>
+      </tr>
+      <tr>
+        <td id="L1185" class="blob-num js-line-number" data-line-number="1185"></td>
+        <td id="LC1185" class="blob-code blob-code-inner js-file-line">95 cz 17 23</td>
+      </tr>
+      <tr>
+        <td id="L1186" class="blob-num js-line-number" data-line-number="1186"></td>
+        <td id="LC1186" class="blob-code blob-code-inner js-file-line">95 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L1187" class="blob-num js-line-number" data-line-number="1187"></td>
+        <td id="LC1187" class="blob-code blob-code-inner js-file-line">95 t 7</td>
+      </tr>
+      <tr>
+        <td id="L1188" class="blob-num js-line-number" data-line-number="1188"></td>
+        <td id="LC1188" class="blob-code blob-code-inner js-file-line">95 y_1_2 16</td>
+      </tr>
+      <tr>
+        <td id="L1189" class="blob-num js-line-number" data-line-number="1189"></td>
+        <td id="LC1189" class="blob-code blob-code-inner js-file-line">95 t 20</td>
+      </tr>
+      <tr>
+        <td id="L1190" class="blob-num js-line-number" data-line-number="1190"></td>
+        <td id="LC1190" class="blob-code blob-code-inner js-file-line">96 cz 1 7</td>
+      </tr>
+      <tr>
+        <td id="L1191" class="blob-num js-line-number" data-line-number="1191"></td>
+        <td id="LC1191" class="blob-code blob-code-inner js-file-line">96 cz 3 9</td>
+      </tr>
+      <tr>
+        <td id="L1192" class="blob-num js-line-number" data-line-number="1192"></td>
+        <td id="LC1192" class="blob-code blob-code-inner js-file-line">96 cz 5 11</td>
+      </tr>
+      <tr>
+        <td id="L1193" class="blob-num js-line-number" data-line-number="1193"></td>
+        <td id="LC1193" class="blob-code blob-code-inner js-file-line">96 cz 12 18</td>
+      </tr>
+      <tr>
+        <td id="L1194" class="blob-num js-line-number" data-line-number="1194"></td>
+        <td id="LC1194" class="blob-code blob-code-inner js-file-line">96 cz 14 20</td>
+      </tr>
+      <tr>
+        <td id="L1195" class="blob-num js-line-number" data-line-number="1195"></td>
+        <td id="LC1195" class="blob-code blob-code-inner js-file-line">96 cz 16 22</td>
+      </tr>
+      <tr>
+        <td id="L1196" class="blob-num js-line-number" data-line-number="1196"></td>
+        <td id="LC1196" class="blob-code blob-code-inner js-file-line">96 x_1_2 0</td>
+      </tr>
+      <tr>
+        <td id="L1197" class="blob-num js-line-number" data-line-number="1197"></td>
+        <td id="LC1197" class="blob-code blob-code-inner js-file-line">96 t 2</td>
+      </tr>
+      <tr>
+        <td id="L1198" class="blob-num js-line-number" data-line-number="1198"></td>
+        <td id="LC1198" class="blob-code blob-code-inner js-file-line">96 y_1_2 4</td>
+      </tr>
+      <tr>
+        <td id="L1199" class="blob-num js-line-number" data-line-number="1199"></td>
+        <td id="LC1199" class="blob-code blob-code-inner js-file-line">96 x_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L1200" class="blob-num js-line-number" data-line-number="1200"></td>
+        <td id="LC1200" class="blob-code blob-code-inner js-file-line">96 t 8</td>
+      </tr>
+      <tr>
+        <td id="L1201" class="blob-num js-line-number" data-line-number="1201"></td>
+        <td id="LC1201" class="blob-code blob-code-inner js-file-line">96 x_1_2 10</td>
+      </tr>
+      <tr>
+        <td id="L1202" class="blob-num js-line-number" data-line-number="1202"></td>
+        <td id="LC1202" class="blob-code blob-code-inner js-file-line">96 x_1_2 13</td>
+      </tr>
+      <tr>
+        <td id="L1203" class="blob-num js-line-number" data-line-number="1203"></td>
+        <td id="LC1203" class="blob-code blob-code-inner js-file-line">96 x_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L1204" class="blob-num js-line-number" data-line-number="1204"></td>
+        <td id="LC1204" class="blob-code blob-code-inner js-file-line">96 y_1_2 17</td>
+      </tr>
+      <tr>
+        <td id="L1205" class="blob-num js-line-number" data-line-number="1205"></td>
+        <td id="LC1205" class="blob-code blob-code-inner js-file-line">96 x_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L1206" class="blob-num js-line-number" data-line-number="1206"></td>
+        <td id="LC1206" class="blob-code blob-code-inner js-file-line">96 t 21</td>
+      </tr>
+      <tr>
+        <td id="L1207" class="blob-num js-line-number" data-line-number="1207"></td>
+        <td id="LC1207" class="blob-code blob-code-inner js-file-line">96 x_1_2 23</td>
+      </tr>
+      <tr>
+        <td id="L1208" class="blob-num js-line-number" data-line-number="1208"></td>
+        <td id="LC1208" class="blob-code blob-code-inner js-file-line">97 cz 0 1</td>
+      </tr>
+      <tr>
+        <td id="L1209" class="blob-num js-line-number" data-line-number="1209"></td>
+        <td id="LC1209" class="blob-code blob-code-inner js-file-line">97 cz 4 5</td>
+      </tr>
+      <tr>
+        <td id="L1210" class="blob-num js-line-number" data-line-number="1210"></td>
+        <td id="LC1210" class="blob-code blob-code-inner js-file-line">97 cz 8 9</td>
+      </tr>
+      <tr>
+        <td id="L1211" class="blob-num js-line-number" data-line-number="1211"></td>
+        <td id="LC1211" class="blob-code blob-code-inner js-file-line">97 cz 12 13</td>
+      </tr>
+      <tr>
+        <td id="L1212" class="blob-num js-line-number" data-line-number="1212"></td>
+        <td id="LC1212" class="blob-code blob-code-inner js-file-line">97 cz 16 17</td>
+      </tr>
+      <tr>
+        <td id="L1213" class="blob-num js-line-number" data-line-number="1213"></td>
+        <td id="LC1213" class="blob-code blob-code-inner js-file-line">97 cz 20 21</td>
+      </tr>
+      <tr>
+        <td id="L1214" class="blob-num js-line-number" data-line-number="1214"></td>
+        <td id="LC1214" class="blob-code blob-code-inner js-file-line">97 t 3</td>
+      </tr>
+      <tr>
+        <td id="L1215" class="blob-num js-line-number" data-line-number="1215"></td>
+        <td id="LC1215" class="blob-code blob-code-inner js-file-line">97 y_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L1216" class="blob-num js-line-number" data-line-number="1216"></td>
+        <td id="LC1216" class="blob-code blob-code-inner js-file-line">97 x_1_2 11</td>
+      </tr>
+      <tr>
+        <td id="L1217" class="blob-num js-line-number" data-line-number="1217"></td>
+        <td id="LC1217" class="blob-code blob-code-inner js-file-line">97 t 14</td>
+      </tr>
+      <tr>
+        <td id="L1218" class="blob-num js-line-number" data-line-number="1218"></td>
+        <td id="LC1218" class="blob-code blob-code-inner js-file-line">97 t 18</td>
+      </tr>
+      <tr>
+        <td id="L1219" class="blob-num js-line-number" data-line-number="1219"></td>
+        <td id="LC1219" class="blob-code blob-code-inner js-file-line">97 x_1_2 22</td>
+      </tr>
+      <tr>
+        <td id="L1220" class="blob-num js-line-number" data-line-number="1220"></td>
+        <td id="LC1220" class="blob-code blob-code-inner js-file-line">98 cz 2 3</td>
+      </tr>
+      <tr>
+        <td id="L1221" class="blob-num js-line-number" data-line-number="1221"></td>
+        <td id="LC1221" class="blob-code blob-code-inner js-file-line">98 cz 6 7</td>
+      </tr>
+      <tr>
+        <td id="L1222" class="blob-num js-line-number" data-line-number="1222"></td>
+        <td id="LC1222" class="blob-code blob-code-inner js-file-line">98 cz 10 11</td>
+      </tr>
+      <tr>
+        <td id="L1223" class="blob-num js-line-number" data-line-number="1223"></td>
+        <td id="LC1223" class="blob-code blob-code-inner js-file-line">98 cz 14 15</td>
+      </tr>
+      <tr>
+        <td id="L1224" class="blob-num js-line-number" data-line-number="1224"></td>
+        <td id="LC1224" class="blob-code blob-code-inner js-file-line">98 cz 18 19</td>
+      </tr>
+      <tr>
+        <td id="L1225" class="blob-num js-line-number" data-line-number="1225"></td>
+        <td id="LC1225" class="blob-code blob-code-inner js-file-line">98 cz 22 23</td>
+      </tr>
+      <tr>
+        <td id="L1226" class="blob-num js-line-number" data-line-number="1226"></td>
+        <td id="LC1226" class="blob-code blob-code-inner js-file-line">98 t 0</td>
+      </tr>
+      <tr>
+        <td id="L1227" class="blob-num js-line-number" data-line-number="1227"></td>
+        <td id="LC1227" class="blob-code blob-code-inner js-file-line">98 t 1</td>
+      </tr>
+      <tr>
+        <td id="L1228" class="blob-num js-line-number" data-line-number="1228"></td>
+        <td id="LC1228" class="blob-code blob-code-inner js-file-line">98 t 4</td>
+      </tr>
+      <tr>
+        <td id="L1229" class="blob-num js-line-number" data-line-number="1229"></td>
+        <td id="LC1229" class="blob-code blob-code-inner js-file-line">98 y_1_2 5</td>
+      </tr>
+      <tr>
+        <td id="L1230" class="blob-num js-line-number" data-line-number="1230"></td>
+        <td id="LC1230" class="blob-code blob-code-inner js-file-line">98 y_1_2 8</td>
+      </tr>
+      <tr>
+        <td id="L1231" class="blob-num js-line-number" data-line-number="1231"></td>
+        <td id="LC1231" class="blob-code blob-code-inner js-file-line">98 y_1_2 9</td>
+      </tr>
+      <tr>
+        <td id="L1232" class="blob-num js-line-number" data-line-number="1232"></td>
+        <td id="LC1232" class="blob-code blob-code-inner js-file-line">98 x_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L1233" class="blob-num js-line-number" data-line-number="1233"></td>
+        <td id="LC1233" class="blob-code blob-code-inner js-file-line">98 t 13</td>
+      </tr>
+      <tr>
+        <td id="L1234" class="blob-num js-line-number" data-line-number="1234"></td>
+        <td id="LC1234" class="blob-code blob-code-inner js-file-line">98 t 16</td>
+      </tr>
+      <tr>
+        <td id="L1235" class="blob-num js-line-number" data-line-number="1235"></td>
+        <td id="LC1235" class="blob-code blob-code-inner js-file-line">98 t 17</td>
+      </tr>
+      <tr>
+        <td id="L1236" class="blob-num js-line-number" data-line-number="1236"></td>
+        <td id="LC1236" class="blob-code blob-code-inner js-file-line">98 y_1_2 20</td>
+      </tr>
+      <tr>
+        <td id="L1237" class="blob-num js-line-number" data-line-number="1237"></td>
+        <td id="LC1237" class="blob-code blob-code-inner js-file-line">98 x_1_2 21</td>
+      </tr>
+      <tr>
+        <td id="L1238" class="blob-num js-line-number" data-line-number="1238"></td>
+        <td id="LC1238" class="blob-code blob-code-inner js-file-line">99 cz 6 12</td>
+      </tr>
+      <tr>
+        <td id="L1239" class="blob-num js-line-number" data-line-number="1239"></td>
+        <td id="LC1239" class="blob-code blob-code-inner js-file-line">99 cz 8 14</td>
+      </tr>
+      <tr>
+        <td id="L1240" class="blob-num js-line-number" data-line-number="1240"></td>
+        <td id="LC1240" class="blob-code blob-code-inner js-file-line">99 cz 10 16</td>
+      </tr>
+      <tr>
+        <td id="L1241" class="blob-num js-line-number" data-line-number="1241"></td>
+        <td id="LC1241" class="blob-code blob-code-inner js-file-line">99 y_1_2 2</td>
+      </tr>
+      <tr>
+        <td id="L1242" class="blob-num js-line-number" data-line-number="1242"></td>
+        <td id="LC1242" class="blob-code blob-code-inner js-file-line">99 x_1_2 3</td>
+      </tr>
+      <tr>
+        <td id="L1243" class="blob-num js-line-number" data-line-number="1243"></td>
+        <td id="LC1243" class="blob-code blob-code-inner js-file-line">99 x_1_2 7</td>
+      </tr>
+      <tr>
+        <td id="L1244" class="blob-num js-line-number" data-line-number="1244"></td>
+        <td id="LC1244" class="blob-code blob-code-inner js-file-line">99 t 11</td>
+      </tr>
+      <tr>
+        <td id="L1245" class="blob-num js-line-number" data-line-number="1245"></td>
+        <td id="LC1245" class="blob-code blob-code-inner js-file-line">99 y_1_2 15</td>
+      </tr>
+      <tr>
+        <td id="L1246" class="blob-num js-line-number" data-line-number="1246"></td>
+        <td id="LC1246" class="blob-code blob-code-inner js-file-line">99 y_1_2 18</td>
+      </tr>
+      <tr>
+        <td id="L1247" class="blob-num js-line-number" data-line-number="1247"></td>
+        <td id="LC1247" class="blob-code blob-code-inner js-file-line">99 y_1_2 19</td>
+      </tr>
+      <tr>
+        <td id="L1248" class="blob-num js-line-number" data-line-number="1248"></td>
+        <td id="LC1248" class="blob-code blob-code-inner js-file-line">99 t 22</td>
+      </tr>
+      <tr>
+        <td id="L1249" class="blob-num js-line-number" data-line-number="1249"></td>
+        <td id="LC1249" class="blob-code blob-code-inner js-file-line">99 t 23</td>
+      </tr>
+      <tr>
+        <td id="L1250" class="blob-num js-line-number" data-line-number="1250"></td>
+        <td id="LC1250" class="blob-code blob-code-inner js-file-line">100 cz 7 13</td>
+      </tr>
+      <tr>
+        <td id="L1251" class="blob-num js-line-number" data-line-number="1251"></td>
+        <td id="LC1251" class="blob-code blob-code-inner js-file-line">100 cz 9 15</td>
+      </tr>
+      <tr>
+        <td id="L1252" class="blob-num js-line-number" data-line-number="1252"></td>
+        <td id="LC1252" class="blob-code blob-code-inner js-file-line">100 cz 11 17</td>
+      </tr>
+      <tr>
+        <td id="L1253" class="blob-num js-line-number" data-line-number="1253"></td>
+        <td id="LC1253" class="blob-code blob-code-inner js-file-line">100 y_1_2 6</td>
+      </tr>
+      <tr>
+        <td id="L1254" class="blob-num js-line-number" data-line-number="1254"></td>
+        <td id="LC1254" class="blob-code blob-code-inner js-file-line">100 t 8</td>
+      </tr>
+      <tr>
+        <td id="L1255" class="blob-num js-line-number" data-line-number="1255"></td>
+        <td id="LC1255" class="blob-code blob-code-inner js-file-line">100 t 10</td>
+      </tr>
+      <tr>
+        <td id="L1256" class="blob-num js-line-number" data-line-number="1256"></td>
+        <td id="LC1256" class="blob-code blob-code-inner js-file-line">100 y_1_2 12</td>
+      </tr>
+      <tr>
+        <td id="L1257" class="blob-num js-line-number" data-line-number="1257"></td>
+        <td id="LC1257" class="blob-code blob-code-inner js-file-line">100 y_1_2 14</td>
+      </tr>
+      <tr>
+        <td id="L1258" class="blob-num js-line-number" data-line-number="1258"></td>
+        <td id="LC1258" class="blob-code blob-code-inner js-file-line">100 x_1_2 16</td>
+      </tr>
+</table>
+
+  <details class="details-reset details-overlay BlobToolbar position-absolute js-file-line-actions dropdown d-none" aria-hidden="true">
+    <summary class="btn-octicon ml-0 px-2 p-0 color-bg-primary border color-border-tertiary rounded-1" aria-label="Inline file action toolbar">
+      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-kebab-horizontal">
+    <path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path>
+</svg>
+    </summary>
+    <details-menu>
+      <ul class="BlobToolbar-dropdown dropdown-menu dropdown-menu-se mt-2" style="width:185px">
+        <li>
+          <clipboard-copy role="menuitem" class="dropdown-item" id="js-copy-lines" style="cursor:pointer;">
+            Copy lines
+          </clipboard-copy>
+        </li>
+        <li>
+          <clipboard-copy role="menuitem" class="dropdown-item" id="js-copy-permalink" style="cursor:pointer;">
+            Copy permalink
+          </clipboard-copy>
+        </li>
+        <li><a class="dropdown-item js-update-url-with-hash" id="js-view-git-blame" role="menuitem" href="/quantumlib/qsim/blame/1d0965c9c27f735edeb2a18b7bf5a27e7592bd6f/circuits/circuit_q24">View git blame</a></li>
+          <li><a class="dropdown-item" id="js-new-issue" role="menuitem" href="/quantumlib/qsim/issues/new">Reference in new issue</a></li>
+      </ul>
+    </details-menu>
+  </details>
+
+  </div>
+
+    </div>
+
+
+  
+
+  <details class="details-reset details-overlay details-overlay-dark" id="jumpto-line-details-dialog">
+    <summary data-hotkey="l" aria-label="Jump to line"></summary>
+    <details-dialog class="Box Box--overlay d-flex flex-column anim-fade-in fast linejump" aria-label="Jump to line">
+      <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="js-jump-to-line-form Box-body d-flex" action="" accept-charset="UTF-8" method="get">
+        <input class="form-control flex-auto mr-3 linejump-input js-jump-to-line-field" type="text" placeholder="Jump to line&hellip;" aria-label="Jump to line" autofocus>
+        <button type="submit" class="btn" data-close-dialog>Go</button>
+</form>    </details-dialog>
+  </details>
+
+
+</div>
+
+
+
+  </div>
+</div>
+
+    </main>
+  </div>
+
+  </div>
+
+          
+<div class="footer container-xl width-full p-responsive" role="contentinfo">
+  <div class="position-relative d-flex flex-row-reverse flex-lg-row flex-wrap flex-lg-nowrap flex-justify-center flex-lg-justify-between pt-6 pb-2 mt-6 f6 color-text-secondary border-top color-border-secondary ">
+    <ul class="list-style-none d-flex flex-wrap col-12 col-lg-5 flex-justify-center flex-lg-justify-between mb-2 mb-lg-0">
+      <li class="mr-3 mr-lg-0">&copy; 2021 GitHub, Inc.</li>
+        <li class="mr-3 mr-lg-0"><a href="https://docs.github.com/en/github/site-policy/github-terms-of-service" data-ga-click="Footer, go to terms, text:terms">Terms</a></li>
+        <li class="mr-3 mr-lg-0"><a href="https://docs.github.com/en/github/site-policy/github-privacy-statement" data-ga-click="Footer, go to privacy, text:privacy">Privacy</a></li>
+        <li class="mr-3 mr-lg-0"><a data-ga-click="Footer, go to security, text:security" href="https://github.com/security">Security</a></li>
+        <li class="mr-3 mr-lg-0"><a href="https://www.githubstatus.com/" data-ga-click="Footer, go to status, text:status">Status</a></li>
+        <li><a data-ga-click="Footer, go to help, text:Docs" href="https://docs.github.com">Docs</a></li>
+    </ul>
+
+    <a aria-label="Homepage" title="GitHub" class="footer-octicon d-none d-lg-block mx-lg-4" href="https://github.com">
+      <svg height="24" class="octicon octicon-mark-github" viewBox="0 0 16 16" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg>
+</a>
+    <ul class="list-style-none d-flex flex-wrap col-12 col-lg-5 flex-justify-center flex-lg-justify-between mb-2 mb-lg-0">
+        <li class="mr-3 mr-lg-0"><a href="https://support.github.com" data-ga-click="Footer, go to contact, text:contact">Contact GitHub</a></li>
+        <li class="mr-3 mr-lg-0"><a href="https://github.com/pricing" data-ga-click="Footer, go to Pricing, text:Pricing">Pricing</a></li>
+      <li class="mr-3 mr-lg-0"><a href="https://docs.github.com" data-ga-click="Footer, go to api, text:api">API</a></li>
+      <li class="mr-3 mr-lg-0"><a href="https://services.github.com" data-ga-click="Footer, go to training, text:training">Training</a></li>
+        <li class="mr-3 mr-lg-0"><a href="https://github.blog" data-ga-click="Footer, go to blog, text:blog">Blog</a></li>
+        <li><a data-ga-click="Footer, go to about, text:about" href="https://github.com/about">About</a></li>
+    </ul>
+  </div>
+  <div class="d-flex flex-justify-center pb-6">
+    <span class="f6 color-text-tertiary"></span>
+  </div>
+
+  
+</div>
+
+
+
+  <div id="ajax-error-message" class="ajax-error-message flash flash-error" hidden>
+    <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-alert">
+    <path fill-rule="evenodd" d="M8.22 1.754a.25.25 0 00-.44 0L1.698 13.132a.25.25 0 00.22.368h12.164a.25.25 0 00.22-.368L8.22 1.754zm-1.763-.707c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0114.082 15H1.918a1.75 1.75 0 01-1.543-2.575L6.457 1.047zM9 11a1 1 0 11-2 0 1 1 0 012 0zm-.25-5.25a.75.75 0 00-1.5 0v2.5a.75.75 0 001.5 0v-2.5z"></path>
+</svg>
+    <button type="button" class="flash-close js-ajax-error-dismiss" aria-label="Dismiss error">
+      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
+    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
+</svg>
+    </button>
+    You can’t perform that action at this time.
+  </div>
+
+  <div class="js-stale-session-flash flash flash-warn flash-banner" hidden
+    >
+    <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-alert">
+    <path fill-rule="evenodd" d="M8.22 1.754a.25.25 0 00-.44 0L1.698 13.132a.25.25 0 00.22.368h12.164a.25.25 0 00.22-.368L8.22 1.754zm-1.763-.707c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0114.082 15H1.918a1.75 1.75 0 01-1.543-2.575L6.457 1.047zM9 11a1 1 0 11-2 0 1 1 0 012 0zm-.25-5.25a.75.75 0 00-1.5 0v2.5a.75.75 0 001.5 0v-2.5z"></path>
+</svg>
+    <span class="js-stale-session-flash-signed-in" hidden>You signed in with another tab or window. <a href="">Reload</a> to refresh your session.</span>
+    <span class="js-stale-session-flash-signed-out" hidden>You signed out in another tab or window. <a href="">Reload</a> to refresh your session.</span>
+  </div>
+    <template id="site-details-dialog">
+  <details class="details-reset details-overlay details-overlay-dark lh-default color-text-primary hx_rsm" open>
+    <summary role="button" aria-label="Close dialog"></summary>
+    <details-dialog class="Box Box--overlay d-flex flex-column anim-fade-in fast hx_rsm-dialog hx_rsm-modal">
+      <button class="Box-btn-octicon m-0 btn-octicon position-absolute right-0 top-0" type="button" aria-label="Close dialog" data-close-dialog>
+        <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
+    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
+</svg>
+      </button>
+      <div class="octocat-spinner my-6 js-details-dialog-spinner"></div>
+    </details-dialog>
+  </details>
+</template>
+
+    <div class="Popover js-hovercard-content position-absolute" style="display: none; outline: none;" tabindex="0">
+  <div class="Popover-message Popover-message--bottom-left Popover-message--large Box color-shadow-large" style="width:360px;">
+  </div>
+</div>
+
+
+
+  
+
+  </body>
+</html>
+
diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
new file mode 100644
index 00000000..c5bf4949
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -0,0 +1,325 @@
+variable "bucket_name" {
+    type = string
+    default = ""
+}
+variable "cluster_name" {
+    type = string
+    default = "condor"
+}
+variable "admin_email" {
+    type = string
+    default = ""
+}
+variable "osversion" {
+    type = string
+    default = "7"
+}
+variable "osimage" {
+    type = string
+    default = "hpc-centos-7"
+}
+variable "osproject" {
+  type = string
+  default = "click-to-deploy-images"
+}
+variable "condorversion" {
+    type = string
+    default = ""
+}
+variable "project" {
+    type = string
+}
+variable "zone" {
+    type = string
+}
+variable "min_replicas" {
+    type = number
+    default = 1
+}
+variable "max_replicas" {
+    type = number
+    default = 20
+}
+variable "use_preemptibles" {
+    type = bool
+    default = true
+}
+variable "metric_target_loadavg" { 
+  type = number 
+  default = "1.0"
+}
+variable "metric_target_queue" { 
+  type = number 
+  default = 10
+}
+variable "compute_instance_type" {
+  type = string
+  default = "n2-standard-80"
+}
+variable "instance_type" {
+  type = string
+  default = "n2-standard-4"
+}
+variable "service_account" {
+  type = string
+  default = "default"
+}
+locals{
+  compute_startup = templatefile(
+    "${path.module}/startup-centos.sh", 
+    {
+      "bucket_name" = var.bucket_name,
+      "project" = var.project,
+      "cluster_name" = var.cluster_name,
+      "htserver_type" = "compute", 
+      "osversion" = var.osversion, 
+      "condorversion" = var.condorversion, 
+      "admin_email" = var.admin_email
+    })
+  submit_startup = templatefile(
+    "${path.module}/startup-centos.sh", 
+    {
+      "bucket_name" = var.bucket_name,
+      "project" = var.project,
+      "cluster_name" = var.cluster_name,
+      "htserver_type" = "submit", 
+      "osversion" = var.osversion, 
+      "condorversion" = var.condorversion, 
+      "admin_email" = var.admin_email
+    })
+  master_startup = templatefile(
+    "${path.module}/startup-centos.sh", 
+    {
+      "bucket_name" = var.bucket_name,
+      "project" = var.project,
+      "cluster_name" = var.cluster_name,
+      "htserver_type" = "master", 
+      "osversion" = var.osversion, 
+      "condorversion" = var.condorversion, 
+      "admin_email" = var.admin_email
+    })
+}
+data "google_compute_image" "startimage" {
+  family  = var.osimage
+  project = var.osproject
+}
+resource "google_compute_instance" "condor-master" {
+  boot_disk {
+    auto_delete = "true"
+    device_name = "boot"
+
+    initialize_params {
+      image = data.google_compute_image.startimage.self_link
+      size  = "200"
+      type  = "pd-standard"
+    }
+
+    mode   = "READ_WRITE"
+  }
+
+  can_ip_forward      = "false"
+  deletion_protection = "false"
+  enable_display      = "false"
+
+  machine_type            = var.instance_type
+  metadata_startup_script = local.master_startup
+  name                    = "${var.cluster_name}-master"
+  network_interface {
+    access_config {
+      network_tier = "PREMIUM"
+    }
+
+    network            = "default"
+    #network_ip         = "10.128.0.2"
+    subnetwork         = "default"
+    subnetwork_project = var.project
+  }
+
+  project = var.project
+
+  scheduling {
+    automatic_restart   = "true"
+    on_host_maintenance = "MIGRATE"
+    preemptible         = "false"
+  }
+
+  service_account {
+    email = var.service_account
+    scopes = ["https://www.googleapis.com/auth/cloud-platform"]
+  }
+
+  shielded_instance_config {
+    enable_integrity_monitoring = "true"
+    enable_secure_boot          = "false"
+    enable_vtpm                 = "true"
+  }
+
+  tags = ["${var.cluster_name}-master"]
+  zone = var.zone
+}
+
+resource "google_compute_instance" "condor-submit" {
+  boot_disk {
+    auto_delete = "true"
+    device_name = "boot"
+
+    initialize_params {
+      image = data.google_compute_image.startimage.self_link
+      size  = "200"
+      type  = "pd-standard"
+    }
+
+    mode   = "READ_WRITE"
+  }
+
+  can_ip_forward      = "false"
+  deletion_protection = "false"
+  enable_display      = "false"
+
+  labels = {
+    goog-dm = "mycondorcluster"
+  }
+
+  machine_type            = var.instance_type
+  metadata_startup_script = local.submit_startup
+  name                    = "${var.cluster_name}-submit"
+
+  network_interface {
+    access_config {
+      network_tier = "PREMIUM"
+    }
+
+    network            = "default"
+    #network_ip         = "10.128.0.3"
+    subnetwork         = "default"
+    subnetwork_project = var.project
+  }
+
+  project = var.project
+
+  scheduling {
+    automatic_restart   = "true"
+    on_host_maintenance = "MIGRATE"
+    preemptible         = "false"
+  }
+
+  service_account {
+      email = var.service_account
+  #  email  = "487217491196-compute@developer.gserviceaccount.com"
+    scopes = ["https://www.googleapis.com/auth/monitoring.write", "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/servicecontrol", "https://www.googleapis.com/auth/devstorage.read_only", "https://www.googleapis.com/auth/logging.write", "https://www.googleapis.com/auth/service.management.readonly", "https://www.googleapis.com/auth/trace.append"]
+  }
+
+  shielded_instance_config {
+    enable_integrity_monitoring = "true"
+    enable_secure_boot          = "false"
+    enable_vtpm                 = "true"
+  }
+
+  tags = ["${var.cluster_name}-submit"]
+  zone = var.zone
+}
+resource "google_compute_instance_template" "condor-compute" {
+  can_ip_forward = "false"
+
+  disk {
+    auto_delete  = "true"
+    boot         = "true"
+    device_name  = "boot"
+    disk_size_gb = "200"
+    mode         = "READ_WRITE"
+    source_image = data.google_compute_image.startimage.self_link
+    type         = "PERSISTENT"
+  }
+
+  machine_type = var.compute_instance_type
+
+  metadata = {
+    startup-script = local.compute_startup
+  }
+
+  name = "${var.cluster_name}-compute"
+
+  network_interface {
+    access_config {
+      network_tier = "PREMIUM"
+    }
+
+    network = "default"
+  }
+
+  project = var.project
+  region  = var.zone
+
+  scheduling {
+    automatic_restart   = "false"
+    on_host_maintenance = "TERMINATE"
+    preemptible         = var.use_preemptibles
+  }
+
+  service_account {
+      email = var.service_account
+  #  email  = "default"
+    scopes = ["https://www.googleapis.com/auth/monitoring.write", "https://www.googleapis.com/auth/trace.append", "https://www.googleapis.com/auth/logging.write", "https://www.googleapis.com/auth/devstorage.full_control"]
+  }
+
+  tags = ["${var.cluster_name}-compute"]
+}
+resource "google_compute_instance_group_manager" "condor-compute-igm" {
+  base_instance_name = var.cluster_name
+  name               = var.cluster_name
+
+  project            = var.project
+  target_size        = "1"
+
+  update_policy {
+    max_surge_fixed         = 5
+    minimal_action          = "REPLACE"
+    type                    = "OPPORTUNISTIC"
+  }
+
+  version {
+    instance_template = google_compute_instance_template.condor-compute.self_link
+    name              = ""
+  }
+  timeouts {
+    create = "60m"
+    delete = "2h"
+  }
+  # Yup, didn't want to use this, but I was getting create and destroy errors. 
+  depends_on = [
+   google_compute_instance_template.condor-compute 
+  ]
+  zone = var.zone
+}
+resource "google_compute_autoscaler" "condor-compute-as" {
+  autoscaling_policy {
+    cooldown_period = "60"
+    max_replicas    = var.max_replicas
+
+    metric {
+      name   = "custom.googleapis.com/q0"
+      target = var.metric_target_queue
+      type   = "GAUGE"
+    }
+    metric {
+      name   = "custom.googleapis.com/la0"
+      target = var.metric_target_loadavg
+      type   = "GAUGE"
+    }
+
+    min_replicas = var.min_replicas
+  }
+
+  name    = "${var.cluster_name}-compute-as"
+  project = var.project
+  target  = google_compute_instance_group_manager.condor-compute-igm.self_link
+  zone    = var.zone
+  timeouts {
+    create = "60m"
+    delete = "2h"
+  }
+
+  depends_on = [
+   google_compute_instance_group_manager.condor-compute-igm
+  ]
+}
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh
new file mode 100644
index 00000000..a76774a8
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh
@@ -0,0 +1,72 @@
+#!/bin/bash -x
+
+SERVER_TYPE="${htserver_type}"
+
+##############################################################
+# Configure Condor Daemons 
+##############################################################
+cd /tmp
+cat <<EOF > condor_config.local
+DISCARD_SESSION_KEYRING_ON_STARTUP=False
+CONDOR_ADMIN=${admin_email}
+CONDOR_HOST=${cluster_name}-master
+EOF
+
+# Case for compute
+if [ "$SERVER_TYPE" == "compute" ]; then
+cat <<EOF1 >> condor_config.local
+# Standard Stuff
+DAEMON_LIST = MASTER, STARTD
+ALLOW_WRITE = \$(ALLOW_WRITE), \$(CONDOR_HOST)
+# Run Dynamics Slots
+NUM_SLOTS = 1
+NUM_SLOTS_TYPE_1 = 1
+SLOT_TYPE_1 = 100%
+SLOT_TYPE_1_PARTITIONABLE = TRUE
+# Allowing Run as Owner
+STARTER_ALLOW_RUNAS_OWNER = TRUE
+SUBMIT_ATTRS = RunAsOwner
+RunAsOwner = True
+UID_DOMAIN = c.${project}.internal
+TRUST_UID_DOMAIN = True
+EOF1
+fi
+
+# Case for master
+if [ "$SERVER_TYPE" == "master" ]; then
+cat <<EOF2 >> condor_config.local
+DAEMON_LIST = MASTER, COLLECTOR, NEGOTIATOR
+ALLOW_WRITE = *
+EOF2
+fi
+
+# Case for submit
+if [ "$SERVER_TYPE" == "submit" ]; then
+cat <<EOF3 >> condor_config.local
+DAEMON_LIST = MASTER, SCHEDD
+ALLOW_WRITE = \$(ALLOW_WRITE), \$(CONDOR_HOST)
+# Allowing Run as Owner
+STARTER_ALLOW_RUNAS_OWNER = TRUE
+SUBMIT_ATTRS = RunAsOwner
+RunAsOwner = True
+UID_DOMAIN = c.${project}.internal
+TRUST_UID_DOMAIN = True
+EOF3
+fi
+
+mkdir -p /etc/condor/config.d
+mv condor_config.local /etc/condor/config.d
+systemctl start condor;systemctl enable condor
+
+##############################################################
+## Some fluentd Stuff
+##############################################################
+
+
+if [ "$SERVER_TYPE" == "submit" ]; then
+mkdir -p /var/log/condor/jobs
+touch /var/log/condor/jobs/stats.log
+chmod 666 /var/log/condor/jobs/stats.log
+fi
+
+service google-fluentd restart
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
new file mode 100644
index 00000000..7177a285
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -0,0 +1,169 @@
+#!/bin/bash -x
+
+SERVER_TYPE="${htserver_type}"
+
+##############################################################
+## Install and configure HTCONDOR
+##############################################################
+
+if [ "${condorversion}" == "" ]; then
+   CONDOR_INSTALL_OPT="condor"
+else
+   CONDOR_INSTALL_OPT="condor-all-${condorversion}"
+  #  email  = "487217491196-compute@developer.gserviceaccount.com"
+fi
+if [ "${osversion}" == "6" ]; then
+   CONDOR_STARTUP_CMD="service condor start"
+else
+   CONDOR_STARTUP_CMD="systemctl start condor;systemctl enable condor"
+fi
+CONDOR_REPO_URL=https://research.cs.wisc.edu/htcondor/yum/repo.d/htcondor-stable-rhel${osversion}.repo
+
+sleep 2 #Give it some time to setup yum
+cd /tmp
+yum update -y
+yum install -y wget curl net-tools vim gcc python3 
+wget https://research.cs.wisc.edu/htcondor/yum/RPM-GPG-KEY-HTCondor
+rpm --import RPM-GPG-KEY-HTCondor
+cd /etc/yum.repos.d && wget $CONDOR_REPO_URL
+yum install -y $CONDOR_INSTALL_OPT
+
+##############################################################
+# Install Docker on Compute Nodes 
+##############################################################
+if [ "$SERVER_TYPE" == "compute" ]; then
+    yum install -y yum-utils
+    yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
+    yum install -y docker-ce docker-ce-cli containerd.io
+    systemctl start docker
+    systemctl enable docker
+    usermod -aG docker condor
+fi
+
+##############################################################
+# Configure Condor Daemons 
+##############################################################
+cd /tmp
+cat <<EOF > condor_config.local
+DISCARD_SESSION_KEYRING_ON_STARTUP=False
+CONDOR_ADMIN=${admin_email}
+CONDOR_HOST=${cluster_name}-master
+EOF
+
+# Case for compute
+if [ "$SERVER_TYPE" == "compute" ]; then
+cat <<EOF1 >> condor_config.local
+# Standard Stuff
+DAEMON_LIST = MASTER, STARTD
+ALLOW_WRITE = \$(ALLOW_WRITE), \$(CONDOR_HOST)
+# Run Dynamics Slots
+NUM_SLOTS = 1
+NUM_SLOTS_TYPE_1 = 1
+SLOT_TYPE_1 = 100%
+SLOT_TYPE_1_PARTITIONABLE = TRUE
+# Allowing Run as Owner
+STARTER_ALLOW_RUNAS_OWNER = TRUE
+SUBMIT_ATTRS = RunAsOwner
+RunAsOwner = True
+UID_DOMAIN = c.${project}.internal
+TRUST_UID_DOMAIN = True
+HasDocker = True
+EOF1
+fi
+
+# Case for master
+if [ "$SERVER_TYPE" == "master" ]; then
+cat <<EOF2 >> condor_config.local
+DAEMON_LIST = MASTER, COLLECTOR, NEGOTIATOR
+ALLOW_WRITE = *
+EOF2
+fi
+
+# Case for submit
+if [ "$SERVER_TYPE" == "submit" ]; then
+cat <<EOF3 >> condor_config.local
+DAEMON_LIST = MASTER, SCHEDD
+ALLOW_WRITE = \$(ALLOW_WRITE), \$(CONDOR_HOST)
+# Allowing Run as Owner
+STARTER_ALLOW_RUNAS_OWNER = TRUE
+SUBMIT_ATTRS = RunAsOwner
+RunAsOwner = True
+UID_DOMAIN = c.${project}.internal
+TRUST_UID_DOMAIN = True
+EOF3
+fi
+
+
+mkdir -p /etc/condor/config.d
+mv condor_config.local /etc/condor/config.d
+eval $CONDOR_STARTUP_CMD
+
+##############################################################
+# Install and configure logging agent for StackDriver
+##############################################################
+curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
+bash install-logging-agent.sh
+
+# Install Custom Metric Plugin:
+google-fluentd-gem install fluent-plugin-stackdriver-monitoring
+
+# Create Fluentd Config
+
+cat <<EOF > condor.conf
+<source>
+  @type tail
+  format none
+  path /var/log/condor/*Log
+  pos_file /var/lib/google-fluentd/pos/condor.pos
+  read_from_head true
+  tag condor
+</source>
+<source>
+  @type exec
+  command condor_status -direct `hostname` -format "%f " TotalLoadAvg |  cut -d " " -f 1
+    <parse>
+      keys la0
+    </parse>
+  tag condor_la0
+  run_interval 5s
+</source>
+<source>
+  @type exec
+  command condor_status -schedd -format "%d" TotalIdleJobs
+    <parse>
+      keys q0
+    </parse>
+  tag condor_q0
+  run_interval 5s
+</source>
+<match condor_la0>
+  @type stackdriver_monitoring
+  project ${project}
+  <custom_metrics>
+    key la0
+    type custom.googleapis.com/la0
+    metric_kind GAUGE
+    value_type DOUBLE
+  </custom_metrics>
+</match>
+<match condor_q0>
+  @type stackdriver_monitoring
+  project ${project}
+  <custom_metrics>
+    key q0
+    type custom.googleapis.com/q0
+    metric_kind GAUGE
+    value_type INT64
+  </custom_metrics>
+</match>
+EOF
+mkdir -p /etc/google-fluentd/config.d/
+mv condor.conf /etc/google-fluentd/config.d/
+
+if [ "$SERVER_TYPE" == "submit" ]; then
+mkdir -p /var/log/condor/jobs
+touch /var/log/condor/jobs/stats.log
+chmod 666 /var/log/condor/jobs/stats.log
+fi
+
+service google-fluentd restart
diff --git a/docs/tutorials/multinode/terraform/init.tf b/docs/tutorials/multinode/terraform/init.tf
new file mode 100644
index 00000000..2e30961d
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/init.tf
@@ -0,0 +1,3 @@
+provider "google" {
+    credentials = file("~/.quantum-htcondor.json")
+}
diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
new file mode 100644
index 00000000..cabf61d2
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -0,0 +1,19 @@
+variable "cluster_name" {
+  type = string
+  default = "c"
+  description = "Name used to prefix resources in cluster."
+  
+}
+
+module "htcondor" {
+  source = "./htcondor/"
+  cluster_name = var.cluster_name
+  osversion = "7"
+  bucket_name = "quantum-hcondor-save"
+  zone="us-east4-c"
+  project="quantum-htcondor"
+  max_replicas=20
+  min_replicas=1
+  service_account="htcondor@quantum-htcondor.iam.gserviceaccount.com"
+  use_preemptibles=true
+}
\ No newline at end of file
diff --git a/docs/tutorials/multinode/test.txt b/docs/tutorials/multinode/test.txt
new file mode 100644
index 00000000..e69de29b

From 2ad573b02b4f4bbad59f44f3068eb8f9d6ff7028 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Wed, 12 May 2021 20:29:15 +0000
Subject: [PATCH 003/246] Added readme

---
 docs/tutorials/multinode/{test.txt => README.md} |  0
 docs/tutorials/multinode/docker.job              | 11 +++++++++++
 2 files changed, 11 insertions(+)
 rename docs/tutorials/multinode/{test.txt => README.md} (100%)
 create mode 100644 docs/tutorials/multinode/docker.job

diff --git a/docs/tutorials/multinode/test.txt b/docs/tutorials/multinode/README.md
similarity index 100%
rename from docs/tutorials/multinode/test.txt
rename to docs/tutorials/multinode/README.md
diff --git a/docs/tutorials/multinode/docker.job b/docs/tutorials/multinode/docker.job
new file mode 100644
index 00000000..363a233c
--- /dev/null
+++ b/docs/tutorials/multinode/docker.job
@@ -0,0 +1,11 @@
+universe                = docker
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
+arguments               = -c circuit_q24
+transfer_input_files    = https://raw.githubusercontent.com/quantumlib/qsim/master/circuits/circuit_q24
+should_transfer_files   = YES
+when_to_transfer_output = ON_EXIT
+output                  = out/out.$(Process)
+error                   = out/err.$(Process)
+log                     = out/log.$(Process)
+request_memory          = 30GB
+queue 1

From 599f246dfb9f4e7d78ae3a978df8d9e09a4cb795 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Wed, 12 May 2021 20:34:57 +0000
Subject: [PATCH 004/246] removed local creds.

---
 docs/tutorials/multinode/terraform/init.tf | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/tutorials/multinode/terraform/init.tf b/docs/tutorials/multinode/terraform/init.tf
index 2e30961d..8660f9fa 100644
--- a/docs/tutorials/multinode/terraform/init.tf
+++ b/docs/tutorials/multinode/terraform/init.tf
@@ -1,3 +1,2 @@
 provider "google" {
-    credentials = file("~/.quantum-htcondor.json")
 }

From 2aa5e4af789ac1ddd555323cc6798293dd08f2ac Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Tue, 18 May 2021 15:35:06 +0000
Subject: [PATCH 005/246] Updated job files.

---
 docs/tutorials/multinode/README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index e69de29b..81dd629b 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -0,0 +1,23 @@
+gcloud iam service-accounts create "htcondor2"   --display-name="HTCONDOR 2"
+gcloud projects add-iam-policy-binding quantum-htcondor --role roles/iam.serviceAccountUser --member="serviceAccount:htcondor2@quantum-htcondor.iam.gserviceaccount.com"
+gcloud projects add-iam-policy-binding quantum-htcondor --role roles/compute.admin --member="serviceAccount:htcondor2@quantum-htcondor.iam.gserviceaccount.com"
+
+
+git clone https://github.com/jrossthomson/qsim.git
+
+cd qsim/docs/tutorials/multinode/
+
+sudo journalctl -f -u google-startup-scripts.service
+
+condor_q
+-- Schedd: c-submit.c.quantum-htcondor.internal : <10.150.15.206:9618?... @ 05/14/21 15:09:57
+OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
+
+Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended 
+Total for jrossthomson: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended 
+Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+
+
+condor_submit .job
+
+condor_q -better-analyze JobId

From 251279a047422cbf013e2762af8e1b6aafe262fd Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Tue, 18 May 2021 15:37:35 +0000
Subject: [PATCH 006/246] update job names

---
 .../multinode/{docker.job => circuit_q24.job} |    2 +-
 docs/tutorials/multinode/circuit_q30.job      |   11 +
 .../tutorials/multinode/terraform/circuit_q24 | 6325 -----------------
 .../multinode/terraform/htcondor/resources.tf |   19 +-
 .../htcondor/startup-centos-noinstall.sh      |   72 -
 .../terraform/htcondor/startup-centos.sh      |    6 +-
 docs/tutorials/multinode/terraform/main.tf    |    2 +-
 7 files changed, 25 insertions(+), 6412 deletions(-)
 rename docs/tutorials/multinode/{docker.job => circuit_q24.job} (78%)
 create mode 100644 docs/tutorials/multinode/circuit_q30.job
 delete mode 100644 docs/tutorials/multinode/terraform/circuit_q24
 delete mode 100644 docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh

diff --git a/docs/tutorials/multinode/docker.job b/docs/tutorials/multinode/circuit_q24.job
similarity index 78%
rename from docs/tutorials/multinode/docker.job
rename to docs/tutorials/multinode/circuit_q24.job
index 363a233c..5d2639a1 100644
--- a/docs/tutorials/multinode/docker.job
+++ b/docs/tutorials/multinode/circuit_q24.job
@@ -1,7 +1,7 @@
 universe                = docker
 docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
 arguments               = -c circuit_q24
-transfer_input_files    = https://raw.githubusercontent.com/quantumlib/qsim/master/circuits/circuit_q24
+transfer_input_files    = ../../../circuits/circuit_q24
 should_transfer_files   = YES
 when_to_transfer_output = ON_EXIT
 output                  = out/out.$(Process)
diff --git a/docs/tutorials/multinode/circuit_q30.job b/docs/tutorials/multinode/circuit_q30.job
new file mode 100644
index 00000000..a3819ecd
--- /dev/null
+++ b/docs/tutorials/multinode/circuit_q30.job
@@ -0,0 +1,11 @@
+universe                = docker
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
+arguments               = -c circuit_q30
+transfer_input_files    = ../../../circuits/circuit_q30
+should_transfer_files   = YES
+when_to_transfer_output = ON_EXIT
+output                  = out/out.$(Process)
+error                   = out/err.$(Process)
+log                     = out/log.$(Process)
+request_memory          = 340GB
+queue 1
diff --git a/docs/tutorials/multinode/terraform/circuit_q24 b/docs/tutorials/multinode/terraform/circuit_q24
deleted file mode 100644
index 757895d7..00000000
--- a/docs/tutorials/multinode/terraform/circuit_q24
+++ /dev/null
@@ -1,6325 +0,0 @@
-
-
-
-
-
-
-<!DOCTYPE html>
-<html lang="en" data-color-mode="auto" data-light-theme="light" data-dark-theme="dark">
-  <head>
-    <meta charset="utf-8">
-  <link rel="dns-prefetch" href="https://github.githubassets.com">
-  <link rel="dns-prefetch" href="https://avatars.githubusercontent.com">
-  <link rel="dns-prefetch" href="https://github-cloud.s3.amazonaws.com">
-  <link rel="dns-prefetch" href="https://user-images.githubusercontent.com/">
-
-
-
-  <link crossorigin="anonymous" media="all" integrity="sha512-sf1Ppoo8CVx+YA47iIi2IUMYtjH17Errad0dPA+lo7DVd6VW1Mdy+TBcpD06Z6FN8MKI7TH5fpYU33+DhP25kg==" rel="stylesheet" href="https://github.githubassets.com/assets/frameworks-b1fd4fa68a3c095c7e600e3b8888b621.css" />
-    <link crossorigin="anonymous" media="all" integrity="sha512-LhF+q2/lZfX1qKIAoHwzUmZ1eN3zI6Hgm96RmuK+fILZRBtO51EiVC8nQ9e5QDRdbJeTMoawW6SNbOiHRWewLg==" rel="stylesheet" href="https://github.githubassets.com/assets/behaviors-2e117eab6fe565f5f5a8a200a07c3352.css" />
-    
-    
-    
-    <link crossorigin="anonymous" media="all" integrity="sha512-IwoajEOel02eeTohMnWahFUlLFlQR2D7ze3SyG2bEzVQ/BE62mymz1R2v9S2LQgaduGAMOG8Zf05OpGuu7Kh7Q==" rel="stylesheet" href="https://github.githubassets.com/assets/github-230a1a8c439e974d9e793a2132759a84.css" />
-
-  <script crossorigin="anonymous" defer="defer" integrity="sha512-CzeY4A6TiG4fGZSWZU8FxmzFFmcQFoPpArF0hkH0/J/S7UL4eed/LKEXMQXfTwiG5yEJBI+9BdKG8KQJNbhcIQ==" type="application/javascript" src="https://github.githubassets.com/assets/environment-0b3798e0.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-xD/II79VugfUBs1ZVmd0ea7wmmLeCyIkPkWprb/jviEdWsOc5n7pJ7Wbn6h70b5CEvAQ5rp9EG3EKBfV34Cqxg==" type="application/javascript" src="https://github.githubassets.com/assets/chunk-frameworks-c43fc823.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-N6FZA172tiL7uDaWQ5DGlKS2MS0ZuYf9n2kkRRfntFnGdL89nWudZXRok+pLWRQd2xLfiSALG5NQ2KCGKP2UtQ==" type="application/javascript" src="https://github.githubassets.com/assets/chunk-vendor-37a15903.js"></script>
-  
-  <script crossorigin="anonymous" defer="defer" integrity="sha512-soTfiFmFphcLCq12ot5mqPZoNEPYwXXy11/urmmYHmJ5Oau+2XYC26hZafLR7yDLCgaD4cwYUetDTxL1/eewBw==" type="application/javascript" src="https://github.githubassets.com/assets/behaviors-b284df88.js"></script>
-  
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-tjuNQcwhEIXGvVIG4XM/Aj4z+Od+NBRkbgWNwEMjGL3nsnAmdoBdbzsn/WTvl3hk+TPt1D0BvBLHLBPgiwvT2w==" type="application/javascript" data-module-id="./chunk-animate-on-scroll.js" data-src="https://github.githubassets.com/assets/chunk-animate-on-scroll-b63b8d41.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-+BKEtK9JkmJ52jKSoX6+SBrGV6kJxB8J/iAPkFQ/oeq8YekNcz7IZlJgM5Tddyx1RrkL3+sdG0tAy3YuFbYqfA==" type="application/javascript" data-module-id="./chunk-codemirror.js" data-src="https://github.githubassets.com/assets/chunk-codemirror-f81284b4.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-EKOvqJ9uTatAt87WxU+OSS4mi7gMUszFbGo4aPErQkjpWLXnrPSeZvK5ngU8OYoIoiVOq+v8dA3C6MF/z2d/kA==" type="application/javascript" data-module-id="./chunk-color-modes.js" data-src="https://github.githubassets.com/assets/chunk-color-modes-10a3afa8.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-zkYZSjUFqSifB+Lt76jclFMrfqpcPqevT801RZcoBNCZHRTBKcFrW9OyJoPOzKFv+fZVDRnqdqGsuIv5KOIgZg==" type="application/javascript" data-module-id="./chunk-contributions-spider-graph.js" data-src="https://github.githubassets.com/assets/chunk-contributions-spider-graph-ce46194a.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-6j/oSF+kbW+yetNPvI684VzAu9pzug6Vj2h+3u1LdCuRhR4jnuiHZfeQKls3nxcT/S3H+oIt7FtigE/aeoj+gg==" type="application/javascript" data-module-id="./chunk-drag-drop.js" data-src="https://github.githubassets.com/assets/chunk-drag-drop-ea3fe848.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-VSSd+Yzi2iMS+pibY6hD/WdypxAEdob5F2RMKxuKcAHS2EpFYJPeTXoVxt0NXg03tfj2dka2mEtHS+vjpYSaDw==" type="application/javascript" data-module-id="./chunk-edit-hook-secret-element.js" data-src="https://github.githubassets.com/assets/chunk-edit-hook-secret-element-55249df9.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-N+ziqJjVMfWiqeVHdayDHpNRlG5HsF+cgV+pFnMDoTJuvBzgw+ndsepe4NcKAxIS3WMvzMaQcYmd2vrIaoAJVg==" type="application/javascript" data-module-id="./chunk-edit.js" data-src="https://github.githubassets.com/assets/chunk-edit-37ece2a8.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-aiqMIGGZGo8AQMjcoImKPMTsZVVRl6htCSY7BpRmpGPG/AF+Wq+P/Oj/dthWQOIk9cCNMPEas7O2zAR6oqn0tA==" type="application/javascript" data-module-id="./chunk-emoji-picker-element.js" data-src="https://github.githubassets.com/assets/chunk-emoji-picker-element-6a2a8c20.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-7o8WoXZcP71e0YBbF1az3Rj9iGr3Irk3kb7Yq1/ZQETySta8pQLfupQJ7yiswg+sN1HTqszDMbp1vcPHFgp7gw==" type="application/javascript" data-module-id="./chunk-filter-input.js" data-src="https://github.githubassets.com/assets/chunk-filter-input-ee8f16a1.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-XwuQdORq1W9Z+a/i72pH+NfR1rhwlGdxIlaIBbTciscGc/+McxMNLixGBp8e6Td4W1zzHvQ1Jyryl5gUfEr76g==" type="application/javascript" data-module-id="./chunk-insights-graph.js" data-src="https://github.githubassets.com/assets/chunk-insights-graph-5f0b9074.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-Y+VVFzGHo9J5bf4Mrn+RGrh1+IExdybA3C1QqPha3UwkV9RZ75jZgV4DsujViAF0iT9OrLYYHvPk9V6QiXjp3g==" type="application/javascript" data-module-id="./chunk-invitations.js" data-src="https://github.githubassets.com/assets/chunk-invitations-63e55517.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-mMOvER8Uml4WMYbXv8BaahVq9eF1v5Hu7M9/3oPlOFPmTJGH+TmvcRPt8fddj86urb+Ri+vlqotFspA/4STDsQ==" type="application/javascript" data-module-id="./chunk-jump-to.js" data-src="https://github.githubassets.com/assets/chunk-jump-to-98c3af11.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-supZkxo+OPYLNtLXxI+e1dkCqVySu4FOWX1fiVVFs2ZggygppNsEz4F9wVp4YtH2TjFsZW8r/75uDUhPneO2sA==" type="application/javascript" data-module-id="./chunk-notification-list-focus.js" data-src="https://github.githubassets.com/assets/chunk-notification-list-focus-b2ea5993.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-ma0OOy3nj0c1cqBx0BkcmIFsLqcSZ+MIukQxyEFM/OWTzZpG+QMgOoWPAHZz43M6fyjAUG1jH6c/6LPiiKPCyw==" type="application/javascript" data-module-id="./chunk-profile-pins-element.js" data-src="https://github.githubassets.com/assets/chunk-profile-pins-element-99ad0e3b.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-zh+tYYvd4W00us1O4PkhmKsl/CzInIyrdoMqV2xqC7XPu06UEHfEMJfOiwidJ5f80SwrdGWogWFuJzLHwRbRgA==" type="application/javascript" data-module-id="./chunk-ref-selector.js" data-src="https://github.githubassets.com/assets/chunk-ref-selector-ce1fad61.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-Zii9oRdZ6q2QDNjL5A+me7jwJjMLvs1NiQNHmajUZnn4t9shcBDb4F8l/PQZW26eYfe5065oM7lIOSmbMinA7Q==" type="application/javascript" data-module-id="./chunk-responsive-underlinenav.js" data-src="https://github.githubassets.com/assets/chunk-responsive-underlinenav-6628bda1.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-9WNXtB07IyWypiPmkuucspwog4mme9q5GKGMSgd7FI0DPimmg/pEw+aaAofFV1vuWMt9I8H5QpsVtlbHGg1YBA==" type="application/javascript" data-module-id="./chunk-runner-groups.js" data-src="https://github.githubassets.com/assets/chunk-runner-groups-f56357b4.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-fIq9Mn7jY/bHQXnsmh+VejpDnaO+d/FDxsp+4CuZtdNLrLuO+dQCjh+m6Yd8GCYD2Cy6DWbCEyM+mH2dkB2H9A==" type="application/javascript" data-module-id="./chunk-sortable-behavior.js" data-src="https://github.githubassets.com/assets/chunk-sortable-behavior-7c8abd32.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-WK8VXw3lfUQ/VRW0zlgKPhcMUqH0uTnB/KzePUPdZhCm/HpxfXXHKTGvj5C0Oex7+zbIM2ECzULbtTCT4ug3yg==" type="application/javascript" data-module-id="./chunk-toast.js" data-src="https://github.githubassets.com/assets/chunk-toast-58af155f.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-vgHJEmEJxNmHucGbVY8bEUoOYo5/ZwpQ69rU8Dld89daWJ54uad9lNptxq32F8pnbHhdngw9lohNEbMbjmj5AQ==" type="application/javascript" data-module-id="./chunk-tweetsodium.js" data-src="https://github.githubassets.com/assets/chunk-tweetsodium-be01c912.js"></script>
-    <script crossorigin="anonymous" defer="defer" integrity="sha512-aSxfTHAZj9wv7n08DxgAKkNg7jhiTo4yKKbDqLGxcDxUk/al571Y2ZSsOmLJ0Vh8cuAL8tW+JgX1t0JeKfyfaA==" type="application/javascript" data-module-id="./chunk-user-status-submit.js" data-src="https://github.githubassets.com/assets/chunk-user-status-submit-692c5f4c.js"></script>
-  
-  <script crossorigin="anonymous" defer="defer" integrity="sha512-/8DIYpYCJFF0xg5QFDVdVJdBQfagC8hDC0Bi5TnoOpswGkZt/Byv4P8wmMYm3r4m6eB8WzeGngZvzA30b8kxiw==" type="application/javascript" src="https://github.githubassets.com/assets/repositories-ffc0c862.js"></script>
-<script crossorigin="anonymous" defer="defer" integrity="sha512-UcfDdsCeeCSVRNSMU527vY80XN0rUQJguclfm0k2nNEfQwzsf8VYtNyiQJZ3YDCOzhMd6AYCl0Bm7Q8JunZMBw==" type="application/javascript" src="https://github.githubassets.com/assets/diffs-51c7c376.js"></script>
-
-  <meta name="viewport" content="width=device-width">
-  
-  <title>qsim/circuit_q24 at master · quantumlib/qsim · GitHub</title>
-    <meta name="description" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim">
-    <link rel="search" type="application/opensearchdescription+xml" href="/opensearch.xml" title="GitHub">
-  <link rel="fluid-icon" href="https://github.com/fluidicon.png" title="GitHub">
-  <meta property="fb:app_id" content="1401488693436528">
-  <meta name="apple-itunes-app" content="app-id=1477376905" />
-    <meta name="twitter:image:src" content="https://opengraph.githubassets.com/8a2f1c7d6b7cef5db1329630ea3d1357bf53f0ebd28d4219a8a78e749eb52269/quantumlib/qsim" /><meta name="twitter:site" content="@github" /><meta name="twitter:card" content="summary_large_image" /><meta name="twitter:title" content="quantumlib/qsim" /><meta name="twitter:description" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim" />
-    <meta property="og:image" content="https://opengraph.githubassets.com/8a2f1c7d6b7cef5db1329630ea3d1357bf53f0ebd28d4219a8a78e749eb52269/quantumlib/qsim" /><meta property="og:image:alt" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim" /><meta property="og:image:width" content="1200" /><meta property="og:image:height" content="600" /><meta property="og:site_name" content="GitHub" /><meta property="og:type" content="object" /><meta property="og:title" content="quantumlib/qsim" /><meta property="og:url" content="https://github.com/quantumlib/qsim" /><meta property="og:description" content="Schrödinger and Schrödinger-Feynman simulators for quantum circuits. - quantumlib/qsim" />
-
-
-
-    
-
-  <link rel="assets" href="https://github.githubassets.com/">
-  
-
-  <meta name="request-id" content="6CA7:5CF8:705A14:B343A1:609BF6B7" data-pjax-transient="true"/><meta name="html-safe-nonce" content="8654840eab26630d55bd2cf1be837d0b0914f5e95130fb027f15e289cdbeb3e6" data-pjax-transient="true"/><meta name="visitor-payload" content="eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI2Q0E3OjVDRjg6NzA1QTE0OkIzNDNBMTo2MDlCRjZCNyIsInZpc2l0b3JfaWQiOiIzNzI3MjEwMTg5MTY4NTcyMDg3IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=" data-pjax-transient="true"/><meta name="visitor-hmac" content="a4b71250d375351b8f7bb98946f4879ef8c1d7fe0a2e75706683747ce13ab4ee" data-pjax-transient="true"/>
-
-    <meta name="hovercard-subject-tag" content="repository:236547448" data-pjax-transient>
-
-
-  <meta name="github-keyboard-shortcuts" content="repository,source-code" data-pjax-transient="true" />
-
-  
-
-  <meta name="selected-link" value="repo_source" data-pjax-transient>
-
-    <meta name="google-site-verification" content="c1kuD-K2HIVF635lypcsWPoD4kilo5-jA_wBFyT4uMY">
-  <meta name="google-site-verification" content="KT5gs8h0wvaagLKAVWq8bbeNwnZZK1r1XQysX3xurLU">
-  <meta name="google-site-verification" content="ZzhVyEFwb7w3e0-uOTltm8Jsck2F5StVihD0exw2fsA">
-  <meta name="google-site-verification" content="GXs5KoUUkNCoaAZn7wPN-t01Pywp9M3sEjnt_3_ZWPc">
-
-  <meta name="octolytics-host" content="collector.githubapp.com" /><meta name="octolytics-app-id" content="github" /><meta name="octolytics-event-url" content="https://collector.githubapp.com/github-external/browser_event" />
-
-  <meta name="analytics-location" content="/&lt;user-name&gt;/&lt;repo-name&gt;/blob/show" data-pjax-transient="true" />
-
-  
-
-
-
-  <meta name="optimizely-datafile" content="{&quot;version&quot;: &quot;4&quot;, &quot;rollouts&quot;: [], &quot;typedAudiences&quot;: [], &quot;anonymizeIP&quot;: true, &quot;projectId&quot;: &quot;16737760170&quot;, &quot;variables&quot;: [], &quot;featureFlags&quot;: [], &quot;experiments&quot;: [{&quot;status&quot;: &quot;Running&quot;, &quot;audienceIds&quot;: [], &quot;variations&quot;: [{&quot;variables&quot;: [], &quot;id&quot;: &quot;20106410318&quot;, &quot;key&quot;: &quot;en&quot;}, {&quot;variables&quot;: [], &quot;id&quot;: &quot;20122000362&quot;, &quot;key&quot;: &quot;ko&quot;}], &quot;id&quot;: &quot;20121990335&quot;, &quot;key&quot;: &quot;ko_homepage_translation&quot;, &quot;layerId&quot;: &quot;20100420349&quot;, &quot;trafficAllocation&quot;: [{&quot;entityId&quot;: &quot;20106410318&quot;, &quot;endOfRange&quot;: 5000}, {&quot;entityId&quot;: &quot;20122000362&quot;, &quot;endOfRange&quot;: 10000}], &quot;forcedVariations&quot;: {}}, {&quot;status&quot;: &quot;Running&quot;, &quot;audienceIds&quot;: [], &quot;variations&quot;: [{&quot;variables&quot;: [], &quot;id&quot;: &quot;20233300304&quot;, &quot;key&quot;: &quot;launch_code_variation&quot;}, {&quot;variables&quot;: [], &quot;id&quot;: &quot;20227370325&quot;, &quot;key&quot;: &quot;control&quot;}], &quot;id&quot;: &quot;20206000276&quot;, &quot;key&quot;: &quot;launch_code_verification&quot;, &quot;layerId&quot;: &quot;20233240262&quot;, &quot;trafficAllocation&quot;: [{&quot;entityId&quot;: &quot;20233300304&quot;, &quot;endOfRange&quot;: 5000}, {&quot;entityId&quot;: &quot;20233300304&quot;, &quot;endOfRange&quot;: 10000}], &quot;forcedVariations&quot;: {}}, {&quot;status&quot;: &quot;Running&quot;, &quot;audienceIds&quot;: [], &quot;variations&quot;: [{&quot;variables&quot;: [], &quot;id&quot;: &quot;20236992340&quot;, &quot;key&quot;: &quot;usd&quot;}, {&quot;variables&quot;: [], &quot;id&quot;: &quot;20184442182&quot;, &quot;key&quot;: &quot;localized_currency&quot;}], &quot;id&quot;: &quot;20233233507&quot;, &quot;key&quot;: &quot;local_currency_pricing&quot;, &quot;layerId&quot;: &quot;20212472765&quot;, &quot;trafficAllocation&quot;: [{&quot;entityId&quot;: &quot;20184442182&quot;, &quot;endOfRange&quot;: 5000}, {&quot;entityId&quot;: &quot;20236992340&quot;, &quot;endOfRange&quot;: 10000}], &quot;forcedVariations&quot;: {&quot;667685045.1617740930&quot;: &quot;localized_currency&quot;}}], &quot;audiences&quot;: [{&quot;conditions&quot;: &quot;[\&quot;or\&quot;, {\&quot;match\&quot;: \&quot;exact\&quot;, \&quot;name\&quot;: \&quot;$opt_dummy_attribute\&quot;, \&quot;type\&quot;: \&quot;custom_attribute\&quot;, \&quot;value\&quot;: \&quot;$opt_dummy_value\&quot;}]&quot;, &quot;id&quot;: &quot;$opt_dummy_audience&quot;, &quot;name&quot;: &quot;Optimizely-Generated Audience for Backwards Compatibility&quot;}], &quot;groups&quot;: [], &quot;attributes&quot;: [{&quot;id&quot;: &quot;16822470375&quot;, &quot;key&quot;: &quot;user_id&quot;}, {&quot;id&quot;: &quot;17143601254&quot;, &quot;key&quot;: &quot;spammy&quot;}, {&quot;id&quot;: &quot;18175660309&quot;, &quot;key&quot;: &quot;organization_plan&quot;}, {&quot;id&quot;: &quot;18813001570&quot;, &quot;key&quot;: &quot;is_logged_in&quot;}, {&quot;id&quot;: &quot;19073851829&quot;, &quot;key&quot;: &quot;geo&quot;}, {&quot;id&quot;: &quot;20175462351&quot;, &quot;key&quot;: &quot;requestedCurrency&quot;}], &quot;botFiltering&quot;: false, &quot;accountId&quot;: &quot;16737760170&quot;, &quot;events&quot;: [{&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;17911811441&quot;, &quot;key&quot;: &quot;hydro_click.dashboard.teacher_toolbox_cta&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18124116703&quot;, &quot;key&quot;: &quot;submit.organizations.complete_sign_up&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18145892387&quot;, &quot;key&quot;: &quot;no_metric.tracked_outside_of_optimizely&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18178755568&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.add_repo&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18180553241&quot;, &quot;key&quot;: &quot;submit.repository_imports.create&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18186103728&quot;, &quot;key&quot;: &quot;click.help.learn_more_about_repository_creation&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18188530140&quot;, &quot;key&quot;: &quot;test_event.do_not_use_in_production&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18191963644&quot;, &quot;key&quot;: &quot;click.empty_org_repo_cta.transfer_repository&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18195612788&quot;, &quot;key&quot;: &quot;click.empty_org_repo_cta.import_repository&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18210945499&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.invite_members&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18211063248&quot;, &quot;key&quot;: &quot;click.empty_org_repo_cta.create_repository&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18215721889&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.update_profile&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18224360785&quot;, &quot;key&quot;: &quot;click.org_onboarding_checklist.dismiss&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18234832286&quot;, &quot;key&quot;: &quot;submit.organization_activation.complete&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18252392383&quot;, &quot;key&quot;: &quot;submit.org_repository.create&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18257551537&quot;, &quot;key&quot;: &quot;submit.org_member_invitation.create&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18259522260&quot;, &quot;key&quot;: &quot;submit.organization_profile.update&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18564603625&quot;, &quot;key&quot;: &quot;view.classroom_select_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18568612016&quot;, &quot;key&quot;: &quot;click.classroom_sign_in_click&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18572592540&quot;, &quot;key&quot;: &quot;view.classroom_name&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18574203855&quot;, &quot;key&quot;: &quot;click.classroom_create_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18582053415&quot;, &quot;key&quot;: &quot;click.classroom_select_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18589463420&quot;, &quot;key&quot;: &quot;click.classroom_create_classroom&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18591323364&quot;, &quot;key&quot;: &quot;click.classroom_create_first_classroom&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18591652321&quot;, &quot;key&quot;: &quot;click.classroom_grant_access&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18607131425&quot;, &quot;key&quot;: &quot;view.classroom_creation&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;18831680583&quot;, &quot;key&quot;: &quot;upgrade_account_plan&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19064064515&quot;, &quot;key&quot;: &quot;click.signup&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19075373687&quot;, &quot;key&quot;: &quot;click.view_account_billing_page&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19077355841&quot;, &quot;key&quot;: &quot;click.dismiss_signup_prompt&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19079713938&quot;, &quot;key&quot;: &quot;click.contact_sales&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19120963070&quot;, &quot;key&quot;: &quot;click.compare_account_plans&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;19151690317&quot;, &quot;key&quot;: &quot;click.upgrade_account_cta&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19424193129&quot;, &quot;key&quot;: &quot;click.open_account_switcher&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19520330825&quot;, &quot;key&quot;: &quot;click.visit_account_profile&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19540970635&quot;, &quot;key&quot;: &quot;click.switch_account_context&quot;}, {&quot;experimentIds&quot;: [&quot;20121990335&quot;], &quot;id&quot;: &quot;19730198868&quot;, &quot;key&quot;: &quot;submit.homepage_signup&quot;}, {&quot;experimentIds&quot;: [&quot;20121990335&quot;], &quot;id&quot;: &quot;19820830627&quot;, &quot;key&quot;: &quot;click.homepage_signup&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;19988571001&quot;, &quot;key&quot;: &quot;click.create_enterprise_trial&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20036538294&quot;, &quot;key&quot;: &quot;click.create_organization_team&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20040653299&quot;, &quot;key&quot;: &quot;click.input_enterprise_trial_form&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20062030003&quot;, &quot;key&quot;: &quot;click.continue_with_team&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20068947153&quot;, &quot;key&quot;: &quot;click.create_organization_free&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20086636658&quot;, &quot;key&quot;: &quot;click.signup_continue.username&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20091648988&quot;, &quot;key&quot;: &quot;click.signup_continue.create_account&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20103637615&quot;, &quot;key&quot;: &quot;click.signup_continue.email&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20111574253&quot;, &quot;key&quot;: &quot;click.signup_continue.password&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20120044111&quot;, &quot;key&quot;: &quot;view.pricing_page&quot;}, {&quot;experimentIds&quot;: [&quot;20121990335&quot;, &quot;20233233507&quot;], &quot;id&quot;: &quot;20152062109&quot;, &quot;key&quot;: &quot;submit.create_account&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20165800992&quot;, &quot;key&quot;: &quot;submit.upgrade_payment_form&quot;}, {&quot;experimentIds&quot;: [&quot;20233233507&quot;], &quot;id&quot;: &quot;20171520319&quot;, &quot;key&quot;: &quot;submit.create_organization&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20222645674&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.discuss_your_needs&quot;}, {&quot;experimentIds&quot;: [&quot;20206000276&quot;], &quot;id&quot;: &quot;20227443657&quot;, &quot;key&quot;: &quot;submit.verify_primary_user_email&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20234607160&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.try_enterprise&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20238175784&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.team&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20239847212&quot;, &quot;key&quot;: &quot;click.recommended_plan_in_signup.continue_free&quot;}, {&quot;experimentIds&quot;: [], &quot;id&quot;: &quot;20251097193&quot;, &quot;key&quot;: &quot;recommended_plan&quot;}], &quot;revision&quot;: &quot;674&quot;}" />
-  <!-- To prevent page flashing, the optimizely JS needs to be loaded in the
-    <head> tag before the DOM renders -->
-  <script crossorigin="anonymous" defer="defer" integrity="sha512-KjDXI2MZJ6BWlcZ1MwvbvGb03Wdwyy9MkAaQI950EjxF4sk+HdRSqJZQ/7RuUGqP55DBAsUY9DJ4APahsReJ/g==" type="application/javascript" src="https://github.githubassets.com/assets/optimizely-2a30d723.js"></script>
-
-
-
-  
-
-      <meta name="hostname" content="github.com">
-    <meta name="user-login" content="">
-
-
-      <meta name="expected-hostname" content="github.com">
-
-
-    <meta name="enabled-features" content="MARKETPLACE_PENDING_INSTALLATIONS,AUTOCOMPLETE_EMOJIS_IN_MARKDOWN_EDITOR,ACTIONS_CONCURRENCY_UI">
-
-  <meta http-equiv="x-pjax-version" content="ff84d8f1624c8c51a2eec95279965c3706b6129c8d785ff1055762e5d9765f7a">
-  
-
-    
-  <meta name="go-import" content="github.com/quantumlib/qsim git https://github.com/quantumlib/qsim.git">
-
-  <meta name="octolytics-dimension-user_id" content="31279789" /><meta name="octolytics-dimension-user_login" content="quantumlib" /><meta name="octolytics-dimension-repository_id" content="236547448" /><meta name="octolytics-dimension-repository_nwo" content="quantumlib/qsim" /><meta name="octolytics-dimension-repository_public" content="true" /><meta name="octolytics-dimension-repository_is_fork" content="false" /><meta name="octolytics-dimension-repository_network_root_id" content="236547448" /><meta name="octolytics-dimension-repository_network_root_nwo" content="quantumlib/qsim" />
-
-
-
-    <link rel="canonical" href="https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24" data-pjax-transient>
-
-
-  <meta name="browser-stats-url" content="https://api.github.com/_private/browser/stats">
-
-  <meta name="browser-errors-url" content="https://api.github.com/_private/browser/errors">
-
-  <meta name="browser-optimizely-client-errors-url" content="https://api.github.com/_private/browser/optimizely_client/errors">
-
-  <link rel="mask-icon" href="https://github.githubassets.com/pinned-octocat.svg" color="#000000">
-  <link rel="alternate icon" class="js-site-favicon" type="image/png" href="https://github.githubassets.com/favicons/favicon.png">
-  <link rel="icon" class="js-site-favicon" type="image/svg+xml" href="https://github.githubassets.com/favicons/favicon.svg">
-
-<meta name="theme-color" content="#1e2327">
-<meta name="color-scheme" content="light dark" />
-
-
-  <link rel="manifest" href="/manifest.json" crossOrigin="use-credentials">
-
-<meta name="enabled-homepage-translation-languages" content="ko">
-
-  </head>
-
-  <body class="logged-out env-production page-responsive page-blob" style="word-wrap: break-word;">
-    
-
-    <div class="position-relative js-header-wrapper ">
-      <a href="#start-of-content" class="px-2 py-4 color-bg-info-inverse color-text-white show-on-focus js-skip-to-content">Skip to content</a>
-      <span class="progress-pjax-loader width-full js-pjax-loader-bar Progress position-fixed">
-    <span style="background-color: #79b8ff;width: 0%;" class="Progress-item progress-pjax-loader-bar"></span>
-</span>      
-      
-
-
-            <header class="Header-old header-logged-out js-details-container Details position-relative f4 py-2" role="banner">
-  <div class="container-xl d-lg-flex flex-items-center p-responsive">
-    <div class="d-flex flex-justify-between flex-items-center">
-        <a class="mr-4" href="https://github.com/" aria-label="Homepage" data-ga-click="(Logged out) Header, go to homepage, icon:logo-wordmark">
-          <svg height="32" class="octicon octicon-mark-github color-text-white" viewBox="0 0 16 16" version="1.1" width="32" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg>
-        </a>
-
-          <div class="d-lg-none css-truncate css-truncate-target width-fit p-2">
-            
-
-          </div>
-
-        <div class="d-flex flex-items-center">
-              <nux-signup-candidates
-                data-attribute-name="href"
-                data-candidate-url="/join_next?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo"
-                data-action="loaded:nux-signup-candidates#determineSignupAction"
-                
-              >
-                <a href="/join?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo"
-                  class="d-inline-block d-lg-none f5 color-text-white no-underline border color-border-tertiary rounded-2 px-2 py-1 mr-3 mr-sm-5"
-                  data-target="nux-signup-candidates.signupAction"
-                  data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;site header&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;SIGN_UP&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="17e93c2b4c85efa02ea09a6c137f6ff2f8f00a1ccb8ac8f931d637b46394bfa3"
-                >
-                  Sign&nbsp;up
-                </a>
-              </nux-signup-candidates>
-
-          <button class="btn-link d-lg-none mt-1 js-details-target" type="button" aria-label="Toggle navigation" aria-expanded="false">
-            <svg height="24" class="octicon octicon-three-bars color-text-white" viewBox="0 0 16 16" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M1 2.75A.75.75 0 011.75 2h12.5a.75.75 0 110 1.5H1.75A.75.75 0 011 2.75zm0 5A.75.75 0 011.75 7h12.5a.75.75 0 110 1.5H1.75A.75.75 0 011 7.75zM1.75 12a.75.75 0 100 1.5h12.5a.75.75 0 100-1.5H1.75z"></path></svg>
-          </button>
-        </div>
-    </div>
-
-    <div class="HeaderMenu HeaderMenu--logged-out position-fixed top-0 right-0 bottom-0 height-fit position-lg-relative d-lg-flex flex-justify-between flex-items-center flex-auto">
-      <div class="d-flex d-lg-none flex-justify-end border-bottom color-bg-secondary p-3">
-        <button class="btn-link js-details-target" type="button" aria-label="Toggle navigation" aria-expanded="false">
-          <svg height="24" class="octicon octicon-x color-text-secondary" viewBox="0 0 24 24" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M5.72 5.72a.75.75 0 011.06 0L12 10.94l5.22-5.22a.75.75 0 111.06 1.06L13.06 12l5.22 5.22a.75.75 0 11-1.06 1.06L12 13.06l-5.22 5.22a.75.75 0 01-1.06-1.06L10.94 12 5.72 6.78a.75.75 0 010-1.06z"></path></svg>
-        </button>
-      </div>
-
-        <nav class="mt-0 px-3 px-lg-0 mb-5 mb-lg-0" aria-label="Global">
-          <ul class="d-lg-flex list-style-none">
-              <li class="d-block d-lg-flex flex-lg-nowrap flex-lg-items-center border-bottom border-lg-bottom-0 mr-0 mr-lg-3 edge-item-fix position-relative flex-wrap flex-justify-between d-flex flex-items-center ">
-                <details class="HeaderMenu-details details-overlay details-reset width-full">
-                  <summary class="HeaderMenu-summary HeaderMenu-link px-0 py-3 border-0 no-wrap d-block d-lg-inline-block">
-                    Why GitHub?
-                    <svg x="0px" y="0px" viewBox="0 0 14 8" xml:space="preserve" fill="none" class="icon-chevon-down-mktg position-absolute position-lg-relative">
-                      <path d="M1,1l6.2,6L13,1"></path>
-                    </svg>
-                  </summary>
-                  <div class="dropdown-menu flex-auto rounded px-0 mt-0 pb-4 p-lg-4 position-relative position-lg-absolute left-0 left-lg-n4">
-                    <a href="/features" class="py-2 lh-condensed-ultra d-block Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Features">Features <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a>
-                    <ul class="list-style-none f5 pb-3">
-                        <li class="edge-item-fix"><a href="/mobile" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Mobile <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/features/actions" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Actions <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/features/codespaces" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Codespaces <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/features/packages" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Packages <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/features/security" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Security <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/features/code-review/" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Code review <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/features/project-management/" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Project management <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/features/integrations" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">Integrations <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                    </ul>
-
-                    <ul class="list-style-none mb-0 border-lg-top pt-lg-3">
-                      <li class="edge-item-fix"><a href="/sponsors" class="py-2 lh-condensed-ultra d-block no-underline Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Sponsors">GitHub Sponsors <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="/customer-stories" class="py-2 lh-condensed-ultra d-block no-underline Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Customer stories">Customer stories<span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                    </ul>
-                  </div>
-                </details>
-              </li>
-              <li class="border-bottom border-lg-bottom-0 mr-0 mr-lg-3">
-                <a href="/team" class="HeaderMenu-link no-underline py-3 d-block d-lg-inline-block" data-ga-click="(Logged out) Header, go to Team">Team</a>
-              </li>
-              <li class="border-bottom border-lg-bottom-0 mr-0 mr-lg-3">
-                <a href="/enterprise" class="HeaderMenu-link no-underline py-3 d-block d-lg-inline-block" data-ga-click="(Logged out) Header, go to Enterprise">Enterprise</a>
-              </li>
-
-              <li class="d-block d-lg-flex flex-lg-nowrap flex-lg-items-center border-bottom border-lg-bottom-0 mr-0 mr-lg-3 edge-item-fix position-relative flex-wrap flex-justify-between d-flex flex-items-center ">
-                <details class="HeaderMenu-details details-overlay details-reset width-full">
-                  <summary class="HeaderMenu-summary HeaderMenu-link px-0 py-3 border-0 no-wrap d-block d-lg-inline-block">
-                    Explore
-                    <svg x="0px" y="0px" viewBox="0 0 14 8" xml:space="preserve" fill="none" class="icon-chevon-down-mktg position-absolute position-lg-relative">
-                      <path d="M1,1l6.2,6L13,1"></path>
-                    </svg>
-                  </summary>
-
-                  <div class="dropdown-menu flex-auto rounded px-0 pt-2 pb-0 mt-0 pb-4 p-lg-4 position-relative position-lg-absolute left-0 left-lg-n4">
-                    <ul class="list-style-none mb-3">
-                      <li class="edge-item-fix"><a href="/explore" class="py-2 lh-condensed-ultra d-block Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Explore">Explore GitHub <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                    </ul>
-
-                    <h4 class="color-text-tertiary text-normal text-mono f5 mb-2 border-lg-top pt-lg-3">Learn and contribute</h4>
-                    <ul class="list-style-none mb-3">
-                      <li class="edge-item-fix"><a href="/topics" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Topics">Topics <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                        <li class="edge-item-fix"><a href="/collections" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Collections">Collections <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="/trending" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Trending">Trending <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="https://lab.github.com/" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Learning lab">Learning Lab <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="https://opensource.guide" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Open source guides">Open source guides <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                    </ul>
-
-                    <h4 class="color-text-tertiary text-normal text-mono f5 mb-2 border-lg-top pt-lg-3">Connect with others</h4>
-                    <ul class="list-style-none mb-0">
-                      <li class="edge-item-fix"><a href="https://github.com/readme" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover">The ReadME Project <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="https://github.com/events" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Events">Events <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="https://github.community" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Community forum">Community forum <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="https://education.github.com" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to GitHub Education">GitHub Education <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="https://stars.github.com" class="py-2 pb-0 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to GitHub Stars Program">GitHub Stars program <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                    </ul>
-                  </div>
-                </details>
-              </li>
-
-              <li class="border-bottom border-lg-bottom-0 mr-0 mr-lg-3">
-                <a href="/marketplace" class="HeaderMenu-link no-underline py-3 d-block d-lg-inline-block" data-ga-click="(Logged out) Header, go to Marketplace">Marketplace</a>
-              </li>
-
-              <li class="d-block d-lg-flex flex-lg-nowrap flex-lg-items-center border-bottom border-lg-bottom-0 mr-0 mr-lg-3 edge-item-fix position-relative flex-wrap flex-justify-between d-flex flex-items-center ">
-                <details class="HeaderMenu-details details-overlay details-reset width-full">
-                  <summary class="HeaderMenu-summary HeaderMenu-link px-0 py-3 border-0 no-wrap d-block d-lg-inline-block">
-                    Pricing
-                    <svg x="0px" y="0px" viewBox="0 0 14 8" xml:space="preserve" fill="none" class="icon-chevon-down-mktg position-absolute position-lg-relative">
-                       <path d="M1,1l6.2,6L13,1"></path>
-                    </svg>
-                  </summary>
-
-                  <div class="dropdown-menu flex-auto rounded px-0 pt-2 pb-4 mt-0 p-lg-4 position-relative position-lg-absolute left-0 left-lg-n4">
-                    <a href="/pricing" class="pb-2 lh-condensed-ultra d-block Link--primary no-underline h5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Pricing">Plans <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a>
-
-                    <ul class="list-style-none mb-3">
-                      <li class="edge-item-fix"><a href="/pricing#feature-comparison" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Compare plans">Compare plans <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                      <li class="edge-item-fix"><a href="https://enterprise.github.com/contact" class="py-2 lh-condensed-ultra d-block Link--secondary no-underline f5 Bump-link--hover" data-ga-click="(Logged out) Header, go to Contact Sales">Contact Sales <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                    </ul>
-
-                    <ul class="list-style-none mb-0 border-lg-top pt-lg-3">
-                      <li class="edge-item-fix"><a href="https://education.github.com" class="py-2 pb-0 lh-condensed-ultra d-block no-underline Link--primary no-underline h5 Bump-link--hover"  data-ga-click="(Logged out) Header, go to Education">Education <span class="Bump-link-symbol float-right text-normal color-text-tertiary pr-3">&rarr;</span></a></li>
-                    </ul>
-                  </div>
-                </details>
-              </li>
-          </ul>
-        </nav>
-
-      <div class="d-lg-flex flex-items-center px-3 px-lg-0 text-center text-lg-left">
-          <div class="d-lg-flex min-width-0 mb-3 mb-lg-0">
-            <div class="header-search flex-auto js-site-search position-relative flex-self-stretch flex-md-self-auto mb-3 mb-md-0 mr-0 mr-md-3 scoped-search site-scoped-search js-jump-to"
-  role="combobox"
-  aria-owns="jump-to-results"
-  aria-label="Search or jump to"
-  aria-haspopup="listbox"
-  aria-expanded="false"
->
-  <div class="position-relative">
-    <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="js-site-search-form" role="search" aria-label="Site" data-scope-type="Repository" data-scope-id="236547448" data-scoped-search-url="/quantumlib/qsim/search" data-owner-scoped-search-url="/orgs/quantumlib/search" data-unscoped-search-url="/search" action="/quantumlib/qsim/search" accept-charset="UTF-8" method="get">
-      <label class="form-control input-sm header-search-wrapper p-0 js-chromeless-input-container header-search-wrapper-jump-to position-relative d-flex flex-justify-between flex-items-center">
-        <input type="text"
-          class="form-control input-sm header-search-input jump-to-field js-jump-to-field js-site-search-focus js-site-search-field is-clearable"
-          data-hotkey="s,/"
-          name="q"
-          value=""
-          placeholder="Search"
-          data-unscoped-placeholder="Search GitHub"
-          data-scoped-placeholder="Search"
-          autocapitalize="off"
-          aria-autocomplete="list"
-          aria-controls="jump-to-results"
-          aria-label="Search"
-          data-jump-to-suggestions-path="/_graphql/GetSuggestedNavigationDestinations"
-          spellcheck="false"
-          autocomplete="off"
-          >
-          <input type="hidden" data-csrf="true" class="js-data-jump-to-suggestions-path-csrf" value="/iVDYbLCFDho82JlvMg5TjYtK4vPmcXkH3LKJbB/jNhafAf+tUeBoF8werutEqR3vaEjGpqXrYn4Rol2xGNDcA==" />
-          <input type="hidden" class="js-site-search-type-field" name="type" >
-            <img src="https://github.githubassets.com/images/search-key-slash.svg" alt="" class="mr-2 header-search-key-slash">
-
-            <div class="Box position-absolute overflow-hidden d-none jump-to-suggestions js-jump-to-suggestions-container">
-              
-<ul class="d-none js-jump-to-suggestions-template-container">
-  
-
-<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-suggestion" role="option">
-  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="suggestion">
-    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
-      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
-    </div>
-
-    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
-
-    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
-    </div>
-
-    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
-      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository">
-        In this repository
-      </span>
-      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
-        All GitHub
-      </span>
-      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-
-    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
-      Jump to
-      <span class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-  </a>
-</li>
-
-</ul>
-
-<ul class="d-none js-jump-to-no-results-template-container">
-  <li class="d-flex flex-justify-center flex-items-center f5 d-none js-jump-to-suggestion p-2">
-    <span class="color-text-secondary">No suggested jump to results</span>
-  </li>
-</ul>
-
-<ul id="jump-to-results" role="listbox" class="p-0 m-0 js-navigation-container jump-to-suggestions-results-container js-jump-to-suggestions-results-container">
-  
-
-<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-scoped-search d-none" role="option">
-  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="scoped_search">
-    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
-      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
-    </div>
-
-    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
-
-    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
-    </div>
-
-    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
-      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository">
-        In this repository
-      </span>
-      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
-        All GitHub
-      </span>
-      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-
-    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
-      Jump to
-      <span class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-  </a>
-</li>
-
-  
-
-<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-owner-scoped-search d-none" role="option">
-  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="owner_scoped_search">
-    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
-      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
-    </div>
-
-    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
-
-    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
-    </div>
-
-    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
-      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this organization">
-        In this organization
-      </span>
-      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
-        All GitHub
-      </span>
-      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-
-    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
-      Jump to
-      <span class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-  </a>
-</li>
-
-  
-
-<li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item js-jump-to-global-search d-none" role="option">
-  <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open p-2" href="" data-item-type="global_search">
-    <div class="jump-to-octicon js-jump-to-octicon flex-shrink-0 mr-2 text-center d-none">
-      <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path></svg>
-      <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M11.5 7a4.499 4.499 0 11-8.998 0A4.499 4.499 0 0111.5 7zm-.82 4.74a6 6 0 111.06-1.06l3.04 3.04a.75.75 0 11-1.06 1.06l-3.04-3.04z"></path></svg>
-    </div>
-
-    <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28">
-
-    <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target">
-    </div>
-
-    <div class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none js-jump-to-badge-search">
-      <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository">
-        In this repository
-      </span>
-      <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub">
-        All GitHub
-      </span>
-      <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-
-    <div aria-hidden="true" class="border rounded-1 flex-shrink-0 color-bg-tertiary px-1 color-text-tertiary ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump">
-      Jump to
-      <span class="d-inline-block ml-1 v-align-middle">↵</span>
-    </div>
-  </a>
-</li>
-
-
-</ul>
-
-            </div>
-      </label>
-</form>  </div>
-</div>
-
-          </div>
-
-        <a href="/login?return_to=%2Fquantumlib%2Fqsim%2Fblob%2Fmaster%2Fcircuits%2Fcircuit_q24"
-          class="HeaderMenu-link flex-shrink-0 no-underline mr-3"
-          data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;site header menu&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;SIGN_UP&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="0e109bf3a24ebce4c5abf1a03e2ae84137e33d67097c43f9d4802ddd06a1006e"
-          data-ga-click="(Logged out) Header, clicked Sign in, text:sign-in">
-          Sign in
-        </a>
-            <nux-signup-candidates
-              data-attribute-name="href"
-              data-candidate-url="/join_next?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo&amp;source_repo=quantumlib%2Fqsim"
-              data-action="loaded:nux-signup-candidates#determineSignupAction"
-              
-            >
-              <a href="/join?ref_cta=Sign+up&amp;ref_loc=header+logged+out&amp;ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&amp;source=header-repo&amp;source_repo=quantumlib%2Fqsim"
-                class="HeaderMenu-link flex-shrink-0 d-inline-block no-underline border color-border-tertiary rounded px-2 py-1"
-                data-target="nux-signup-candidates.signupAction"
-                data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;site header menu&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;SIGN_UP&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="0e109bf3a24ebce4c5abf1a03e2ae84137e33d67097c43f9d4802ddd06a1006e"
-                data-hydro-click="{&quot;event_type&quot;:&quot;analytics.event&quot;,&quot;payload&quot;:{&quot;category&quot;:&quot;Sign up&quot;,&quot;action&quot;:&quot;click to sign up for account&quot;,&quot;label&quot;:&quot;ref_page:/&lt;user-name&gt;/&lt;repo-name&gt;/blob/show;ref_cta:Sign up;ref_loc:header logged out&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="8eca39af97e6f4b898c2d1996b269ab98520fbcd61eb97151881315fea38fc76"
-              >
-                Sign up
-              </a>
-            </nux-signup-candidates>
-      </div>
-    </div>
-  </div>
-</header>
-
-    </div>
-
-  <div id="start-of-content" class="show-on-focus"></div>
-
-
-
-
-
-    <div data-pjax-replace id="js-flash-container">
-
-
-  <template class="js-flash-template">
-    <div class="flash flash-full  {{ className }}">
-  <div class=" px-2" >
-    <button class="flash-close js-flash-close" type="button" aria-label="Dismiss this message">
-      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
-    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
-</svg>
-    </button>
-    
-      <div>{{ message }}</div>
-
-  </div>
-</div>
-  </template>
-</div>
-
-
-    
-
-  <include-fragment class="js-notification-shelf-include-fragment" data-base-src="https://github.com/notifications/beta/shelf"></include-fragment>
-
-
-
-
-  <div
-    class="application-main "
-    data-commit-hovercards-enabled
-    data-discussion-hovercards-enabled
-    data-issue-and-pr-hovercards-enabled
-  >
-        <div itemscope itemtype="http://schema.org/SoftwareSourceCode" class="">
-    <main id="js-repo-pjax-container" data-pjax-container >
-      
-
-      
-    
-
-
-
-
-
-
-  
-
-
-  <div class="color-bg-secondary pt-3 hide-full-screen mb-5">
-
-      <div class="d-flex mb-3 px-3 px-md-4 px-lg-5">
-
-        <div class="flex-auto min-width-0 width-fit mr-3">
-            <h1 class=" d-flex flex-wrap flex-items-center break-word f3 text-normal">
-    <svg class="octicon octicon-repo color-text-secondary mr-2" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M2 2.5A2.5 2.5 0 014.5 0h8.75a.75.75 0 01.75.75v12.5a.75.75 0 01-.75.75h-2.5a.75.75 0 110-1.5h1.75v-2h-8a1 1 0 00-.714 1.7.75.75 0 01-1.072 1.05A2.495 2.495 0 012 11.5v-9zm10.5-1V9h-8c-.356 0-.694.074-1 .208V2.5a1 1 0 011-1h8zM5 12.25v3.25a.25.25 0 00.4.2l1.45-1.087a.25.25 0 01.3 0L8.6 15.7a.25.25 0 00.4-.2v-3.25a.25.25 0 00-.25-.25h-3.5a.25.25 0 00-.25.25z"></path></svg>
-  <span class="author flex-self-stretch" itemprop="author">
-    <a class="url fn" rel="author" data-hovercard-type="organization" data-hovercard-url="/orgs/quantumlib/hovercard" href="/quantumlib">quantumlib</a>
-  </span>
-  <span class="mx-1 flex-self-stretch color-text-secondary">/</span>
-  <strong itemprop="name" class="mr-2 flex-self-stretch">
-    <a data-pjax="#js-repo-pjax-container" href="/quantumlib/qsim">qsim</a>
-  </strong>
-  
-</h1>
-
-
-        </div>
-
-          <ul class="pagehead-actions flex-shrink-0 d-none d-md-inline" style="padding: 2px 0;">
-
-  <li>
-      <a class="tooltipped tooltipped-s btn btn-sm" aria-label="You must be signed in to change notification settings" rel="nofollow" data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;notification subscription menu watch&quot;,&quot;repository_id&quot;:null,&quot;auth_type&quot;:&quot;LOG_IN&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="f197f3a9c3aa1fe688c997cb5ee7a1cac54aa838665ff1b2b4dbe5984069f58c" href="/login?return_to=%2Fquantumlib%2Fqsim">
-    <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-bell">
-    <path d="M8 16a2 2 0 001.985-1.75c.017-.137-.097-.25-.235-.25h-3.5c-.138 0-.252.113-.235.25A2 2 0 008 16z"></path><path fill-rule="evenodd" d="M8 1.5A3.5 3.5 0 004.5 5v2.947c0 .346-.102.683-.294.97l-1.703 2.556a.018.018 0 00-.003.01l.001.006c0 .002.002.004.004.006a.017.017 0 00.006.004l.007.001h10.964l.007-.001a.016.016 0 00.006-.004.016.016 0 00.004-.006l.001-.007a.017.017 0 00-.003-.01l-1.703-2.554a1.75 1.75 0 01-.294-.97V5A3.5 3.5 0 008 1.5zM3 5a5 5 0 0110 0v2.947c0 .05.015.098.042.139l1.703 2.555A1.518 1.518 0 0113.482 13H2.518a1.518 1.518 0 01-1.263-2.36l1.703-2.554A.25.25 0 003 7.947V5z"></path>
-</svg>
-    Notifications
-</a>
-  </li>
-
-  <li>
-          <a class="btn btn-sm btn-with-count  tooltipped tooltipped-s" aria-label="You must be signed in to star a repository" rel="nofollow" data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;star button&quot;,&quot;repository_id&quot;:236547448,&quot;auth_type&quot;:&quot;LOG_IN&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="230a5fba514b19a9d0bf46e0f28fee134a31c7f74e000c92dfcc27543bec6bc4" href="/login?return_to=%2Fquantumlib%2Fqsim">
-      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-star v-align-text-bottom mr-1">
-    <path fill-rule="evenodd" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.75.75 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25zm0 2.445L6.615 5.5a.75.75 0 01-.564.41l-3.097.45 2.24 2.184a.75.75 0 01.216.664l-.528 3.084 2.769-1.456a.75.75 0 01.698 0l2.77 1.456-.53-3.084a.75.75 0 01.216-.664l2.24-2.183-3.096-.45a.75.75 0 01-.564-.41L8 2.694v.001z"></path>
-</svg>
-      <span>
-        Star
-</span></a>
-    <a class="social-count js-social-count" href="/quantumlib/qsim/stargazers"
-      aria-label="205 users starred this repository">
-      205
-    </a>
-
-  </li>
-
-  <li>
-        <a class="btn btn-sm btn-with-count tooltipped tooltipped-s" aria-label="You must be signed in to fork a repository" rel="nofollow" data-hydro-click="{&quot;event_type&quot;:&quot;authentication.click&quot;,&quot;payload&quot;:{&quot;location_in_page&quot;:&quot;repo details fork button&quot;,&quot;repository_id&quot;:236547448,&quot;auth_type&quot;:&quot;LOG_IN&quot;,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="f241901a9a14c4f841439fd6821dfe3bb89f66d0ad3cec50ef95be40848017e5" href="/login?return_to=%2Fquantumlib%2Fqsim">
-          <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-repo-forked">
-    <path fill-rule="evenodd" d="M5 3.25a.75.75 0 11-1.5 0 .75.75 0 011.5 0zm0 2.122a2.25 2.25 0 10-1.5 0v.878A2.25 2.25 0 005.75 8.5h1.5v2.128a2.251 2.251 0 101.5 0V8.5h1.5a2.25 2.25 0 002.25-2.25v-.878a2.25 2.25 0 10-1.5 0v.878a.75.75 0 01-.75.75h-4.5A.75.75 0 015 6.25v-.878zm3.75 7.378a.75.75 0 11-1.5 0 .75.75 0 011.5 0zm3-8.75a.75.75 0 100-1.5.75.75 0 000 1.5z"></path>
-</svg>
-          Fork
-</a>
-      <a href="/quantumlib/qsim/network/members" class="social-count"
-         aria-label="57 users forked this repository">
-        57
-      </a>
-  </li>
-</ul>
-
-      </div>
-        
-
-  <nav data-pjax="#js-repo-pjax-container" aria-label="Repository" class="js-repo-nav js-sidenav-container-pjax js-responsive-underlinenav overflow-hidden UnderlineNav px-3 px-md-4 px-lg-5 color-bg-secondary">
-
-    <ul class="UnderlineNav-body list-style-none">
-        <li class="d-flex">
-  <a href="/quantumlib/qsim" data-tab-item="i0code-tab" data-selected-links="repo_source repo_downloads repo_commits repo_releases repo_tags repo_branches repo_packages repo_deployments /quantumlib/qsim" data-hotkey="g c" data-ga-click="Repository, Navigation click, Code tab" aria-current="page" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item selected">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-code UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M4.72 3.22a.75.75 0 011.06 1.06L2.06 8l3.72 3.72a.75.75 0 11-1.06 1.06L.47 8.53a.75.75 0 010-1.06l4.25-4.25zm6.56 0a.75.75 0 10-1.06 1.06L13.94 8l-3.72 3.72a.75.75 0 101.06 1.06l4.25-4.25a.75.75 0 000-1.06l-4.25-4.25z"></path>
-</svg>
-          <span data-content="Code">Code</span>
-            <span title="Not available" class="Counter"></span>
-
-    
-</a></li>
-        <li class="d-flex">
-  <a href="/quantumlib/qsim/issues" data-tab-item="i1issues-tab" data-selected-links="repo_issues repo_labels repo_milestones /quantumlib/qsim/issues" data-hotkey="g i" data-ga-click="Repository, Navigation click, Issues tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-issue-opened UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M8 1.5a6.5 6.5 0 100 13 6.5 6.5 0 000-13zM0 8a8 8 0 1116 0A8 8 0 010 8zm9 3a1 1 0 11-2 0 1 1 0 012 0zm-.25-6.25a.75.75 0 00-1.5 0v3.5a.75.75 0 001.5 0v-3.5z"></path>
-</svg>
-          <span data-content="Issues">Issues</span>
-            <span title="19" class="Counter">19</span>
-
-    
-</a></li>
-        <li class="d-flex">
-  <a href="/quantumlib/qsim/pulls" data-tab-item="i2pull-requests-tab" data-selected-links="repo_pulls checks /quantumlib/qsim/pulls" data-hotkey="g p" data-ga-click="Repository, Navigation click, Pull requests tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-git-pull-request UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M7.177 3.073L9.573.677A.25.25 0 0110 .854v4.792a.25.25 0 01-.427.177L7.177 3.427a.25.25 0 010-.354zM3.75 2.5a.75.75 0 100 1.5.75.75 0 000-1.5zm-2.25.75a2.25 2.25 0 113 2.122v5.256a2.251 2.251 0 11-1.5 0V5.372A2.25 2.25 0 011.5 3.25zM11 2.5h-1V4h1a1 1 0 011 1v5.628a2.251 2.251 0 101.5 0V5A2.5 2.5 0 0011 2.5zm1 10.25a.75.75 0 111.5 0 .75.75 0 01-1.5 0zM3.75 12a.75.75 0 100 1.5.75.75 0 000-1.5z"></path>
-</svg>
-          <span data-content="Pull requests">Pull requests</span>
-            <span title="3" class="Counter">3</span>
-
-    
-</a></li>
-        <li class="d-flex">
-  <a href="/quantumlib/qsim/actions" data-tab-item="i3actions-tab" data-selected-links="repo_actions /quantumlib/qsim/actions" data-hotkey="g a" data-ga-click="Repository, Navigation click, Actions tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-play UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M1.5 8a6.5 6.5 0 1113 0 6.5 6.5 0 01-13 0zM8 0a8 8 0 100 16A8 8 0 008 0zM6.379 5.227A.25.25 0 006 5.442v5.117a.25.25 0 00.379.214l4.264-2.559a.25.25 0 000-.428L6.379 5.227z"></path>
-</svg>
-          <span data-content="Actions">Actions</span>
-            <span title="Not available" class="Counter"></span>
-
-    
-</a></li>
-        <li class="d-flex">
-  <a href="/quantumlib/qsim/projects" data-tab-item="i4projects-tab" data-selected-links="repo_projects new_repo_project repo_project /quantumlib/qsim/projects" data-hotkey="g b" data-ga-click="Repository, Navigation click, Projects tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-project UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M1.75 0A1.75 1.75 0 000 1.75v12.5C0 15.216.784 16 1.75 16h12.5A1.75 1.75 0 0016 14.25V1.75A1.75 1.75 0 0014.25 0H1.75zM1.5 1.75a.25.25 0 01.25-.25h12.5a.25.25 0 01.25.25v12.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V1.75zM11.75 3a.75.75 0 00-.75.75v7.5a.75.75 0 001.5 0v-7.5a.75.75 0 00-.75-.75zm-8.25.75a.75.75 0 011.5 0v5.5a.75.75 0 01-1.5 0v-5.5zM8 3a.75.75 0 00-.75.75v3.5a.75.75 0 001.5 0v-3.5A.75.75 0 008 3z"></path>
-</svg>
-          <span data-content="Projects">Projects</span>
-            <span title="0" hidden="hidden" class="Counter">0</span>
-
-    
-</a></li>
-        <li class="d-flex">
-  <a href="/quantumlib/qsim/wiki" data-tab-item="i5wiki-tab" data-selected-links="repo_wiki /quantumlib/qsim/wiki" data-hotkey="g w" data-ga-click="Repository, Navigation click, Wikis tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-book UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M0 1.75A.75.75 0 01.75 1h4.253c1.227 0 2.317.59 3 1.501A3.744 3.744 0 0111.006 1h4.245a.75.75 0 01.75.75v10.5a.75.75 0 01-.75.75h-4.507a2.25 2.25 0 00-1.591.659l-.622.621a.75.75 0 01-1.06 0l-.622-.621A2.25 2.25 0 005.258 13H.75a.75.75 0 01-.75-.75V1.75zm8.755 3a2.25 2.25 0 012.25-2.25H14.5v9h-3.757c-.71 0-1.4.201-1.992.572l.004-7.322zm-1.504 7.324l.004-5.073-.002-2.253A2.25 2.25 0 005.003 2.5H1.5v9h3.757a3.75 3.75 0 011.994.574z"></path>
-</svg>
-          <span data-content="Wiki">Wiki</span>
-            <span title="Not available" class="Counter"></span>
-
-    
-</a></li>
-        <li class="d-flex">
-  <a href="/quantumlib/qsim/security" data-tab-item="i6security-tab" data-selected-links="security overview alerts policy token_scanning code_scanning /quantumlib/qsim/security" data-hotkey="g s" data-ga-click="Repository, Navigation click, Security tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-shield UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M7.467.133a1.75 1.75 0 011.066 0l5.25 1.68A1.75 1.75 0 0115 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.7 1.7 0 01-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 011.217-1.667l5.25-1.68zm.61 1.429a.25.25 0 00-.153 0l-5.25 1.68a.25.25 0 00-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.2.2 0 00.154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.25.25 0 00-.174-.237l-5.25-1.68zM9 10.5a1 1 0 11-2 0 1 1 0 012 0zm-.25-5.75a.75.75 0 10-1.5 0v3a.75.75 0 001.5 0v-3z"></path>
-</svg>
-          <span data-content="Security">Security</span>
-            <include-fragment src="/quantumlib/qsim/security/overall-count" accept="text/fragment+html"></include-fragment>
-
-    
-</a></li>
-        <li class="d-flex">
-  <a href="/quantumlib/qsim/pulse" data-tab-item="i7insights-tab" data-selected-links="repo_graphs repo_contributors dependency_graph dependabot_updates pulse people community /quantumlib/qsim/pulse" data-ga-click="Repository, Navigation click, Insights tab" class="UnderlineNav-item hx_underlinenav-item no-wrap js-responsive-underlinenav-item">
-    
-                  <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-graph UnderlineNav-octicon d-none d-sm-inline">
-    <path fill-rule="evenodd" d="M1.5 1.75a.75.75 0 00-1.5 0v12.5c0 .414.336.75.75.75h14.5a.75.75 0 000-1.5H1.5V1.75zm14.28 2.53a.75.75 0 00-1.06-1.06L10 7.94 7.53 5.47a.75.75 0 00-1.06 0L3.22 8.72a.75.75 0 001.06 1.06L7 7.06l2.47 2.47a.75.75 0 001.06 0l5.25-5.25z"></path>
-</svg>
-          <span data-content="Insights">Insights</span>
-            <span title="Not available" class="Counter"></span>
-
-    
-</a></li>
-</ul>
-      <div style="visibility:hidden;" class="UnderlineNav-actions  js-responsive-underlinenav-overflow position-absolute pr-3 pr-md-4 pr-lg-5 right-0">      <details class="details-overlay details-reset position-relative">
-  <summary role="button">          <div class="UnderlineNav-item mr-0 border-0">
-            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-kebab-horizontal">
-    <path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path>
-</svg>
-            <span class="sr-only">More</span>
-          </div>
-</summary>
-  <div>          <details-menu role="menu" class="dropdown-menu dropdown-menu-sw">
-  
-            <ul>
-                <li data-menu-item="i0code-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim" href="/quantumlib/qsim">
-                    Code
-</a>                </li>
-                <li data-menu-item="i1issues-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/issues" href="/quantumlib/qsim/issues">
-                    Issues
-</a>                </li>
-                <li data-menu-item="i2pull-requests-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/pulls" href="/quantumlib/qsim/pulls">
-                    Pull requests
-</a>                </li>
-                <li data-menu-item="i3actions-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/actions" href="/quantumlib/qsim/actions">
-                    Actions
-</a>                </li>
-                <li data-menu-item="i4projects-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/projects" href="/quantumlib/qsim/projects">
-                    Projects
-</a>                </li>
-                <li data-menu-item="i5wiki-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/wiki" href="/quantumlib/qsim/wiki">
-                    Wiki
-</a>                </li>
-                <li data-menu-item="i6security-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/security" href="/quantumlib/qsim/security">
-                    Security
-</a>                </li>
-                <li data-menu-item="i7insights-tab" hidden>
-                  <a role="menuitem" class="js-selected-navigation-item dropdown-item" data-selected-links=" /quantumlib/qsim/pulse" href="/quantumlib/qsim/pulse">
-                    Insights
-</a>                </li>
-            </ul>
-
-</details-menu></div>
-</details></div>
-</nav>
-
-  </div>
-
-
-<div class="container-xl clearfix new-discussion-timeline px-3 px-md-4 px-lg-5">
-  <div id="repo-content-pjax-container" class="repository-content " >
-
-    
-      
-    
-<div>
-  
-
-
-    <a class="d-none js-permalink-shortcut" data-hotkey="y" href="/quantumlib/qsim/blob/1d0965c9c27f735edeb2a18b7bf5a27e7592bd6f/circuits/circuit_q24">Permalink</a>
-
-    <!-- blob contrib key: blob_contributors:v22:015210a8b5806fde8e96e079906c704b5fefe5024be20c1a6014b6e1cd358ae8 -->
-
-    <div class="d-flex flex-items-start flex-shrink-0 pb-3 flex-wrap flex-md-nowrap flex-justify-between flex-md-justify-start">
-      
-<div class="position-relative">
-  <details class="details-reset details-overlay mr-0 mb-0 " id="branch-select-menu">
-    <summary class="btn css-truncate"
-            data-hotkey="w"
-            title="Switch branches or tags">
-      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-git-branch text-gray">
-    <path fill-rule="evenodd" d="M11.75 2.5a.75.75 0 100 1.5.75.75 0 000-1.5zm-2.25.75a2.25 2.25 0 113 2.122V6A2.5 2.5 0 0110 8.5H6a1 1 0 00-1 1v1.128a2.251 2.251 0 11-1.5 0V5.372a2.25 2.25 0 111.5 0v1.836A2.492 2.492 0 016 7h4a1 1 0 001-1v-.628A2.25 2.25 0 019.5 3.25zM4.25 12a.75.75 0 100 1.5.75.75 0 000-1.5zM3.5 3.25a.75.75 0 111.5 0 .75.75 0 01-1.5 0z"></path>
-</svg>
-      <span class="css-truncate-target" data-menu-button>master</span>
-      <span class="dropdown-caret"></span>
-    </summary>
-
-      
-<div class="SelectMenu">
-  <div class="SelectMenu-modal">
-    <header class="SelectMenu-header">
-      <span class="SelectMenu-title">Switch branches/tags</span>
-      <button class="SelectMenu-closeButton" type="button" data-toggle-for="branch-select-menu"><svg aria-label="Close menu" aria-hidden="false" role="img" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
-    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
-</svg></button>
-    </header>
-
-    <input-demux data-action="tab-container-change:input-demux#storeInput tab-container-changed:input-demux#updateInput">
-      <tab-container class="d-flex flex-column js-branches-tags-tabs" style="min-height: 0;">
-        <div class="SelectMenu-filter">
-          <input data-target="input-demux.source"
-                 id="context-commitish-filter-field"
-                 class="SelectMenu-input form-control"
-                 aria-owns="ref-list-branches"
-                 data-controls-ref-menu-id="ref-list-branches"
-                 autofocus
-                 autocomplete="off"
-                 aria-label="Filter branches/tags"
-                 placeholder="Filter branches/tags"
-                 type="text"
-          >
-        </div>
-
-        <div class="SelectMenu-tabs" role="tablist" data-target="input-demux.control" >
-          <button class="SelectMenu-tab" type="button" role="tab" aria-selected="true">Branches</button>
-          <button class="SelectMenu-tab" type="button" role="tab">Tags</button>
-        </div>
-
-        <div role="tabpanel" id="ref-list-branches" data-filter-placeholder="Filter branches/tags" class="d-flex flex-column flex-auto overflow-auto" tabindex="">
-          <ref-selector
-            type="branch"
-            data-targets="input-demux.sinks"
-            data-action="
-              input-entered:ref-selector#inputEntered
-              tab-selected:ref-selector#tabSelected
-              focus-list:ref-selector#focusFirstListMember
-            "
-            query-endpoint="/quantumlib/qsim/refs"
-            
-            cache-key="v0:1620746711.204412"
-            current-committish="bWFzdGVy"
-            default-branch="bWFzdGVy"
-            name-with-owner="cXVhbnR1bWxpYi9xc2lt"
-          >
-
-              <template data-target="ref-selector.noMatchTemplate">
-    <div class="SelectMenu-message">Nothing to show</div>
-</template>
-
-
-            <!-- TODO: this max-height is necessary or else the branch list won't scroll.  why? -->
-            <div data-target="ref-selector.listContainer" role="menu" class="SelectMenu-list " style="max-height: 330px">
-              <div class="SelectMenu-loading pt-3 pb-0" aria-label="Menu is loading">
-                <svg style="box-sizing: content-box; color: var(--color-icon-primary);" viewBox="0 0 16 16" fill="none" width="32" height="32" class="anim-rotate">
-  <circle cx="8" cy="8" r="7" stroke="currentColor" stroke-opacity="0.25" stroke-width="2" vector-effect="non-scaling-stroke" />
-  <path d="M15 8a7.002 7.002 0 00-7-7" stroke="currentColor" stroke-width="2" stroke-linecap="round" vector-effect="non-scaling-stroke" />
-</svg>
-              </div>
-            </div>
-
-              <template data-target="ref-selector.itemTemplate">
-  <a href="https://github.com/quantumlib/qsim/blob/{{ urlEncodedRefName }}/circuits/circuit_q24" class="SelectMenu-item" role="menuitemradio" rel="nofollow" aria-checked="{{ isCurrent }}" data-index="{{ index }}">
-    <svg class="octicon octicon-check SelectMenu-icon SelectMenu-icon--check" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M13.78 4.22a.75.75 0 010 1.06l-7.25 7.25a.75.75 0 01-1.06 0L2.22 9.28a.75.75 0 011.06-1.06L6 10.94l6.72-6.72a.75.75 0 011.06 0z"></path></svg>
-    <span class="flex-1 css-truncate css-truncate-overflow {{ isFilteringClass }}">{{ refName }}</span>
-    <span hidden="{{ isNotDefault }}" class="Label Label--secondary flex-self-start">default</span>
-  </a>
-</template>
-
-
-              <footer class="SelectMenu-footer"><a href="/quantumlib/qsim/branches">View all branches</a></footer>
-          </ref-selector>
-
-        </div>
-
-        <div role="tabpanel" id="tags-menu" data-filter-placeholder="Find a tag" class="d-flex flex-column flex-auto overflow-auto" tabindex="" hidden>
-          <ref-selector
-            type="tag"
-            data-action="
-              input-entered:ref-selector#inputEntered
-              tab-selected:ref-selector#tabSelected
-              focus-list:ref-selector#focusFirstListMember
-            "
-            data-targets="input-demux.sinks"
-            query-endpoint="/quantumlib/qsim/refs"
-            cache-key="v0:1620746711.204412"
-            current-committish="bWFzdGVy"
-            default-branch="bWFzdGVy"
-            name-with-owner="cXVhbnR1bWxpYi9xc2lt"
-          >
-
-            <template data-target="ref-selector.noMatchTemplate">
-              <div class="SelectMenu-message" data-index="{{ index }}">Nothing to show</div>
-            </template>
-
-              <template data-target="ref-selector.itemTemplate">
-  <a href="https://github.com/quantumlib/qsim/blob/{{ urlEncodedRefName }}/circuits/circuit_q24" class="SelectMenu-item" role="menuitemradio" rel="nofollow" aria-checked="{{ isCurrent }}" data-index="{{ index }}">
-    <svg class="octicon octicon-check SelectMenu-icon SelectMenu-icon--check" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M13.78 4.22a.75.75 0 010 1.06l-7.25 7.25a.75.75 0 01-1.06 0L2.22 9.28a.75.75 0 011.06-1.06L6 10.94l6.72-6.72a.75.75 0 011.06 0z"></path></svg>
-    <span class="flex-1 css-truncate css-truncate-overflow {{ isFilteringClass }}">{{ refName }}</span>
-    <span hidden="{{ isNotDefault }}" class="Label Label--secondary flex-self-start">default</span>
-  </a>
-</template>
-
-
-            <div data-target="ref-selector.listContainer" role="menu" class="SelectMenu-list" style="max-height: 330px">
-              <div class="SelectMenu-loading pt-3 pb-0" aria-label="Menu is loading">
-                <svg style="box-sizing: content-box; color: var(--color-icon-primary);" viewBox="0 0 16 16" fill="none" width="32" height="32" class="anim-rotate">
-  <circle cx="8" cy="8" r="7" stroke="currentColor" stroke-opacity="0.25" stroke-width="2" vector-effect="non-scaling-stroke" />
-  <path d="M15 8a7.002 7.002 0 00-7-7" stroke="currentColor" stroke-width="2" stroke-linecap="round" vector-effect="non-scaling-stroke" />
-</svg>
-              </div>
-            </div>
-              <footer class="SelectMenu-footer"><a href="/quantumlib/qsim/tags">View all tags</a></footer>
-          </ref-selector>
-        </div>
-      </tab-container>
-    </input-demux>
-  </div>
-</div>
-
-  </details>
-
-</div>
-
-      <h2 id="blob-path" class="breadcrumb flex-auto flex-self-center min-width-0 text-normal mx-2 width-full width-md-auto flex-order-1 flex-md-order-none mt-3 mt-md-0">
-        <span class="js-repo-root text-bold"><span class="js-path-segment d-inline-block wb-break-all"><a data-pjax="true" href="/quantumlib/qsim"><span>qsim</span></a></span></span><span class="separator">/</span><span class="js-path-segment d-inline-block wb-break-all"><a data-pjax="true" href="/quantumlib/qsim/tree/master/circuits"><span>circuits</span></a></span><span class="separator">/</span><strong class="final-path">circuit_q24</strong>
-      </h2>
-      <a href="/quantumlib/qsim/find/master"
-            class="js-pjax-capture-input btn mr-2 d-none d-md-block"
-            data-pjax
-            data-hotkey="t">
-        Go to file
-      </a>
-
-      <details id="blob-more-options-details" class="details-overlay details-reset position-relative">
-  <summary role="button" class="btn">
-  
-            <svg aria-label="More options" role="img" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-kebab-horizontal">
-    <path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path>
-</svg>
-
-  
-
-</summary>
-  <div>          <ul class="dropdown-menu dropdown-menu-sw">
-            <li class="d-block d-md-none">
-              <a class="dropdown-item d-flex flex-items-baseline" data-hydro-click="{&quot;event_type&quot;:&quot;repository.click&quot;,&quot;payload&quot;:{&quot;target&quot;:&quot;FIND_FILE_BUTTON&quot;,&quot;repository_id&quot;:236547448,&quot;originating_url&quot;:&quot;https://github.com/quantumlib/qsim/blob/master/circuits/circuit_q24&quot;,&quot;user_id&quot;:null}}" data-hydro-click-hmac="e3859f32acd054d8f94869880124db148dd267228c790ef09f547ee94f089fbe" data-ga-click="Repository, find file, location:repo overview" data-hotkey="t" data-pjax="true" href="/quantumlib/qsim/find/master">
-                <span class="flex-auto">Go to file</span>
-                <span class="text-small color-text-secondary" aria-hidden="true">T</span>
-</a>            </li>
-            <li data-toggle-for="blob-more-options-details">
-              <button type="button" data-toggle-for="jumpto-line-details-dialog" class="btn-link dropdown-item">
-                <span class="d-flex flex-items-baseline">
-                  <span class="flex-auto">Go to line</span>
-                  <span class="text-small color-text-secondary" aria-hidden="true">L</span>
-                </span>
-              </button>
-            </li>
-            <li class="dropdown-divider" role="none"></li>
-            <li>
-              <clipboard-copy value="circuits/circuit_q24" class="dropdown-item cursor-pointer" data-toggle-for="blob-more-options-details">
-                Copy path
-              </clipboard-copy>
-            </li>
-            <li>
-              <clipboard-copy value="https://github.com/quantumlib/qsim/blob/1d0965c9c27f735edeb2a18b7bf5a27e7592bd6f/circuits/circuit_q24" class="dropdown-item cursor-pointer" data-toggle-for="blob-more-options-details" >
-                <span class="d-flex flex-items-baseline">
-                  <span class="flex-auto">Copy permalink</span>
-                </span>
-              </clipboard-copy>
-            </li>
-          </ul>
-</div>
-</details>    </div>
-
-
-
-    <div class="Box d-flex flex-column flex-shrink-0 mb-3">
-      
-  <div class="Box-header Box-header--blue Details js-details-container">
-      <div class="d-flex flex-items-center">
-        <span class="flex-shrink-0 ml-n1 mr-n1 mt-n1 mb-n1">
-          <a rel="contributor" data-skip-pjax="true" data-hovercard-type="user" data-hovercard-url="/users/sergeisakov/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="/sergeisakov"><img class="avatar avatar-user" src="https://avatars.githubusercontent.com/u/54642992?s=48&amp;v=4" width="24" height="24" alt="@sergeisakov" /></a>
-        </span>
-        <div class="flex-1 d-flex flex-items-center ml-3 min-width-0">
-          <div class="css-truncate css-truncate-overflow">
-            <a class="text-bold Link--primary" rel="contributor" data-hovercard-type="user" data-hovercard-url="/users/sergeisakov/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="/sergeisakov">sergeisakov</a>
-
-                <span class="markdown-title">
-                  <a data-pjax="true" title="Add qsim and qsimh simulators." class="Link--secondary" href="/quantumlib/qsim/commit/598c0b0a7dda9ccff31f7471c2714fedcb39f4c2">Add qsim and qsimh simulators.</a>
-                </span>
-          </div>
-
-
-          <span class="ml-2">
-            <include-fragment accept="text/fragment+html" src="/quantumlib/qsim/commit/598c0b0a7dda9ccff31f7471c2714fedcb39f4c2/rollup?direction=e" class="d-inline"></include-fragment>
-          </span>
-        </div>
-        <div class="ml-3 d-flex flex-shrink-0 flex-items-center flex-justify-end color-text-secondary no-wrap">
-          <span class="d-none d-md-inline">
-            <span>Latest commit</span>
-            <a class="text-small text-mono Link--secondary" href="/quantumlib/qsim/commit/598c0b0a7dda9ccff31f7471c2714fedcb39f4c2" data-pjax>598c0b0</a>
-            <span itemprop="dateModified"><relative-time datetime="2020-02-07T16:40:22Z" class="no-wrap">Feb 7, 2020</relative-time></span>
-          </span>
-
-          <a data-pjax href="/quantumlib/qsim/commits/master/circuits/circuit_q24" class="ml-3 no-wrap Link--primary no-underline">
-            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-history text-gray">
-    <path fill-rule="evenodd" d="M1.643 3.143L.427 1.927A.25.25 0 000 2.104V5.75c0 .138.112.25.25.25h3.646a.25.25 0 00.177-.427L2.715 4.215a6.5 6.5 0 11-1.18 4.458.75.75 0 10-1.493.154 8.001 8.001 0 101.6-5.684zM7.75 4a.75.75 0 01.75.75v2.992l2.028.812a.75.75 0 01-.557 1.392l-2.5-1A.75.75 0 017 8.25v-3.5A.75.75 0 017.75 4z"></path>
-</svg>
-            <span class="d-none d-sm-inline">
-              <strong>History</strong>
-            </span>
-          </a>
-        </div>
-      </div>
-
-  </div>
-
-  <div class="Box-body d-flex flex-items-center flex-auto border-bottom-0 flex-wrap" >
-    <details class="details-reset details-overlay details-overlay-dark lh-default color-text-primary float-left mr-3" id="blob_contributors_box">
-      <summary class="Link--primary">
-        <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-people text-gray">
-    <path fill-rule="evenodd" d="M5.5 3.5a2 2 0 100 4 2 2 0 000-4zM2 5.5a3.5 3.5 0 115.898 2.549 5.507 5.507 0 013.034 4.084.75.75 0 11-1.482.235 4.001 4.001 0 00-7.9 0 .75.75 0 01-1.482-.236A5.507 5.507 0 013.102 8.05 3.49 3.49 0 012 5.5zM11 4a.75.75 0 100 1.5 1.5 1.5 0 01.666 2.844.75.75 0 00-.416.672v.352a.75.75 0 00.574.73c1.2.289 2.162 1.2 2.522 2.372a.75.75 0 101.434-.44 5.01 5.01 0 00-2.56-3.012A3 3 0 0011 4z"></path>
-</svg>
-        <strong>1</strong>
-        
-        contributor
-      </summary>
-      <details-dialog
-        class="Box Box--overlay d-flex flex-column anim-fade-in fast"
-        aria-label="Users who have contributed to this file"
-        src="/quantumlib/qsim/contributors-list/master/circuits/circuit_q24" preload>
-        <div class="Box-header">
-          <button class="Box-btn-octicon btn-octicon float-right" type="button" aria-label="Close dialog" data-close-dialog>
-            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
-    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
-</svg>
-          </button>
-          <h3 class="Box-title">
-            Users who have contributed to this file
-          </h3>
-        </div>
-        <include-fragment>
-          <svg style="box-sizing: content-box; color: var(--color-icon-primary);" viewBox="0 0 16 16" fill="none" width="32" height="32" class="my-3 mx-auto d-block anim-rotate">
-  <circle cx="8" cy="8" r="7" stroke="currentColor" stroke-opacity="0.25" stroke-width="2" vector-effect="non-scaling-stroke" />
-  <path d="M15 8a7.002 7.002 0 00-7-7" stroke="currentColor" stroke-width="2" stroke-linecap="round" vector-effect="non-scaling-stroke" />
-</svg>
-        </include-fragment>
-      </details-dialog>
-    </details>
-  </div>
-    </div>
-
-
-
-
-
-
-
-
-  
-    <div data-target="readme-toc.content" class="Box mt-3 position-relative
-    ">
-      
-  <div
-    class="Box-header py-2 pr-2 d-flex flex-shrink-0 flex-md-row flex-items-center"
-    
-  >
-
-
-  <div class="text-mono f6 flex-auto pr-3 flex-order-2 flex-md-order-1">
-
-      1258 lines (1258 sloc)
-      <span class="file-info-divider"></span>
-    12.8 KB
-  </div>
-
-  <div class="d-flex py-1 py-md-0 flex-auto flex-order-1 flex-md-order-2 flex-sm-grow-0 flex-justify-between hide-sm hide-md">
-
-    <div class="BtnGroup">
-      <a href="/quantumlib/qsim/raw/master/circuits/circuit_q24" id="raw-url" role="button" class="btn-sm btn BtnGroup-item">
-  
-  Raw
-  
-
-</a>
-        <a href="/quantumlib/qsim/blame/master/circuits/circuit_q24" data-hotkey="b" role="button" class="js-update-url-with-hash btn-sm btn BtnGroup-item">
-  
-  Blame
-  
-
-</a>
-    </div>
-
-    <div>
-          <a class="btn-octicon tooltipped tooltipped-nw js-remove-unless-platform"
-             data-platforms="windows,mac"
-             href="https://desktop.github.com"
-             aria-label="Open this file in GitHub Desktop"
-             data-ga-click="Repository, open with desktop">
-              <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-device-desktop">
-    <path fill-rule="evenodd" d="M1.75 2.5h12.5a.25.25 0 01.25.25v7.5a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25v-7.5a.25.25 0 01.25-.25zM14.25 1H1.75A1.75 1.75 0 000 2.75v7.5C0 11.216.784 12 1.75 12h3.727c-.1 1.041-.52 1.872-1.292 2.757A.75.75 0 004.75 16h6.5a.75.75 0 00.565-1.243c-.772-.885-1.193-1.716-1.292-2.757h3.727A1.75 1.75 0 0016 10.25v-7.5A1.75 1.75 0 0014.25 1zM9.018 12H6.982a5.72 5.72 0 01-.765 2.5h3.566a5.72 5.72 0 01-.765-2.5z"></path>
-</svg>
-          </a>
-
-          <a href="/login?return_to=%2Fquantumlib%2Fqsim%2Fblob%2Fmaster%2Fcircuits%2Fcircuit_q24" class="btn-octicon disabled tooltipped tooltipped-nw"
-            aria-label="You must be signed in to make or propose changes">
-            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-pencil">
-    <path fill-rule="evenodd" d="M11.013 1.427a1.75 1.75 0 012.474 0l1.086 1.086a1.75 1.75 0 010 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 01-.927-.928l.929-3.25a1.75 1.75 0 01.445-.758l8.61-8.61zm1.414 1.06a.25.25 0 00-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 000-.354l-1.086-1.086zM11.189 6.25L9.75 4.81l-6.286 6.287a.25.25 0 00-.064.108l-.558 1.953 1.953-.558a.249.249 0 00.108-.064l6.286-6.286z"></path>
-</svg>
-          </a>
-          <a href="/login?return_to=%2Fquantumlib%2Fqsim%2Fblob%2Fmaster%2Fcircuits%2Fcircuit_q24" class="btn-octicon btn-octicon-danger disabled tooltipped tooltipped-nw"
-            aria-label="You must be signed in to make or propose changes">
-            <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-trash">
-    <path fill-rule="evenodd" d="M6.5 1.75a.25.25 0 01.25-.25h2.5a.25.25 0 01.25.25V3h-3V1.75zm4.5 0V3h2.25a.75.75 0 010 1.5H2.75a.75.75 0 010-1.5H5V1.75C5 .784 5.784 0 6.75 0h2.5C10.216 0 11 .784 11 1.75zM4.496 6.675a.75.75 0 10-1.492.15l.66 6.6A1.75 1.75 0 005.405 15h5.19c.9 0 1.652-.681 1.741-1.576l.66-6.6a.75.75 0 00-1.492-.149l-.66 6.6a.25.25 0 01-.249.225h-5.19a.25.25 0 01-.249-.225l-.66-6.6z"></path>
-</svg>
-          </a>
-    </div>
-  </div>
-
-    <div class="d-flex hide-lg hide-xl flex-order-2 flex-grow-0">
-      <details class="dropdown details-reset details-overlay d-inline-block">
-        <summary class="btn-octicon" aria-haspopup="true" aria-label="possible actions">
-          <svg height="16" class="octicon octicon-kebab-horizontal" viewBox="0 0 16 16" version="1.1" width="16" aria-hidden="true"><path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path></svg>
-        </summary>
-
-        <ul class="dropdown-menu dropdown-menu-sw">
-            <li>
-                <a class="dropdown-item tooltipped tooltipped-nw js-remove-unless-platform"
-                   data-platforms="windows,mac"
-                   href="https://desktop.github.com"
-                   data-ga-click="Repository, open with desktop">
-                  Open with Desktop
-                </a>
-            </li>
-          <li>
-            <a class="dropdown-item" href="/quantumlib/qsim/raw/master/circuits/circuit_q24">
-              View raw
-            </a>
-          </li>
-            <li>
-              <a class="dropdown-item" href="/quantumlib/qsim/blame/master/circuits/circuit_q24">
-                View blame
-              </a>
-            </li>
-
-        </ul>
-      </details>
-    </div>
-</div>
-
-
-      
-  <div itemprop="text" class="Box-body p-0 blob-wrapper data type-text  gist-border-0">
-      
-<table class="highlight tab-size js-file-line-container" data-tab-size="8" data-paste-markdown-skip>
-      <tr>
-        <td id="L1" class="blob-num js-line-number" data-line-number="1"></td>
-        <td id="LC1" class="blob-code blob-code-inner js-file-line">24</td>
-      </tr>
-      <tr>
-        <td id="L2" class="blob-num js-line-number" data-line-number="2"></td>
-        <td id="LC2" class="blob-code blob-code-inner js-file-line">0 h 0</td>
-      </tr>
-      <tr>
-        <td id="L3" class="blob-num js-line-number" data-line-number="3"></td>
-        <td id="LC3" class="blob-code blob-code-inner js-file-line">0 h 1</td>
-      </tr>
-      <tr>
-        <td id="L4" class="blob-num js-line-number" data-line-number="4"></td>
-        <td id="LC4" class="blob-code blob-code-inner js-file-line">0 h 2</td>
-      </tr>
-      <tr>
-        <td id="L5" class="blob-num js-line-number" data-line-number="5"></td>
-        <td id="LC5" class="blob-code blob-code-inner js-file-line">0 h 3</td>
-      </tr>
-      <tr>
-        <td id="L6" class="blob-num js-line-number" data-line-number="6"></td>
-        <td id="LC6" class="blob-code blob-code-inner js-file-line">0 h 4</td>
-      </tr>
-      <tr>
-        <td id="L7" class="blob-num js-line-number" data-line-number="7"></td>
-        <td id="LC7" class="blob-code blob-code-inner js-file-line">0 h 5</td>
-      </tr>
-      <tr>
-        <td id="L8" class="blob-num js-line-number" data-line-number="8"></td>
-        <td id="LC8" class="blob-code blob-code-inner js-file-line">0 h 6</td>
-      </tr>
-      <tr>
-        <td id="L9" class="blob-num js-line-number" data-line-number="9"></td>
-        <td id="LC9" class="blob-code blob-code-inner js-file-line">0 h 7</td>
-      </tr>
-      <tr>
-        <td id="L10" class="blob-num js-line-number" data-line-number="10"></td>
-        <td id="LC10" class="blob-code blob-code-inner js-file-line">0 h 8</td>
-      </tr>
-      <tr>
-        <td id="L11" class="blob-num js-line-number" data-line-number="11"></td>
-        <td id="LC11" class="blob-code blob-code-inner js-file-line">0 h 9</td>
-      </tr>
-      <tr>
-        <td id="L12" class="blob-num js-line-number" data-line-number="12"></td>
-        <td id="LC12" class="blob-code blob-code-inner js-file-line">0 h 10</td>
-      </tr>
-      <tr>
-        <td id="L13" class="blob-num js-line-number" data-line-number="13"></td>
-        <td id="LC13" class="blob-code blob-code-inner js-file-line">0 h 11</td>
-      </tr>
-      <tr>
-        <td id="L14" class="blob-num js-line-number" data-line-number="14"></td>
-        <td id="LC14" class="blob-code blob-code-inner js-file-line">0 h 12</td>
-      </tr>
-      <tr>
-        <td id="L15" class="blob-num js-line-number" data-line-number="15"></td>
-        <td id="LC15" class="blob-code blob-code-inner js-file-line">0 h 13</td>
-      </tr>
-      <tr>
-        <td id="L16" class="blob-num js-line-number" data-line-number="16"></td>
-        <td id="LC16" class="blob-code blob-code-inner js-file-line">0 h 14</td>
-      </tr>
-      <tr>
-        <td id="L17" class="blob-num js-line-number" data-line-number="17"></td>
-        <td id="LC17" class="blob-code blob-code-inner js-file-line">0 h 15</td>
-      </tr>
-      <tr>
-        <td id="L18" class="blob-num js-line-number" data-line-number="18"></td>
-        <td id="LC18" class="blob-code blob-code-inner js-file-line">0 h 16</td>
-      </tr>
-      <tr>
-        <td id="L19" class="blob-num js-line-number" data-line-number="19"></td>
-        <td id="LC19" class="blob-code blob-code-inner js-file-line">0 h 17</td>
-      </tr>
-      <tr>
-        <td id="L20" class="blob-num js-line-number" data-line-number="20"></td>
-        <td id="LC20" class="blob-code blob-code-inner js-file-line">0 h 18</td>
-      </tr>
-      <tr>
-        <td id="L21" class="blob-num js-line-number" data-line-number="21"></td>
-        <td id="LC21" class="blob-code blob-code-inner js-file-line">0 h 19</td>
-      </tr>
-      <tr>
-        <td id="L22" class="blob-num js-line-number" data-line-number="22"></td>
-        <td id="LC22" class="blob-code blob-code-inner js-file-line">0 h 20</td>
-      </tr>
-      <tr>
-        <td id="L23" class="blob-num js-line-number" data-line-number="23"></td>
-        <td id="LC23" class="blob-code blob-code-inner js-file-line">0 h 21</td>
-      </tr>
-      <tr>
-        <td id="L24" class="blob-num js-line-number" data-line-number="24"></td>
-        <td id="LC24" class="blob-code blob-code-inner js-file-line">0 h 22</td>
-      </tr>
-      <tr>
-        <td id="L25" class="blob-num js-line-number" data-line-number="25"></td>
-        <td id="LC25" class="blob-code blob-code-inner js-file-line">0 h 23</td>
-      </tr>
-      <tr>
-        <td id="L26" class="blob-num js-line-number" data-line-number="26"></td>
-        <td id="LC26" class="blob-code blob-code-inner js-file-line">1 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L27" class="blob-num js-line-number" data-line-number="27"></td>
-        <td id="LC27" class="blob-code blob-code-inner js-file-line">1 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L28" class="blob-num js-line-number" data-line-number="28"></td>
-        <td id="LC28" class="blob-code blob-code-inner js-file-line">1 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L29" class="blob-num js-line-number" data-line-number="29"></td>
-        <td id="LC29" class="blob-code blob-code-inner js-file-line">1 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L30" class="blob-num js-line-number" data-line-number="30"></td>
-        <td id="LC30" class="blob-code blob-code-inner js-file-line">1 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L31" class="blob-num js-line-number" data-line-number="31"></td>
-        <td id="LC31" class="blob-code blob-code-inner js-file-line">1 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L32" class="blob-num js-line-number" data-line-number="32"></td>
-        <td id="LC32" class="blob-code blob-code-inner js-file-line">2 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L33" class="blob-num js-line-number" data-line-number="33"></td>
-        <td id="LC33" class="blob-code blob-code-inner js-file-line">2 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L34" class="blob-num js-line-number" data-line-number="34"></td>
-        <td id="LC34" class="blob-code blob-code-inner js-file-line">2 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L35" class="blob-num js-line-number" data-line-number="35"></td>
-        <td id="LC35" class="blob-code blob-code-inner js-file-line">2 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L36" class="blob-num js-line-number" data-line-number="36"></td>
-        <td id="LC36" class="blob-code blob-code-inner js-file-line">2 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L37" class="blob-num js-line-number" data-line-number="37"></td>
-        <td id="LC37" class="blob-code blob-code-inner js-file-line">2 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L38" class="blob-num js-line-number" data-line-number="38"></td>
-        <td id="LC38" class="blob-code blob-code-inner js-file-line">2 t 0</td>
-      </tr>
-      <tr>
-        <td id="L39" class="blob-num js-line-number" data-line-number="39"></td>
-        <td id="LC39" class="blob-code blob-code-inner js-file-line">2 t 1</td>
-      </tr>
-      <tr>
-        <td id="L40" class="blob-num js-line-number" data-line-number="40"></td>
-        <td id="LC40" class="blob-code blob-code-inner js-file-line">2 t 4</td>
-      </tr>
-      <tr>
-        <td id="L41" class="blob-num js-line-number" data-line-number="41"></td>
-        <td id="LC41" class="blob-code blob-code-inner js-file-line">2 t 5</td>
-      </tr>
-      <tr>
-        <td id="L42" class="blob-num js-line-number" data-line-number="42"></td>
-        <td id="LC42" class="blob-code blob-code-inner js-file-line">2 t 8</td>
-      </tr>
-      <tr>
-        <td id="L43" class="blob-num js-line-number" data-line-number="43"></td>
-        <td id="LC43" class="blob-code blob-code-inner js-file-line">2 t 9</td>
-      </tr>
-      <tr>
-        <td id="L44" class="blob-num js-line-number" data-line-number="44"></td>
-        <td id="LC44" class="blob-code blob-code-inner js-file-line">2 t 12</td>
-      </tr>
-      <tr>
-        <td id="L45" class="blob-num js-line-number" data-line-number="45"></td>
-        <td id="LC45" class="blob-code blob-code-inner js-file-line">2 t 13</td>
-      </tr>
-      <tr>
-        <td id="L46" class="blob-num js-line-number" data-line-number="46"></td>
-        <td id="LC46" class="blob-code blob-code-inner js-file-line">2 t 16</td>
-      </tr>
-      <tr>
-        <td id="L47" class="blob-num js-line-number" data-line-number="47"></td>
-        <td id="LC47" class="blob-code blob-code-inner js-file-line">2 t 17</td>
-      </tr>
-      <tr>
-        <td id="L48" class="blob-num js-line-number" data-line-number="48"></td>
-        <td id="LC48" class="blob-code blob-code-inner js-file-line">2 t 20</td>
-      </tr>
-      <tr>
-        <td id="L49" class="blob-num js-line-number" data-line-number="49"></td>
-        <td id="LC49" class="blob-code blob-code-inner js-file-line">2 t 21</td>
-      </tr>
-      <tr>
-        <td id="L50" class="blob-num js-line-number" data-line-number="50"></td>
-        <td id="LC50" class="blob-code blob-code-inner js-file-line">3 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L51" class="blob-num js-line-number" data-line-number="51"></td>
-        <td id="LC51" class="blob-code blob-code-inner js-file-line">3 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L52" class="blob-num js-line-number" data-line-number="52"></td>
-        <td id="LC52" class="blob-code blob-code-inner js-file-line">3 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L53" class="blob-num js-line-number" data-line-number="53"></td>
-        <td id="LC53" class="blob-code blob-code-inner js-file-line">3 t 2</td>
-      </tr>
-      <tr>
-        <td id="L54" class="blob-num js-line-number" data-line-number="54"></td>
-        <td id="LC54" class="blob-code blob-code-inner js-file-line">3 t 3</td>
-      </tr>
-      <tr>
-        <td id="L55" class="blob-num js-line-number" data-line-number="55"></td>
-        <td id="LC55" class="blob-code blob-code-inner js-file-line">3 t 7</td>
-      </tr>
-      <tr>
-        <td id="L56" class="blob-num js-line-number" data-line-number="56"></td>
-        <td id="LC56" class="blob-code blob-code-inner js-file-line">3 t 11</td>
-      </tr>
-      <tr>
-        <td id="L57" class="blob-num js-line-number" data-line-number="57"></td>
-        <td id="LC57" class="blob-code blob-code-inner js-file-line">3 t 15</td>
-      </tr>
-      <tr>
-        <td id="L58" class="blob-num js-line-number" data-line-number="58"></td>
-        <td id="LC58" class="blob-code blob-code-inner js-file-line">3 t 18</td>
-      </tr>
-      <tr>
-        <td id="L59" class="blob-num js-line-number" data-line-number="59"></td>
-        <td id="LC59" class="blob-code blob-code-inner js-file-line">3 t 19</td>
-      </tr>
-      <tr>
-        <td id="L60" class="blob-num js-line-number" data-line-number="60"></td>
-        <td id="LC60" class="blob-code blob-code-inner js-file-line">3 t 22</td>
-      </tr>
-      <tr>
-        <td id="L61" class="blob-num js-line-number" data-line-number="61"></td>
-        <td id="LC61" class="blob-code blob-code-inner js-file-line">3 t 23</td>
-      </tr>
-      <tr>
-        <td id="L62" class="blob-num js-line-number" data-line-number="62"></td>
-        <td id="LC62" class="blob-code blob-code-inner js-file-line">4 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L63" class="blob-num js-line-number" data-line-number="63"></td>
-        <td id="LC63" class="blob-code blob-code-inner js-file-line">4 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L64" class="blob-num js-line-number" data-line-number="64"></td>
-        <td id="LC64" class="blob-code blob-code-inner js-file-line">4 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L65" class="blob-num js-line-number" data-line-number="65"></td>
-        <td id="LC65" class="blob-code blob-code-inner js-file-line">4 t 6</td>
-      </tr>
-      <tr>
-        <td id="L66" class="blob-num js-line-number" data-line-number="66"></td>
-        <td id="LC66" class="blob-code blob-code-inner js-file-line">4 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L67" class="blob-num js-line-number" data-line-number="67"></td>
-        <td id="LC67" class="blob-code blob-code-inner js-file-line">4 t 10</td>
-      </tr>
-      <tr>
-        <td id="L68" class="blob-num js-line-number" data-line-number="68"></td>
-        <td id="LC68" class="blob-code blob-code-inner js-file-line">4 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L69" class="blob-num js-line-number" data-line-number="69"></td>
-        <td id="LC69" class="blob-code blob-code-inner js-file-line">4 t 14</td>
-      </tr>
-      <tr>
-        <td id="L70" class="blob-num js-line-number" data-line-number="70"></td>
-        <td id="LC70" class="blob-code blob-code-inner js-file-line">4 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L71" class="blob-num js-line-number" data-line-number="71"></td>
-        <td id="LC71" class="blob-code blob-code-inner js-file-line">5 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L72" class="blob-num js-line-number" data-line-number="72"></td>
-        <td id="LC72" class="blob-code blob-code-inner js-file-line">5 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L73" class="blob-num js-line-number" data-line-number="73"></td>
-        <td id="LC73" class="blob-code blob-code-inner js-file-line">5 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L74" class="blob-num js-line-number" data-line-number="74"></td>
-        <td id="LC74" class="blob-code blob-code-inner js-file-line">5 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L75" class="blob-num js-line-number" data-line-number="75"></td>
-        <td id="LC75" class="blob-code blob-code-inner js-file-line">5 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L76" class="blob-num js-line-number" data-line-number="76"></td>
-        <td id="LC76" class="blob-code blob-code-inner js-file-line">5 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L77" class="blob-num js-line-number" data-line-number="77"></td>
-        <td id="LC77" class="blob-code blob-code-inner js-file-line">5 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L78" class="blob-num js-line-number" data-line-number="78"></td>
-        <td id="LC78" class="blob-code blob-code-inner js-file-line">5 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L79" class="blob-num js-line-number" data-line-number="79"></td>
-        <td id="LC79" class="blob-code blob-code-inner js-file-line">6 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L80" class="blob-num js-line-number" data-line-number="80"></td>
-        <td id="LC80" class="blob-code blob-code-inner js-file-line">6 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L81" class="blob-num js-line-number" data-line-number="81"></td>
-        <td id="LC81" class="blob-code blob-code-inner js-file-line">6 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L82" class="blob-num js-line-number" data-line-number="82"></td>
-        <td id="LC82" class="blob-code blob-code-inner js-file-line">6 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L83" class="blob-num js-line-number" data-line-number="83"></td>
-        <td id="LC83" class="blob-code blob-code-inner js-file-line">6 y_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L84" class="blob-num js-line-number" data-line-number="84"></td>
-        <td id="LC84" class="blob-code blob-code-inner js-file-line">6 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L85" class="blob-num js-line-number" data-line-number="85"></td>
-        <td id="LC85" class="blob-code blob-code-inner js-file-line">6 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L86" class="blob-num js-line-number" data-line-number="86"></td>
-        <td id="LC86" class="blob-code blob-code-inner js-file-line">6 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L87" class="blob-num js-line-number" data-line-number="87"></td>
-        <td id="LC87" class="blob-code blob-code-inner js-file-line">6 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L88" class="blob-num js-line-number" data-line-number="88"></td>
-        <td id="LC88" class="blob-code blob-code-inner js-file-line">6 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L89" class="blob-num js-line-number" data-line-number="89"></td>
-        <td id="LC89" class="blob-code blob-code-inner js-file-line">6 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L90" class="blob-num js-line-number" data-line-number="90"></td>
-        <td id="LC90" class="blob-code blob-code-inner js-file-line">6 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L91" class="blob-num js-line-number" data-line-number="91"></td>
-        <td id="LC91" class="blob-code blob-code-inner js-file-line">7 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L92" class="blob-num js-line-number" data-line-number="92"></td>
-        <td id="LC92" class="blob-code blob-code-inner js-file-line">7 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L93" class="blob-num js-line-number" data-line-number="93"></td>
-        <td id="LC93" class="blob-code blob-code-inner js-file-line">7 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L94" class="blob-num js-line-number" data-line-number="94"></td>
-        <td id="LC94" class="blob-code blob-code-inner js-file-line">7 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L95" class="blob-num js-line-number" data-line-number="95"></td>
-        <td id="LC95" class="blob-code blob-code-inner js-file-line">7 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L96" class="blob-num js-line-number" data-line-number="96"></td>
-        <td id="LC96" class="blob-code blob-code-inner js-file-line">7 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L97" class="blob-num js-line-number" data-line-number="97"></td>
-        <td id="LC97" class="blob-code blob-code-inner js-file-line">7 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L98" class="blob-num js-line-number" data-line-number="98"></td>
-        <td id="LC98" class="blob-code blob-code-inner js-file-line">7 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L99" class="blob-num js-line-number" data-line-number="99"></td>
-        <td id="LC99" class="blob-code blob-code-inner js-file-line">7 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L100" class="blob-num js-line-number" data-line-number="100"></td>
-        <td id="LC100" class="blob-code blob-code-inner js-file-line">7 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L101" class="blob-num js-line-number" data-line-number="101"></td>
-        <td id="LC101" class="blob-code blob-code-inner js-file-line">8 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L102" class="blob-num js-line-number" data-line-number="102"></td>
-        <td id="LC102" class="blob-code blob-code-inner js-file-line">8 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L103" class="blob-num js-line-number" data-line-number="103"></td>
-        <td id="LC103" class="blob-code blob-code-inner js-file-line">8 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L104" class="blob-num js-line-number" data-line-number="104"></td>
-        <td id="LC104" class="blob-code blob-code-inner js-file-line">8 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L105" class="blob-num js-line-number" data-line-number="105"></td>
-        <td id="LC105" class="blob-code blob-code-inner js-file-line">8 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L106" class="blob-num js-line-number" data-line-number="106"></td>
-        <td id="LC106" class="blob-code blob-code-inner js-file-line">8 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L107" class="blob-num js-line-number" data-line-number="107"></td>
-        <td id="LC107" class="blob-code blob-code-inner js-file-line">8 y_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L108" class="blob-num js-line-number" data-line-number="108"></td>
-        <td id="LC108" class="blob-code blob-code-inner js-file-line">8 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L109" class="blob-num js-line-number" data-line-number="109"></td>
-        <td id="LC109" class="blob-code blob-code-inner js-file-line">8 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L110" class="blob-num js-line-number" data-line-number="110"></td>
-        <td id="LC110" class="blob-code blob-code-inner js-file-line">8 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L111" class="blob-num js-line-number" data-line-number="111"></td>
-        <td id="LC111" class="blob-code blob-code-inner js-file-line">8 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L112" class="blob-num js-line-number" data-line-number="112"></td>
-        <td id="LC112" class="blob-code blob-code-inner js-file-line">8 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L113" class="blob-num js-line-number" data-line-number="113"></td>
-        <td id="LC113" class="blob-code blob-code-inner js-file-line">8 t 13</td>
-      </tr>
-      <tr>
-        <td id="L114" class="blob-num js-line-number" data-line-number="114"></td>
-        <td id="LC114" class="blob-code blob-code-inner js-file-line">8 t 15</td>
-      </tr>
-      <tr>
-        <td id="L115" class="blob-num js-line-number" data-line-number="115"></td>
-        <td id="LC115" class="blob-code blob-code-inner js-file-line">8 t 17</td>
-      </tr>
-      <tr>
-        <td id="L116" class="blob-num js-line-number" data-line-number="116"></td>
-        <td id="LC116" class="blob-code blob-code-inner js-file-line">8 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L117" class="blob-num js-line-number" data-line-number="117"></td>
-        <td id="LC117" class="blob-code blob-code-inner js-file-line">8 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L118" class="blob-num js-line-number" data-line-number="118"></td>
-        <td id="LC118" class="blob-code blob-code-inner js-file-line">8 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L119" class="blob-num js-line-number" data-line-number="119"></td>
-        <td id="LC119" class="blob-code blob-code-inner js-file-line">9 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L120" class="blob-num js-line-number" data-line-number="120"></td>
-        <td id="LC120" class="blob-code blob-code-inner js-file-line">9 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L121" class="blob-num js-line-number" data-line-number="121"></td>
-        <td id="LC121" class="blob-code blob-code-inner js-file-line">9 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L122" class="blob-num js-line-number" data-line-number="122"></td>
-        <td id="LC122" class="blob-code blob-code-inner js-file-line">9 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L123" class="blob-num js-line-number" data-line-number="123"></td>
-        <td id="LC123" class="blob-code blob-code-inner js-file-line">9 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L124" class="blob-num js-line-number" data-line-number="124"></td>
-        <td id="LC124" class="blob-code blob-code-inner js-file-line">9 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L125" class="blob-num js-line-number" data-line-number="125"></td>
-        <td id="LC125" class="blob-code blob-code-inner js-file-line">9 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L126" class="blob-num js-line-number" data-line-number="126"></td>
-        <td id="LC126" class="blob-code blob-code-inner js-file-line">9 t 7</td>
-      </tr>
-      <tr>
-        <td id="L127" class="blob-num js-line-number" data-line-number="127"></td>
-        <td id="LC127" class="blob-code blob-code-inner js-file-line">9 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L128" class="blob-num js-line-number" data-line-number="128"></td>
-        <td id="LC128" class="blob-code blob-code-inner js-file-line">9 t 14</td>
-      </tr>
-      <tr>
-        <td id="L129" class="blob-num js-line-number" data-line-number="129"></td>
-        <td id="LC129" class="blob-code blob-code-inner js-file-line">9 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L130" class="blob-num js-line-number" data-line-number="130"></td>
-        <td id="LC130" class="blob-code blob-code-inner js-file-line">9 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L131" class="blob-num js-line-number" data-line-number="131"></td>
-        <td id="LC131" class="blob-code blob-code-inner js-file-line">10 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L132" class="blob-num js-line-number" data-line-number="132"></td>
-        <td id="LC132" class="blob-code blob-code-inner js-file-line">10 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L133" class="blob-num js-line-number" data-line-number="133"></td>
-        <td id="LC133" class="blob-code blob-code-inner js-file-line">10 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L134" class="blob-num js-line-number" data-line-number="134"></td>
-        <td id="LC134" class="blob-code blob-code-inner js-file-line">10 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L135" class="blob-num js-line-number" data-line-number="135"></td>
-        <td id="LC135" class="blob-code blob-code-inner js-file-line">10 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L136" class="blob-num js-line-number" data-line-number="136"></td>
-        <td id="LC136" class="blob-code blob-code-inner js-file-line">10 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L137" class="blob-num js-line-number" data-line-number="137"></td>
-        <td id="LC137" class="blob-code blob-code-inner js-file-line">10 t 0</td>
-      </tr>
-      <tr>
-        <td id="L138" class="blob-num js-line-number" data-line-number="138"></td>
-        <td id="LC138" class="blob-code blob-code-inner js-file-line">10 t 1</td>
-      </tr>
-      <tr>
-        <td id="L139" class="blob-num js-line-number" data-line-number="139"></td>
-        <td id="LC139" class="blob-code blob-code-inner js-file-line">10 x_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L140" class="blob-num js-line-number" data-line-number="140"></td>
-        <td id="LC140" class="blob-code blob-code-inner js-file-line">10 x_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L141" class="blob-num js-line-number" data-line-number="141"></td>
-        <td id="LC141" class="blob-code blob-code-inner js-file-line">10 t 8</td>
-      </tr>
-      <tr>
-        <td id="L142" class="blob-num js-line-number" data-line-number="142"></td>
-        <td id="LC142" class="blob-code blob-code-inner js-file-line">10 x_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L143" class="blob-num js-line-number" data-line-number="143"></td>
-        <td id="LC143" class="blob-code blob-code-inner js-file-line">10 t 12</td>
-      </tr>
-      <tr>
-        <td id="L144" class="blob-num js-line-number" data-line-number="144"></td>
-        <td id="LC144" class="blob-code blob-code-inner js-file-line">10 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L145" class="blob-num js-line-number" data-line-number="145"></td>
-        <td id="LC145" class="blob-code blob-code-inner js-file-line">10 t 16</td>
-      </tr>
-      <tr>
-        <td id="L146" class="blob-num js-line-number" data-line-number="146"></td>
-        <td id="LC146" class="blob-code blob-code-inner js-file-line">10 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L147" class="blob-num js-line-number" data-line-number="147"></td>
-        <td id="LC147" class="blob-code blob-code-inner js-file-line">10 t 20</td>
-      </tr>
-      <tr>
-        <td id="L148" class="blob-num js-line-number" data-line-number="148"></td>
-        <td id="LC148" class="blob-code blob-code-inner js-file-line">10 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L149" class="blob-num js-line-number" data-line-number="149"></td>
-        <td id="LC149" class="blob-code blob-code-inner js-file-line">11 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L150" class="blob-num js-line-number" data-line-number="150"></td>
-        <td id="LC150" class="blob-code blob-code-inner js-file-line">11 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L151" class="blob-num js-line-number" data-line-number="151"></td>
-        <td id="LC151" class="blob-code blob-code-inner js-file-line">11 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L152" class="blob-num js-line-number" data-line-number="152"></td>
-        <td id="LC152" class="blob-code blob-code-inner js-file-line">11 t 2</td>
-      </tr>
-      <tr>
-        <td id="L153" class="blob-num js-line-number" data-line-number="153"></td>
-        <td id="LC153" class="blob-code blob-code-inner js-file-line">11 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L154" class="blob-num js-line-number" data-line-number="154"></td>
-        <td id="LC154" class="blob-code blob-code-inner js-file-line">11 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L155" class="blob-num js-line-number" data-line-number="155"></td>
-        <td id="LC155" class="blob-code blob-code-inner js-file-line">11 t 11</td>
-      </tr>
-      <tr>
-        <td id="L156" class="blob-num js-line-number" data-line-number="156"></td>
-        <td id="LC156" class="blob-code blob-code-inner js-file-line">11 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L157" class="blob-num js-line-number" data-line-number="157"></td>
-        <td id="LC157" class="blob-code blob-code-inner js-file-line">11 t 18</td>
-      </tr>
-      <tr>
-        <td id="L158" class="blob-num js-line-number" data-line-number="158"></td>
-        <td id="LC158" class="blob-code blob-code-inner js-file-line">11 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L159" class="blob-num js-line-number" data-line-number="159"></td>
-        <td id="LC159" class="blob-code blob-code-inner js-file-line">11 t 22</td>
-      </tr>
-      <tr>
-        <td id="L160" class="blob-num js-line-number" data-line-number="160"></td>
-        <td id="LC160" class="blob-code blob-code-inner js-file-line">11 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L161" class="blob-num js-line-number" data-line-number="161"></td>
-        <td id="LC161" class="blob-code blob-code-inner js-file-line">12 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L162" class="blob-num js-line-number" data-line-number="162"></td>
-        <td id="LC162" class="blob-code blob-code-inner js-file-line">12 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L163" class="blob-num js-line-number" data-line-number="163"></td>
-        <td id="LC163" class="blob-code blob-code-inner js-file-line">12 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L164" class="blob-num js-line-number" data-line-number="164"></td>
-        <td id="LC164" class="blob-code blob-code-inner js-file-line">12 x_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L165" class="blob-num js-line-number" data-line-number="165"></td>
-        <td id="LC165" class="blob-code blob-code-inner js-file-line">12 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L166" class="blob-num js-line-number" data-line-number="166"></td>
-        <td id="LC166" class="blob-code blob-code-inner js-file-line">12 t 10</td>
-      </tr>
-      <tr>
-        <td id="L167" class="blob-num js-line-number" data-line-number="167"></td>
-        <td id="LC167" class="blob-code blob-code-inner js-file-line">12 x_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L168" class="blob-num js-line-number" data-line-number="168"></td>
-        <td id="LC168" class="blob-code blob-code-inner js-file-line">12 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L169" class="blob-num js-line-number" data-line-number="169"></td>
-        <td id="LC169" class="blob-code blob-code-inner js-file-line">12 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L170" class="blob-num js-line-number" data-line-number="170"></td>
-        <td id="LC170" class="blob-code blob-code-inner js-file-line">13 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L171" class="blob-num js-line-number" data-line-number="171"></td>
-        <td id="LC171" class="blob-code blob-code-inner js-file-line">13 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L172" class="blob-num js-line-number" data-line-number="172"></td>
-        <td id="LC172" class="blob-code blob-code-inner js-file-line">13 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L173" class="blob-num js-line-number" data-line-number="173"></td>
-        <td id="LC173" class="blob-code blob-code-inner js-file-line">13 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L174" class="blob-num js-line-number" data-line-number="174"></td>
-        <td id="LC174" class="blob-code blob-code-inner js-file-line">13 t 7</td>
-      </tr>
-      <tr>
-        <td id="L175" class="blob-num js-line-number" data-line-number="175"></td>
-        <td id="LC175" class="blob-code blob-code-inner js-file-line">13 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L176" class="blob-num js-line-number" data-line-number="176"></td>
-        <td id="LC176" class="blob-code blob-code-inner js-file-line">13 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L177" class="blob-num js-line-number" data-line-number="177"></td>
-        <td id="LC177" class="blob-code blob-code-inner js-file-line">13 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L178" class="blob-num js-line-number" data-line-number="178"></td>
-        <td id="LC178" class="blob-code blob-code-inner js-file-line">14 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L179" class="blob-num js-line-number" data-line-number="179"></td>
-        <td id="LC179" class="blob-code blob-code-inner js-file-line">14 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L180" class="blob-num js-line-number" data-line-number="180"></td>
-        <td id="LC180" class="blob-code blob-code-inner js-file-line">14 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L181" class="blob-num js-line-number" data-line-number="181"></td>
-        <td id="LC181" class="blob-code blob-code-inner js-file-line">14 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L182" class="blob-num js-line-number" data-line-number="182"></td>
-        <td id="LC182" class="blob-code blob-code-inner js-file-line">14 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L183" class="blob-num js-line-number" data-line-number="183"></td>
-        <td id="LC183" class="blob-code blob-code-inner js-file-line">14 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L184" class="blob-num js-line-number" data-line-number="184"></td>
-        <td id="LC184" class="blob-code blob-code-inner js-file-line">14 t 9</td>
-      </tr>
-      <tr>
-        <td id="L185" class="blob-num js-line-number" data-line-number="185"></td>
-        <td id="LC185" class="blob-code blob-code-inner js-file-line">14 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L186" class="blob-num js-line-number" data-line-number="186"></td>
-        <td id="LC186" class="blob-code blob-code-inner js-file-line">14 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L187" class="blob-num js-line-number" data-line-number="187"></td>
-        <td id="LC187" class="blob-code blob-code-inner js-file-line">14 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L188" class="blob-num js-line-number" data-line-number="188"></td>
-        <td id="LC188" class="blob-code blob-code-inner js-file-line">14 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L189" class="blob-num js-line-number" data-line-number="189"></td>
-        <td id="LC189" class="blob-code blob-code-inner js-file-line">14 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L190" class="blob-num js-line-number" data-line-number="190"></td>
-        <td id="LC190" class="blob-code blob-code-inner js-file-line">15 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L191" class="blob-num js-line-number" data-line-number="191"></td>
-        <td id="LC191" class="blob-code blob-code-inner js-file-line">15 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L192" class="blob-num js-line-number" data-line-number="192"></td>
-        <td id="LC192" class="blob-code blob-code-inner js-file-line">15 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L193" class="blob-num js-line-number" data-line-number="193"></td>
-        <td id="LC193" class="blob-code blob-code-inner js-file-line">15 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L194" class="blob-num js-line-number" data-line-number="194"></td>
-        <td id="LC194" class="blob-code blob-code-inner js-file-line">15 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L195" class="blob-num js-line-number" data-line-number="195"></td>
-        <td id="LC195" class="blob-code blob-code-inner js-file-line">15 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L196" class="blob-num js-line-number" data-line-number="196"></td>
-        <td id="LC196" class="blob-code blob-code-inner js-file-line">15 t 3</td>
-      </tr>
-      <tr>
-        <td id="L197" class="blob-num js-line-number" data-line-number="197"></td>
-        <td id="LC197" class="blob-code blob-code-inner js-file-line">15 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L198" class="blob-num js-line-number" data-line-number="198"></td>
-        <td id="LC198" class="blob-code blob-code-inner js-file-line">15 t 16</td>
-      </tr>
-      <tr>
-        <td id="L199" class="blob-num js-line-number" data-line-number="199"></td>
-        <td id="LC199" class="blob-code blob-code-inner js-file-line">15 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L200" class="blob-num js-line-number" data-line-number="200"></td>
-        <td id="LC200" class="blob-code blob-code-inner js-file-line">16 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L201" class="blob-num js-line-number" data-line-number="201"></td>
-        <td id="LC201" class="blob-code blob-code-inner js-file-line">16 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L202" class="blob-num js-line-number" data-line-number="202"></td>
-        <td id="LC202" class="blob-code blob-code-inner js-file-line">16 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L203" class="blob-num js-line-number" data-line-number="203"></td>
-        <td id="LC203" class="blob-code blob-code-inner js-file-line">16 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L204" class="blob-num js-line-number" data-line-number="204"></td>
-        <td id="LC204" class="blob-code blob-code-inner js-file-line">16 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L205" class="blob-num js-line-number" data-line-number="205"></td>
-        <td id="LC205" class="blob-code blob-code-inner js-file-line">16 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L206" class="blob-num js-line-number" data-line-number="206"></td>
-        <td id="LC206" class="blob-code blob-code-inner js-file-line">16 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L207" class="blob-num js-line-number" data-line-number="207"></td>
-        <td id="LC207" class="blob-code blob-code-inner js-file-line">16 t 2</td>
-      </tr>
-      <tr>
-        <td id="L208" class="blob-num js-line-number" data-line-number="208"></td>
-        <td id="LC208" class="blob-code blob-code-inner js-file-line">16 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L209" class="blob-num js-line-number" data-line-number="209"></td>
-        <td id="LC209" class="blob-code blob-code-inner js-file-line">16 t 6</td>
-      </tr>
-      <tr>
-        <td id="L210" class="blob-num js-line-number" data-line-number="210"></td>
-        <td id="LC210" class="blob-code blob-code-inner js-file-line">16 t 8</td>
-      </tr>
-      <tr>
-        <td id="L211" class="blob-num js-line-number" data-line-number="211"></td>
-        <td id="LC211" class="blob-code blob-code-inner js-file-line">16 t 10</td>
-      </tr>
-      <tr>
-        <td id="L212" class="blob-num js-line-number" data-line-number="212"></td>
-        <td id="LC212" class="blob-code blob-code-inner js-file-line">16 t 13</td>
-      </tr>
-      <tr>
-        <td id="L213" class="blob-num js-line-number" data-line-number="213"></td>
-        <td id="LC213" class="blob-code blob-code-inner js-file-line">16 t 15</td>
-      </tr>
-      <tr>
-        <td id="L214" class="blob-num js-line-number" data-line-number="214"></td>
-        <td id="LC214" class="blob-code blob-code-inner js-file-line">16 t 17</td>
-      </tr>
-      <tr>
-        <td id="L215" class="blob-num js-line-number" data-line-number="215"></td>
-        <td id="LC215" class="blob-code blob-code-inner js-file-line">16 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L216" class="blob-num js-line-number" data-line-number="216"></td>
-        <td id="LC216" class="blob-code blob-code-inner js-file-line">16 t 21</td>
-      </tr>
-      <tr>
-        <td id="L217" class="blob-num js-line-number" data-line-number="217"></td>
-        <td id="LC217" class="blob-code blob-code-inner js-file-line">16 t 23</td>
-      </tr>
-      <tr>
-        <td id="L218" class="blob-num js-line-number" data-line-number="218"></td>
-        <td id="LC218" class="blob-code blob-code-inner js-file-line">17 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L219" class="blob-num js-line-number" data-line-number="219"></td>
-        <td id="LC219" class="blob-code blob-code-inner js-file-line">17 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L220" class="blob-num js-line-number" data-line-number="220"></td>
-        <td id="LC220" class="blob-code blob-code-inner js-file-line">17 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L221" class="blob-num js-line-number" data-line-number="221"></td>
-        <td id="LC221" class="blob-code blob-code-inner js-file-line">17 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L222" class="blob-num js-line-number" data-line-number="222"></td>
-        <td id="LC222" class="blob-code blob-code-inner js-file-line">17 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L223" class="blob-num js-line-number" data-line-number="223"></td>
-        <td id="LC223" class="blob-code blob-code-inner js-file-line">17 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L224" class="blob-num js-line-number" data-line-number="224"></td>
-        <td id="LC224" class="blob-code blob-code-inner js-file-line">17 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L225" class="blob-num js-line-number" data-line-number="225"></td>
-        <td id="LC225" class="blob-code blob-code-inner js-file-line">17 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L226" class="blob-num js-line-number" data-line-number="226"></td>
-        <td id="LC226" class="blob-code blob-code-inner js-file-line">17 t 11</td>
-      </tr>
-      <tr>
-        <td id="L227" class="blob-num js-line-number" data-line-number="227"></td>
-        <td id="LC227" class="blob-code blob-code-inner js-file-line">17 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L228" class="blob-num js-line-number" data-line-number="228"></td>
-        <td id="LC228" class="blob-code blob-code-inner js-file-line">17 x_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L229" class="blob-num js-line-number" data-line-number="229"></td>
-        <td id="LC229" class="blob-code blob-code-inner js-file-line">17 t 22</td>
-      </tr>
-      <tr>
-        <td id="L230" class="blob-num js-line-number" data-line-number="230"></td>
-        <td id="LC230" class="blob-code blob-code-inner js-file-line">18 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L231" class="blob-num js-line-number" data-line-number="231"></td>
-        <td id="LC231" class="blob-code blob-code-inner js-file-line">18 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L232" class="blob-num js-line-number" data-line-number="232"></td>
-        <td id="LC232" class="blob-code blob-code-inner js-file-line">18 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L233" class="blob-num js-line-number" data-line-number="233"></td>
-        <td id="LC233" class="blob-code blob-code-inner js-file-line">18 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L234" class="blob-num js-line-number" data-line-number="234"></td>
-        <td id="LC234" class="blob-code blob-code-inner js-file-line">18 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L235" class="blob-num js-line-number" data-line-number="235"></td>
-        <td id="LC235" class="blob-code blob-code-inner js-file-line">18 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L236" class="blob-num js-line-number" data-line-number="236"></td>
-        <td id="LC236" class="blob-code blob-code-inner js-file-line">18 t 0</td>
-      </tr>
-      <tr>
-        <td id="L237" class="blob-num js-line-number" data-line-number="237"></td>
-        <td id="LC237" class="blob-code blob-code-inner js-file-line">18 y_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L238" class="blob-num js-line-number" data-line-number="238"></td>
-        <td id="LC238" class="blob-code blob-code-inner js-file-line">18 t 4</td>
-      </tr>
-      <tr>
-        <td id="L239" class="blob-num js-line-number" data-line-number="239"></td>
-        <td id="LC239" class="blob-code blob-code-inner js-file-line">18 y_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L240" class="blob-num js-line-number" data-line-number="240"></td>
-        <td id="LC240" class="blob-code blob-code-inner js-file-line">18 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L241" class="blob-num js-line-number" data-line-number="241"></td>
-        <td id="LC241" class="blob-code blob-code-inner js-file-line">18 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L242" class="blob-num js-line-number" data-line-number="242"></td>
-        <td id="LC242" class="blob-code blob-code-inner js-file-line">18 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L243" class="blob-num js-line-number" data-line-number="243"></td>
-        <td id="LC243" class="blob-code blob-code-inner js-file-line">18 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L244" class="blob-num js-line-number" data-line-number="244"></td>
-        <td id="LC244" class="blob-code blob-code-inner js-file-line">18 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L245" class="blob-num js-line-number" data-line-number="245"></td>
-        <td id="LC245" class="blob-code blob-code-inner js-file-line">18 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L246" class="blob-num js-line-number" data-line-number="246"></td>
-        <td id="LC246" class="blob-code blob-code-inner js-file-line">18 t 20</td>
-      </tr>
-      <tr>
-        <td id="L247" class="blob-num js-line-number" data-line-number="247"></td>
-        <td id="LC247" class="blob-code blob-code-inner js-file-line">18 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L248" class="blob-num js-line-number" data-line-number="248"></td>
-        <td id="LC248" class="blob-code blob-code-inner js-file-line">19 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L249" class="blob-num js-line-number" data-line-number="249"></td>
-        <td id="LC249" class="blob-code blob-code-inner js-file-line">19 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L250" class="blob-num js-line-number" data-line-number="250"></td>
-        <td id="LC250" class="blob-code blob-code-inner js-file-line">19 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L251" class="blob-num js-line-number" data-line-number="251"></td>
-        <td id="LC251" class="blob-code blob-code-inner js-file-line">19 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L252" class="blob-num js-line-number" data-line-number="252"></td>
-        <td id="LC252" class="blob-code blob-code-inner js-file-line">19 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L253" class="blob-num js-line-number" data-line-number="253"></td>
-        <td id="LC253" class="blob-code blob-code-inner js-file-line">19 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L254" class="blob-num js-line-number" data-line-number="254"></td>
-        <td id="LC254" class="blob-code blob-code-inner js-file-line">19 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L255" class="blob-num js-line-number" data-line-number="255"></td>
-        <td id="LC255" class="blob-code blob-code-inner js-file-line">19 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L256" class="blob-num js-line-number" data-line-number="256"></td>
-        <td id="LC256" class="blob-code blob-code-inner js-file-line">19 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L257" class="blob-num js-line-number" data-line-number="257"></td>
-        <td id="LC257" class="blob-code blob-code-inner js-file-line">19 t 19</td>
-      </tr>
-      <tr>
-        <td id="L258" class="blob-num js-line-number" data-line-number="258"></td>
-        <td id="LC258" class="blob-code blob-code-inner js-file-line">19 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L259" class="blob-num js-line-number" data-line-number="259"></td>
-        <td id="LC259" class="blob-code blob-code-inner js-file-line">19 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L260" class="blob-num js-line-number" data-line-number="260"></td>
-        <td id="LC260" class="blob-code blob-code-inner js-file-line">20 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L261" class="blob-num js-line-number" data-line-number="261"></td>
-        <td id="LC261" class="blob-code blob-code-inner js-file-line">20 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L262" class="blob-num js-line-number" data-line-number="262"></td>
-        <td id="LC262" class="blob-code blob-code-inner js-file-line">20 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L263" class="blob-num js-line-number" data-line-number="263"></td>
-        <td id="LC263" class="blob-code blob-code-inner js-file-line">20 x_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L264" class="blob-num js-line-number" data-line-number="264"></td>
-        <td id="LC264" class="blob-code blob-code-inner js-file-line">20 t 8</td>
-      </tr>
-      <tr>
-        <td id="L265" class="blob-num js-line-number" data-line-number="265"></td>
-        <td id="LC265" class="blob-code blob-code-inner js-file-line">20 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L266" class="blob-num js-line-number" data-line-number="266"></td>
-        <td id="LC266" class="blob-code blob-code-inner js-file-line">20 t 12</td>
-      </tr>
-      <tr>
-        <td id="L267" class="blob-num js-line-number" data-line-number="267"></td>
-        <td id="LC267" class="blob-code blob-code-inner js-file-line">20 t 14</td>
-      </tr>
-      <tr>
-        <td id="L268" class="blob-num js-line-number" data-line-number="268"></td>
-        <td id="LC268" class="blob-code blob-code-inner js-file-line">20 t 16</td>
-      </tr>
-      <tr>
-        <td id="L269" class="blob-num js-line-number" data-line-number="269"></td>
-        <td id="LC269" class="blob-code blob-code-inner js-file-line">21 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L270" class="blob-num js-line-number" data-line-number="270"></td>
-        <td id="LC270" class="blob-code blob-code-inner js-file-line">21 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L271" class="blob-num js-line-number" data-line-number="271"></td>
-        <td id="LC271" class="blob-code blob-code-inner js-file-line">21 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L272" class="blob-num js-line-number" data-line-number="272"></td>
-        <td id="LC272" class="blob-code blob-code-inner js-file-line">21 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L273" class="blob-num js-line-number" data-line-number="273"></td>
-        <td id="LC273" class="blob-code blob-code-inner js-file-line">21 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L274" class="blob-num js-line-number" data-line-number="274"></td>
-        <td id="LC274" class="blob-code blob-code-inner js-file-line">21 t 11</td>
-      </tr>
-      <tr>
-        <td id="L275" class="blob-num js-line-number" data-line-number="275"></td>
-        <td id="LC275" class="blob-code blob-code-inner js-file-line">21 t 15</td>
-      </tr>
-      <tr>
-        <td id="L276" class="blob-num js-line-number" data-line-number="276"></td>
-        <td id="LC276" class="blob-code blob-code-inner js-file-line">21 t 17</td>
-      </tr>
-      <tr>
-        <td id="L277" class="blob-num js-line-number" data-line-number="277"></td>
-        <td id="LC277" class="blob-code blob-code-inner js-file-line">22 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L278" class="blob-num js-line-number" data-line-number="278"></td>
-        <td id="LC278" class="blob-code blob-code-inner js-file-line">22 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L279" class="blob-num js-line-number" data-line-number="279"></td>
-        <td id="LC279" class="blob-code blob-code-inner js-file-line">22 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L280" class="blob-num js-line-number" data-line-number="280"></td>
-        <td id="LC280" class="blob-code blob-code-inner js-file-line">22 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L281" class="blob-num js-line-number" data-line-number="281"></td>
-        <td id="LC281" class="blob-code blob-code-inner js-file-line">22 t 1</td>
-      </tr>
-      <tr>
-        <td id="L282" class="blob-num js-line-number" data-line-number="282"></td>
-        <td id="LC282" class="blob-code blob-code-inner js-file-line">22 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L283" class="blob-num js-line-number" data-line-number="283"></td>
-        <td id="LC283" class="blob-code blob-code-inner js-file-line">22 t 9</td>
-      </tr>
-      <tr>
-        <td id="L284" class="blob-num js-line-number" data-line-number="284"></td>
-        <td id="LC284" class="blob-code blob-code-inner js-file-line">22 t 10</td>
-      </tr>
-      <tr>
-        <td id="L285" class="blob-num js-line-number" data-line-number="285"></td>
-        <td id="LC285" class="blob-code blob-code-inner js-file-line">22 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L286" class="blob-num js-line-number" data-line-number="286"></td>
-        <td id="LC286" class="blob-code blob-code-inner js-file-line">22 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L287" class="blob-num js-line-number" data-line-number="287"></td>
-        <td id="LC287" class="blob-code blob-code-inner js-file-line">22 t 21</td>
-      </tr>
-      <tr>
-        <td id="L288" class="blob-num js-line-number" data-line-number="288"></td>
-        <td id="LC288" class="blob-code blob-code-inner js-file-line">22 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L289" class="blob-num js-line-number" data-line-number="289"></td>
-        <td id="LC289" class="blob-code blob-code-inner js-file-line">23 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L290" class="blob-num js-line-number" data-line-number="290"></td>
-        <td id="LC290" class="blob-code blob-code-inner js-file-line">23 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L291" class="blob-num js-line-number" data-line-number="291"></td>
-        <td id="LC291" class="blob-code blob-code-inner js-file-line">23 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L292" class="blob-num js-line-number" data-line-number="292"></td>
-        <td id="LC292" class="blob-code blob-code-inner js-file-line">23 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L293" class="blob-num js-line-number" data-line-number="293"></td>
-        <td id="LC293" class="blob-code blob-code-inner js-file-line">23 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L294" class="blob-num js-line-number" data-line-number="294"></td>
-        <td id="LC294" class="blob-code blob-code-inner js-file-line">23 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L295" class="blob-num js-line-number" data-line-number="295"></td>
-        <td id="LC295" class="blob-code blob-code-inner js-file-line">23 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L296" class="blob-num js-line-number" data-line-number="296"></td>
-        <td id="LC296" class="blob-code blob-code-inner js-file-line">23 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L297" class="blob-num js-line-number" data-line-number="297"></td>
-        <td id="LC297" class="blob-code blob-code-inner js-file-line">23 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L298" class="blob-num js-line-number" data-line-number="298"></td>
-        <td id="LC298" class="blob-code blob-code-inner js-file-line">23 y_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L299" class="blob-num js-line-number" data-line-number="299"></td>
-        <td id="LC299" class="blob-code blob-code-inner js-file-line">24 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L300" class="blob-num js-line-number" data-line-number="300"></td>
-        <td id="LC300" class="blob-code blob-code-inner js-file-line">24 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L301" class="blob-num js-line-number" data-line-number="301"></td>
-        <td id="LC301" class="blob-code blob-code-inner js-file-line">24 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L302" class="blob-num js-line-number" data-line-number="302"></td>
-        <td id="LC302" class="blob-code blob-code-inner js-file-line">24 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L303" class="blob-num js-line-number" data-line-number="303"></td>
-        <td id="LC303" class="blob-code blob-code-inner js-file-line">24 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L304" class="blob-num js-line-number" data-line-number="304"></td>
-        <td id="LC304" class="blob-code blob-code-inner js-file-line">24 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L305" class="blob-num js-line-number" data-line-number="305"></td>
-        <td id="LC305" class="blob-code blob-code-inner js-file-line">24 y_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L306" class="blob-num js-line-number" data-line-number="306"></td>
-        <td id="LC306" class="blob-code blob-code-inner js-file-line">24 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L307" class="blob-num js-line-number" data-line-number="307"></td>
-        <td id="LC307" class="blob-code blob-code-inner js-file-line">24 x_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L308" class="blob-num js-line-number" data-line-number="308"></td>
-        <td id="LC308" class="blob-code blob-code-inner js-file-line">24 t 6</td>
-      </tr>
-      <tr>
-        <td id="L309" class="blob-num js-line-number" data-line-number="309"></td>
-        <td id="LC309" class="blob-code blob-code-inner js-file-line">24 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L310" class="blob-num js-line-number" data-line-number="310"></td>
-        <td id="LC310" class="blob-code blob-code-inner js-file-line">24 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L311" class="blob-num js-line-number" data-line-number="311"></td>
-        <td id="LC311" class="blob-code blob-code-inner js-file-line">24 t 13</td>
-      </tr>
-      <tr>
-        <td id="L312" class="blob-num js-line-number" data-line-number="312"></td>
-        <td id="LC312" class="blob-code blob-code-inner js-file-line">24 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L313" class="blob-num js-line-number" data-line-number="313"></td>
-        <td id="LC313" class="blob-code blob-code-inner js-file-line">24 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L314" class="blob-num js-line-number" data-line-number="314"></td>
-        <td id="LC314" class="blob-code blob-code-inner js-file-line">24 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L315" class="blob-num js-line-number" data-line-number="315"></td>
-        <td id="LC315" class="blob-code blob-code-inner js-file-line">24 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L316" class="blob-num js-line-number" data-line-number="316"></td>
-        <td id="LC316" class="blob-code blob-code-inner js-file-line">24 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L317" class="blob-num js-line-number" data-line-number="317"></td>
-        <td id="LC317" class="blob-code blob-code-inner js-file-line">25 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L318" class="blob-num js-line-number" data-line-number="318"></td>
-        <td id="LC318" class="blob-code blob-code-inner js-file-line">25 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L319" class="blob-num js-line-number" data-line-number="319"></td>
-        <td id="LC319" class="blob-code blob-code-inner js-file-line">25 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L320" class="blob-num js-line-number" data-line-number="320"></td>
-        <td id="LC320" class="blob-code blob-code-inner js-file-line">25 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L321" class="blob-num js-line-number" data-line-number="321"></td>
-        <td id="LC321" class="blob-code blob-code-inner js-file-line">25 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L322" class="blob-num js-line-number" data-line-number="322"></td>
-        <td id="LC322" class="blob-code blob-code-inner js-file-line">25 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L323" class="blob-num js-line-number" data-line-number="323"></td>
-        <td id="LC323" class="blob-code blob-code-inner js-file-line">25 t 3</td>
-      </tr>
-      <tr>
-        <td id="L324" class="blob-num js-line-number" data-line-number="324"></td>
-        <td id="LC324" class="blob-code blob-code-inner js-file-line">25 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L325" class="blob-num js-line-number" data-line-number="325"></td>
-        <td id="LC325" class="blob-code blob-code-inner js-file-line">25 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L326" class="blob-num js-line-number" data-line-number="326"></td>
-        <td id="LC326" class="blob-code blob-code-inner js-file-line">25 t 14</td>
-      </tr>
-      <tr>
-        <td id="L327" class="blob-num js-line-number" data-line-number="327"></td>
-        <td id="LC327" class="blob-code blob-code-inner js-file-line">25 t 18</td>
-      </tr>
-      <tr>
-        <td id="L328" class="blob-num js-line-number" data-line-number="328"></td>
-        <td id="LC328" class="blob-code blob-code-inner js-file-line">25 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L329" class="blob-num js-line-number" data-line-number="329"></td>
-        <td id="LC329" class="blob-code blob-code-inner js-file-line">26 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L330" class="blob-num js-line-number" data-line-number="330"></td>
-        <td id="LC330" class="blob-code blob-code-inner js-file-line">26 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L331" class="blob-num js-line-number" data-line-number="331"></td>
-        <td id="LC331" class="blob-code blob-code-inner js-file-line">26 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L332" class="blob-num js-line-number" data-line-number="332"></td>
-        <td id="LC332" class="blob-code blob-code-inner js-file-line">26 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L333" class="blob-num js-line-number" data-line-number="333"></td>
-        <td id="LC333" class="blob-code blob-code-inner js-file-line">26 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L334" class="blob-num js-line-number" data-line-number="334"></td>
-        <td id="LC334" class="blob-code blob-code-inner js-file-line">26 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L335" class="blob-num js-line-number" data-line-number="335"></td>
-        <td id="LC335" class="blob-code blob-code-inner js-file-line">26 t 0</td>
-      </tr>
-      <tr>
-        <td id="L336" class="blob-num js-line-number" data-line-number="336"></td>
-        <td id="LC336" class="blob-code blob-code-inner js-file-line">26 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L337" class="blob-num js-line-number" data-line-number="337"></td>
-        <td id="LC337" class="blob-code blob-code-inner js-file-line">26 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L338" class="blob-num js-line-number" data-line-number="338"></td>
-        <td id="LC338" class="blob-code blob-code-inner js-file-line">26 t 5</td>
-      </tr>
-      <tr>
-        <td id="L339" class="blob-num js-line-number" data-line-number="339"></td>
-        <td id="LC339" class="blob-code blob-code-inner js-file-line">26 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L340" class="blob-num js-line-number" data-line-number="340"></td>
-        <td id="LC340" class="blob-code blob-code-inner js-file-line">26 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L341" class="blob-num js-line-number" data-line-number="341"></td>
-        <td id="LC341" class="blob-code blob-code-inner js-file-line">26 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L342" class="blob-num js-line-number" data-line-number="342"></td>
-        <td id="LC342" class="blob-code blob-code-inner js-file-line">26 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L343" class="blob-num js-line-number" data-line-number="343"></td>
-        <td id="LC343" class="blob-code blob-code-inner js-file-line">26 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L344" class="blob-num js-line-number" data-line-number="344"></td>
-        <td id="LC344" class="blob-code blob-code-inner js-file-line">26 t 17</td>
-      </tr>
-      <tr>
-        <td id="L345" class="blob-num js-line-number" data-line-number="345"></td>
-        <td id="LC345" class="blob-code blob-code-inner js-file-line">26 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L346" class="blob-num js-line-number" data-line-number="346"></td>
-        <td id="LC346" class="blob-code blob-code-inner js-file-line">26 t 21</td>
-      </tr>
-      <tr>
-        <td id="L347" class="blob-num js-line-number" data-line-number="347"></td>
-        <td id="LC347" class="blob-code blob-code-inner js-file-line">27 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L348" class="blob-num js-line-number" data-line-number="348"></td>
-        <td id="LC348" class="blob-code blob-code-inner js-file-line">27 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L349" class="blob-num js-line-number" data-line-number="349"></td>
-        <td id="LC349" class="blob-code blob-code-inner js-file-line">27 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L350" class="blob-num js-line-number" data-line-number="350"></td>
-        <td id="LC350" class="blob-code blob-code-inner js-file-line">27 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L351" class="blob-num js-line-number" data-line-number="351"></td>
-        <td id="LC351" class="blob-code blob-code-inner js-file-line">27 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L352" class="blob-num js-line-number" data-line-number="352"></td>
-        <td id="LC352" class="blob-code blob-code-inner js-file-line">27 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L353" class="blob-num js-line-number" data-line-number="353"></td>
-        <td id="LC353" class="blob-code blob-code-inner js-file-line">27 t 11</td>
-      </tr>
-      <tr>
-        <td id="L354" class="blob-num js-line-number" data-line-number="354"></td>
-        <td id="LC354" class="blob-code blob-code-inner js-file-line">27 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L355" class="blob-num js-line-number" data-line-number="355"></td>
-        <td id="LC355" class="blob-code blob-code-inner js-file-line">27 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L356" class="blob-num js-line-number" data-line-number="356"></td>
-        <td id="LC356" class="blob-code blob-code-inner js-file-line">27 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L357" class="blob-num js-line-number" data-line-number="357"></td>
-        <td id="LC357" class="blob-code blob-code-inner js-file-line">27 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L358" class="blob-num js-line-number" data-line-number="358"></td>
-        <td id="LC358" class="blob-code blob-code-inner js-file-line">27 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L359" class="blob-num js-line-number" data-line-number="359"></td>
-        <td id="LC359" class="blob-code blob-code-inner js-file-line">28 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L360" class="blob-num js-line-number" data-line-number="360"></td>
-        <td id="LC360" class="blob-code blob-code-inner js-file-line">28 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L361" class="blob-num js-line-number" data-line-number="361"></td>
-        <td id="LC361" class="blob-code blob-code-inner js-file-line">28 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L362" class="blob-num js-line-number" data-line-number="362"></td>
-        <td id="LC362" class="blob-code blob-code-inner js-file-line">28 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L363" class="blob-num js-line-number" data-line-number="363"></td>
-        <td id="LC363" class="blob-code blob-code-inner js-file-line">28 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L364" class="blob-num js-line-number" data-line-number="364"></td>
-        <td id="LC364" class="blob-code blob-code-inner js-file-line">28 t 10</td>
-      </tr>
-      <tr>
-        <td id="L365" class="blob-num js-line-number" data-line-number="365"></td>
-        <td id="LC365" class="blob-code blob-code-inner js-file-line">28 x_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L366" class="blob-num js-line-number" data-line-number="366"></td>
-        <td id="LC366" class="blob-code blob-code-inner js-file-line">28 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L367" class="blob-num js-line-number" data-line-number="367"></td>
-        <td id="LC367" class="blob-code blob-code-inner js-file-line">28 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L368" class="blob-num js-line-number" data-line-number="368"></td>
-        <td id="LC368" class="blob-code blob-code-inner js-file-line">29 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L369" class="blob-num js-line-number" data-line-number="369"></td>
-        <td id="LC369" class="blob-code blob-code-inner js-file-line">29 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L370" class="blob-num js-line-number" data-line-number="370"></td>
-        <td id="LC370" class="blob-code blob-code-inner js-file-line">29 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L371" class="blob-num js-line-number" data-line-number="371"></td>
-        <td id="LC371" class="blob-code blob-code-inner js-file-line">29 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L372" class="blob-num js-line-number" data-line-number="372"></td>
-        <td id="LC372" class="blob-code blob-code-inner js-file-line">29 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L373" class="blob-num js-line-number" data-line-number="373"></td>
-        <td id="LC373" class="blob-code blob-code-inner js-file-line">29 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L374" class="blob-num js-line-number" data-line-number="374"></td>
-        <td id="LC374" class="blob-code blob-code-inner js-file-line">29 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L375" class="blob-num js-line-number" data-line-number="375"></td>
-        <td id="LC375" class="blob-code blob-code-inner js-file-line">29 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L376" class="blob-num js-line-number" data-line-number="376"></td>
-        <td id="LC376" class="blob-code blob-code-inner js-file-line">30 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L377" class="blob-num js-line-number" data-line-number="377"></td>
-        <td id="LC377" class="blob-code blob-code-inner js-file-line">30 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L378" class="blob-num js-line-number" data-line-number="378"></td>
-        <td id="LC378" class="blob-code blob-code-inner js-file-line">30 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L379" class="blob-num js-line-number" data-line-number="379"></td>
-        <td id="LC379" class="blob-code blob-code-inner js-file-line">30 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L380" class="blob-num js-line-number" data-line-number="380"></td>
-        <td id="LC380" class="blob-code blob-code-inner js-file-line">30 t 1</td>
-      </tr>
-      <tr>
-        <td id="L381" class="blob-num js-line-number" data-line-number="381"></td>
-        <td id="LC381" class="blob-code blob-code-inner js-file-line">30 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L382" class="blob-num js-line-number" data-line-number="382"></td>
-        <td id="LC382" class="blob-code blob-code-inner js-file-line">30 x_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L383" class="blob-num js-line-number" data-line-number="383"></td>
-        <td id="LC383" class="blob-code blob-code-inner js-file-line">30 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L384" class="blob-num js-line-number" data-line-number="384"></td>
-        <td id="LC384" class="blob-code blob-code-inner js-file-line">30 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L385" class="blob-num js-line-number" data-line-number="385"></td>
-        <td id="LC385" class="blob-code blob-code-inner js-file-line">30 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L386" class="blob-num js-line-number" data-line-number="386"></td>
-        <td id="LC386" class="blob-code blob-code-inner js-file-line">30 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L387" class="blob-num js-line-number" data-line-number="387"></td>
-        <td id="LC387" class="blob-code blob-code-inner js-file-line">30 t 22</td>
-      </tr>
-      <tr>
-        <td id="L388" class="blob-num js-line-number" data-line-number="388"></td>
-        <td id="LC388" class="blob-code blob-code-inner js-file-line">31 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L389" class="blob-num js-line-number" data-line-number="389"></td>
-        <td id="LC389" class="blob-code blob-code-inner js-file-line">31 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L390" class="blob-num js-line-number" data-line-number="390"></td>
-        <td id="LC390" class="blob-code blob-code-inner js-file-line">31 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L391" class="blob-num js-line-number" data-line-number="391"></td>
-        <td id="LC391" class="blob-code blob-code-inner js-file-line">31 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L392" class="blob-num js-line-number" data-line-number="392"></td>
-        <td id="LC392" class="blob-code blob-code-inner js-file-line">31 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L393" class="blob-num js-line-number" data-line-number="393"></td>
-        <td id="LC393" class="blob-code blob-code-inner js-file-line">31 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L394" class="blob-num js-line-number" data-line-number="394"></td>
-        <td id="LC394" class="blob-code blob-code-inner js-file-line">31 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L395" class="blob-num js-line-number" data-line-number="395"></td>
-        <td id="LC395" class="blob-code blob-code-inner js-file-line">31 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L396" class="blob-num js-line-number" data-line-number="396"></td>
-        <td id="LC396" class="blob-code blob-code-inner js-file-line">31 t 16</td>
-      </tr>
-      <tr>
-        <td id="L397" class="blob-num js-line-number" data-line-number="397"></td>
-        <td id="LC397" class="blob-code blob-code-inner js-file-line">31 y_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L398" class="blob-num js-line-number" data-line-number="398"></td>
-        <td id="LC398" class="blob-code blob-code-inner js-file-line">32 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L399" class="blob-num js-line-number" data-line-number="399"></td>
-        <td id="LC399" class="blob-code blob-code-inner js-file-line">32 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L400" class="blob-num js-line-number" data-line-number="400"></td>
-        <td id="LC400" class="blob-code blob-code-inner js-file-line">32 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L401" class="blob-num js-line-number" data-line-number="401"></td>
-        <td id="LC401" class="blob-code blob-code-inner js-file-line">32 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L402" class="blob-num js-line-number" data-line-number="402"></td>
-        <td id="LC402" class="blob-code blob-code-inner js-file-line">32 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L403" class="blob-num js-line-number" data-line-number="403"></td>
-        <td id="LC403" class="blob-code blob-code-inner js-file-line">32 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L404" class="blob-num js-line-number" data-line-number="404"></td>
-        <td id="LC404" class="blob-code blob-code-inner js-file-line">32 y_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L405" class="blob-num js-line-number" data-line-number="405"></td>
-        <td id="LC405" class="blob-code blob-code-inner js-file-line">32 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L406" class="blob-num js-line-number" data-line-number="406"></td>
-        <td id="LC406" class="blob-code blob-code-inner js-file-line">32 x_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L407" class="blob-num js-line-number" data-line-number="407"></td>
-        <td id="LC407" class="blob-code blob-code-inner js-file-line">32 t 6</td>
-      </tr>
-      <tr>
-        <td id="L408" class="blob-num js-line-number" data-line-number="408"></td>
-        <td id="LC408" class="blob-code blob-code-inner js-file-line">32 t 8</td>
-      </tr>
-      <tr>
-        <td id="L409" class="blob-num js-line-number" data-line-number="409"></td>
-        <td id="LC409" class="blob-code blob-code-inner js-file-line">32 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L410" class="blob-num js-line-number" data-line-number="410"></td>
-        <td id="LC410" class="blob-code blob-code-inner js-file-line">32 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L411" class="blob-num js-line-number" data-line-number="411"></td>
-        <td id="LC411" class="blob-code blob-code-inner js-file-line">32 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L412" class="blob-num js-line-number" data-line-number="412"></td>
-        <td id="LC412" class="blob-code blob-code-inner js-file-line">32 t 17</td>
-      </tr>
-      <tr>
-        <td id="L413" class="blob-num js-line-number" data-line-number="413"></td>
-        <td id="LC413" class="blob-code blob-code-inner js-file-line">32 t 19</td>
-      </tr>
-      <tr>
-        <td id="L414" class="blob-num js-line-number" data-line-number="414"></td>
-        <td id="LC414" class="blob-code blob-code-inner js-file-line">32 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L415" class="blob-num js-line-number" data-line-number="415"></td>
-        <td id="LC415" class="blob-code blob-code-inner js-file-line">32 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L416" class="blob-num js-line-number" data-line-number="416"></td>
-        <td id="LC416" class="blob-code blob-code-inner js-file-line">33 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L417" class="blob-num js-line-number" data-line-number="417"></td>
-        <td id="LC417" class="blob-code blob-code-inner js-file-line">33 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L418" class="blob-num js-line-number" data-line-number="418"></td>
-        <td id="LC418" class="blob-code blob-code-inner js-file-line">33 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L419" class="blob-num js-line-number" data-line-number="419"></td>
-        <td id="LC419" class="blob-code blob-code-inner js-file-line">33 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L420" class="blob-num js-line-number" data-line-number="420"></td>
-        <td id="LC420" class="blob-code blob-code-inner js-file-line">33 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L421" class="blob-num js-line-number" data-line-number="421"></td>
-        <td id="LC421" class="blob-code blob-code-inner js-file-line">33 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L422" class="blob-num js-line-number" data-line-number="422"></td>
-        <td id="LC422" class="blob-code blob-code-inner js-file-line">33 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L423" class="blob-num js-line-number" data-line-number="423"></td>
-        <td id="LC423" class="blob-code blob-code-inner js-file-line">33 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L424" class="blob-num js-line-number" data-line-number="424"></td>
-        <td id="LC424" class="blob-code blob-code-inner js-file-line">33 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L425" class="blob-num js-line-number" data-line-number="425"></td>
-        <td id="LC425" class="blob-code blob-code-inner js-file-line">33 t 14</td>
-      </tr>
-      <tr>
-        <td id="L426" class="blob-num js-line-number" data-line-number="426"></td>
-        <td id="LC426" class="blob-code blob-code-inner js-file-line">33 x_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L427" class="blob-num js-line-number" data-line-number="427"></td>
-        <td id="LC427" class="blob-code blob-code-inner js-file-line">33 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L428" class="blob-num js-line-number" data-line-number="428"></td>
-        <td id="LC428" class="blob-code blob-code-inner js-file-line">34 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L429" class="blob-num js-line-number" data-line-number="429"></td>
-        <td id="LC429" class="blob-code blob-code-inner js-file-line">34 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L430" class="blob-num js-line-number" data-line-number="430"></td>
-        <td id="LC430" class="blob-code blob-code-inner js-file-line">34 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L431" class="blob-num js-line-number" data-line-number="431"></td>
-        <td id="LC431" class="blob-code blob-code-inner js-file-line">34 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L432" class="blob-num js-line-number" data-line-number="432"></td>
-        <td id="LC432" class="blob-code blob-code-inner js-file-line">34 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L433" class="blob-num js-line-number" data-line-number="433"></td>
-        <td id="LC433" class="blob-code blob-code-inner js-file-line">34 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L434" class="blob-num js-line-number" data-line-number="434"></td>
-        <td id="LC434" class="blob-code blob-code-inner js-file-line">34 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L435" class="blob-num js-line-number" data-line-number="435"></td>
-        <td id="LC435" class="blob-code blob-code-inner js-file-line">34 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L436" class="blob-num js-line-number" data-line-number="436"></td>
-        <td id="LC436" class="blob-code blob-code-inner js-file-line">34 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L437" class="blob-num js-line-number" data-line-number="437"></td>
-        <td id="LC437" class="blob-code blob-code-inner js-file-line">34 y_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L438" class="blob-num js-line-number" data-line-number="438"></td>
-        <td id="LC438" class="blob-code blob-code-inner js-file-line">34 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L439" class="blob-num js-line-number" data-line-number="439"></td>
-        <td id="LC439" class="blob-code blob-code-inner js-file-line">34 t 9</td>
-      </tr>
-      <tr>
-        <td id="L440" class="blob-num js-line-number" data-line-number="440"></td>
-        <td id="LC440" class="blob-code blob-code-inner js-file-line">34 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L441" class="blob-num js-line-number" data-line-number="441"></td>
-        <td id="LC441" class="blob-code blob-code-inner js-file-line">34 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L442" class="blob-num js-line-number" data-line-number="442"></td>
-        <td id="LC442" class="blob-code blob-code-inner js-file-line">34 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L443" class="blob-num js-line-number" data-line-number="443"></td>
-        <td id="LC443" class="blob-code blob-code-inner js-file-line">34 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L444" class="blob-num js-line-number" data-line-number="444"></td>
-        <td id="LC444" class="blob-code blob-code-inner js-file-line">34 t 20</td>
-      </tr>
-      <tr>
-        <td id="L445" class="blob-num js-line-number" data-line-number="445"></td>
-        <td id="LC445" class="blob-code blob-code-inner js-file-line">34 t 21</td>
-      </tr>
-      <tr>
-        <td id="L446" class="blob-num js-line-number" data-line-number="446"></td>
-        <td id="LC446" class="blob-code blob-code-inner js-file-line">35 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L447" class="blob-num js-line-number" data-line-number="447"></td>
-        <td id="LC447" class="blob-code blob-code-inner js-file-line">35 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L448" class="blob-num js-line-number" data-line-number="448"></td>
-        <td id="LC448" class="blob-code blob-code-inner js-file-line">35 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L449" class="blob-num js-line-number" data-line-number="449"></td>
-        <td id="LC449" class="blob-code blob-code-inner js-file-line">35 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L450" class="blob-num js-line-number" data-line-number="450"></td>
-        <td id="LC450" class="blob-code blob-code-inner js-file-line">35 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L451" class="blob-num js-line-number" data-line-number="451"></td>
-        <td id="LC451" class="blob-code blob-code-inner js-file-line">35 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L452" class="blob-num js-line-number" data-line-number="452"></td>
-        <td id="LC452" class="blob-code blob-code-inner js-file-line">35 t 11</td>
-      </tr>
-      <tr>
-        <td id="L453" class="blob-num js-line-number" data-line-number="453"></td>
-        <td id="LC453" class="blob-code blob-code-inner js-file-line">35 t 15</td>
-      </tr>
-      <tr>
-        <td id="L454" class="blob-num js-line-number" data-line-number="454"></td>
-        <td id="LC454" class="blob-code blob-code-inner js-file-line">35 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L455" class="blob-num js-line-number" data-line-number="455"></td>
-        <td id="LC455" class="blob-code blob-code-inner js-file-line">35 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L456" class="blob-num js-line-number" data-line-number="456"></td>
-        <td id="LC456" class="blob-code blob-code-inner js-file-line">35 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L457" class="blob-num js-line-number" data-line-number="457"></td>
-        <td id="LC457" class="blob-code blob-code-inner js-file-line">35 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L458" class="blob-num js-line-number" data-line-number="458"></td>
-        <td id="LC458" class="blob-code blob-code-inner js-file-line">36 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L459" class="blob-num js-line-number" data-line-number="459"></td>
-        <td id="LC459" class="blob-code blob-code-inner js-file-line">36 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L460" class="blob-num js-line-number" data-line-number="460"></td>
-        <td id="LC460" class="blob-code blob-code-inner js-file-line">36 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L461" class="blob-num js-line-number" data-line-number="461"></td>
-        <td id="LC461" class="blob-code blob-code-inner js-file-line">36 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L462" class="blob-num js-line-number" data-line-number="462"></td>
-        <td id="LC462" class="blob-code blob-code-inner js-file-line">36 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L463" class="blob-num js-line-number" data-line-number="463"></td>
-        <td id="LC463" class="blob-code blob-code-inner js-file-line">36 t 10</td>
-      </tr>
-      <tr>
-        <td id="L464" class="blob-num js-line-number" data-line-number="464"></td>
-        <td id="LC464" class="blob-code blob-code-inner js-file-line">36 t 12</td>
-      </tr>
-      <tr>
-        <td id="L465" class="blob-num js-line-number" data-line-number="465"></td>
-        <td id="LC465" class="blob-code blob-code-inner js-file-line">36 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L466" class="blob-num js-line-number" data-line-number="466"></td>
-        <td id="LC466" class="blob-code blob-code-inner js-file-line">36 t 16</td>
-      </tr>
-      <tr>
-        <td id="L467" class="blob-num js-line-number" data-line-number="467"></td>
-        <td id="LC467" class="blob-code blob-code-inner js-file-line">37 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L468" class="blob-num js-line-number" data-line-number="468"></td>
-        <td id="LC468" class="blob-code blob-code-inner js-file-line">37 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L469" class="blob-num js-line-number" data-line-number="469"></td>
-        <td id="LC469" class="blob-code blob-code-inner js-file-line">37 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L470" class="blob-num js-line-number" data-line-number="470"></td>
-        <td id="LC470" class="blob-code blob-code-inner js-file-line">37 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L471" class="blob-num js-line-number" data-line-number="471"></td>
-        <td id="LC471" class="blob-code blob-code-inner js-file-line">37 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L472" class="blob-num js-line-number" data-line-number="472"></td>
-        <td id="LC472" class="blob-code blob-code-inner js-file-line">37 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L473" class="blob-num js-line-number" data-line-number="473"></td>
-        <td id="LC473" class="blob-code blob-code-inner js-file-line">37 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L474" class="blob-num js-line-number" data-line-number="474"></td>
-        <td id="LC474" class="blob-code blob-code-inner js-file-line">37 t 17</td>
-      </tr>
-      <tr>
-        <td id="L475" class="blob-num js-line-number" data-line-number="475"></td>
-        <td id="LC475" class="blob-code blob-code-inner js-file-line">38 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L476" class="blob-num js-line-number" data-line-number="476"></td>
-        <td id="LC476" class="blob-code blob-code-inner js-file-line">38 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L477" class="blob-num js-line-number" data-line-number="477"></td>
-        <td id="LC477" class="blob-code blob-code-inner js-file-line">38 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L478" class="blob-num js-line-number" data-line-number="478"></td>
-        <td id="LC478" class="blob-code blob-code-inner js-file-line">38 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L479" class="blob-num js-line-number" data-line-number="479"></td>
-        <td id="LC479" class="blob-code blob-code-inner js-file-line">38 t 1</td>
-      </tr>
-      <tr>
-        <td id="L480" class="blob-num js-line-number" data-line-number="480"></td>
-        <td id="LC480" class="blob-code blob-code-inner js-file-line">38 t 2</td>
-      </tr>
-      <tr>
-        <td id="L481" class="blob-num js-line-number" data-line-number="481"></td>
-        <td id="LC481" class="blob-code blob-code-inner js-file-line">38 x_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L482" class="blob-num js-line-number" data-line-number="482"></td>
-        <td id="LC482" class="blob-code blob-code-inner js-file-line">38 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L483" class="blob-num js-line-number" data-line-number="483"></td>
-        <td id="LC483" class="blob-code blob-code-inner js-file-line">38 t 13</td>
-      </tr>
-      <tr>
-        <td id="L484" class="blob-num js-line-number" data-line-number="484"></td>
-        <td id="LC484" class="blob-code blob-code-inner js-file-line">38 t 14</td>
-      </tr>
-      <tr>
-        <td id="L485" class="blob-num js-line-number" data-line-number="485"></td>
-        <td id="LC485" class="blob-code blob-code-inner js-file-line">38 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L486" class="blob-num js-line-number" data-line-number="486"></td>
-        <td id="LC486" class="blob-code blob-code-inner js-file-line">38 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L487" class="blob-num js-line-number" data-line-number="487"></td>
-        <td id="LC487" class="blob-code blob-code-inner js-file-line">39 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L488" class="blob-num js-line-number" data-line-number="488"></td>
-        <td id="LC488" class="blob-code blob-code-inner js-file-line">39 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L489" class="blob-num js-line-number" data-line-number="489"></td>
-        <td id="LC489" class="blob-code blob-code-inner js-file-line">39 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L490" class="blob-num js-line-number" data-line-number="490"></td>
-        <td id="LC490" class="blob-code blob-code-inner js-file-line">39 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L491" class="blob-num js-line-number" data-line-number="491"></td>
-        <td id="LC491" class="blob-code blob-code-inner js-file-line">39 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L492" class="blob-num js-line-number" data-line-number="492"></td>
-        <td id="LC492" class="blob-code blob-code-inner js-file-line">39 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L493" class="blob-num js-line-number" data-line-number="493"></td>
-        <td id="LC493" class="blob-code blob-code-inner js-file-line">39 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L494" class="blob-num js-line-number" data-line-number="494"></td>
-        <td id="LC494" class="blob-code blob-code-inner js-file-line">39 t 7</td>
-      </tr>
-      <tr>
-        <td id="L495" class="blob-num js-line-number" data-line-number="495"></td>
-        <td id="LC495" class="blob-code blob-code-inner js-file-line">39 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L496" class="blob-num js-line-number" data-line-number="496"></td>
-        <td id="LC496" class="blob-code blob-code-inner js-file-line">39 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L497" class="blob-num js-line-number" data-line-number="497"></td>
-        <td id="LC497" class="blob-code blob-code-inner js-file-line">40 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L498" class="blob-num js-line-number" data-line-number="498"></td>
-        <td id="LC498" class="blob-code blob-code-inner js-file-line">40 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L499" class="blob-num js-line-number" data-line-number="499"></td>
-        <td id="LC499" class="blob-code blob-code-inner js-file-line">40 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L500" class="blob-num js-line-number" data-line-number="500"></td>
-        <td id="LC500" class="blob-code blob-code-inner js-file-line">40 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L501" class="blob-num js-line-number" data-line-number="501"></td>
-        <td id="LC501" class="blob-code blob-code-inner js-file-line">40 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L502" class="blob-num js-line-number" data-line-number="502"></td>
-        <td id="LC502" class="blob-code blob-code-inner js-file-line">40 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L503" class="blob-num js-line-number" data-line-number="503"></td>
-        <td id="LC503" class="blob-code blob-code-inner js-file-line">40 y_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L504" class="blob-num js-line-number" data-line-number="504"></td>
-        <td id="LC504" class="blob-code blob-code-inner js-file-line">40 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L505" class="blob-num js-line-number" data-line-number="505"></td>
-        <td id="LC505" class="blob-code blob-code-inner js-file-line">40 t 4</td>
-      </tr>
-      <tr>
-        <td id="L506" class="blob-num js-line-number" data-line-number="506"></td>
-        <td id="LC506" class="blob-code blob-code-inner js-file-line">40 t 6</td>
-      </tr>
-      <tr>
-        <td id="L507" class="blob-num js-line-number" data-line-number="507"></td>
-        <td id="LC507" class="blob-code blob-code-inner js-file-line">40 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L508" class="blob-num js-line-number" data-line-number="508"></td>
-        <td id="LC508" class="blob-code blob-code-inner js-file-line">40 t 10</td>
-      </tr>
-      <tr>
-        <td id="L509" class="blob-num js-line-number" data-line-number="509"></td>
-        <td id="LC509" class="blob-code blob-code-inner js-file-line">40 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L510" class="blob-num js-line-number" data-line-number="510"></td>
-        <td id="LC510" class="blob-code blob-code-inner js-file-line">40 t 15</td>
-      </tr>
-      <tr>
-        <td id="L511" class="blob-num js-line-number" data-line-number="511"></td>
-        <td id="LC511" class="blob-code blob-code-inner js-file-line">40 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L512" class="blob-num js-line-number" data-line-number="512"></td>
-        <td id="LC512" class="blob-code blob-code-inner js-file-line">40 t 19</td>
-      </tr>
-      <tr>
-        <td id="L513" class="blob-num js-line-number" data-line-number="513"></td>
-        <td id="LC513" class="blob-code blob-code-inner js-file-line">40 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L514" class="blob-num js-line-number" data-line-number="514"></td>
-        <td id="LC514" class="blob-code blob-code-inner js-file-line">40 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L515" class="blob-num js-line-number" data-line-number="515"></td>
-        <td id="LC515" class="blob-code blob-code-inner js-file-line">41 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L516" class="blob-num js-line-number" data-line-number="516"></td>
-        <td id="LC516" class="blob-code blob-code-inner js-file-line">41 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L517" class="blob-num js-line-number" data-line-number="517"></td>
-        <td id="LC517" class="blob-code blob-code-inner js-file-line">41 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L518" class="blob-num js-line-number" data-line-number="518"></td>
-        <td id="LC518" class="blob-code blob-code-inner js-file-line">41 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L519" class="blob-num js-line-number" data-line-number="519"></td>
-        <td id="LC519" class="blob-code blob-code-inner js-file-line">41 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L520" class="blob-num js-line-number" data-line-number="520"></td>
-        <td id="LC520" class="blob-code blob-code-inner js-file-line">41 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L521" class="blob-num js-line-number" data-line-number="521"></td>
-        <td id="LC521" class="blob-code blob-code-inner js-file-line">41 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L522" class="blob-num js-line-number" data-line-number="522"></td>
-        <td id="LC522" class="blob-code blob-code-inner js-file-line">41 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L523" class="blob-num js-line-number" data-line-number="523"></td>
-        <td id="LC523" class="blob-code blob-code-inner js-file-line">41 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L524" class="blob-num js-line-number" data-line-number="524"></td>
-        <td id="LC524" class="blob-code blob-code-inner js-file-line">41 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L525" class="blob-num js-line-number" data-line-number="525"></td>
-        <td id="LC525" class="blob-code blob-code-inner js-file-line">41 x_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L526" class="blob-num js-line-number" data-line-number="526"></td>
-        <td id="LC526" class="blob-code blob-code-inner js-file-line">41 t 22</td>
-      </tr>
-      <tr>
-        <td id="L527" class="blob-num js-line-number" data-line-number="527"></td>
-        <td id="LC527" class="blob-code blob-code-inner js-file-line">42 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L528" class="blob-num js-line-number" data-line-number="528"></td>
-        <td id="LC528" class="blob-code blob-code-inner js-file-line">42 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L529" class="blob-num js-line-number" data-line-number="529"></td>
-        <td id="LC529" class="blob-code blob-code-inner js-file-line">42 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L530" class="blob-num js-line-number" data-line-number="530"></td>
-        <td id="LC530" class="blob-code blob-code-inner js-file-line">42 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L531" class="blob-num js-line-number" data-line-number="531"></td>
-        <td id="LC531" class="blob-code blob-code-inner js-file-line">42 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L532" class="blob-num js-line-number" data-line-number="532"></td>
-        <td id="LC532" class="blob-code blob-code-inner js-file-line">42 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L533" class="blob-num js-line-number" data-line-number="533"></td>
-        <td id="LC533" class="blob-code blob-code-inner js-file-line">42 t 0</td>
-      </tr>
-      <tr>
-        <td id="L534" class="blob-num js-line-number" data-line-number="534"></td>
-        <td id="LC534" class="blob-code blob-code-inner js-file-line">42 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L535" class="blob-num js-line-number" data-line-number="535"></td>
-        <td id="LC535" class="blob-code blob-code-inner js-file-line">42 x_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L536" class="blob-num js-line-number" data-line-number="536"></td>
-        <td id="LC536" class="blob-code blob-code-inner js-file-line">42 x_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L537" class="blob-num js-line-number" data-line-number="537"></td>
-        <td id="LC537" class="blob-code blob-code-inner js-file-line">42 t 8</td>
-      </tr>
-      <tr>
-        <td id="L538" class="blob-num js-line-number" data-line-number="538"></td>
-        <td id="LC538" class="blob-code blob-code-inner js-file-line">42 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L539" class="blob-num js-line-number" data-line-number="539"></td>
-        <td id="LC539" class="blob-code blob-code-inner js-file-line">42 x_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L540" class="blob-num js-line-number" data-line-number="540"></td>
-        <td id="LC540" class="blob-code blob-code-inner js-file-line">42 t 13</td>
-      </tr>
-      <tr>
-        <td id="L541" class="blob-num js-line-number" data-line-number="541"></td>
-        <td id="LC541" class="blob-code blob-code-inner js-file-line">42 t 16</td>
-      </tr>
-      <tr>
-        <td id="L542" class="blob-num js-line-number" data-line-number="542"></td>
-        <td id="LC542" class="blob-code blob-code-inner js-file-line">42 t 17</td>
-      </tr>
-      <tr>
-        <td id="L543" class="blob-num js-line-number" data-line-number="543"></td>
-        <td id="LC543" class="blob-code blob-code-inner js-file-line">42 t 20</td>
-      </tr>
-      <tr>
-        <td id="L544" class="blob-num js-line-number" data-line-number="544"></td>
-        <td id="LC544" class="blob-code blob-code-inner js-file-line">42 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L545" class="blob-num js-line-number" data-line-number="545"></td>
-        <td id="LC545" class="blob-code blob-code-inner js-file-line">43 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L546" class="blob-num js-line-number" data-line-number="546"></td>
-        <td id="LC546" class="blob-code blob-code-inner js-file-line">43 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L547" class="blob-num js-line-number" data-line-number="547"></td>
-        <td id="LC547" class="blob-code blob-code-inner js-file-line">43 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L548" class="blob-num js-line-number" data-line-number="548"></td>
-        <td id="LC548" class="blob-code blob-code-inner js-file-line">43 t 2</td>
-      </tr>
-      <tr>
-        <td id="L549" class="blob-num js-line-number" data-line-number="549"></td>
-        <td id="LC549" class="blob-code blob-code-inner js-file-line">43 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L550" class="blob-num js-line-number" data-line-number="550"></td>
-        <td id="LC550" class="blob-code blob-code-inner js-file-line">43 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L551" class="blob-num js-line-number" data-line-number="551"></td>
-        <td id="LC551" class="blob-code blob-code-inner js-file-line">43 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L552" class="blob-num js-line-number" data-line-number="552"></td>
-        <td id="LC552" class="blob-code blob-code-inner js-file-line">43 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L553" class="blob-num js-line-number" data-line-number="553"></td>
-        <td id="LC553" class="blob-code blob-code-inner js-file-line">43 t 18</td>
-      </tr>
-      <tr>
-        <td id="L554" class="blob-num js-line-number" data-line-number="554"></td>
-        <td id="LC554" class="blob-code blob-code-inner js-file-line">43 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L555" class="blob-num js-line-number" data-line-number="555"></td>
-        <td id="LC555" class="blob-code blob-code-inner js-file-line">43 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L556" class="blob-num js-line-number" data-line-number="556"></td>
-        <td id="LC556" class="blob-code blob-code-inner js-file-line">43 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L557" class="blob-num js-line-number" data-line-number="557"></td>
-        <td id="LC557" class="blob-code blob-code-inner js-file-line">44 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L558" class="blob-num js-line-number" data-line-number="558"></td>
-        <td id="LC558" class="blob-code blob-code-inner js-file-line">44 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L559" class="blob-num js-line-number" data-line-number="559"></td>
-        <td id="LC559" class="blob-code blob-code-inner js-file-line">44 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L560" class="blob-num js-line-number" data-line-number="560"></td>
-        <td id="LC560" class="blob-code blob-code-inner js-file-line">44 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L561" class="blob-num js-line-number" data-line-number="561"></td>
-        <td id="LC561" class="blob-code blob-code-inner js-file-line">44 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L562" class="blob-num js-line-number" data-line-number="562"></td>
-        <td id="LC562" class="blob-code blob-code-inner js-file-line">44 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L563" class="blob-num js-line-number" data-line-number="563"></td>
-        <td id="LC563" class="blob-code blob-code-inner js-file-line">44 t 12</td>
-      </tr>
-      <tr>
-        <td id="L564" class="blob-num js-line-number" data-line-number="564"></td>
-        <td id="LC564" class="blob-code blob-code-inner js-file-line">44 t 14</td>
-      </tr>
-      <tr>
-        <td id="L565" class="blob-num js-line-number" data-line-number="565"></td>
-        <td id="LC565" class="blob-code blob-code-inner js-file-line">44 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L566" class="blob-num js-line-number" data-line-number="566"></td>
-        <td id="LC566" class="blob-code blob-code-inner js-file-line">45 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L567" class="blob-num js-line-number" data-line-number="567"></td>
-        <td id="LC567" class="blob-code blob-code-inner js-file-line">45 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L568" class="blob-num js-line-number" data-line-number="568"></td>
-        <td id="LC568" class="blob-code blob-code-inner js-file-line">45 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L569" class="blob-num js-line-number" data-line-number="569"></td>
-        <td id="LC569" class="blob-code blob-code-inner js-file-line">45 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L570" class="blob-num js-line-number" data-line-number="570"></td>
-        <td id="LC570" class="blob-code blob-code-inner js-file-line">45 t 7</td>
-      </tr>
-      <tr>
-        <td id="L571" class="blob-num js-line-number" data-line-number="571"></td>
-        <td id="LC571" class="blob-code blob-code-inner js-file-line">45 t 11</td>
-      </tr>
-      <tr>
-        <td id="L572" class="blob-num js-line-number" data-line-number="572"></td>
-        <td id="LC572" class="blob-code blob-code-inner js-file-line">45 t 15</td>
-      </tr>
-      <tr>
-        <td id="L573" class="blob-num js-line-number" data-line-number="573"></td>
-        <td id="LC573" class="blob-code blob-code-inner js-file-line">45 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L574" class="blob-num js-line-number" data-line-number="574"></td>
-        <td id="LC574" class="blob-code blob-code-inner js-file-line">46 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L575" class="blob-num js-line-number" data-line-number="575"></td>
-        <td id="LC575" class="blob-code blob-code-inner js-file-line">46 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L576" class="blob-num js-line-number" data-line-number="576"></td>
-        <td id="LC576" class="blob-code blob-code-inner js-file-line">46 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L577" class="blob-num js-line-number" data-line-number="577"></td>
-        <td id="LC577" class="blob-code blob-code-inner js-file-line">46 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L578" class="blob-num js-line-number" data-line-number="578"></td>
-        <td id="LC578" class="blob-code blob-code-inner js-file-line">46 y_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L579" class="blob-num js-line-number" data-line-number="579"></td>
-        <td id="LC579" class="blob-code blob-code-inner js-file-line">46 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L580" class="blob-num js-line-number" data-line-number="580"></td>
-        <td id="LC580" class="blob-code blob-code-inner js-file-line">46 t 9</td>
-      </tr>
-      <tr>
-        <td id="L581" class="blob-num js-line-number" data-line-number="581"></td>
-        <td id="LC581" class="blob-code blob-code-inner js-file-line">46 t 10</td>
-      </tr>
-      <tr>
-        <td id="L582" class="blob-num js-line-number" data-line-number="582"></td>
-        <td id="LC582" class="blob-code blob-code-inner js-file-line">46 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L583" class="blob-num js-line-number" data-line-number="583"></td>
-        <td id="LC583" class="blob-code blob-code-inner js-file-line">46 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L584" class="blob-num js-line-number" data-line-number="584"></td>
-        <td id="LC584" class="blob-code blob-code-inner js-file-line">46 t 21</td>
-      </tr>
-      <tr>
-        <td id="L585" class="blob-num js-line-number" data-line-number="585"></td>
-        <td id="LC585" class="blob-code blob-code-inner js-file-line">46 t 22</td>
-      </tr>
-      <tr>
-        <td id="L586" class="blob-num js-line-number" data-line-number="586"></td>
-        <td id="LC586" class="blob-code blob-code-inner js-file-line">47 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L587" class="blob-num js-line-number" data-line-number="587"></td>
-        <td id="LC587" class="blob-code blob-code-inner js-file-line">47 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L588" class="blob-num js-line-number" data-line-number="588"></td>
-        <td id="LC588" class="blob-code blob-code-inner js-file-line">47 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L589" class="blob-num js-line-number" data-line-number="589"></td>
-        <td id="LC589" class="blob-code blob-code-inner js-file-line">47 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L590" class="blob-num js-line-number" data-line-number="590"></td>
-        <td id="LC590" class="blob-code blob-code-inner js-file-line">47 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L591" class="blob-num js-line-number" data-line-number="591"></td>
-        <td id="LC591" class="blob-code blob-code-inner js-file-line">47 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L592" class="blob-num js-line-number" data-line-number="592"></td>
-        <td id="LC592" class="blob-code blob-code-inner js-file-line">47 t 3</td>
-      </tr>
-      <tr>
-        <td id="L593" class="blob-num js-line-number" data-line-number="593"></td>
-        <td id="LC593" class="blob-code blob-code-inner js-file-line">47 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L594" class="blob-num js-line-number" data-line-number="594"></td>
-        <td id="LC594" class="blob-code blob-code-inner js-file-line">47 t 16</td>
-      </tr>
-      <tr>
-        <td id="L595" class="blob-num js-line-number" data-line-number="595"></td>
-        <td id="LC595" class="blob-code blob-code-inner js-file-line">47 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L596" class="blob-num js-line-number" data-line-number="596"></td>
-        <td id="LC596" class="blob-code blob-code-inner js-file-line">48 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L597" class="blob-num js-line-number" data-line-number="597"></td>
-        <td id="LC597" class="blob-code blob-code-inner js-file-line">48 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L598" class="blob-num js-line-number" data-line-number="598"></td>
-        <td id="LC598" class="blob-code blob-code-inner js-file-line">48 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L599" class="blob-num js-line-number" data-line-number="599"></td>
-        <td id="LC599" class="blob-code blob-code-inner js-file-line">48 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L600" class="blob-num js-line-number" data-line-number="600"></td>
-        <td id="LC600" class="blob-code blob-code-inner js-file-line">48 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L601" class="blob-num js-line-number" data-line-number="601"></td>
-        <td id="LC601" class="blob-code blob-code-inner js-file-line">48 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L602" class="blob-num js-line-number" data-line-number="602"></td>
-        <td id="LC602" class="blob-code blob-code-inner js-file-line">48 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L603" class="blob-num js-line-number" data-line-number="603"></td>
-        <td id="LC603" class="blob-code blob-code-inner js-file-line">48 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L604" class="blob-num js-line-number" data-line-number="604"></td>
-        <td id="LC604" class="blob-code blob-code-inner js-file-line">48 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L605" class="blob-num js-line-number" data-line-number="605"></td>
-        <td id="LC605" class="blob-code blob-code-inner js-file-line">48 t 6</td>
-      </tr>
-      <tr>
-        <td id="L606" class="blob-num js-line-number" data-line-number="606"></td>
-        <td id="LC606" class="blob-code blob-code-inner js-file-line">48 t 8</td>
-      </tr>
-      <tr>
-        <td id="L607" class="blob-num js-line-number" data-line-number="607"></td>
-        <td id="LC607" class="blob-code blob-code-inner js-file-line">48 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L608" class="blob-num js-line-number" data-line-number="608"></td>
-        <td id="LC608" class="blob-code blob-code-inner js-file-line">48 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L609" class="blob-num js-line-number" data-line-number="609"></td>
-        <td id="LC609" class="blob-code blob-code-inner js-file-line">48 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L610" class="blob-num js-line-number" data-line-number="610"></td>
-        <td id="LC610" class="blob-code blob-code-inner js-file-line">48 t 17</td>
-      </tr>
-      <tr>
-        <td id="L611" class="blob-num js-line-number" data-line-number="611"></td>
-        <td id="LC611" class="blob-code blob-code-inner js-file-line">48 t 19</td>
-      </tr>
-      <tr>
-        <td id="L612" class="blob-num js-line-number" data-line-number="612"></td>
-        <td id="LC612" class="blob-code blob-code-inner js-file-line">48 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L613" class="blob-num js-line-number" data-line-number="613"></td>
-        <td id="LC613" class="blob-code blob-code-inner js-file-line">48 t 23</td>
-      </tr>
-      <tr>
-        <td id="L614" class="blob-num js-line-number" data-line-number="614"></td>
-        <td id="LC614" class="blob-code blob-code-inner js-file-line">49 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L615" class="blob-num js-line-number" data-line-number="615"></td>
-        <td id="LC615" class="blob-code blob-code-inner js-file-line">49 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L616" class="blob-num js-line-number" data-line-number="616"></td>
-        <td id="LC616" class="blob-code blob-code-inner js-file-line">49 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L617" class="blob-num js-line-number" data-line-number="617"></td>
-        <td id="LC617" class="blob-code blob-code-inner js-file-line">49 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L618" class="blob-num js-line-number" data-line-number="618"></td>
-        <td id="LC618" class="blob-code blob-code-inner js-file-line">49 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L619" class="blob-num js-line-number" data-line-number="619"></td>
-        <td id="LC619" class="blob-code blob-code-inner js-file-line">49 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L620" class="blob-num js-line-number" data-line-number="620"></td>
-        <td id="LC620" class="blob-code blob-code-inner js-file-line">49 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L621" class="blob-num js-line-number" data-line-number="621"></td>
-        <td id="LC621" class="blob-code blob-code-inner js-file-line">49 t 7</td>
-      </tr>
-      <tr>
-        <td id="L622" class="blob-num js-line-number" data-line-number="622"></td>
-        <td id="LC622" class="blob-code blob-code-inner js-file-line">49 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L623" class="blob-num js-line-number" data-line-number="623"></td>
-        <td id="LC623" class="blob-code blob-code-inner js-file-line">49 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L624" class="blob-num js-line-number" data-line-number="624"></td>
-        <td id="LC624" class="blob-code blob-code-inner js-file-line">49 x_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L625" class="blob-num js-line-number" data-line-number="625"></td>
-        <td id="LC625" class="blob-code blob-code-inner js-file-line">49 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L626" class="blob-num js-line-number" data-line-number="626"></td>
-        <td id="LC626" class="blob-code blob-code-inner js-file-line">50 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L627" class="blob-num js-line-number" data-line-number="627"></td>
-        <td id="LC627" class="blob-code blob-code-inner js-file-line">50 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L628" class="blob-num js-line-number" data-line-number="628"></td>
-        <td id="LC628" class="blob-code blob-code-inner js-file-line">50 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L629" class="blob-num js-line-number" data-line-number="629"></td>
-        <td id="LC629" class="blob-code blob-code-inner js-file-line">50 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L630" class="blob-num js-line-number" data-line-number="630"></td>
-        <td id="LC630" class="blob-code blob-code-inner js-file-line">50 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L631" class="blob-num js-line-number" data-line-number="631"></td>
-        <td id="LC631" class="blob-code blob-code-inner js-file-line">50 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L632" class="blob-num js-line-number" data-line-number="632"></td>
-        <td id="LC632" class="blob-code blob-code-inner js-file-line">50 t 0</td>
-      </tr>
-      <tr>
-        <td id="L633" class="blob-num js-line-number" data-line-number="633"></td>
-        <td id="LC633" class="blob-code blob-code-inner js-file-line">50 t 1</td>
-      </tr>
-      <tr>
-        <td id="L634" class="blob-num js-line-number" data-line-number="634"></td>
-        <td id="LC634" class="blob-code blob-code-inner js-file-line">50 x_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L635" class="blob-num js-line-number" data-line-number="635"></td>
-        <td id="LC635" class="blob-code blob-code-inner js-file-line">50 t 5</td>
-      </tr>
-      <tr>
-        <td id="L636" class="blob-num js-line-number" data-line-number="636"></td>
-        <td id="LC636" class="blob-code blob-code-inner js-file-line">50 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L637" class="blob-num js-line-number" data-line-number="637"></td>
-        <td id="LC637" class="blob-code blob-code-inner js-file-line">50 x_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L638" class="blob-num js-line-number" data-line-number="638"></td>
-        <td id="LC638" class="blob-code blob-code-inner js-file-line">50 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L639" class="blob-num js-line-number" data-line-number="639"></td>
-        <td id="LC639" class="blob-code blob-code-inner js-file-line">50 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L640" class="blob-num js-line-number" data-line-number="640"></td>
-        <td id="LC640" class="blob-code blob-code-inner js-file-line">50 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L641" class="blob-num js-line-number" data-line-number="641"></td>
-        <td id="LC641" class="blob-code blob-code-inner js-file-line">50 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L642" class="blob-num js-line-number" data-line-number="642"></td>
-        <td id="LC642" class="blob-code blob-code-inner js-file-line">50 t 20</td>
-      </tr>
-      <tr>
-        <td id="L643" class="blob-num js-line-number" data-line-number="643"></td>
-        <td id="LC643" class="blob-code blob-code-inner js-file-line">50 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L644" class="blob-num js-line-number" data-line-number="644"></td>
-        <td id="LC644" class="blob-code blob-code-inner js-file-line">51 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L645" class="blob-num js-line-number" data-line-number="645"></td>
-        <td id="LC645" class="blob-code blob-code-inner js-file-line">51 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L646" class="blob-num js-line-number" data-line-number="646"></td>
-        <td id="LC646" class="blob-code blob-code-inner js-file-line">51 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L647" class="blob-num js-line-number" data-line-number="647"></td>
-        <td id="LC647" class="blob-code blob-code-inner js-file-line">51 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L648" class="blob-num js-line-number" data-line-number="648"></td>
-        <td id="LC648" class="blob-code blob-code-inner js-file-line">51 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L649" class="blob-num js-line-number" data-line-number="649"></td>
-        <td id="LC649" class="blob-code blob-code-inner js-file-line">51 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L650" class="blob-num js-line-number" data-line-number="650"></td>
-        <td id="LC650" class="blob-code blob-code-inner js-file-line">51 t 11</td>
-      </tr>
-      <tr>
-        <td id="L651" class="blob-num js-line-number" data-line-number="651"></td>
-        <td id="LC651" class="blob-code blob-code-inner js-file-line">51 t 15</td>
-      </tr>
-      <tr>
-        <td id="L652" class="blob-num js-line-number" data-line-number="652"></td>
-        <td id="LC652" class="blob-code blob-code-inner js-file-line">51 t 18</td>
-      </tr>
-      <tr>
-        <td id="L653" class="blob-num js-line-number" data-line-number="653"></td>
-        <td id="LC653" class="blob-code blob-code-inner js-file-line">51 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L654" class="blob-num js-line-number" data-line-number="654"></td>
-        <td id="LC654" class="blob-code blob-code-inner js-file-line">51 t 22</td>
-      </tr>
-      <tr>
-        <td id="L655" class="blob-num js-line-number" data-line-number="655"></td>
-        <td id="LC655" class="blob-code blob-code-inner js-file-line">51 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L656" class="blob-num js-line-number" data-line-number="656"></td>
-        <td id="LC656" class="blob-code blob-code-inner js-file-line">52 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L657" class="blob-num js-line-number" data-line-number="657"></td>
-        <td id="LC657" class="blob-code blob-code-inner js-file-line">52 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L658" class="blob-num js-line-number" data-line-number="658"></td>
-        <td id="LC658" class="blob-code blob-code-inner js-file-line">52 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L659" class="blob-num js-line-number" data-line-number="659"></td>
-        <td id="LC659" class="blob-code blob-code-inner js-file-line">52 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L660" class="blob-num js-line-number" data-line-number="660"></td>
-        <td id="LC660" class="blob-code blob-code-inner js-file-line">52 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L661" class="blob-num js-line-number" data-line-number="661"></td>
-        <td id="LC661" class="blob-code blob-code-inner js-file-line">52 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L662" class="blob-num js-line-number" data-line-number="662"></td>
-        <td id="LC662" class="blob-code blob-code-inner js-file-line">52 x_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L663" class="blob-num js-line-number" data-line-number="663"></td>
-        <td id="LC663" class="blob-code blob-code-inner js-file-line">52 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L664" class="blob-num js-line-number" data-line-number="664"></td>
-        <td id="LC664" class="blob-code blob-code-inner js-file-line">52 t 16</td>
-      </tr>
-      <tr>
-        <td id="L665" class="blob-num js-line-number" data-line-number="665"></td>
-        <td id="LC665" class="blob-code blob-code-inner js-file-line">53 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L666" class="blob-num js-line-number" data-line-number="666"></td>
-        <td id="LC666" class="blob-code blob-code-inner js-file-line">53 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L667" class="blob-num js-line-number" data-line-number="667"></td>
-        <td id="LC667" class="blob-code blob-code-inner js-file-line">53 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L668" class="blob-num js-line-number" data-line-number="668"></td>
-        <td id="LC668" class="blob-code blob-code-inner js-file-line">53 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L669" class="blob-num js-line-number" data-line-number="669"></td>
-        <td id="LC669" class="blob-code blob-code-inner js-file-line">53 t 7</td>
-      </tr>
-      <tr>
-        <td id="L670" class="blob-num js-line-number" data-line-number="670"></td>
-        <td id="LC670" class="blob-code blob-code-inner js-file-line">53 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L671" class="blob-num js-line-number" data-line-number="671"></td>
-        <td id="LC671" class="blob-code blob-code-inner js-file-line">53 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L672" class="blob-num js-line-number" data-line-number="672"></td>
-        <td id="LC672" class="blob-code blob-code-inner js-file-line">53 t 17</td>
-      </tr>
-      <tr>
-        <td id="L673" class="blob-num js-line-number" data-line-number="673"></td>
-        <td id="LC673" class="blob-code blob-code-inner js-file-line">54 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L674" class="blob-num js-line-number" data-line-number="674"></td>
-        <td id="LC674" class="blob-code blob-code-inner js-file-line">54 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L675" class="blob-num js-line-number" data-line-number="675"></td>
-        <td id="LC675" class="blob-code blob-code-inner js-file-line">54 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L676" class="blob-num js-line-number" data-line-number="676"></td>
-        <td id="LC676" class="blob-code blob-code-inner js-file-line">54 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L677" class="blob-num js-line-number" data-line-number="677"></td>
-        <td id="LC677" class="blob-code blob-code-inner js-file-line">54 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L678" class="blob-num js-line-number" data-line-number="678"></td>
-        <td id="LC678" class="blob-code blob-code-inner js-file-line">54 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L679" class="blob-num js-line-number" data-line-number="679"></td>
-        <td id="LC679" class="blob-code blob-code-inner js-file-line">54 t 9</td>
-      </tr>
-      <tr>
-        <td id="L680" class="blob-num js-line-number" data-line-number="680"></td>
-        <td id="LC680" class="blob-code blob-code-inner js-file-line">54 t 10</td>
-      </tr>
-      <tr>
-        <td id="L681" class="blob-num js-line-number" data-line-number="681"></td>
-        <td id="LC681" class="blob-code blob-code-inner js-file-line">54 t 13</td>
-      </tr>
-      <tr>
-        <td id="L682" class="blob-num js-line-number" data-line-number="682"></td>
-        <td id="LC682" class="blob-code blob-code-inner js-file-line">54 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L683" class="blob-num js-line-number" data-line-number="683"></td>
-        <td id="LC683" class="blob-code blob-code-inner js-file-line">54 t 21</td>
-      </tr>
-      <tr>
-        <td id="L684" class="blob-num js-line-number" data-line-number="684"></td>
-        <td id="LC684" class="blob-code blob-code-inner js-file-line">54 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L685" class="blob-num js-line-number" data-line-number="685"></td>
-        <td id="LC685" class="blob-code blob-code-inner js-file-line">55 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L686" class="blob-num js-line-number" data-line-number="686"></td>
-        <td id="LC686" class="blob-code blob-code-inner js-file-line">55 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L687" class="blob-num js-line-number" data-line-number="687"></td>
-        <td id="LC687" class="blob-code blob-code-inner js-file-line">55 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L688" class="blob-num js-line-number" data-line-number="688"></td>
-        <td id="LC688" class="blob-code blob-code-inner js-file-line">55 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L689" class="blob-num js-line-number" data-line-number="689"></td>
-        <td id="LC689" class="blob-code blob-code-inner js-file-line">55 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L690" class="blob-num js-line-number" data-line-number="690"></td>
-        <td id="LC690" class="blob-code blob-code-inner js-file-line">55 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L691" class="blob-num js-line-number" data-line-number="691"></td>
-        <td id="LC691" class="blob-code blob-code-inner js-file-line">55 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L692" class="blob-num js-line-number" data-line-number="692"></td>
-        <td id="LC692" class="blob-code blob-code-inner js-file-line">55 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L693" class="blob-num js-line-number" data-line-number="693"></td>
-        <td id="LC693" class="blob-code blob-code-inner js-file-line">55 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L694" class="blob-num js-line-number" data-line-number="694"></td>
-        <td id="LC694" class="blob-code blob-code-inner js-file-line">55 y_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L695" class="blob-num js-line-number" data-line-number="695"></td>
-        <td id="LC695" class="blob-code blob-code-inner js-file-line">56 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L696" class="blob-num js-line-number" data-line-number="696"></td>
-        <td id="LC696" class="blob-code blob-code-inner js-file-line">56 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L697" class="blob-num js-line-number" data-line-number="697"></td>
-        <td id="LC697" class="blob-code blob-code-inner js-file-line">56 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L698" class="blob-num js-line-number" data-line-number="698"></td>
-        <td id="LC698" class="blob-code blob-code-inner js-file-line">56 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L699" class="blob-num js-line-number" data-line-number="699"></td>
-        <td id="LC699" class="blob-code blob-code-inner js-file-line">56 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L700" class="blob-num js-line-number" data-line-number="700"></td>
-        <td id="LC700" class="blob-code blob-code-inner js-file-line">56 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L701" class="blob-num js-line-number" data-line-number="701"></td>
-        <td id="LC701" class="blob-code blob-code-inner js-file-line">56 y_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L702" class="blob-num js-line-number" data-line-number="702"></td>
-        <td id="LC702" class="blob-code blob-code-inner js-file-line">56 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L703" class="blob-num js-line-number" data-line-number="703"></td>
-        <td id="LC703" class="blob-code blob-code-inner js-file-line">56 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L704" class="blob-num js-line-number" data-line-number="704"></td>
-        <td id="LC704" class="blob-code blob-code-inner js-file-line">56 t 6</td>
-      </tr>
-      <tr>
-        <td id="L705" class="blob-num js-line-number" data-line-number="705"></td>
-        <td id="LC705" class="blob-code blob-code-inner js-file-line">56 t 8</td>
-      </tr>
-      <tr>
-        <td id="L706" class="blob-num js-line-number" data-line-number="706"></td>
-        <td id="LC706" class="blob-code blob-code-inner js-file-line">56 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L707" class="blob-num js-line-number" data-line-number="707"></td>
-        <td id="LC707" class="blob-code blob-code-inner js-file-line">56 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L708" class="blob-num js-line-number" data-line-number="708"></td>
-        <td id="LC708" class="blob-code blob-code-inner js-file-line">56 t 15</td>
-      </tr>
-      <tr>
-        <td id="L709" class="blob-num js-line-number" data-line-number="709"></td>
-        <td id="LC709" class="blob-code blob-code-inner js-file-line">56 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L710" class="blob-num js-line-number" data-line-number="710"></td>
-        <td id="LC710" class="blob-code blob-code-inner js-file-line">56 t 19</td>
-      </tr>
-      <tr>
-        <td id="L711" class="blob-num js-line-number" data-line-number="711"></td>
-        <td id="LC711" class="blob-code blob-code-inner js-file-line">56 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L712" class="blob-num js-line-number" data-line-number="712"></td>
-        <td id="LC712" class="blob-code blob-code-inner js-file-line">56 t 23</td>
-      </tr>
-      <tr>
-        <td id="L713" class="blob-num js-line-number" data-line-number="713"></td>
-        <td id="LC713" class="blob-code blob-code-inner js-file-line">57 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L714" class="blob-num js-line-number" data-line-number="714"></td>
-        <td id="LC714" class="blob-code blob-code-inner js-file-line">57 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L715" class="blob-num js-line-number" data-line-number="715"></td>
-        <td id="LC715" class="blob-code blob-code-inner js-file-line">57 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L716" class="blob-num js-line-number" data-line-number="716"></td>
-        <td id="LC716" class="blob-code blob-code-inner js-file-line">57 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L717" class="blob-num js-line-number" data-line-number="717"></td>
-        <td id="LC717" class="blob-code blob-code-inner js-file-line">57 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L718" class="blob-num js-line-number" data-line-number="718"></td>
-        <td id="LC718" class="blob-code blob-code-inner js-file-line">57 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L719" class="blob-num js-line-number" data-line-number="719"></td>
-        <td id="LC719" class="blob-code blob-code-inner js-file-line">57 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L720" class="blob-num js-line-number" data-line-number="720"></td>
-        <td id="LC720" class="blob-code blob-code-inner js-file-line">57 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L721" class="blob-num js-line-number" data-line-number="721"></td>
-        <td id="LC721" class="blob-code blob-code-inner js-file-line">57 t 11</td>
-      </tr>
-      <tr>
-        <td id="L722" class="blob-num js-line-number" data-line-number="722"></td>
-        <td id="LC722" class="blob-code blob-code-inner js-file-line">57 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L723" class="blob-num js-line-number" data-line-number="723"></td>
-        <td id="LC723" class="blob-code blob-code-inner js-file-line">57 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L724" class="blob-num js-line-number" data-line-number="724"></td>
-        <td id="LC724" class="blob-code blob-code-inner js-file-line">57 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L725" class="blob-num js-line-number" data-line-number="725"></td>
-        <td id="LC725" class="blob-code blob-code-inner js-file-line">58 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L726" class="blob-num js-line-number" data-line-number="726"></td>
-        <td id="LC726" class="blob-code blob-code-inner js-file-line">58 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L727" class="blob-num js-line-number" data-line-number="727"></td>
-        <td id="LC727" class="blob-code blob-code-inner js-file-line">58 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L728" class="blob-num js-line-number" data-line-number="728"></td>
-        <td id="LC728" class="blob-code blob-code-inner js-file-line">58 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L729" class="blob-num js-line-number" data-line-number="729"></td>
-        <td id="LC729" class="blob-code blob-code-inner js-file-line">58 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L730" class="blob-num js-line-number" data-line-number="730"></td>
-        <td id="LC730" class="blob-code blob-code-inner js-file-line">58 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L731" class="blob-num js-line-number" data-line-number="731"></td>
-        <td id="LC731" class="blob-code blob-code-inner js-file-line">58 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L732" class="blob-num js-line-number" data-line-number="732"></td>
-        <td id="LC732" class="blob-code blob-code-inner js-file-line">58 t 1</td>
-      </tr>
-      <tr>
-        <td id="L733" class="blob-num js-line-number" data-line-number="733"></td>
-        <td id="LC733" class="blob-code blob-code-inner js-file-line">58 t 4</td>
-      </tr>
-      <tr>
-        <td id="L734" class="blob-num js-line-number" data-line-number="734"></td>
-        <td id="LC734" class="blob-code blob-code-inner js-file-line">58 y_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L735" class="blob-num js-line-number" data-line-number="735"></td>
-        <td id="LC735" class="blob-code blob-code-inner js-file-line">58 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L736" class="blob-num js-line-number" data-line-number="736"></td>
-        <td id="LC736" class="blob-code blob-code-inner js-file-line">58 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L737" class="blob-num js-line-number" data-line-number="737"></td>
-        <td id="LC737" class="blob-code blob-code-inner js-file-line">58 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L738" class="blob-num js-line-number" data-line-number="738"></td>
-        <td id="LC738" class="blob-code blob-code-inner js-file-line">58 t 13</td>
-      </tr>
-      <tr>
-        <td id="L739" class="blob-num js-line-number" data-line-number="739"></td>
-        <td id="LC739" class="blob-code blob-code-inner js-file-line">58 t 16</td>
-      </tr>
-      <tr>
-        <td id="L740" class="blob-num js-line-number" data-line-number="740"></td>
-        <td id="LC740" class="blob-code blob-code-inner js-file-line">58 t 17</td>
-      </tr>
-      <tr>
-        <td id="L741" class="blob-num js-line-number" data-line-number="741"></td>
-        <td id="LC741" class="blob-code blob-code-inner js-file-line">58 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L742" class="blob-num js-line-number" data-line-number="742"></td>
-        <td id="LC742" class="blob-code blob-code-inner js-file-line">58 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L743" class="blob-num js-line-number" data-line-number="743"></td>
-        <td id="LC743" class="blob-code blob-code-inner js-file-line">59 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L744" class="blob-num js-line-number" data-line-number="744"></td>
-        <td id="LC744" class="blob-code blob-code-inner js-file-line">59 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L745" class="blob-num js-line-number" data-line-number="745"></td>
-        <td id="LC745" class="blob-code blob-code-inner js-file-line">59 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L746" class="blob-num js-line-number" data-line-number="746"></td>
-        <td id="LC746" class="blob-code blob-code-inner js-file-line">59 t 2</td>
-      </tr>
-      <tr>
-        <td id="L747" class="blob-num js-line-number" data-line-number="747"></td>
-        <td id="LC747" class="blob-code blob-code-inner js-file-line">59 t 3</td>
-      </tr>
-      <tr>
-        <td id="L748" class="blob-num js-line-number" data-line-number="748"></td>
-        <td id="LC748" class="blob-code blob-code-inner js-file-line">59 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L749" class="blob-num js-line-number" data-line-number="749"></td>
-        <td id="LC749" class="blob-code blob-code-inner js-file-line">59 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L750" class="blob-num js-line-number" data-line-number="750"></td>
-        <td id="LC750" class="blob-code blob-code-inner js-file-line">59 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L751" class="blob-num js-line-number" data-line-number="751"></td>
-        <td id="LC751" class="blob-code blob-code-inner js-file-line">59 t 18</td>
-      </tr>
-      <tr>
-        <td id="L752" class="blob-num js-line-number" data-line-number="752"></td>
-        <td id="LC752" class="blob-code blob-code-inner js-file-line">59 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L753" class="blob-num js-line-number" data-line-number="753"></td>
-        <td id="LC753" class="blob-code blob-code-inner js-file-line">59 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L754" class="blob-num js-line-number" data-line-number="754"></td>
-        <td id="LC754" class="blob-code blob-code-inner js-file-line">59 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L755" class="blob-num js-line-number" data-line-number="755"></td>
-        <td id="LC755" class="blob-code blob-code-inner js-file-line">60 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L756" class="blob-num js-line-number" data-line-number="756"></td>
-        <td id="LC756" class="blob-code blob-code-inner js-file-line">60 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L757" class="blob-num js-line-number" data-line-number="757"></td>
-        <td id="LC757" class="blob-code blob-code-inner js-file-line">60 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L758" class="blob-num js-line-number" data-line-number="758"></td>
-        <td id="LC758" class="blob-code blob-code-inner js-file-line">60 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L759" class="blob-num js-line-number" data-line-number="759"></td>
-        <td id="LC759" class="blob-code blob-code-inner js-file-line">60 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L760" class="blob-num js-line-number" data-line-number="760"></td>
-        <td id="LC760" class="blob-code blob-code-inner js-file-line">60 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L761" class="blob-num js-line-number" data-line-number="761"></td>
-        <td id="LC761" class="blob-code blob-code-inner js-file-line">60 x_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L762" class="blob-num js-line-number" data-line-number="762"></td>
-        <td id="LC762" class="blob-code blob-code-inner js-file-line">60 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L763" class="blob-num js-line-number" data-line-number="763"></td>
-        <td id="LC763" class="blob-code blob-code-inner js-file-line">60 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L764" class="blob-num js-line-number" data-line-number="764"></td>
-        <td id="LC764" class="blob-code blob-code-inner js-file-line">61 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L765" class="blob-num js-line-number" data-line-number="765"></td>
-        <td id="LC765" class="blob-code blob-code-inner js-file-line">61 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L766" class="blob-num js-line-number" data-line-number="766"></td>
-        <td id="LC766" class="blob-code blob-code-inner js-file-line">61 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L767" class="blob-num js-line-number" data-line-number="767"></td>
-        <td id="LC767" class="blob-code blob-code-inner js-file-line">61 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L768" class="blob-num js-line-number" data-line-number="768"></td>
-        <td id="LC768" class="blob-code blob-code-inner js-file-line">61 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L769" class="blob-num js-line-number" data-line-number="769"></td>
-        <td id="LC769" class="blob-code blob-code-inner js-file-line">61 t 11</td>
-      </tr>
-      <tr>
-        <td id="L770" class="blob-num js-line-number" data-line-number="770"></td>
-        <td id="LC770" class="blob-code blob-code-inner js-file-line">61 t 15</td>
-      </tr>
-      <tr>
-        <td id="L771" class="blob-num js-line-number" data-line-number="771"></td>
-        <td id="LC771" class="blob-code blob-code-inner js-file-line">61 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L772" class="blob-num js-line-number" data-line-number="772"></td>
-        <td id="LC772" class="blob-code blob-code-inner js-file-line">62 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L773" class="blob-num js-line-number" data-line-number="773"></td>
-        <td id="LC773" class="blob-code blob-code-inner js-file-line">62 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L774" class="blob-num js-line-number" data-line-number="774"></td>
-        <td id="LC774" class="blob-code blob-code-inner js-file-line">62 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L775" class="blob-num js-line-number" data-line-number="775"></td>
-        <td id="LC775" class="blob-code blob-code-inner js-file-line">62 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L776" class="blob-num js-line-number" data-line-number="776"></td>
-        <td id="LC776" class="blob-code blob-code-inner js-file-line">62 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L777" class="blob-num js-line-number" data-line-number="777"></td>
-        <td id="LC777" class="blob-code blob-code-inner js-file-line">62 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L778" class="blob-num js-line-number" data-line-number="778"></td>
-        <td id="LC778" class="blob-code blob-code-inner js-file-line">62 t 9</td>
-      </tr>
-      <tr>
-        <td id="L779" class="blob-num js-line-number" data-line-number="779"></td>
-        <td id="LC779" class="blob-code blob-code-inner js-file-line">62 t 10</td>
-      </tr>
-      <tr>
-        <td id="L780" class="blob-num js-line-number" data-line-number="780"></td>
-        <td id="LC780" class="blob-code blob-code-inner js-file-line">62 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L781" class="blob-num js-line-number" data-line-number="781"></td>
-        <td id="LC781" class="blob-code blob-code-inner js-file-line">62 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L782" class="blob-num js-line-number" data-line-number="782"></td>
-        <td id="LC782" class="blob-code blob-code-inner js-file-line">62 t 21</td>
-      </tr>
-      <tr>
-        <td id="L783" class="blob-num js-line-number" data-line-number="783"></td>
-        <td id="LC783" class="blob-code blob-code-inner js-file-line">62 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L784" class="blob-num js-line-number" data-line-number="784"></td>
-        <td id="LC784" class="blob-code blob-code-inner js-file-line">63 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L785" class="blob-num js-line-number" data-line-number="785"></td>
-        <td id="LC785" class="blob-code blob-code-inner js-file-line">63 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L786" class="blob-num js-line-number" data-line-number="786"></td>
-        <td id="LC786" class="blob-code blob-code-inner js-file-line">63 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L787" class="blob-num js-line-number" data-line-number="787"></td>
-        <td id="LC787" class="blob-code blob-code-inner js-file-line">63 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L788" class="blob-num js-line-number" data-line-number="788"></td>
-        <td id="LC788" class="blob-code blob-code-inner js-file-line">63 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L789" class="blob-num js-line-number" data-line-number="789"></td>
-        <td id="LC789" class="blob-code blob-code-inner js-file-line">63 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L790" class="blob-num js-line-number" data-line-number="790"></td>
-        <td id="LC790" class="blob-code blob-code-inner js-file-line">63 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L791" class="blob-num js-line-number" data-line-number="791"></td>
-        <td id="LC791" class="blob-code blob-code-inner js-file-line">63 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L792" class="blob-num js-line-number" data-line-number="792"></td>
-        <td id="LC792" class="blob-code blob-code-inner js-file-line">63 t 16</td>
-      </tr>
-      <tr>
-        <td id="L793" class="blob-num js-line-number" data-line-number="793"></td>
-        <td id="LC793" class="blob-code blob-code-inner js-file-line">63 t 20</td>
-      </tr>
-      <tr>
-        <td id="L794" class="blob-num js-line-number" data-line-number="794"></td>
-        <td id="LC794" class="blob-code blob-code-inner js-file-line">64 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L795" class="blob-num js-line-number" data-line-number="795"></td>
-        <td id="LC795" class="blob-code blob-code-inner js-file-line">64 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L796" class="blob-num js-line-number" data-line-number="796"></td>
-        <td id="LC796" class="blob-code blob-code-inner js-file-line">64 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L797" class="blob-num js-line-number" data-line-number="797"></td>
-        <td id="LC797" class="blob-code blob-code-inner js-file-line">64 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L798" class="blob-num js-line-number" data-line-number="798"></td>
-        <td id="LC798" class="blob-code blob-code-inner js-file-line">64 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L799" class="blob-num js-line-number" data-line-number="799"></td>
-        <td id="LC799" class="blob-code blob-code-inner js-file-line">64 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L800" class="blob-num js-line-number" data-line-number="800"></td>
-        <td id="LC800" class="blob-code blob-code-inner js-file-line">64 t 0</td>
-      </tr>
-      <tr>
-        <td id="L801" class="blob-num js-line-number" data-line-number="801"></td>
-        <td id="LC801" class="blob-code blob-code-inner js-file-line">64 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L802" class="blob-num js-line-number" data-line-number="802"></td>
-        <td id="LC802" class="blob-code blob-code-inner js-file-line">64 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L803" class="blob-num js-line-number" data-line-number="803"></td>
-        <td id="LC803" class="blob-code blob-code-inner js-file-line">64 x_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L804" class="blob-num js-line-number" data-line-number="804"></td>
-        <td id="LC804" class="blob-code blob-code-inner js-file-line">64 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L805" class="blob-num js-line-number" data-line-number="805"></td>
-        <td id="LC805" class="blob-code blob-code-inner js-file-line">64 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L806" class="blob-num js-line-number" data-line-number="806"></td>
-        <td id="LC806" class="blob-code blob-code-inner js-file-line">64 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L807" class="blob-num js-line-number" data-line-number="807"></td>
-        <td id="LC807" class="blob-code blob-code-inner js-file-line">64 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L808" class="blob-num js-line-number" data-line-number="808"></td>
-        <td id="LC808" class="blob-code blob-code-inner js-file-line">64 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L809" class="blob-num js-line-number" data-line-number="809"></td>
-        <td id="LC809" class="blob-code blob-code-inner js-file-line">64 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L810" class="blob-num js-line-number" data-line-number="810"></td>
-        <td id="LC810" class="blob-code blob-code-inner js-file-line">64 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L811" class="blob-num js-line-number" data-line-number="811"></td>
-        <td id="LC811" class="blob-code blob-code-inner js-file-line">64 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L812" class="blob-num js-line-number" data-line-number="812"></td>
-        <td id="LC812" class="blob-code blob-code-inner js-file-line">65 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L813" class="blob-num js-line-number" data-line-number="813"></td>
-        <td id="LC813" class="blob-code blob-code-inner js-file-line">65 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L814" class="blob-num js-line-number" data-line-number="814"></td>
-        <td id="LC814" class="blob-code blob-code-inner js-file-line">65 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L815" class="blob-num js-line-number" data-line-number="815"></td>
-        <td id="LC815" class="blob-code blob-code-inner js-file-line">65 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L816" class="blob-num js-line-number" data-line-number="816"></td>
-        <td id="LC816" class="blob-code blob-code-inner js-file-line">65 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L817" class="blob-num js-line-number" data-line-number="817"></td>
-        <td id="LC817" class="blob-code blob-code-inner js-file-line">65 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L818" class="blob-num js-line-number" data-line-number="818"></td>
-        <td id="LC818" class="blob-code blob-code-inner js-file-line">65 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L819" class="blob-num js-line-number" data-line-number="819"></td>
-        <td id="LC819" class="blob-code blob-code-inner js-file-line">65 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L820" class="blob-num js-line-number" data-line-number="820"></td>
-        <td id="LC820" class="blob-code blob-code-inner js-file-line">65 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L821" class="blob-num js-line-number" data-line-number="821"></td>
-        <td id="LC821" class="blob-code blob-code-inner js-file-line">65 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L822" class="blob-num js-line-number" data-line-number="822"></td>
-        <td id="LC822" class="blob-code blob-code-inner js-file-line">65 x_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L823" class="blob-num js-line-number" data-line-number="823"></td>
-        <td id="LC823" class="blob-code blob-code-inner js-file-line">65 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L824" class="blob-num js-line-number" data-line-number="824"></td>
-        <td id="LC824" class="blob-code blob-code-inner js-file-line">66 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L825" class="blob-num js-line-number" data-line-number="825"></td>
-        <td id="LC825" class="blob-code blob-code-inner js-file-line">66 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L826" class="blob-num js-line-number" data-line-number="826"></td>
-        <td id="LC826" class="blob-code blob-code-inner js-file-line">66 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L827" class="blob-num js-line-number" data-line-number="827"></td>
-        <td id="LC827" class="blob-code blob-code-inner js-file-line">66 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L828" class="blob-num js-line-number" data-line-number="828"></td>
-        <td id="LC828" class="blob-code blob-code-inner js-file-line">66 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L829" class="blob-num js-line-number" data-line-number="829"></td>
-        <td id="LC829" class="blob-code blob-code-inner js-file-line">66 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L830" class="blob-num js-line-number" data-line-number="830"></td>
-        <td id="LC830" class="blob-code blob-code-inner js-file-line">66 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L831" class="blob-num js-line-number" data-line-number="831"></td>
-        <td id="LC831" class="blob-code blob-code-inner js-file-line">66 y_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L832" class="blob-num js-line-number" data-line-number="832"></td>
-        <td id="LC832" class="blob-code blob-code-inner js-file-line">66 t 4</td>
-      </tr>
-      <tr>
-        <td id="L833" class="blob-num js-line-number" data-line-number="833"></td>
-        <td id="LC833" class="blob-code blob-code-inner js-file-line">66 x_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L834" class="blob-num js-line-number" data-line-number="834"></td>
-        <td id="LC834" class="blob-code blob-code-inner js-file-line">66 t 8</td>
-      </tr>
-      <tr>
-        <td id="L835" class="blob-num js-line-number" data-line-number="835"></td>
-        <td id="LC835" class="blob-code blob-code-inner js-file-line">66 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L836" class="blob-num js-line-number" data-line-number="836"></td>
-        <td id="LC836" class="blob-code blob-code-inner js-file-line">66 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L837" class="blob-num js-line-number" data-line-number="837"></td>
-        <td id="LC837" class="blob-code blob-code-inner js-file-line">66 t 13</td>
-      </tr>
-      <tr>
-        <td id="L838" class="blob-num js-line-number" data-line-number="838"></td>
-        <td id="LC838" class="blob-code blob-code-inner js-file-line">66 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L839" class="blob-num js-line-number" data-line-number="839"></td>
-        <td id="LC839" class="blob-code blob-code-inner js-file-line">66 t 17</td>
-      </tr>
-      <tr>
-        <td id="L840" class="blob-num js-line-number" data-line-number="840"></td>
-        <td id="LC840" class="blob-code blob-code-inner js-file-line">66 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L841" class="blob-num js-line-number" data-line-number="841"></td>
-        <td id="LC841" class="blob-code blob-code-inner js-file-line">66 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L842" class="blob-num js-line-number" data-line-number="842"></td>
-        <td id="LC842" class="blob-code blob-code-inner js-file-line">67 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L843" class="blob-num js-line-number" data-line-number="843"></td>
-        <td id="LC843" class="blob-code blob-code-inner js-file-line">67 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L844" class="blob-num js-line-number" data-line-number="844"></td>
-        <td id="LC844" class="blob-code blob-code-inner js-file-line">67 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L845" class="blob-num js-line-number" data-line-number="845"></td>
-        <td id="LC845" class="blob-code blob-code-inner js-file-line">67 t 2</td>
-      </tr>
-      <tr>
-        <td id="L846" class="blob-num js-line-number" data-line-number="846"></td>
-        <td id="LC846" class="blob-code blob-code-inner js-file-line">67 t 3</td>
-      </tr>
-      <tr>
-        <td id="L847" class="blob-num js-line-number" data-line-number="847"></td>
-        <td id="LC847" class="blob-code blob-code-inner js-file-line">67 t 7</td>
-      </tr>
-      <tr>
-        <td id="L848" class="blob-num js-line-number" data-line-number="848"></td>
-        <td id="LC848" class="blob-code blob-code-inner js-file-line">67 t 11</td>
-      </tr>
-      <tr>
-        <td id="L849" class="blob-num js-line-number" data-line-number="849"></td>
-        <td id="LC849" class="blob-code blob-code-inner js-file-line">67 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L850" class="blob-num js-line-number" data-line-number="850"></td>
-        <td id="LC850" class="blob-code blob-code-inner js-file-line">67 t 18</td>
-      </tr>
-      <tr>
-        <td id="L851" class="blob-num js-line-number" data-line-number="851"></td>
-        <td id="LC851" class="blob-code blob-code-inner js-file-line">67 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L852" class="blob-num js-line-number" data-line-number="852"></td>
-        <td id="LC852" class="blob-code blob-code-inner js-file-line">67 t 22</td>
-      </tr>
-      <tr>
-        <td id="L853" class="blob-num js-line-number" data-line-number="853"></td>
-        <td id="LC853" class="blob-code blob-code-inner js-file-line">67 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L854" class="blob-num js-line-number" data-line-number="854"></td>
-        <td id="LC854" class="blob-code blob-code-inner js-file-line">68 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L855" class="blob-num js-line-number" data-line-number="855"></td>
-        <td id="LC855" class="blob-code blob-code-inner js-file-line">68 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L856" class="blob-num js-line-number" data-line-number="856"></td>
-        <td id="LC856" class="blob-code blob-code-inner js-file-line">68 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L857" class="blob-num js-line-number" data-line-number="857"></td>
-        <td id="LC857" class="blob-code blob-code-inner js-file-line">68 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L858" class="blob-num js-line-number" data-line-number="858"></td>
-        <td id="LC858" class="blob-code blob-code-inner js-file-line">68 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L859" class="blob-num js-line-number" data-line-number="859"></td>
-        <td id="LC859" class="blob-code blob-code-inner js-file-line">68 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L860" class="blob-num js-line-number" data-line-number="860"></td>
-        <td id="LC860" class="blob-code blob-code-inner js-file-line">68 t 12</td>
-      </tr>
-      <tr>
-        <td id="L861" class="blob-num js-line-number" data-line-number="861"></td>
-        <td id="LC861" class="blob-code blob-code-inner js-file-line">68 t 14</td>
-      </tr>
-      <tr>
-        <td id="L862" class="blob-num js-line-number" data-line-number="862"></td>
-        <td id="LC862" class="blob-code blob-code-inner js-file-line">68 t 16</td>
-      </tr>
-      <tr>
-        <td id="L863" class="blob-num js-line-number" data-line-number="863"></td>
-        <td id="LC863" class="blob-code blob-code-inner js-file-line">69 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L864" class="blob-num js-line-number" data-line-number="864"></td>
-        <td id="LC864" class="blob-code blob-code-inner js-file-line">69 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L865" class="blob-num js-line-number" data-line-number="865"></td>
-        <td id="LC865" class="blob-code blob-code-inner js-file-line">69 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L866" class="blob-num js-line-number" data-line-number="866"></td>
-        <td id="LC866" class="blob-code blob-code-inner js-file-line">69 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L867" class="blob-num js-line-number" data-line-number="867"></td>
-        <td id="LC867" class="blob-code blob-code-inner js-file-line">69 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L868" class="blob-num js-line-number" data-line-number="868"></td>
-        <td id="LC868" class="blob-code blob-code-inner js-file-line">69 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L869" class="blob-num js-line-number" data-line-number="869"></td>
-        <td id="LC869" class="blob-code blob-code-inner js-file-line">69 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L870" class="blob-num js-line-number" data-line-number="870"></td>
-        <td id="LC870" class="blob-code blob-code-inner js-file-line">69 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L871" class="blob-num js-line-number" data-line-number="871"></td>
-        <td id="LC871" class="blob-code blob-code-inner js-file-line">70 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L872" class="blob-num js-line-number" data-line-number="872"></td>
-        <td id="LC872" class="blob-code blob-code-inner js-file-line">70 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L873" class="blob-num js-line-number" data-line-number="873"></td>
-        <td id="LC873" class="blob-code blob-code-inner js-file-line">70 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L874" class="blob-num js-line-number" data-line-number="874"></td>
-        <td id="LC874" class="blob-code blob-code-inner js-file-line">70 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L875" class="blob-num js-line-number" data-line-number="875"></td>
-        <td id="LC875" class="blob-code blob-code-inner js-file-line">70 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L876" class="blob-num js-line-number" data-line-number="876"></td>
-        <td id="LC876" class="blob-code blob-code-inner js-file-line">70 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L877" class="blob-num js-line-number" data-line-number="877"></td>
-        <td id="LC877" class="blob-code blob-code-inner js-file-line">70 x_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L878" class="blob-num js-line-number" data-line-number="878"></td>
-        <td id="LC878" class="blob-code blob-code-inner js-file-line">70 t 10</td>
-      </tr>
-      <tr>
-        <td id="L879" class="blob-num js-line-number" data-line-number="879"></td>
-        <td id="LC879" class="blob-code blob-code-inner js-file-line">70 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L880" class="blob-num js-line-number" data-line-number="880"></td>
-        <td id="LC880" class="blob-code blob-code-inner js-file-line">70 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L881" class="blob-num js-line-number" data-line-number="881"></td>
-        <td id="LC881" class="blob-code blob-code-inner js-file-line">70 t 21</td>
-      </tr>
-      <tr>
-        <td id="L882" class="blob-num js-line-number" data-line-number="882"></td>
-        <td id="LC882" class="blob-code blob-code-inner js-file-line">70 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L883" class="blob-num js-line-number" data-line-number="883"></td>
-        <td id="LC883" class="blob-code blob-code-inner js-file-line">71 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L884" class="blob-num js-line-number" data-line-number="884"></td>
-        <td id="LC884" class="blob-code blob-code-inner js-file-line">71 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L885" class="blob-num js-line-number" data-line-number="885"></td>
-        <td id="LC885" class="blob-code blob-code-inner js-file-line">71 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L886" class="blob-num js-line-number" data-line-number="886"></td>
-        <td id="LC886" class="blob-code blob-code-inner js-file-line">71 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L887" class="blob-num js-line-number" data-line-number="887"></td>
-        <td id="LC887" class="blob-code blob-code-inner js-file-line">71 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L888" class="blob-num js-line-number" data-line-number="888"></td>
-        <td id="LC888" class="blob-code blob-code-inner js-file-line">71 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L889" class="blob-num js-line-number" data-line-number="889"></td>
-        <td id="LC889" class="blob-code blob-code-inner js-file-line">71 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L890" class="blob-num js-line-number" data-line-number="890"></td>
-        <td id="LC890" class="blob-code blob-code-inner js-file-line">71 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L891" class="blob-num js-line-number" data-line-number="891"></td>
-        <td id="LC891" class="blob-code blob-code-inner js-file-line">71 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L892" class="blob-num js-line-number" data-line-number="892"></td>
-        <td id="LC892" class="blob-code blob-code-inner js-file-line">71 t 20</td>
-      </tr>
-      <tr>
-        <td id="L893" class="blob-num js-line-number" data-line-number="893"></td>
-        <td id="LC893" class="blob-code blob-code-inner js-file-line">72 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L894" class="blob-num js-line-number" data-line-number="894"></td>
-        <td id="LC894" class="blob-code blob-code-inner js-file-line">72 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L895" class="blob-num js-line-number" data-line-number="895"></td>
-        <td id="LC895" class="blob-code blob-code-inner js-file-line">72 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L896" class="blob-num js-line-number" data-line-number="896"></td>
-        <td id="LC896" class="blob-code blob-code-inner js-file-line">72 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L897" class="blob-num js-line-number" data-line-number="897"></td>
-        <td id="LC897" class="blob-code blob-code-inner js-file-line">72 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L898" class="blob-num js-line-number" data-line-number="898"></td>
-        <td id="LC898" class="blob-code blob-code-inner js-file-line">72 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L899" class="blob-num js-line-number" data-line-number="899"></td>
-        <td id="LC899" class="blob-code blob-code-inner js-file-line">72 t 0</td>
-      </tr>
-      <tr>
-        <td id="L900" class="blob-num js-line-number" data-line-number="900"></td>
-        <td id="LC900" class="blob-code blob-code-inner js-file-line">72 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L901" class="blob-num js-line-number" data-line-number="901"></td>
-        <td id="LC901" class="blob-code blob-code-inner js-file-line">72 x_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L902" class="blob-num js-line-number" data-line-number="902"></td>
-        <td id="LC902" class="blob-code blob-code-inner js-file-line">72 t 6</td>
-      </tr>
-      <tr>
-        <td id="L903" class="blob-num js-line-number" data-line-number="903"></td>
-        <td id="LC903" class="blob-code blob-code-inner js-file-line">72 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L904" class="blob-num js-line-number" data-line-number="904"></td>
-        <td id="LC904" class="blob-code blob-code-inner js-file-line">72 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L905" class="blob-num js-line-number" data-line-number="905"></td>
-        <td id="LC905" class="blob-code blob-code-inner js-file-line">72 t 13</td>
-      </tr>
-      <tr>
-        <td id="L906" class="blob-num js-line-number" data-line-number="906"></td>
-        <td id="LC906" class="blob-code blob-code-inner js-file-line">72 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L907" class="blob-num js-line-number" data-line-number="907"></td>
-        <td id="LC907" class="blob-code blob-code-inner js-file-line">72 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L908" class="blob-num js-line-number" data-line-number="908"></td>
-        <td id="LC908" class="blob-code blob-code-inner js-file-line">72 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L909" class="blob-num js-line-number" data-line-number="909"></td>
-        <td id="LC909" class="blob-code blob-code-inner js-file-line">72 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L910" class="blob-num js-line-number" data-line-number="910"></td>
-        <td id="LC910" class="blob-code blob-code-inner js-file-line">72 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L911" class="blob-num js-line-number" data-line-number="911"></td>
-        <td id="LC911" class="blob-code blob-code-inner js-file-line">73 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L912" class="blob-num js-line-number" data-line-number="912"></td>
-        <td id="LC912" class="blob-code blob-code-inner js-file-line">73 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L913" class="blob-num js-line-number" data-line-number="913"></td>
-        <td id="LC913" class="blob-code blob-code-inner js-file-line">73 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L914" class="blob-num js-line-number" data-line-number="914"></td>
-        <td id="LC914" class="blob-code blob-code-inner js-file-line">73 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L915" class="blob-num js-line-number" data-line-number="915"></td>
-        <td id="LC915" class="blob-code blob-code-inner js-file-line">73 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L916" class="blob-num js-line-number" data-line-number="916"></td>
-        <td id="LC916" class="blob-code blob-code-inner js-file-line">73 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L917" class="blob-num js-line-number" data-line-number="917"></td>
-        <td id="LC917" class="blob-code blob-code-inner js-file-line">73 t 3</td>
-      </tr>
-      <tr>
-        <td id="L918" class="blob-num js-line-number" data-line-number="918"></td>
-        <td id="LC918" class="blob-code blob-code-inner js-file-line">73 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L919" class="blob-num js-line-number" data-line-number="919"></td>
-        <td id="LC919" class="blob-code blob-code-inner js-file-line">73 t 11</td>
-      </tr>
-      <tr>
-        <td id="L920" class="blob-num js-line-number" data-line-number="920"></td>
-        <td id="LC920" class="blob-code blob-code-inner js-file-line">73 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L921" class="blob-num js-line-number" data-line-number="921"></td>
-        <td id="LC921" class="blob-code blob-code-inner js-file-line">73 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L922" class="blob-num js-line-number" data-line-number="922"></td>
-        <td id="LC922" class="blob-code blob-code-inner js-file-line">73 t 22</td>
-      </tr>
-      <tr>
-        <td id="L923" class="blob-num js-line-number" data-line-number="923"></td>
-        <td id="LC923" class="blob-code blob-code-inner js-file-line">74 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L924" class="blob-num js-line-number" data-line-number="924"></td>
-        <td id="LC924" class="blob-code blob-code-inner js-file-line">74 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L925" class="blob-num js-line-number" data-line-number="925"></td>
-        <td id="LC925" class="blob-code blob-code-inner js-file-line">74 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L926" class="blob-num js-line-number" data-line-number="926"></td>
-        <td id="LC926" class="blob-code blob-code-inner js-file-line">74 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L927" class="blob-num js-line-number" data-line-number="927"></td>
-        <td id="LC927" class="blob-code blob-code-inner js-file-line">74 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L928" class="blob-num js-line-number" data-line-number="928"></td>
-        <td id="LC928" class="blob-code blob-code-inner js-file-line">74 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L929" class="blob-num js-line-number" data-line-number="929"></td>
-        <td id="LC929" class="blob-code blob-code-inner js-file-line">74 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L930" class="blob-num js-line-number" data-line-number="930"></td>
-        <td id="LC930" class="blob-code blob-code-inner js-file-line">74 y_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L931" class="blob-num js-line-number" data-line-number="931"></td>
-        <td id="LC931" class="blob-code blob-code-inner js-file-line">74 t 4</td>
-      </tr>
-      <tr>
-        <td id="L932" class="blob-num js-line-number" data-line-number="932"></td>
-        <td id="LC932" class="blob-code blob-code-inner js-file-line">74 y_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L933" class="blob-num js-line-number" data-line-number="933"></td>
-        <td id="LC933" class="blob-code blob-code-inner js-file-line">74 t 8</td>
-      </tr>
-      <tr>
-        <td id="L934" class="blob-num js-line-number" data-line-number="934"></td>
-        <td id="LC934" class="blob-code blob-code-inner js-file-line">74 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L935" class="blob-num js-line-number" data-line-number="935"></td>
-        <td id="LC935" class="blob-code blob-code-inner js-file-line">74 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L936" class="blob-num js-line-number" data-line-number="936"></td>
-        <td id="LC936" class="blob-code blob-code-inner js-file-line">74 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L937" class="blob-num js-line-number" data-line-number="937"></td>
-        <td id="LC937" class="blob-code blob-code-inner js-file-line">74 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L938" class="blob-num js-line-number" data-line-number="938"></td>
-        <td id="LC938" class="blob-code blob-code-inner js-file-line">74 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L939" class="blob-num js-line-number" data-line-number="939"></td>
-        <td id="LC939" class="blob-code blob-code-inner js-file-line">74 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L940" class="blob-num js-line-number" data-line-number="940"></td>
-        <td id="LC940" class="blob-code blob-code-inner js-file-line">74 t 21</td>
-      </tr>
-      <tr>
-        <td id="L941" class="blob-num js-line-number" data-line-number="941"></td>
-        <td id="LC941" class="blob-code blob-code-inner js-file-line">75 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L942" class="blob-num js-line-number" data-line-number="942"></td>
-        <td id="LC942" class="blob-code blob-code-inner js-file-line">75 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L943" class="blob-num js-line-number" data-line-number="943"></td>
-        <td id="LC943" class="blob-code blob-code-inner js-file-line">75 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L944" class="blob-num js-line-number" data-line-number="944"></td>
-        <td id="LC944" class="blob-code blob-code-inner js-file-line">75 t 2</td>
-      </tr>
-      <tr>
-        <td id="L945" class="blob-num js-line-number" data-line-number="945"></td>
-        <td id="LC945" class="blob-code blob-code-inner js-file-line">75 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L946" class="blob-num js-line-number" data-line-number="946"></td>
-        <td id="LC946" class="blob-code blob-code-inner js-file-line">75 t 7</td>
-      </tr>
-      <tr>
-        <td id="L947" class="blob-num js-line-number" data-line-number="947"></td>
-        <td id="LC947" class="blob-code blob-code-inner js-file-line">75 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L948" class="blob-num js-line-number" data-line-number="948"></td>
-        <td id="LC948" class="blob-code blob-code-inner js-file-line">75 t 15</td>
-      </tr>
-      <tr>
-        <td id="L949" class="blob-num js-line-number" data-line-number="949"></td>
-        <td id="LC949" class="blob-code blob-code-inner js-file-line">75 t 18</td>
-      </tr>
-      <tr>
-        <td id="L950" class="blob-num js-line-number" data-line-number="950"></td>
-        <td id="LC950" class="blob-code blob-code-inner js-file-line">75 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L951" class="blob-num js-line-number" data-line-number="951"></td>
-        <td id="LC951" class="blob-code blob-code-inner js-file-line">75 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L952" class="blob-num js-line-number" data-line-number="952"></td>
-        <td id="LC952" class="blob-code blob-code-inner js-file-line">75 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L953" class="blob-num js-line-number" data-line-number="953"></td>
-        <td id="LC953" class="blob-code blob-code-inner js-file-line">76 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L954" class="blob-num js-line-number" data-line-number="954"></td>
-        <td id="LC954" class="blob-code blob-code-inner js-file-line">76 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L955" class="blob-num js-line-number" data-line-number="955"></td>
-        <td id="LC955" class="blob-code blob-code-inner js-file-line">76 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L956" class="blob-num js-line-number" data-line-number="956"></td>
-        <td id="LC956" class="blob-code blob-code-inner js-file-line">76 x_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L957" class="blob-num js-line-number" data-line-number="957"></td>
-        <td id="LC957" class="blob-code blob-code-inner js-file-line">76 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L958" class="blob-num js-line-number" data-line-number="958"></td>
-        <td id="LC958" class="blob-code blob-code-inner js-file-line">76 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L959" class="blob-num js-line-number" data-line-number="959"></td>
-        <td id="LC959" class="blob-code blob-code-inner js-file-line">76 x_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L960" class="blob-num js-line-number" data-line-number="960"></td>
-        <td id="LC960" class="blob-code blob-code-inner js-file-line">76 t 14</td>
-      </tr>
-      <tr>
-        <td id="L961" class="blob-num js-line-number" data-line-number="961"></td>
-        <td id="LC961" class="blob-code blob-code-inner js-file-line">76 t 16</td>
-      </tr>
-      <tr>
-        <td id="L962" class="blob-num js-line-number" data-line-number="962"></td>
-        <td id="LC962" class="blob-code blob-code-inner js-file-line">77 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L963" class="blob-num js-line-number" data-line-number="963"></td>
-        <td id="LC963" class="blob-code blob-code-inner js-file-line">77 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L964" class="blob-num js-line-number" data-line-number="964"></td>
-        <td id="LC964" class="blob-code blob-code-inner js-file-line">77 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L965" class="blob-num js-line-number" data-line-number="965"></td>
-        <td id="LC965" class="blob-code blob-code-inner js-file-line">77 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L966" class="blob-num js-line-number" data-line-number="966"></td>
-        <td id="LC966" class="blob-code blob-code-inner js-file-line">77 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L967" class="blob-num js-line-number" data-line-number="967"></td>
-        <td id="LC967" class="blob-code blob-code-inner js-file-line">77 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L968" class="blob-num js-line-number" data-line-number="968"></td>
-        <td id="LC968" class="blob-code blob-code-inner js-file-line">77 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L969" class="blob-num js-line-number" data-line-number="969"></td>
-        <td id="LC969" class="blob-code blob-code-inner js-file-line">77 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L970" class="blob-num js-line-number" data-line-number="970"></td>
-        <td id="LC970" class="blob-code blob-code-inner js-file-line">78 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L971" class="blob-num js-line-number" data-line-number="971"></td>
-        <td id="LC971" class="blob-code blob-code-inner js-file-line">78 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L972" class="blob-num js-line-number" data-line-number="972"></td>
-        <td id="LC972" class="blob-code blob-code-inner js-file-line">78 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L973" class="blob-num js-line-number" data-line-number="973"></td>
-        <td id="LC973" class="blob-code blob-code-inner js-file-line">78 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L974" class="blob-num js-line-number" data-line-number="974"></td>
-        <td id="LC974" class="blob-code blob-code-inner js-file-line">78 t 1</td>
-      </tr>
-      <tr>
-        <td id="L975" class="blob-num js-line-number" data-line-number="975"></td>
-        <td id="LC975" class="blob-code blob-code-inner js-file-line">78 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L976" class="blob-num js-line-number" data-line-number="976"></td>
-        <td id="LC976" class="blob-code blob-code-inner js-file-line">78 x_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L977" class="blob-num js-line-number" data-line-number="977"></td>
-        <td id="LC977" class="blob-code blob-code-inner js-file-line">78 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L978" class="blob-num js-line-number" data-line-number="978"></td>
-        <td id="LC978" class="blob-code blob-code-inner js-file-line">78 t 13</td>
-      </tr>
-      <tr>
-        <td id="L979" class="blob-num js-line-number" data-line-number="979"></td>
-        <td id="LC979" class="blob-code blob-code-inner js-file-line">78 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L980" class="blob-num js-line-number" data-line-number="980"></td>
-        <td id="LC980" class="blob-code blob-code-inner js-file-line">78 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L981" class="blob-num js-line-number" data-line-number="981"></td>
-        <td id="LC981" class="blob-code blob-code-inner js-file-line">78 t 22</td>
-      </tr>
-      <tr>
-        <td id="L982" class="blob-num js-line-number" data-line-number="982"></td>
-        <td id="LC982" class="blob-code blob-code-inner js-file-line">79 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L983" class="blob-num js-line-number" data-line-number="983"></td>
-        <td id="LC983" class="blob-code blob-code-inner js-file-line">79 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L984" class="blob-num js-line-number" data-line-number="984"></td>
-        <td id="LC984" class="blob-code blob-code-inner js-file-line">79 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L985" class="blob-num js-line-number" data-line-number="985"></td>
-        <td id="LC985" class="blob-code blob-code-inner js-file-line">79 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L986" class="blob-num js-line-number" data-line-number="986"></td>
-        <td id="LC986" class="blob-code blob-code-inner js-file-line">79 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L987" class="blob-num js-line-number" data-line-number="987"></td>
-        <td id="LC987" class="blob-code blob-code-inner js-file-line">79 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L988" class="blob-num js-line-number" data-line-number="988"></td>
-        <td id="LC988" class="blob-code blob-code-inner js-file-line">79 t 3</td>
-      </tr>
-      <tr>
-        <td id="L989" class="blob-num js-line-number" data-line-number="989"></td>
-        <td id="LC989" class="blob-code blob-code-inner js-file-line">79 t 7</td>
-      </tr>
-      <tr>
-        <td id="L990" class="blob-num js-line-number" data-line-number="990"></td>
-        <td id="LC990" class="blob-code blob-code-inner js-file-line">79 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L991" class="blob-num js-line-number" data-line-number="991"></td>
-        <td id="LC991" class="blob-code blob-code-inner js-file-line">79 t 20</td>
-      </tr>
-      <tr>
-        <td id="L992" class="blob-num js-line-number" data-line-number="992"></td>
-        <td id="LC992" class="blob-code blob-code-inner js-file-line">80 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L993" class="blob-num js-line-number" data-line-number="993"></td>
-        <td id="LC993" class="blob-code blob-code-inner js-file-line">80 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L994" class="blob-num js-line-number" data-line-number="994"></td>
-        <td id="LC994" class="blob-code blob-code-inner js-file-line">80 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L995" class="blob-num js-line-number" data-line-number="995"></td>
-        <td id="LC995" class="blob-code blob-code-inner js-file-line">80 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L996" class="blob-num js-line-number" data-line-number="996"></td>
-        <td id="LC996" class="blob-code blob-code-inner js-file-line">80 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L997" class="blob-num js-line-number" data-line-number="997"></td>
-        <td id="LC997" class="blob-code blob-code-inner js-file-line">80 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L998" class="blob-num js-line-number" data-line-number="998"></td>
-        <td id="LC998" class="blob-code blob-code-inner js-file-line">80 t 0</td>
-      </tr>
-      <tr>
-        <td id="L999" class="blob-num js-line-number" data-line-number="999"></td>
-        <td id="LC999" class="blob-code blob-code-inner js-file-line">80 t 2</td>
-      </tr>
-      <tr>
-        <td id="L1000" class="blob-num js-line-number" data-line-number="1000"></td>
-        <td id="LC1000" class="blob-code blob-code-inner js-file-line">80 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L1001" class="blob-num js-line-number" data-line-number="1001"></td>
-        <td id="LC1001" class="blob-code blob-code-inner js-file-line">80 t 6</td>
-      </tr>
-      <tr>
-        <td id="L1002" class="blob-num js-line-number" data-line-number="1002"></td>
-        <td id="LC1002" class="blob-code blob-code-inner js-file-line">80 t 8</td>
-      </tr>
-      <tr>
-        <td id="L1003" class="blob-num js-line-number" data-line-number="1003"></td>
-        <td id="LC1003" class="blob-code blob-code-inner js-file-line">80 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L1004" class="blob-num js-line-number" data-line-number="1004"></td>
-        <td id="LC1004" class="blob-code blob-code-inner js-file-line">80 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L1005" class="blob-num js-line-number" data-line-number="1005"></td>
-        <td id="LC1005" class="blob-code blob-code-inner js-file-line">80 t 15</td>
-      </tr>
-      <tr>
-        <td id="L1006" class="blob-num js-line-number" data-line-number="1006"></td>
-        <td id="LC1006" class="blob-code blob-code-inner js-file-line">80 t 17</td>
-      </tr>
-      <tr>
-        <td id="L1007" class="blob-num js-line-number" data-line-number="1007"></td>
-        <td id="LC1007" class="blob-code blob-code-inner js-file-line">80 t 19</td>
-      </tr>
-      <tr>
-        <td id="L1008" class="blob-num js-line-number" data-line-number="1008"></td>
-        <td id="LC1008" class="blob-code blob-code-inner js-file-line">80 t 21</td>
-      </tr>
-      <tr>
-        <td id="L1009" class="blob-num js-line-number" data-line-number="1009"></td>
-        <td id="LC1009" class="blob-code blob-code-inner js-file-line">80 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L1010" class="blob-num js-line-number" data-line-number="1010"></td>
-        <td id="LC1010" class="blob-code blob-code-inner js-file-line">81 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L1011" class="blob-num js-line-number" data-line-number="1011"></td>
-        <td id="LC1011" class="blob-code blob-code-inner js-file-line">81 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L1012" class="blob-num js-line-number" data-line-number="1012"></td>
-        <td id="LC1012" class="blob-code blob-code-inner js-file-line">81 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L1013" class="blob-num js-line-number" data-line-number="1013"></td>
-        <td id="LC1013" class="blob-code blob-code-inner js-file-line">81 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L1014" class="blob-num js-line-number" data-line-number="1014"></td>
-        <td id="LC1014" class="blob-code blob-code-inner js-file-line">81 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L1015" class="blob-num js-line-number" data-line-number="1015"></td>
-        <td id="LC1015" class="blob-code blob-code-inner js-file-line">81 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L1016" class="blob-num js-line-number" data-line-number="1016"></td>
-        <td id="LC1016" class="blob-code blob-code-inner js-file-line">81 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L1017" class="blob-num js-line-number" data-line-number="1017"></td>
-        <td id="LC1017" class="blob-code blob-code-inner js-file-line">81 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L1018" class="blob-num js-line-number" data-line-number="1018"></td>
-        <td id="LC1018" class="blob-code blob-code-inner js-file-line">81 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L1019" class="blob-num js-line-number" data-line-number="1019"></td>
-        <td id="LC1019" class="blob-code blob-code-inner js-file-line">81 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L1020" class="blob-num js-line-number" data-line-number="1020"></td>
-        <td id="LC1020" class="blob-code blob-code-inner js-file-line">81 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L1021" class="blob-num js-line-number" data-line-number="1021"></td>
-        <td id="LC1021" class="blob-code blob-code-inner js-file-line">81 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L1022" class="blob-num js-line-number" data-line-number="1022"></td>
-        <td id="LC1022" class="blob-code blob-code-inner js-file-line">82 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L1023" class="blob-num js-line-number" data-line-number="1023"></td>
-        <td id="LC1023" class="blob-code blob-code-inner js-file-line">82 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L1024" class="blob-num js-line-number" data-line-number="1024"></td>
-        <td id="LC1024" class="blob-code blob-code-inner js-file-line">82 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L1025" class="blob-num js-line-number" data-line-number="1025"></td>
-        <td id="LC1025" class="blob-code blob-code-inner js-file-line">82 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L1026" class="blob-num js-line-number" data-line-number="1026"></td>
-        <td id="LC1026" class="blob-code blob-code-inner js-file-line">82 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L1027" class="blob-num js-line-number" data-line-number="1027"></td>
-        <td id="LC1027" class="blob-code blob-code-inner js-file-line">82 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L1028" class="blob-num js-line-number" data-line-number="1028"></td>
-        <td id="LC1028" class="blob-code blob-code-inner js-file-line">82 y_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L1029" class="blob-num js-line-number" data-line-number="1029"></td>
-        <td id="LC1029" class="blob-code blob-code-inner js-file-line">82 x_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L1030" class="blob-num js-line-number" data-line-number="1030"></td>
-        <td id="LC1030" class="blob-code blob-code-inner js-file-line">82 t 4</td>
-      </tr>
-      <tr>
-        <td id="L1031" class="blob-num js-line-number" data-line-number="1031"></td>
-        <td id="LC1031" class="blob-code blob-code-inner js-file-line">82 x_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L1032" class="blob-num js-line-number" data-line-number="1032"></td>
-        <td id="LC1032" class="blob-code blob-code-inner js-file-line">82 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L1033" class="blob-num js-line-number" data-line-number="1033"></td>
-        <td id="LC1033" class="blob-code blob-code-inner js-file-line">82 t 9</td>
-      </tr>
-      <tr>
-        <td id="L1034" class="blob-num js-line-number" data-line-number="1034"></td>
-        <td id="LC1034" class="blob-code blob-code-inner js-file-line">82 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L1035" class="blob-num js-line-number" data-line-number="1035"></td>
-        <td id="LC1035" class="blob-code blob-code-inner js-file-line">82 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L1036" class="blob-num js-line-number" data-line-number="1036"></td>
-        <td id="LC1036" class="blob-code blob-code-inner js-file-line">82 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L1037" class="blob-num js-line-number" data-line-number="1037"></td>
-        <td id="LC1037" class="blob-code blob-code-inner js-file-line">82 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L1038" class="blob-num js-line-number" data-line-number="1038"></td>
-        <td id="LC1038" class="blob-code blob-code-inner js-file-line">82 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L1039" class="blob-num js-line-number" data-line-number="1039"></td>
-        <td id="LC1039" class="blob-code blob-code-inner js-file-line">82 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L1040" class="blob-num js-line-number" data-line-number="1040"></td>
-        <td id="LC1040" class="blob-code blob-code-inner js-file-line">83 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L1041" class="blob-num js-line-number" data-line-number="1041"></td>
-        <td id="LC1041" class="blob-code blob-code-inner js-file-line">83 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L1042" class="blob-num js-line-number" data-line-number="1042"></td>
-        <td id="LC1042" class="blob-code blob-code-inner js-file-line">83 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L1043" class="blob-num js-line-number" data-line-number="1043"></td>
-        <td id="LC1043" class="blob-code blob-code-inner js-file-line">83 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L1044" class="blob-num js-line-number" data-line-number="1044"></td>
-        <td id="LC1044" class="blob-code blob-code-inner js-file-line">83 t 3</td>
-      </tr>
-      <tr>
-        <td id="L1045" class="blob-num js-line-number" data-line-number="1045"></td>
-        <td id="LC1045" class="blob-code blob-code-inner js-file-line">83 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L1046" class="blob-num js-line-number" data-line-number="1046"></td>
-        <td id="LC1046" class="blob-code blob-code-inner js-file-line">83 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L1047" class="blob-num js-line-number" data-line-number="1047"></td>
-        <td id="LC1047" class="blob-code blob-code-inner js-file-line">83 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L1048" class="blob-num js-line-number" data-line-number="1048"></td>
-        <td id="LC1048" class="blob-code blob-code-inner js-file-line">83 t 18</td>
-      </tr>
-      <tr>
-        <td id="L1049" class="blob-num js-line-number" data-line-number="1049"></td>
-        <td id="LC1049" class="blob-code blob-code-inner js-file-line">83 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L1050" class="blob-num js-line-number" data-line-number="1050"></td>
-        <td id="LC1050" class="blob-code blob-code-inner js-file-line">83 t 22</td>
-      </tr>
-      <tr>
-        <td id="L1051" class="blob-num js-line-number" data-line-number="1051"></td>
-        <td id="LC1051" class="blob-code blob-code-inner js-file-line">83 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L1052" class="blob-num js-line-number" data-line-number="1052"></td>
-        <td id="LC1052" class="blob-code blob-code-inner js-file-line">84 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L1053" class="blob-num js-line-number" data-line-number="1053"></td>
-        <td id="LC1053" class="blob-code blob-code-inner js-file-line">84 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L1054" class="blob-num js-line-number" data-line-number="1054"></td>
-        <td id="LC1054" class="blob-code blob-code-inner js-file-line">84 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L1055" class="blob-num js-line-number" data-line-number="1055"></td>
-        <td id="LC1055" class="blob-code blob-code-inner js-file-line">84 x_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L1056" class="blob-num js-line-number" data-line-number="1056"></td>
-        <td id="LC1056" class="blob-code blob-code-inner js-file-line">84 t 8</td>
-      </tr>
-      <tr>
-        <td id="L1057" class="blob-num js-line-number" data-line-number="1057"></td>
-        <td id="LC1057" class="blob-code blob-code-inner js-file-line">84 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L1058" class="blob-num js-line-number" data-line-number="1058"></td>
-        <td id="LC1058" class="blob-code blob-code-inner js-file-line">84 t 12</td>
-      </tr>
-      <tr>
-        <td id="L1059" class="blob-num js-line-number" data-line-number="1059"></td>
-        <td id="LC1059" class="blob-code blob-code-inner js-file-line">84 t 14</td>
-      </tr>
-      <tr>
-        <td id="L1060" class="blob-num js-line-number" data-line-number="1060"></td>
-        <td id="LC1060" class="blob-code blob-code-inner js-file-line">84 t 16</td>
-      </tr>
-      <tr>
-        <td id="L1061" class="blob-num js-line-number" data-line-number="1061"></td>
-        <td id="LC1061" class="blob-code blob-code-inner js-file-line">85 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L1062" class="blob-num js-line-number" data-line-number="1062"></td>
-        <td id="LC1062" class="blob-code blob-code-inner js-file-line">85 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L1063" class="blob-num js-line-number" data-line-number="1063"></td>
-        <td id="LC1063" class="blob-code blob-code-inner js-file-line">85 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L1064" class="blob-num js-line-number" data-line-number="1064"></td>
-        <td id="LC1064" class="blob-code blob-code-inner js-file-line">85 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L1065" class="blob-num js-line-number" data-line-number="1065"></td>
-        <td id="LC1065" class="blob-code blob-code-inner js-file-line">85 t 7</td>
-      </tr>
-      <tr>
-        <td id="L1066" class="blob-num js-line-number" data-line-number="1066"></td>
-        <td id="LC1066" class="blob-code blob-code-inner js-file-line">85 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L1067" class="blob-num js-line-number" data-line-number="1067"></td>
-        <td id="LC1067" class="blob-code blob-code-inner js-file-line">85 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L1068" class="blob-num js-line-number" data-line-number="1068"></td>
-        <td id="LC1068" class="blob-code blob-code-inner js-file-line">85 t 17</td>
-      </tr>
-      <tr>
-        <td id="L1069" class="blob-num js-line-number" data-line-number="1069"></td>
-        <td id="LC1069" class="blob-code blob-code-inner js-file-line">86 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L1070" class="blob-num js-line-number" data-line-number="1070"></td>
-        <td id="LC1070" class="blob-code blob-code-inner js-file-line">86 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L1071" class="blob-num js-line-number" data-line-number="1071"></td>
-        <td id="LC1071" class="blob-code blob-code-inner js-file-line">86 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L1072" class="blob-num js-line-number" data-line-number="1072"></td>
-        <td id="LC1072" class="blob-code blob-code-inner js-file-line">86 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L1073" class="blob-num js-line-number" data-line-number="1073"></td>
-        <td id="LC1073" class="blob-code blob-code-inner js-file-line">86 y_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L1074" class="blob-num js-line-number" data-line-number="1074"></td>
-        <td id="LC1074" class="blob-code blob-code-inner js-file-line">86 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L1075" class="blob-num js-line-number" data-line-number="1075"></td>
-        <td id="LC1075" class="blob-code blob-code-inner js-file-line">86 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L1076" class="blob-num js-line-number" data-line-number="1076"></td>
-        <td id="LC1076" class="blob-code blob-code-inner js-file-line">86 t 10</td>
-      </tr>
-      <tr>
-        <td id="L1077" class="blob-num js-line-number" data-line-number="1077"></td>
-        <td id="LC1077" class="blob-code blob-code-inner js-file-line">86 t 13</td>
-      </tr>
-      <tr>
-        <td id="L1078" class="blob-num js-line-number" data-line-number="1078"></td>
-        <td id="LC1078" class="blob-code blob-code-inner js-file-line">86 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L1079" class="blob-num js-line-number" data-line-number="1079"></td>
-        <td id="LC1079" class="blob-code blob-code-inner js-file-line">86 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L1080" class="blob-num js-line-number" data-line-number="1080"></td>
-        <td id="LC1080" class="blob-code blob-code-inner js-file-line">86 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L1081" class="blob-num js-line-number" data-line-number="1081"></td>
-        <td id="LC1081" class="blob-code blob-code-inner js-file-line">87 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L1082" class="blob-num js-line-number" data-line-number="1082"></td>
-        <td id="LC1082" class="blob-code blob-code-inner js-file-line">87 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L1083" class="blob-num js-line-number" data-line-number="1083"></td>
-        <td id="LC1083" class="blob-code blob-code-inner js-file-line">87 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L1084" class="blob-num js-line-number" data-line-number="1084"></td>
-        <td id="LC1084" class="blob-code blob-code-inner js-file-line">87 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L1085" class="blob-num js-line-number" data-line-number="1085"></td>
-        <td id="LC1085" class="blob-code blob-code-inner js-file-line">87 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L1086" class="blob-num js-line-number" data-line-number="1086"></td>
-        <td id="LC1086" class="blob-code blob-code-inner js-file-line">87 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L1087" class="blob-num js-line-number" data-line-number="1087"></td>
-        <td id="LC1087" class="blob-code blob-code-inner js-file-line">87 y_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L1088" class="blob-num js-line-number" data-line-number="1088"></td>
-        <td id="LC1088" class="blob-code blob-code-inner js-file-line">87 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L1089" class="blob-num js-line-number" data-line-number="1089"></td>
-        <td id="LC1089" class="blob-code blob-code-inner js-file-line">87 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L1090" class="blob-num js-line-number" data-line-number="1090"></td>
-        <td id="LC1090" class="blob-code blob-code-inner js-file-line">87 t 20</td>
-      </tr>
-      <tr>
-        <td id="L1091" class="blob-num js-line-number" data-line-number="1091"></td>
-        <td id="LC1091" class="blob-code blob-code-inner js-file-line">88 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L1092" class="blob-num js-line-number" data-line-number="1092"></td>
-        <td id="LC1092" class="blob-code blob-code-inner js-file-line">88 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L1093" class="blob-num js-line-number" data-line-number="1093"></td>
-        <td id="LC1093" class="blob-code blob-code-inner js-file-line">88 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L1094" class="blob-num js-line-number" data-line-number="1094"></td>
-        <td id="LC1094" class="blob-code blob-code-inner js-file-line">88 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L1095" class="blob-num js-line-number" data-line-number="1095"></td>
-        <td id="LC1095" class="blob-code blob-code-inner js-file-line">88 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L1096" class="blob-num js-line-number" data-line-number="1096"></td>
-        <td id="LC1096" class="blob-code blob-code-inner js-file-line">88 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L1097" class="blob-num js-line-number" data-line-number="1097"></td>
-        <td id="LC1097" class="blob-code blob-code-inner js-file-line">88 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L1098" class="blob-num js-line-number" data-line-number="1098"></td>
-        <td id="LC1098" class="blob-code blob-code-inner js-file-line">88 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L1099" class="blob-num js-line-number" data-line-number="1099"></td>
-        <td id="LC1099" class="blob-code blob-code-inner js-file-line">88 x_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L1100" class="blob-num js-line-number" data-line-number="1100"></td>
-        <td id="LC1100" class="blob-code blob-code-inner js-file-line">88 t 6</td>
-      </tr>
-      <tr>
-        <td id="L1101" class="blob-num js-line-number" data-line-number="1101"></td>
-        <td id="LC1101" class="blob-code blob-code-inner js-file-line">88 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L1102" class="blob-num js-line-number" data-line-number="1102"></td>
-        <td id="LC1102" class="blob-code blob-code-inner js-file-line">88 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L1103" class="blob-num js-line-number" data-line-number="1103"></td>
-        <td id="LC1103" class="blob-code blob-code-inner js-file-line">88 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L1104" class="blob-num js-line-number" data-line-number="1104"></td>
-        <td id="LC1104" class="blob-code blob-code-inner js-file-line">88 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L1105" class="blob-num js-line-number" data-line-number="1105"></td>
-        <td id="LC1105" class="blob-code blob-code-inner js-file-line">88 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L1106" class="blob-num js-line-number" data-line-number="1106"></td>
-        <td id="LC1106" class="blob-code blob-code-inner js-file-line">88 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L1107" class="blob-num js-line-number" data-line-number="1107"></td>
-        <td id="LC1107" class="blob-code blob-code-inner js-file-line">88 y_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L1108" class="blob-num js-line-number" data-line-number="1108"></td>
-        <td id="LC1108" class="blob-code blob-code-inner js-file-line">88 t 23</td>
-      </tr>
-      <tr>
-        <td id="L1109" class="blob-num js-line-number" data-line-number="1109"></td>
-        <td id="LC1109" class="blob-code blob-code-inner js-file-line">89 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L1110" class="blob-num js-line-number" data-line-number="1110"></td>
-        <td id="LC1110" class="blob-code blob-code-inner js-file-line">89 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L1111" class="blob-num js-line-number" data-line-number="1111"></td>
-        <td id="LC1111" class="blob-code blob-code-inner js-file-line">89 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L1112" class="blob-num js-line-number" data-line-number="1112"></td>
-        <td id="LC1112" class="blob-code blob-code-inner js-file-line">89 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L1113" class="blob-num js-line-number" data-line-number="1113"></td>
-        <td id="LC1113" class="blob-code blob-code-inner js-file-line">89 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L1114" class="blob-num js-line-number" data-line-number="1114"></td>
-        <td id="LC1114" class="blob-code blob-code-inner js-file-line">89 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L1115" class="blob-num js-line-number" data-line-number="1115"></td>
-        <td id="LC1115" class="blob-code blob-code-inner js-file-line">89 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L1116" class="blob-num js-line-number" data-line-number="1116"></td>
-        <td id="LC1116" class="blob-code blob-code-inner js-file-line">89 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L1117" class="blob-num js-line-number" data-line-number="1117"></td>
-        <td id="LC1117" class="blob-code blob-code-inner js-file-line">89 y_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L1118" class="blob-num js-line-number" data-line-number="1118"></td>
-        <td id="LC1118" class="blob-code blob-code-inner js-file-line">89 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L1119" class="blob-num js-line-number" data-line-number="1119"></td>
-        <td id="LC1119" class="blob-code blob-code-inner js-file-line">89 x_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L1120" class="blob-num js-line-number" data-line-number="1120"></td>
-        <td id="LC1120" class="blob-code blob-code-inner js-file-line">89 t 22</td>
-      </tr>
-      <tr>
-        <td id="L1121" class="blob-num js-line-number" data-line-number="1121"></td>
-        <td id="LC1121" class="blob-code blob-code-inner js-file-line">90 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L1122" class="blob-num js-line-number" data-line-number="1122"></td>
-        <td id="LC1122" class="blob-code blob-code-inner js-file-line">90 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L1123" class="blob-num js-line-number" data-line-number="1123"></td>
-        <td id="LC1123" class="blob-code blob-code-inner js-file-line">90 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L1124" class="blob-num js-line-number" data-line-number="1124"></td>
-        <td id="LC1124" class="blob-code blob-code-inner js-file-line">90 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L1125" class="blob-num js-line-number" data-line-number="1125"></td>
-        <td id="LC1125" class="blob-code blob-code-inner js-file-line">90 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L1126" class="blob-num js-line-number" data-line-number="1126"></td>
-        <td id="LC1126" class="blob-code blob-code-inner js-file-line">90 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L1127" class="blob-num js-line-number" data-line-number="1127"></td>
-        <td id="LC1127" class="blob-code blob-code-inner js-file-line">90 t 0</td>
-      </tr>
-      <tr>
-        <td id="L1128" class="blob-num js-line-number" data-line-number="1128"></td>
-        <td id="LC1128" class="blob-code blob-code-inner js-file-line">90 t 1</td>
-      </tr>
-      <tr>
-        <td id="L1129" class="blob-num js-line-number" data-line-number="1129"></td>
-        <td id="LC1129" class="blob-code blob-code-inner js-file-line">90 t 4</td>
-      </tr>
-      <tr>
-        <td id="L1130" class="blob-num js-line-number" data-line-number="1130"></td>
-        <td id="LC1130" class="blob-code blob-code-inner js-file-line">90 t 5</td>
-      </tr>
-      <tr>
-        <td id="L1131" class="blob-num js-line-number" data-line-number="1131"></td>
-        <td id="LC1131" class="blob-code blob-code-inner js-file-line">90 t 8</td>
-      </tr>
-      <tr>
-        <td id="L1132" class="blob-num js-line-number" data-line-number="1132"></td>
-        <td id="LC1132" class="blob-code blob-code-inner js-file-line">90 t 9</td>
-      </tr>
-      <tr>
-        <td id="L1133" class="blob-num js-line-number" data-line-number="1133"></td>
-        <td id="LC1133" class="blob-code blob-code-inner js-file-line">90 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L1134" class="blob-num js-line-number" data-line-number="1134"></td>
-        <td id="LC1134" class="blob-code blob-code-inner js-file-line">90 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L1135" class="blob-num js-line-number" data-line-number="1135"></td>
-        <td id="LC1135" class="blob-code blob-code-inner js-file-line">90 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L1136" class="blob-num js-line-number" data-line-number="1136"></td>
-        <td id="LC1136" class="blob-code blob-code-inner js-file-line">90 x_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L1137" class="blob-num js-line-number" data-line-number="1137"></td>
-        <td id="LC1137" class="blob-code blob-code-inner js-file-line">90 x_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L1138" class="blob-num js-line-number" data-line-number="1138"></td>
-        <td id="LC1138" class="blob-code blob-code-inner js-file-line">90 t 21</td>
-      </tr>
-      <tr>
-        <td id="L1139" class="blob-num js-line-number" data-line-number="1139"></td>
-        <td id="LC1139" class="blob-code blob-code-inner js-file-line">91 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L1140" class="blob-num js-line-number" data-line-number="1140"></td>
-        <td id="LC1140" class="blob-code blob-code-inner js-file-line">91 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L1141" class="blob-num js-line-number" data-line-number="1141"></td>
-        <td id="LC1141" class="blob-code blob-code-inner js-file-line">91 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L1142" class="blob-num js-line-number" data-line-number="1142"></td>
-        <td id="LC1142" class="blob-code blob-code-inner js-file-line">91 t 2</td>
-      </tr>
-      <tr>
-        <td id="L1143" class="blob-num js-line-number" data-line-number="1143"></td>
-        <td id="LC1143" class="blob-code blob-code-inner js-file-line">91 t 3</td>
-      </tr>
-      <tr>
-        <td id="L1144" class="blob-num js-line-number" data-line-number="1144"></td>
-        <td id="LC1144" class="blob-code blob-code-inner js-file-line">91 t 7</td>
-      </tr>
-      <tr>
-        <td id="L1145" class="blob-num js-line-number" data-line-number="1145"></td>
-        <td id="LC1145" class="blob-code blob-code-inner js-file-line">91 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L1146" class="blob-num js-line-number" data-line-number="1146"></td>
-        <td id="LC1146" class="blob-code blob-code-inner js-file-line">91 t 15</td>
-      </tr>
-      <tr>
-        <td id="L1147" class="blob-num js-line-number" data-line-number="1147"></td>
-        <td id="LC1147" class="blob-code blob-code-inner js-file-line">91 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L1148" class="blob-num js-line-number" data-line-number="1148"></td>
-        <td id="LC1148" class="blob-code blob-code-inner js-file-line">91 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L1149" class="blob-num js-line-number" data-line-number="1149"></td>
-        <td id="LC1149" class="blob-code blob-code-inner js-file-line">91 y_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L1150" class="blob-num js-line-number" data-line-number="1150"></td>
-        <td id="LC1150" class="blob-code blob-code-inner js-file-line">91 y_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L1151" class="blob-num js-line-number" data-line-number="1151"></td>
-        <td id="LC1151" class="blob-code blob-code-inner js-file-line">92 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L1152" class="blob-num js-line-number" data-line-number="1152"></td>
-        <td id="LC1152" class="blob-code blob-code-inner js-file-line">92 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L1153" class="blob-num js-line-number" data-line-number="1153"></td>
-        <td id="LC1153" class="blob-code blob-code-inner js-file-line">92 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L1154" class="blob-num js-line-number" data-line-number="1154"></td>
-        <td id="LC1154" class="blob-code blob-code-inner js-file-line">92 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L1155" class="blob-num js-line-number" data-line-number="1155"></td>
-        <td id="LC1155" class="blob-code blob-code-inner js-file-line">92 x_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L1156" class="blob-num js-line-number" data-line-number="1156"></td>
-        <td id="LC1156" class="blob-code blob-code-inner js-file-line">92 t 10</td>
-      </tr>
-      <tr>
-        <td id="L1157" class="blob-num js-line-number" data-line-number="1157"></td>
-        <td id="LC1157" class="blob-code blob-code-inner js-file-line">92 t 12</td>
-      </tr>
-      <tr>
-        <td id="L1158" class="blob-num js-line-number" data-line-number="1158"></td>
-        <td id="LC1158" class="blob-code blob-code-inner js-file-line">92 t 14</td>
-      </tr>
-      <tr>
-        <td id="L1159" class="blob-num js-line-number" data-line-number="1159"></td>
-        <td id="LC1159" class="blob-code blob-code-inner js-file-line">92 x_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L1160" class="blob-num js-line-number" data-line-number="1160"></td>
-        <td id="LC1160" class="blob-code blob-code-inner js-file-line">93 cz 1 2</td>
-      </tr>
-      <tr>
-        <td id="L1161" class="blob-num js-line-number" data-line-number="1161"></td>
-        <td id="LC1161" class="blob-code blob-code-inner js-file-line">93 cz 9 10</td>
-      </tr>
-      <tr>
-        <td id="L1162" class="blob-num js-line-number" data-line-number="1162"></td>
-        <td id="LC1162" class="blob-code blob-code-inner js-file-line">93 cz 13 14</td>
-      </tr>
-      <tr>
-        <td id="L1163" class="blob-num js-line-number" data-line-number="1163"></td>
-        <td id="LC1163" class="blob-code blob-code-inner js-file-line">93 cz 21 22</td>
-      </tr>
-      <tr>
-        <td id="L1164" class="blob-num js-line-number" data-line-number="1164"></td>
-        <td id="LC1164" class="blob-code blob-code-inner js-file-line">93 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L1165" class="blob-num js-line-number" data-line-number="1165"></td>
-        <td id="LC1165" class="blob-code blob-code-inner js-file-line">93 t 11</td>
-      </tr>
-      <tr>
-        <td id="L1166" class="blob-num js-line-number" data-line-number="1166"></td>
-        <td id="LC1166" class="blob-code blob-code-inner js-file-line">93 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L1167" class="blob-num js-line-number" data-line-number="1167"></td>
-        <td id="LC1167" class="blob-code blob-code-inner js-file-line">93 t 17</td>
-      </tr>
-      <tr>
-        <td id="L1168" class="blob-num js-line-number" data-line-number="1168"></td>
-        <td id="LC1168" class="blob-code blob-code-inner js-file-line">94 cz 3 4</td>
-      </tr>
-      <tr>
-        <td id="L1169" class="blob-num js-line-number" data-line-number="1169"></td>
-        <td id="LC1169" class="blob-code blob-code-inner js-file-line">94 cz 7 8</td>
-      </tr>
-      <tr>
-        <td id="L1170" class="blob-num js-line-number" data-line-number="1170"></td>
-        <td id="LC1170" class="blob-code blob-code-inner js-file-line">94 cz 15 16</td>
-      </tr>
-      <tr>
-        <td id="L1171" class="blob-num js-line-number" data-line-number="1171"></td>
-        <td id="LC1171" class="blob-code blob-code-inner js-file-line">94 cz 19 20</td>
-      </tr>
-      <tr>
-        <td id="L1172" class="blob-num js-line-number" data-line-number="1172"></td>
-        <td id="LC1172" class="blob-code blob-code-inner js-file-line">94 y_1_2 1</td>
-      </tr>
-      <tr>
-        <td id="L1173" class="blob-num js-line-number" data-line-number="1173"></td>
-        <td id="LC1173" class="blob-code blob-code-inner js-file-line">94 x_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L1174" class="blob-num js-line-number" data-line-number="1174"></td>
-        <td id="LC1174" class="blob-code blob-code-inner js-file-line">94 x_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L1175" class="blob-num js-line-number" data-line-number="1175"></td>
-        <td id="LC1175" class="blob-code blob-code-inner js-file-line">94 y_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L1176" class="blob-num js-line-number" data-line-number="1176"></td>
-        <td id="LC1176" class="blob-code blob-code-inner js-file-line">94 y_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L1177" class="blob-num js-line-number" data-line-number="1177"></td>
-        <td id="LC1177" class="blob-code blob-code-inner js-file-line">94 x_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L1178" class="blob-num js-line-number" data-line-number="1178"></td>
-        <td id="LC1178" class="blob-code blob-code-inner js-file-line">94 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L1179" class="blob-num js-line-number" data-line-number="1179"></td>
-        <td id="LC1179" class="blob-code blob-code-inner js-file-line">94 t 22</td>
-      </tr>
-      <tr>
-        <td id="L1180" class="blob-num js-line-number" data-line-number="1180"></td>
-        <td id="LC1180" class="blob-code blob-code-inner js-file-line">95 cz 0 6</td>
-      </tr>
-      <tr>
-        <td id="L1181" class="blob-num js-line-number" data-line-number="1181"></td>
-        <td id="LC1181" class="blob-code blob-code-inner js-file-line">95 cz 2 8</td>
-      </tr>
-      <tr>
-        <td id="L1182" class="blob-num js-line-number" data-line-number="1182"></td>
-        <td id="LC1182" class="blob-code blob-code-inner js-file-line">95 cz 4 10</td>
-      </tr>
-      <tr>
-        <td id="L1183" class="blob-num js-line-number" data-line-number="1183"></td>
-        <td id="LC1183" class="blob-code blob-code-inner js-file-line">95 cz 13 19</td>
-      </tr>
-      <tr>
-        <td id="L1184" class="blob-num js-line-number" data-line-number="1184"></td>
-        <td id="LC1184" class="blob-code blob-code-inner js-file-line">95 cz 15 21</td>
-      </tr>
-      <tr>
-        <td id="L1185" class="blob-num js-line-number" data-line-number="1185"></td>
-        <td id="LC1185" class="blob-code blob-code-inner js-file-line">95 cz 17 23</td>
-      </tr>
-      <tr>
-        <td id="L1186" class="blob-num js-line-number" data-line-number="1186"></td>
-        <td id="LC1186" class="blob-code blob-code-inner js-file-line">95 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L1187" class="blob-num js-line-number" data-line-number="1187"></td>
-        <td id="LC1187" class="blob-code blob-code-inner js-file-line">95 t 7</td>
-      </tr>
-      <tr>
-        <td id="L1188" class="blob-num js-line-number" data-line-number="1188"></td>
-        <td id="LC1188" class="blob-code blob-code-inner js-file-line">95 y_1_2 16</td>
-      </tr>
-      <tr>
-        <td id="L1189" class="blob-num js-line-number" data-line-number="1189"></td>
-        <td id="LC1189" class="blob-code blob-code-inner js-file-line">95 t 20</td>
-      </tr>
-      <tr>
-        <td id="L1190" class="blob-num js-line-number" data-line-number="1190"></td>
-        <td id="LC1190" class="blob-code blob-code-inner js-file-line">96 cz 1 7</td>
-      </tr>
-      <tr>
-        <td id="L1191" class="blob-num js-line-number" data-line-number="1191"></td>
-        <td id="LC1191" class="blob-code blob-code-inner js-file-line">96 cz 3 9</td>
-      </tr>
-      <tr>
-        <td id="L1192" class="blob-num js-line-number" data-line-number="1192"></td>
-        <td id="LC1192" class="blob-code blob-code-inner js-file-line">96 cz 5 11</td>
-      </tr>
-      <tr>
-        <td id="L1193" class="blob-num js-line-number" data-line-number="1193"></td>
-        <td id="LC1193" class="blob-code blob-code-inner js-file-line">96 cz 12 18</td>
-      </tr>
-      <tr>
-        <td id="L1194" class="blob-num js-line-number" data-line-number="1194"></td>
-        <td id="LC1194" class="blob-code blob-code-inner js-file-line">96 cz 14 20</td>
-      </tr>
-      <tr>
-        <td id="L1195" class="blob-num js-line-number" data-line-number="1195"></td>
-        <td id="LC1195" class="blob-code blob-code-inner js-file-line">96 cz 16 22</td>
-      </tr>
-      <tr>
-        <td id="L1196" class="blob-num js-line-number" data-line-number="1196"></td>
-        <td id="LC1196" class="blob-code blob-code-inner js-file-line">96 x_1_2 0</td>
-      </tr>
-      <tr>
-        <td id="L1197" class="blob-num js-line-number" data-line-number="1197"></td>
-        <td id="LC1197" class="blob-code blob-code-inner js-file-line">96 t 2</td>
-      </tr>
-      <tr>
-        <td id="L1198" class="blob-num js-line-number" data-line-number="1198"></td>
-        <td id="LC1198" class="blob-code blob-code-inner js-file-line">96 y_1_2 4</td>
-      </tr>
-      <tr>
-        <td id="L1199" class="blob-num js-line-number" data-line-number="1199"></td>
-        <td id="LC1199" class="blob-code blob-code-inner js-file-line">96 x_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L1200" class="blob-num js-line-number" data-line-number="1200"></td>
-        <td id="LC1200" class="blob-code blob-code-inner js-file-line">96 t 8</td>
-      </tr>
-      <tr>
-        <td id="L1201" class="blob-num js-line-number" data-line-number="1201"></td>
-        <td id="LC1201" class="blob-code blob-code-inner js-file-line">96 x_1_2 10</td>
-      </tr>
-      <tr>
-        <td id="L1202" class="blob-num js-line-number" data-line-number="1202"></td>
-        <td id="LC1202" class="blob-code blob-code-inner js-file-line">96 x_1_2 13</td>
-      </tr>
-      <tr>
-        <td id="L1203" class="blob-num js-line-number" data-line-number="1203"></td>
-        <td id="LC1203" class="blob-code blob-code-inner js-file-line">96 x_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L1204" class="blob-num js-line-number" data-line-number="1204"></td>
-        <td id="LC1204" class="blob-code blob-code-inner js-file-line">96 y_1_2 17</td>
-      </tr>
-      <tr>
-        <td id="L1205" class="blob-num js-line-number" data-line-number="1205"></td>
-        <td id="LC1205" class="blob-code blob-code-inner js-file-line">96 x_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L1206" class="blob-num js-line-number" data-line-number="1206"></td>
-        <td id="LC1206" class="blob-code blob-code-inner js-file-line">96 t 21</td>
-      </tr>
-      <tr>
-        <td id="L1207" class="blob-num js-line-number" data-line-number="1207"></td>
-        <td id="LC1207" class="blob-code blob-code-inner js-file-line">96 x_1_2 23</td>
-      </tr>
-      <tr>
-        <td id="L1208" class="blob-num js-line-number" data-line-number="1208"></td>
-        <td id="LC1208" class="blob-code blob-code-inner js-file-line">97 cz 0 1</td>
-      </tr>
-      <tr>
-        <td id="L1209" class="blob-num js-line-number" data-line-number="1209"></td>
-        <td id="LC1209" class="blob-code blob-code-inner js-file-line">97 cz 4 5</td>
-      </tr>
-      <tr>
-        <td id="L1210" class="blob-num js-line-number" data-line-number="1210"></td>
-        <td id="LC1210" class="blob-code blob-code-inner js-file-line">97 cz 8 9</td>
-      </tr>
-      <tr>
-        <td id="L1211" class="blob-num js-line-number" data-line-number="1211"></td>
-        <td id="LC1211" class="blob-code blob-code-inner js-file-line">97 cz 12 13</td>
-      </tr>
-      <tr>
-        <td id="L1212" class="blob-num js-line-number" data-line-number="1212"></td>
-        <td id="LC1212" class="blob-code blob-code-inner js-file-line">97 cz 16 17</td>
-      </tr>
-      <tr>
-        <td id="L1213" class="blob-num js-line-number" data-line-number="1213"></td>
-        <td id="LC1213" class="blob-code blob-code-inner js-file-line">97 cz 20 21</td>
-      </tr>
-      <tr>
-        <td id="L1214" class="blob-num js-line-number" data-line-number="1214"></td>
-        <td id="LC1214" class="blob-code blob-code-inner js-file-line">97 t 3</td>
-      </tr>
-      <tr>
-        <td id="L1215" class="blob-num js-line-number" data-line-number="1215"></td>
-        <td id="LC1215" class="blob-code blob-code-inner js-file-line">97 y_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L1216" class="blob-num js-line-number" data-line-number="1216"></td>
-        <td id="LC1216" class="blob-code blob-code-inner js-file-line">97 x_1_2 11</td>
-      </tr>
-      <tr>
-        <td id="L1217" class="blob-num js-line-number" data-line-number="1217"></td>
-        <td id="LC1217" class="blob-code blob-code-inner js-file-line">97 t 14</td>
-      </tr>
-      <tr>
-        <td id="L1218" class="blob-num js-line-number" data-line-number="1218"></td>
-        <td id="LC1218" class="blob-code blob-code-inner js-file-line">97 t 18</td>
-      </tr>
-      <tr>
-        <td id="L1219" class="blob-num js-line-number" data-line-number="1219"></td>
-        <td id="LC1219" class="blob-code blob-code-inner js-file-line">97 x_1_2 22</td>
-      </tr>
-      <tr>
-        <td id="L1220" class="blob-num js-line-number" data-line-number="1220"></td>
-        <td id="LC1220" class="blob-code blob-code-inner js-file-line">98 cz 2 3</td>
-      </tr>
-      <tr>
-        <td id="L1221" class="blob-num js-line-number" data-line-number="1221"></td>
-        <td id="LC1221" class="blob-code blob-code-inner js-file-line">98 cz 6 7</td>
-      </tr>
-      <tr>
-        <td id="L1222" class="blob-num js-line-number" data-line-number="1222"></td>
-        <td id="LC1222" class="blob-code blob-code-inner js-file-line">98 cz 10 11</td>
-      </tr>
-      <tr>
-        <td id="L1223" class="blob-num js-line-number" data-line-number="1223"></td>
-        <td id="LC1223" class="blob-code blob-code-inner js-file-line">98 cz 14 15</td>
-      </tr>
-      <tr>
-        <td id="L1224" class="blob-num js-line-number" data-line-number="1224"></td>
-        <td id="LC1224" class="blob-code blob-code-inner js-file-line">98 cz 18 19</td>
-      </tr>
-      <tr>
-        <td id="L1225" class="blob-num js-line-number" data-line-number="1225"></td>
-        <td id="LC1225" class="blob-code blob-code-inner js-file-line">98 cz 22 23</td>
-      </tr>
-      <tr>
-        <td id="L1226" class="blob-num js-line-number" data-line-number="1226"></td>
-        <td id="LC1226" class="blob-code blob-code-inner js-file-line">98 t 0</td>
-      </tr>
-      <tr>
-        <td id="L1227" class="blob-num js-line-number" data-line-number="1227"></td>
-        <td id="LC1227" class="blob-code blob-code-inner js-file-line">98 t 1</td>
-      </tr>
-      <tr>
-        <td id="L1228" class="blob-num js-line-number" data-line-number="1228"></td>
-        <td id="LC1228" class="blob-code blob-code-inner js-file-line">98 t 4</td>
-      </tr>
-      <tr>
-        <td id="L1229" class="blob-num js-line-number" data-line-number="1229"></td>
-        <td id="LC1229" class="blob-code blob-code-inner js-file-line">98 y_1_2 5</td>
-      </tr>
-      <tr>
-        <td id="L1230" class="blob-num js-line-number" data-line-number="1230"></td>
-        <td id="LC1230" class="blob-code blob-code-inner js-file-line">98 y_1_2 8</td>
-      </tr>
-      <tr>
-        <td id="L1231" class="blob-num js-line-number" data-line-number="1231"></td>
-        <td id="LC1231" class="blob-code blob-code-inner js-file-line">98 y_1_2 9</td>
-      </tr>
-      <tr>
-        <td id="L1232" class="blob-num js-line-number" data-line-number="1232"></td>
-        <td id="LC1232" class="blob-code blob-code-inner js-file-line">98 x_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L1233" class="blob-num js-line-number" data-line-number="1233"></td>
-        <td id="LC1233" class="blob-code blob-code-inner js-file-line">98 t 13</td>
-      </tr>
-      <tr>
-        <td id="L1234" class="blob-num js-line-number" data-line-number="1234"></td>
-        <td id="LC1234" class="blob-code blob-code-inner js-file-line">98 t 16</td>
-      </tr>
-      <tr>
-        <td id="L1235" class="blob-num js-line-number" data-line-number="1235"></td>
-        <td id="LC1235" class="blob-code blob-code-inner js-file-line">98 t 17</td>
-      </tr>
-      <tr>
-        <td id="L1236" class="blob-num js-line-number" data-line-number="1236"></td>
-        <td id="LC1236" class="blob-code blob-code-inner js-file-line">98 y_1_2 20</td>
-      </tr>
-      <tr>
-        <td id="L1237" class="blob-num js-line-number" data-line-number="1237"></td>
-        <td id="LC1237" class="blob-code blob-code-inner js-file-line">98 x_1_2 21</td>
-      </tr>
-      <tr>
-        <td id="L1238" class="blob-num js-line-number" data-line-number="1238"></td>
-        <td id="LC1238" class="blob-code blob-code-inner js-file-line">99 cz 6 12</td>
-      </tr>
-      <tr>
-        <td id="L1239" class="blob-num js-line-number" data-line-number="1239"></td>
-        <td id="LC1239" class="blob-code blob-code-inner js-file-line">99 cz 8 14</td>
-      </tr>
-      <tr>
-        <td id="L1240" class="blob-num js-line-number" data-line-number="1240"></td>
-        <td id="LC1240" class="blob-code blob-code-inner js-file-line">99 cz 10 16</td>
-      </tr>
-      <tr>
-        <td id="L1241" class="blob-num js-line-number" data-line-number="1241"></td>
-        <td id="LC1241" class="blob-code blob-code-inner js-file-line">99 y_1_2 2</td>
-      </tr>
-      <tr>
-        <td id="L1242" class="blob-num js-line-number" data-line-number="1242"></td>
-        <td id="LC1242" class="blob-code blob-code-inner js-file-line">99 x_1_2 3</td>
-      </tr>
-      <tr>
-        <td id="L1243" class="blob-num js-line-number" data-line-number="1243"></td>
-        <td id="LC1243" class="blob-code blob-code-inner js-file-line">99 x_1_2 7</td>
-      </tr>
-      <tr>
-        <td id="L1244" class="blob-num js-line-number" data-line-number="1244"></td>
-        <td id="LC1244" class="blob-code blob-code-inner js-file-line">99 t 11</td>
-      </tr>
-      <tr>
-        <td id="L1245" class="blob-num js-line-number" data-line-number="1245"></td>
-        <td id="LC1245" class="blob-code blob-code-inner js-file-line">99 y_1_2 15</td>
-      </tr>
-      <tr>
-        <td id="L1246" class="blob-num js-line-number" data-line-number="1246"></td>
-        <td id="LC1246" class="blob-code blob-code-inner js-file-line">99 y_1_2 18</td>
-      </tr>
-      <tr>
-        <td id="L1247" class="blob-num js-line-number" data-line-number="1247"></td>
-        <td id="LC1247" class="blob-code blob-code-inner js-file-line">99 y_1_2 19</td>
-      </tr>
-      <tr>
-        <td id="L1248" class="blob-num js-line-number" data-line-number="1248"></td>
-        <td id="LC1248" class="blob-code blob-code-inner js-file-line">99 t 22</td>
-      </tr>
-      <tr>
-        <td id="L1249" class="blob-num js-line-number" data-line-number="1249"></td>
-        <td id="LC1249" class="blob-code blob-code-inner js-file-line">99 t 23</td>
-      </tr>
-      <tr>
-        <td id="L1250" class="blob-num js-line-number" data-line-number="1250"></td>
-        <td id="LC1250" class="blob-code blob-code-inner js-file-line">100 cz 7 13</td>
-      </tr>
-      <tr>
-        <td id="L1251" class="blob-num js-line-number" data-line-number="1251"></td>
-        <td id="LC1251" class="blob-code blob-code-inner js-file-line">100 cz 9 15</td>
-      </tr>
-      <tr>
-        <td id="L1252" class="blob-num js-line-number" data-line-number="1252"></td>
-        <td id="LC1252" class="blob-code blob-code-inner js-file-line">100 cz 11 17</td>
-      </tr>
-      <tr>
-        <td id="L1253" class="blob-num js-line-number" data-line-number="1253"></td>
-        <td id="LC1253" class="blob-code blob-code-inner js-file-line">100 y_1_2 6</td>
-      </tr>
-      <tr>
-        <td id="L1254" class="blob-num js-line-number" data-line-number="1254"></td>
-        <td id="LC1254" class="blob-code blob-code-inner js-file-line">100 t 8</td>
-      </tr>
-      <tr>
-        <td id="L1255" class="blob-num js-line-number" data-line-number="1255"></td>
-        <td id="LC1255" class="blob-code blob-code-inner js-file-line">100 t 10</td>
-      </tr>
-      <tr>
-        <td id="L1256" class="blob-num js-line-number" data-line-number="1256"></td>
-        <td id="LC1256" class="blob-code blob-code-inner js-file-line">100 y_1_2 12</td>
-      </tr>
-      <tr>
-        <td id="L1257" class="blob-num js-line-number" data-line-number="1257"></td>
-        <td id="LC1257" class="blob-code blob-code-inner js-file-line">100 y_1_2 14</td>
-      </tr>
-      <tr>
-        <td id="L1258" class="blob-num js-line-number" data-line-number="1258"></td>
-        <td id="LC1258" class="blob-code blob-code-inner js-file-line">100 x_1_2 16</td>
-      </tr>
-</table>
-
-  <details class="details-reset details-overlay BlobToolbar position-absolute js-file-line-actions dropdown d-none" aria-hidden="true">
-    <summary class="btn-octicon ml-0 px-2 p-0 color-bg-primary border color-border-tertiary rounded-1" aria-label="Inline file action toolbar">
-      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-kebab-horizontal">
-    <path d="M8 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zM1.5 9a1.5 1.5 0 100-3 1.5 1.5 0 000 3zm13 0a1.5 1.5 0 100-3 1.5 1.5 0 000 3z"></path>
-</svg>
-    </summary>
-    <details-menu>
-      <ul class="BlobToolbar-dropdown dropdown-menu dropdown-menu-se mt-2" style="width:185px">
-        <li>
-          <clipboard-copy role="menuitem" class="dropdown-item" id="js-copy-lines" style="cursor:pointer;">
-            Copy lines
-          </clipboard-copy>
-        </li>
-        <li>
-          <clipboard-copy role="menuitem" class="dropdown-item" id="js-copy-permalink" style="cursor:pointer;">
-            Copy permalink
-          </clipboard-copy>
-        </li>
-        <li><a class="dropdown-item js-update-url-with-hash" id="js-view-git-blame" role="menuitem" href="/quantumlib/qsim/blame/1d0965c9c27f735edeb2a18b7bf5a27e7592bd6f/circuits/circuit_q24">View git blame</a></li>
-          <li><a class="dropdown-item" id="js-new-issue" role="menuitem" href="/quantumlib/qsim/issues/new">Reference in new issue</a></li>
-      </ul>
-    </details-menu>
-  </details>
-
-  </div>
-
-    </div>
-
-
-  
-
-  <details class="details-reset details-overlay details-overlay-dark" id="jumpto-line-details-dialog">
-    <summary data-hotkey="l" aria-label="Jump to line"></summary>
-    <details-dialog class="Box Box--overlay d-flex flex-column anim-fade-in fast linejump" aria-label="Jump to line">
-      <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="js-jump-to-line-form Box-body d-flex" action="" accept-charset="UTF-8" method="get">
-        <input class="form-control flex-auto mr-3 linejump-input js-jump-to-line-field" type="text" placeholder="Jump to line&hellip;" aria-label="Jump to line" autofocus>
-        <button type="submit" class="btn" data-close-dialog>Go</button>
-</form>    </details-dialog>
-  </details>
-
-
-</div>
-
-
-
-  </div>
-</div>
-
-    </main>
-  </div>
-
-  </div>
-
-          
-<div class="footer container-xl width-full p-responsive" role="contentinfo">
-  <div class="position-relative d-flex flex-row-reverse flex-lg-row flex-wrap flex-lg-nowrap flex-justify-center flex-lg-justify-between pt-6 pb-2 mt-6 f6 color-text-secondary border-top color-border-secondary ">
-    <ul class="list-style-none d-flex flex-wrap col-12 col-lg-5 flex-justify-center flex-lg-justify-between mb-2 mb-lg-0">
-      <li class="mr-3 mr-lg-0">&copy; 2021 GitHub, Inc.</li>
-        <li class="mr-3 mr-lg-0"><a href="https://docs.github.com/en/github/site-policy/github-terms-of-service" data-ga-click="Footer, go to terms, text:terms">Terms</a></li>
-        <li class="mr-3 mr-lg-0"><a href="https://docs.github.com/en/github/site-policy/github-privacy-statement" data-ga-click="Footer, go to privacy, text:privacy">Privacy</a></li>
-        <li class="mr-3 mr-lg-0"><a data-ga-click="Footer, go to security, text:security" href="https://github.com/security">Security</a></li>
-        <li class="mr-3 mr-lg-0"><a href="https://www.githubstatus.com/" data-ga-click="Footer, go to status, text:status">Status</a></li>
-        <li><a data-ga-click="Footer, go to help, text:Docs" href="https://docs.github.com">Docs</a></li>
-    </ul>
-
-    <a aria-label="Homepage" title="GitHub" class="footer-octicon d-none d-lg-block mx-lg-4" href="https://github.com">
-      <svg height="24" class="octicon octicon-mark-github" viewBox="0 0 16 16" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg>
-</a>
-    <ul class="list-style-none d-flex flex-wrap col-12 col-lg-5 flex-justify-center flex-lg-justify-between mb-2 mb-lg-0">
-        <li class="mr-3 mr-lg-0"><a href="https://support.github.com" data-ga-click="Footer, go to contact, text:contact">Contact GitHub</a></li>
-        <li class="mr-3 mr-lg-0"><a href="https://github.com/pricing" data-ga-click="Footer, go to Pricing, text:Pricing">Pricing</a></li>
-      <li class="mr-3 mr-lg-0"><a href="https://docs.github.com" data-ga-click="Footer, go to api, text:api">API</a></li>
-      <li class="mr-3 mr-lg-0"><a href="https://services.github.com" data-ga-click="Footer, go to training, text:training">Training</a></li>
-        <li class="mr-3 mr-lg-0"><a href="https://github.blog" data-ga-click="Footer, go to blog, text:blog">Blog</a></li>
-        <li><a data-ga-click="Footer, go to about, text:about" href="https://github.com/about">About</a></li>
-    </ul>
-  </div>
-  <div class="d-flex flex-justify-center pb-6">
-    <span class="f6 color-text-tertiary"></span>
-  </div>
-
-  
-</div>
-
-
-
-  <div id="ajax-error-message" class="ajax-error-message flash flash-error" hidden>
-    <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-alert">
-    <path fill-rule="evenodd" d="M8.22 1.754a.25.25 0 00-.44 0L1.698 13.132a.25.25 0 00.22.368h12.164a.25.25 0 00.22-.368L8.22 1.754zm-1.763-.707c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0114.082 15H1.918a1.75 1.75 0 01-1.543-2.575L6.457 1.047zM9 11a1 1 0 11-2 0 1 1 0 012 0zm-.25-5.25a.75.75 0 00-1.5 0v2.5a.75.75 0 001.5 0v-2.5z"></path>
-</svg>
-    <button type="button" class="flash-close js-ajax-error-dismiss" aria-label="Dismiss error">
-      <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
-    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
-</svg>
-    </button>
-    You can’t perform that action at this time.
-  </div>
-
-  <div class="js-stale-session-flash flash flash-warn flash-banner" hidden
-    >
-    <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-alert">
-    <path fill-rule="evenodd" d="M8.22 1.754a.25.25 0 00-.44 0L1.698 13.132a.25.25 0 00.22.368h12.164a.25.25 0 00.22-.368L8.22 1.754zm-1.763-.707c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0114.082 15H1.918a1.75 1.75 0 01-1.543-2.575L6.457 1.047zM9 11a1 1 0 11-2 0 1 1 0 012 0zm-.25-5.25a.75.75 0 00-1.5 0v2.5a.75.75 0 001.5 0v-2.5z"></path>
-</svg>
-    <span class="js-stale-session-flash-signed-in" hidden>You signed in with another tab or window. <a href="">Reload</a> to refresh your session.</span>
-    <span class="js-stale-session-flash-signed-out" hidden>You signed out in another tab or window. <a href="">Reload</a> to refresh your session.</span>
-  </div>
-    <template id="site-details-dialog">
-  <details class="details-reset details-overlay details-overlay-dark lh-default color-text-primary hx_rsm" open>
-    <summary role="button" aria-label="Close dialog"></summary>
-    <details-dialog class="Box Box--overlay d-flex flex-column anim-fade-in fast hx_rsm-dialog hx_rsm-modal">
-      <button class="Box-btn-octicon m-0 btn-octicon position-absolute right-0 top-0" type="button" aria-label="Close dialog" data-close-dialog>
-        <svg aria-hidden="true" viewBox="0 0 16 16" version="1.1" height="16" width="16" class="octicon octicon-x">
-    <path fill-rule="evenodd" d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z"></path>
-</svg>
-      </button>
-      <div class="octocat-spinner my-6 js-details-dialog-spinner"></div>
-    </details-dialog>
-  </details>
-</template>
-
-    <div class="Popover js-hovercard-content position-absolute" style="display: none; outline: none;" tabindex="0">
-  <div class="Popover-message Popover-message--bottom-left Popover-message--large Box color-shadow-large" style="width:360px;">
-  </div>
-</div>
-
-
-
-  
-
-  </body>
-</html>
-
diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index c5bf4949..b3f75fe2 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -54,7 +54,7 @@ variable "metric_target_queue" {
 }
 variable "compute_instance_type" {
   type = string
-  default = "n2-standard-80"
+  default = "n2-standard-16"
 }
 variable "instance_type" {
   type = string
@@ -87,13 +87,13 @@ locals{
       "condorversion" = var.condorversion, 
       "admin_email" = var.admin_email
     })
-  master_startup = templatefile(
+  manager_startup = templatefile(
     "${path.module}/startup-centos.sh", 
     {
       "bucket_name" = var.bucket_name,
       "project" = var.project,
       "cluster_name" = var.cluster_name,
-      "htserver_type" = "master", 
+      "htserver_type" = "manager", 
       "osversion" = var.osversion, 
       "condorversion" = var.condorversion, 
       "admin_email" = var.admin_email
@@ -103,7 +103,7 @@ data "google_compute_image" "startimage" {
   family  = var.osimage
   project = var.osproject
 }
-resource "google_compute_instance" "condor-master" {
+resource "google_compute_instance" "condor-manager" {
   boot_disk {
     auto_delete = "true"
     device_name = "boot"
@@ -122,8 +122,8 @@ resource "google_compute_instance" "condor-master" {
   enable_display      = "false"
 
   machine_type            = var.instance_type
-  metadata_startup_script = local.master_startup
-  name                    = "${var.cluster_name}-master"
+  metadata_startup_script = local.manager_startup
+  name                    = "${var.cluster_name}-manager"
   network_interface {
     access_config {
       network_tier = "PREMIUM"
@@ -154,7 +154,7 @@ resource "google_compute_instance" "condor-master" {
     enable_vtpm                 = "true"
   }
 
-  tags = ["${var.cluster_name}-master"]
+  tags = ["${var.cluster_name}-manager"]
   zone = var.zone
 }
 
@@ -257,9 +257,8 @@ resource "google_compute_instance_template" "condor-compute" {
   }
 
   service_account {
-      email = var.service_account
-  #  email  = "default"
-    scopes = ["https://www.googleapis.com/auth/monitoring.write", "https://www.googleapis.com/auth/trace.append", "https://www.googleapis.com/auth/logging.write", "https://www.googleapis.com/auth/devstorage.full_control"]
+    email = var.service_account
+    scopes = ["cloud-platform"]
   }
 
   tags = ["${var.cluster_name}-compute"]
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh
deleted file mode 100644
index a76774a8..00000000
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos-noinstall.sh
+++ /dev/null
@@ -1,72 +0,0 @@
-#!/bin/bash -x
-
-SERVER_TYPE="${htserver_type}"
-
-##############################################################
-# Configure Condor Daemons 
-##############################################################
-cd /tmp
-cat <<EOF > condor_config.local
-DISCARD_SESSION_KEYRING_ON_STARTUP=False
-CONDOR_ADMIN=${admin_email}
-CONDOR_HOST=${cluster_name}-master
-EOF
-
-# Case for compute
-if [ "$SERVER_TYPE" == "compute" ]; then
-cat <<EOF1 >> condor_config.local
-# Standard Stuff
-DAEMON_LIST = MASTER, STARTD
-ALLOW_WRITE = \$(ALLOW_WRITE), \$(CONDOR_HOST)
-# Run Dynamics Slots
-NUM_SLOTS = 1
-NUM_SLOTS_TYPE_1 = 1
-SLOT_TYPE_1 = 100%
-SLOT_TYPE_1_PARTITIONABLE = TRUE
-# Allowing Run as Owner
-STARTER_ALLOW_RUNAS_OWNER = TRUE
-SUBMIT_ATTRS = RunAsOwner
-RunAsOwner = True
-UID_DOMAIN = c.${project}.internal
-TRUST_UID_DOMAIN = True
-EOF1
-fi
-
-# Case for master
-if [ "$SERVER_TYPE" == "master" ]; then
-cat <<EOF2 >> condor_config.local
-DAEMON_LIST = MASTER, COLLECTOR, NEGOTIATOR
-ALLOW_WRITE = *
-EOF2
-fi
-
-# Case for submit
-if [ "$SERVER_TYPE" == "submit" ]; then
-cat <<EOF3 >> condor_config.local
-DAEMON_LIST = MASTER, SCHEDD
-ALLOW_WRITE = \$(ALLOW_WRITE), \$(CONDOR_HOST)
-# Allowing Run as Owner
-STARTER_ALLOW_RUNAS_OWNER = TRUE
-SUBMIT_ATTRS = RunAsOwner
-RunAsOwner = True
-UID_DOMAIN = c.${project}.internal
-TRUST_UID_DOMAIN = True
-EOF3
-fi
-
-mkdir -p /etc/condor/config.d
-mv condor_config.local /etc/condor/config.d
-systemctl start condor;systemctl enable condor
-
-##############################################################
-## Some fluentd Stuff
-##############################################################
-
-
-if [ "$SERVER_TYPE" == "submit" ]; then
-mkdir -p /var/log/condor/jobs
-touch /var/log/condor/jobs/stats.log
-chmod 666 /var/log/condor/jobs/stats.log
-fi
-
-service google-fluentd restart
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
index 7177a285..d883efa1 100644
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -47,7 +47,7 @@ cd /tmp
 cat <<EOF > condor_config.local
 DISCARD_SESSION_KEYRING_ON_STARTUP=False
 CONDOR_ADMIN=${admin_email}
-CONDOR_HOST=${cluster_name}-master
+CONDOR_HOST=${cluster_name}-manager
 EOF
 
 # Case for compute
@@ -71,8 +71,8 @@ HasDocker = True
 EOF1
 fi
 
-# Case for master
-if [ "$SERVER_TYPE" == "master" ]; then
+# Case for manager
+if [ "$SERVER_TYPE" == "manager" ]; then
 cat <<EOF2 >> condor_config.local
 DAEMON_LIST = MASTER, COLLECTOR, NEGOTIATOR
 ALLOW_WRITE = *
diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
index cabf61d2..d532b02c 100644
--- a/docs/tutorials/multinode/terraform/main.tf
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -14,6 +14,6 @@ module "htcondor" {
   project="quantum-htcondor"
   max_replicas=20
   min_replicas=1
-  service_account="htcondor@quantum-htcondor.iam.gserviceaccount.com"
+  service_account="htcondor2@quantum-htcondor.iam.gserviceaccount.com"
   use_preemptibles=true
 }
\ No newline at end of file

From 11207a19f09fbe9c3a5693dadbbb901e6f1b155e Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Wed, 19 May 2021 21:17:28 +0000
Subject: [PATCH 007/246] Update docs, with steps

---
 docs/tutorials/multinode/terraform/README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index bbcec480..3669fcfd 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -39,7 +39,6 @@ module "htcondor" {
   cluster_name = var.cluster_name
   osimage = "lsst"
   osversion = "7"
-  bucket_name = "[[GCS_FUSE_BUCKET]]"
   zone="[[YOUR_ZONE]]"
   project="[[PROJECT_ID]]"
   max_replicas=20

From 7e457d897fc315993f99c233db08635a2ace0685 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Wed, 19 May 2021 21:18:02 +0000
Subject: [PATCH 008/246] Update docs

---
 docs/tutorials/multinode/README.md            | 77 +++++++++++++++++--
 docs/tutorials/multinode/circuit_q24.job      |  8 +-
 docs/tutorials/multinode/circuit_q30.job      |  8 +-
 .../multinode/terraform/htcondor/resources.tf | 40 +++++-----
 docs/tutorials/multinode/terraform/main.tf    | 15 ++--
 5 files changed, 109 insertions(+), 39 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 81dd629b..a2fc5a16 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -1,12 +1,79 @@
-gcloud iam service-accounts create "htcondor2"   --display-name="HTCONDOR 2"
-gcloud projects add-iam-policy-binding quantum-htcondor --role roles/iam.serviceAccountUser --member="serviceAccount:htcondor2@quantum-htcondor.iam.gserviceaccount.com"
-gcloud projects add-iam-policy-binding quantum-htcondor --role roles/compute.admin --member="serviceAccount:htcondor2@quantum-htcondor.iam.gserviceaccount.com"
+# To run a multinode quantum simulation
+s
+## Objectives
 
+* Use Terraform to deploy a HTCondor cluster
+* Run a multinode simulation using HTCondor
+* Query cluster information and monitor running jobs in HTCondor
+* Autoscale nodes to runt jobs that new more Simulation capacit
 
-git clone https://github.com/jrossthomson/qsim.git
+## Costs
 
-cd qsim/docs/tutorials/multinode/
+This tutorial uses the following billable components of Google Cloud:
 
+* [Compute Engine](https://cloud.google.com/compute/all-pricing)
+
+To generate a cost estimate based on your projected usage, use the [pricing calculator](https://cloud.google.com/products/calculator).
+When you finish this tutorial, you can avoid continued billing by deleting the resources 
+you created. For more information, see Cleaning up.
+
+## Before you begin
+1. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project. To make this easy, try to choose a project where you are _Owner_ or _Editor_.
+
+      > Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
+Go to [project selector](https://console.cloud.google.com/projectselector2/home/dashboard)
+
+1. Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.
+1. Enable the [Compute Engine and Deployment Manager APIs](https://console.cloud.google.com/flows/enableapi?apiid=compute,deploymentmanager.googleapis.com).
+1. In the Cloud Console, [activate Cloud Shell](https://console.cloud.google.com/?cloudshell=true)
+
+At the bottom of the Cloud Console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Cloud SDK already installed, including the gcloud command-line tool, and with values already set for your current project. It can take a few seconds for the session to initialize.
+
+## Setting up your environment in Cloud Shell
+Select a region and zone for your cluster to run. [This guide can help](https://cloud.google.com/compute/docs/regions-zones).
+
+Once selected, define the following environment variables in Cloud Shell.
+
+```
+export TF_VAR_project=[[YOUR_PROJECT_ID]]
+export TF_VAR_region=[[YOUR_REGION]]
+export TF_VAR_zone=[[YOUR_ZONE]]
+```
+With those variables defined, you can configure `gcloud`. Cut and paste the gcloud config commands in your Cloud Shell.
+
+```
+gcloud config set project $TF_VAR_project
+gcloud config set compute/region $TF_VAR_region
+gcloud config set compute/zone $TF_VAR_zone
+```
+With that completed, you can create a service account that will run the HTCondor cluster.
+
+```
+gcloud iam service-accounts create htcondor
+```
+Then give the 
+```
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/iam.serviceAccountUser \
+ --member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/compute.admin \
+--member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
+```
+
+## Clone the repository
+
+The `qsim` repository has all the code required to create the repository and to run the simulations.
+
+1. Clone the repo and change to the working directory.
+     ```
+     git clone https://github.com/jrossthomson/qsim.git
+     cd qsim/docs/tutorials/multinode/terraform
+     ```
+
+1. Build the cluster with Terraform
+     ```
+     terraform init
+     make apply
+     ```
 sudo journalctl -f -u google-startup-scripts.service
 
 condor_q
diff --git a/docs/tutorials/multinode/circuit_q24.job b/docs/tutorials/multinode/circuit_q24.job
index 5d2639a1..a8d6b3ff 100644
--- a/docs/tutorials/multinode/circuit_q24.job
+++ b/docs/tutorials/multinode/circuit_q24.job
@@ -4,8 +4,8 @@ arguments               = -c circuit_q24
 transfer_input_files    = ../../../circuits/circuit_q24
 should_transfer_files   = YES
 when_to_transfer_output = ON_EXIT
-output                  = out/out.$(Process)
-error                   = out/err.$(Process)
-log                     = out/log.$(Process)
-request_memory          = 30GB
+output                  = out/out.$(Cluster)-$(Process)
+error                   = out/err.$(Cluster)-$(Process)
+log                     = out/log.$(Cluster)-$(Process)
+request_memory          = 1GB
 queue 1
diff --git a/docs/tutorials/multinode/circuit_q30.job b/docs/tutorials/multinode/circuit_q30.job
index a3819ecd..756295c7 100644
--- a/docs/tutorials/multinode/circuit_q30.job
+++ b/docs/tutorials/multinode/circuit_q30.job
@@ -4,8 +4,8 @@ arguments               = -c circuit_q30
 transfer_input_files    = ../../../circuits/circuit_q30
 should_transfer_files   = YES
 when_to_transfer_output = ON_EXIT
-output                  = out/out.$(Process)
-error                   = out/err.$(Process)
-log                     = out/log.$(Process)
-request_memory          = 340GB
+output                  = out/out.$(Cluster)-$(Process)
+error                   = out/err.$(Cluster)-$(Process)
+log                     = out/log.$(Cluster)-$(Process)
+request_memory          = 10GB
 queue 1
diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index b3f75fe2..f10d6b2a 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -1,7 +1,3 @@
-variable "bucket_name" {
-    type = string
-    default = ""
-}
 variable "cluster_name" {
     type = string
     default = "condor"
@@ -68,7 +64,6 @@ locals{
   compute_startup = templatefile(
     "${path.module}/startup-centos.sh", 
     {
-      "bucket_name" = var.bucket_name,
       "project" = var.project,
       "cluster_name" = var.cluster_name,
       "htserver_type" = "compute", 
@@ -79,7 +74,6 @@ locals{
   submit_startup = templatefile(
     "${path.module}/startup-centos.sh", 
     {
-      "bucket_name" = var.bucket_name,
       "project" = var.project,
       "cluster_name" = var.cluster_name,
       "htserver_type" = "submit", 
@@ -90,7 +84,6 @@ locals{
   manager_startup = templatefile(
     "${path.module}/startup-centos.sh", 
     {
-      "bucket_name" = var.bucket_name,
       "project" = var.project,
       "cluster_name" = var.cluster_name,
       "htserver_type" = "manager", 
@@ -291,28 +284,33 @@ resource "google_compute_instance_group_manager" "condor-compute-igm" {
   zone = var.zone
 }
 resource "google_compute_autoscaler" "condor-compute-as" {
+  name    = "${var.cluster_name}-compute-as"
+  project = var.project
+  target  = google_compute_instance_group_manager.condor-compute-igm.self_link
+  zone    = var.zone
+
   autoscaling_policy {
     cooldown_period = "60"
     max_replicas    = var.max_replicas
+    min_replicas = var.min_replicas
 
-    metric {
-      name   = "custom.googleapis.com/q0"
-      target = var.metric_target_queue
-      type   = "GAUGE"
-    }
-    metric {
-      name   = "custom.googleapis.com/la0"
-      target = var.metric_target_loadavg
-      type   = "GAUGE"
+    cpu_utilization {
+      target = 0.2
     }
 
-    min_replicas = var.min_replicas
+    # metric {
+    #   name   = "custom.googleapis.com/q0"
+    #   target = var.metric_target_queue
+    #   type   = "GAUGE"
+    # }
+    # metric {
+    #   name   = "custom.googleapis.com/la0"
+    #   target = var.metric_target_loadavg
+    #   type   = "GAUGE"
+    # }
+
   }
 
-  name    = "${var.cluster_name}-compute-as"
-  project = var.project
-  target  = google_compute_instance_group_manager.condor-compute-igm.self_link
-  zone    = var.zone
   timeouts {
     create = "60m"
     delete = "2h"
diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
index d532b02c..85a3b8b9 100644
--- a/docs/tutorials/multinode/terraform/main.tf
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -1,3 +1,9 @@
+variable "project" {
+  type=string
+}
+variable "zone" {
+  type=string
+}
 variable "cluster_name" {
   type = string
   default = "c"
@@ -8,12 +14,11 @@ variable "cluster_name" {
 module "htcondor" {
   source = "./htcondor/"
   cluster_name = var.cluster_name
+  project = var.project
+  zone = var.zone
   osversion = "7"
-  bucket_name = "quantum-hcondor-save"
-  zone="us-east4-c"
-  project="quantum-htcondor"
   max_replicas=20
   min_replicas=1
-  service_account="htcondor2@quantum-htcondor.iam.gserviceaccount.com"
-  use_preemptibles=true
+  service_account="htcondor@quantum-htcondor.iam.gserviceaccount.com"
+  use_preemptibles=false
 }
\ No newline at end of file

From 492bf1072d40463dad9b52e733860a58d1b90865 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Wed, 19 May 2021 21:38:43 +0000
Subject: [PATCH 009/246] Fix service account name.

---
 docs/tutorials/multinode/terraform/main.tf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
index 85a3b8b9..6ddf6cb1 100644
--- a/docs/tutorials/multinode/terraform/main.tf
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -19,6 +19,6 @@ module "htcondor" {
   osversion = "7"
   max_replicas=20
   min_replicas=1
-  service_account="htcondor@quantum-htcondor.iam.gserviceaccount.com"
+  service_account="htcondor@${var.project}.iam.gserviceaccount.com"
   use_preemptibles=false
 }
\ No newline at end of file

From 60ee232d95c23722f0463392f2676fe027edee23 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Thu, 20 May 2021 17:09:23 +0000
Subject: [PATCH 010/246] UPdate to docs.

---
 docs/tutorials/multinode/README.md            | 207 +++++++++++++++++-
 .../{circuit_q24.job => circuit_q24.sub}      |   0
 .../{circuit_q30.job => circuit_q30.sub}      |   0
 docs/tutorials/multinode/out/placeholder      |   0
 4 files changed, 197 insertions(+), 10 deletions(-)
 rename docs/tutorials/multinode/{circuit_q24.job => circuit_q24.sub} (100%)
 rename docs/tutorials/multinode/{circuit_q30.job => circuit_q30.sub} (100%)
 create mode 100644 docs/tutorials/multinode/out/placeholder

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index a2fc5a16..88c41206 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -51,15 +51,17 @@ With that completed, you can create a service account that will run the HTCondor
 ```
 gcloud iam service-accounts create htcondor
 ```
-Then give the 
+Then give the service accounts the permissions that will allow HTCondor to run correctly. 
 ```
 gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/iam.serviceAccountUser \
  --member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
 gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/compute.admin \
 --member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/monitoring.admin \
+--member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
 ```
 
-## Clone the repository
+## Clone the repository and build the cluster
 
 The `qsim` repository has all the code required to create the repository and to run the simulations.
 
@@ -74,17 +76,202 @@ The `qsim` repository has all the code required to create the repository and to
      terraform init
      make apply
      ```
-sudo journalctl -f -u google-startup-scripts.service
 
+This process will create 3 VMs instances and an autoscaling Managed Instance Group. To see the instances use the glcoud command in the Cloud Shell.
+```
+gcloud compute instances list
+```
+The output should be something like the output here:
+```
+NAME       ZONE        MACHINE_TYPE    PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP     STATUS
+c-8xlg     us-east4-c  n2-standard-16               10.150.0.21  34.86.120.132   RUNNING
+c-manager  us-east4-c  n2-standard-4                10.150.0.16  35.188.250.134  RUNNING
+c-submit   us-east4-c  n2-standard-4                10.150.0.17  35.245.189.252  RUNNING
+```
+
+The Mangaged Instance Group can be seen with gcloud.
+```
+gcloud compute instance-groups list
+```
+And the output like the following.
+```
+NAME  LOCATION    SCOPE  NETWORK  MANAGED  INSTANCES
+c     us-east4-c  zone   default  Yes      1
+```
+## Run a job on the cluster
+The next step is to run a job on the HTCondor cluster. Jobs are submitted on the `c-submit` VM instance known as the Submit Node in HTCondor. You connect to the Submit Node using gcloud SSH.
+```
+gcloud compute ssh c-submit
+```
+There will now be a prompt with something like `username@c-submit`.
+
+For convenience there is prepared HTCondor job submission files in the Github repo. To get these, 
+clone the repository on the Submit Node, and change to the tutorial directory.
+```
+     git clone https://github.com/jrossthomson/qsim.git
+     cd qsim/docs/tutorials/multinode
+```
+
+It is very likely that the HTCondor installation is not completely finished at this point: it takes several minutes. The `condor_status` command will tell you if the cluster is ready to run jobs. 
+
+```
+condor_status
+```
+The output from the command should resemble this.
+```
+Name                                           OpSys      Arch   State     Activity LoadAv Mem    ActvtyTime
+
+slot1@c-6klg.c.test-quantum-multinode.internal LINUX      X86_64 Unclaimed Idle      0.000 64263  0+00:19:33
+
+               Machines Owner Claimed Unclaimed Matched Preempting  Drain
+
+  X86_64/LINUX        1     0       0         1       0          0      0
+
+         Total        1     0       0         1       0          0      0
+```
+
+If  the output shows "Unclaimed" machines, you are ready to submit a job with HTCondor.
+
+```
+condor_submit circuit_q32.sub
+```
+There should be a response indicating the job was submitted.
+```
+Submitting job(s).
+1 job(s) submitted to cluster 1.
+```
+Now you can see if the job is running correctly.
+```
 condor_q
--- Schedd: c-submit.c.quantum-htcondor.internal : <10.150.15.206:9618?... @ 05/14/21 15:09:57
-OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
+```
+The output will be similar to the snippet below.
+```
+-- Schedd: c-submit.c.test-quantum-multinode.internal : <10.150.0.6:9618?... @ 05/20/21 15:04:24
+OWNER        BATCH_NAME    SUBMITTED   DONE   RUN    IDLE  TOTAL JOB_IDS
+jrossthomson ID: 1        5/20 15:04      _      1      _      1 1.0
 
-Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended 
-Total for jrossthomson: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended 
-Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+Total for query: 1 jobs; 0 completed, 0 removed, 0 idle, 1 running, 0 held, 0 suspended
+Total for jrossthomson: 1 jobs; 0 completed, 0 removed, 0 idle, 1 running, 0 held, 0 suspended
+Total for all users: 1 jobs; 0 completed, 0 removed, 0 idle, 1 running, 0 held, 0 suspended
+```
+When this is completed you should see output in the `out` directory.
+```
+ls out/
+err.1-0  log.1-0  out.1-0
+```
+The contents of `out.1-0` will have the content you are expecting from the simulation. This will take about 10 minutes to be complete.
+```
+cat out/out.1-0
+000:   -4.734056e-05   1.2809795e-05   2.4052194e-09
+001:  -3.6258607e-06   2.3642724e-07   1.3202764e-11
+010:  -2.9523137e-05    2.280164e-05   1.3915304e-09
+011:  -1.3954962e-05   9.4717652e-06   2.8445529e-10
+100:  -6.8555892e-06  -6.7632163e-07   4.7456514e-11
+101:  -2.0390624e-05   3.1813841e-05   1.4278979e-09
+110:   1.5711608e-05  -7.5214862e-06   3.0342737e-10
+111:   9.2345472e-06  -2.7716227e-05   8.5346613e-10
+```
+## Sumitting many jobs
+
+The job just submitted only ran a single instance of a qsim simulation. The main purpose of the present study is to
+run many (up to thousands of) simulations to provide a broad study with statistical significance.
+
+A simple way to submit many jobs is to use the `queue` command in the HTCondor. For this step edit the file `circuit_q30.sub`
+in your favorite editor, such as vim or nano. You will see the full submission file.
+```
+universe                = docker/jross
+
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
+arguments               = -c circuit_q30
+transfer_input_files    = ../../../circuits/circuit_q30
+should_transfer_files   = YES
+when_to_transfer_output = ON_EXIT
+output                  = out/out.$(Cluster)-$(Process)
+error                   = out/err.$(Cluster)-$(Process)
+log                     = out/log.$(Cluster)-$(Process)
+request_memory          = 10GB
+queue 1
+```
+The submission file is running the public qsim `docker image` from [QuantumAI](https://quantumai.google/qsim). 
+The command that is running utimately is running the `qsim` base executable.
+```
+qsim_base.x -c circuit_q30
+```
+This is achieved by running the _docker_image_ as listed with the `arguments` "-c circuit_q30". The 
+circuit file `circuit_q30` is transferred to the compute nodes via the `transfer_input_files` command. 
+
+> If you are interested
+> in an introduction to HTCondor in general, there is a 
+> [great introduction from CERN](https://indico.cern.ch/event/611296/contributions/2604376/attachments/1471164/2276521/TannenbaumT_UserTutorial.pdf). For details on job submission syntax there is a section of the [HTCondor Manual](https://htcondor.readthedocs.io/en/latest/users-manual/submitting-a-job.html) dedicated to this.
+
+To expand the simulation to run 20 instances of the docker image, the change required is to modify the `queue` command.
+```
+queue 20
+```
+Now when you run the `condor_submit` command, 
+```
+condor_submit circuit_q32.sub
+```
+20 jobs will be visible from the `condor_q` command.
+
+The really cool part is that now when you look at the list of VM instance you see that the system has 
+automatically scaled up the number of VM machines to support the 20 jobs you have requested to run, or as we normally refer to it,
+performs __autoscaling__.
+
+```
+gcloud compute instances list
+NAME       ZONE        MACHINE_TYPE    PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP     STATUS
+c-2q8w     us-east4-c  n2-standard-16               10.150.0.15  35.245.204.243  RUNNING
+c-40dz     us-east4-c  n2-standard-16               10.150.0.11  34.86.33.206    RUNNING
+c-4x4g     us-east4-c  n2-standard-16               10.150.0.14  35.245.201.254  RUNNING
+c-6klg     us-east4-c  n2-standard-16               10.150.0.8   34.86.161.51    RUNNING
+c-748q     us-east4-c  n2-standard-16               10.150.0.12  35.245.74.106   RUNNING
+c-dgt0     us-east4-c  n2-standard-16               10.150.0.13  34.86.102.113   RUNNING
+c-manager  us-east4-c  n2-standard-4                10.150.0.7   35.221.59.182   RUNNING
+c-submit   us-east4-c  n2-standard-4                10.150.0.6   35.245.203.14   RUNNING
+c-vdsz     us-east4-c  n2-standard-16               10.150.0.10  35.236.211.189  RUNNING
+c-x4bd     us-east4-c  n2-standard-16               10.150.0.9   34.86.246.195   RUNNING
+```
+
+When all these 20 jobs are complete, you can see the output in the `out` directory.
+```
+ls out/out.*
+out/out.2-0  out/out.2-10  out/out.2-12  out/out.2-14  out/out.2-16  out/out.2-18  out/out.2-2  out/out.2-4  out/out.2-6  out/out.2-8
+out/out.2-1  out/out.2-11  out/out.2-12  out/out.2-15  out/out.2-17  out/out.2-19  out/out.2-2  out/out.2-5  out/out.2-7  out/out.2-9
+
+```
+The output of the simulation is in these files.
 
+Finally, after the system has been idle for several minutes, you will see that the number of VM instances with autoscale 
+back to a single Compute Node, the  Manager Node and the Submit node. This helps to control costs by removing VMs when
+you do not need them.
 
-condor_submit .job
+## Next steps
+Further work here will allow you to run multiple simulations for different work. There are several things to look at.
+
+* Creating and running with your own container
+* Running with multiple input files
+* Selecting different configurations of the submit file
+
+## Cleaning up
+The easiest way to eliminate billing is to delete the Cloud project you created for the tutorial. Alternatively, 
+you can delete the individual resources.
+
+### Delete the project
+> __Caution:__ Deleting a project has the following effects:
+> Everything in the project is deleted. If you used an existing project for this tutorial, when you delete it, you also delete any other work you've done in the project.
+> Custom project IDs are lost. When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as an appspot.com URL, delete selected resources inside the project instead of deleting the whole project.
+
+1. In the Cloud Console, go to the Manage resources page.
+     > Go to [Manage resources](https://console.cloud.google.com/iam-admin/projects)
+
+1. In the project list, select the project that you want to delete, and then click Delete.
+1. In the dialog, type the project ID, and then click Shut down to delete the project.
+
+### Delete the Slurm cluster
+The second option is to delete the HTCondor cluster. In the `qsim/docs/tutorials/multinode/terraform` directory, run the make command.
+```
+     make destroy
+```
+This will remove the HTCondor cluster.
 
-condor_q -better-analyze JobId
diff --git a/docs/tutorials/multinode/circuit_q24.job b/docs/tutorials/multinode/circuit_q24.sub
similarity index 100%
rename from docs/tutorials/multinode/circuit_q24.job
rename to docs/tutorials/multinode/circuit_q24.sub
diff --git a/docs/tutorials/multinode/circuit_q30.job b/docs/tutorials/multinode/circuit_q30.sub
similarity index 100%
rename from docs/tutorials/multinode/circuit_q30.job
rename to docs/tutorials/multinode/circuit_q30.sub
diff --git a/docs/tutorials/multinode/out/placeholder b/docs/tutorials/multinode/out/placeholder
new file mode 100644
index 00000000..e69de29b

From fd7003f3d5ced04a1d40110325539dfcb13ce3e1 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Thu, 20 May 2021 17:17:40 +0000
Subject: [PATCH 011/246] Fixed typo

---
 docs/tutorials/multinode/README.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 88c41206..e960819f 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -1,5 +1,4 @@
-# To run a multinode quantum simulation
-s
+# Run a multinode quantum simulation
 ## Objectives
 
 * Use Terraform to deploy a HTCondor cluster

From aabb5983f26096c0c3093c982cace25dfe9ba25c Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Fri, 21 May 2021 18:14:55 +0000
Subject: [PATCH 012/246] added dentos7 as the os, losing HPC image

---
 docs/tutorials/multinode/terraform/htcondor/resources.tf      | 2 +-
 docs/tutorials/multinode/terraform/htcondor/startup-centos.sh | 2 +-
 docs/tutorials/multinode/terraform/main.tf                    | 2 ++
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index f10d6b2a..30c68824 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -16,7 +16,7 @@ variable "osimage" {
 }
 variable "osproject" {
   type = string
-  default = "click-to-deploy-images"
+  default = "cloud-hpc-image-public"
 }
 variable "condorversion" {
     type = string
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
index d883efa1..66220888 100644
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -22,7 +22,7 @@ CONDOR_REPO_URL=https://research.cs.wisc.edu/htcondor/yum/repo.d/htcondor-stable
 sleep 2 #Give it some time to setup yum
 cd /tmp
 yum update -y
-yum install -y wget curl net-tools vim gcc python3 
+yum install -y wget curl net-tools vim gcc python3 git
 wget https://research.cs.wisc.edu/htcondor/yum/RPM-GPG-KEY-HTCondor
 rpm --import RPM-GPG-KEY-HTCondor
 cd /etc/yum.repos.d && wget $CONDOR_REPO_URL
diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
index 6ddf6cb1..72ac2f8d 100644
--- a/docs/tutorials/multinode/terraform/main.tf
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -21,4 +21,6 @@ module "htcondor" {
   min_replicas=1
   service_account="htcondor@${var.project}.iam.gserviceaccount.com"
   use_preemptibles=false
+  osproject ="centos-cloud"
+  osimage ="centos-7"
 }
\ No newline at end of file

From f0b7d0e92d29d8bd3c75157bf57f5bbd881621e1 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 20 Jul 2021 10:28:46 -0700
Subject: [PATCH 013/246] Support noise model in simulator construction

---
 qsimcirq/qsim_simulator.py      | 40 ++++++++++++++++++++++++---------
 qsimcirq_tests/qsimcirq_test.py | 31 +++++++++++++++++++++++++
 2 files changed, 61 insertions(+), 10 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 886334c7..bb7e9e3c 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -16,7 +16,7 @@
 
 from cirq import (
     circuits,
-    linalg,
+    devices,
     ops,
     protocols,
     sim,
@@ -80,7 +80,10 @@ class QSimSimulator(
     SimulatesExpectationValues,
 ):
     def __init__(
-        self, qsim_options: dict = {}, seed: value.RANDOM_STATE_OR_SEED_LIKE = None
+        self,
+        qsim_options: dict = {},
+        seed: value.RANDOM_STATE_OR_SEED_LIKE = None,
+        noise: "devices.NOISE_MODEL_LIKE" = None,
     ):
         """Creates a new QSimSimulator using the given options and seed.
 
@@ -109,6 +112,7 @@ def __init__(
         self._prng = value.parse_random_state(seed)
         self.qsim_options = {"t": 1, "f": 2, "v": 0, "r": 1}
         self.qsim_options.update(qsim_options)
+        self.noise = devices.NoiseModel.from_noise_model_like(noise)
 
     def get_seed(self):
         # Limit seed size to 32-bit integer for C++ conversion.
@@ -160,8 +164,12 @@ def _sample_measure_results(
             ValueError: If there are multiple MeasurementGates with the same key,
                 or if repetitions is negative.
         """
-        if not isinstance(program, qsimc.QSimCircuit):
-            program = qsimc.QSimCircuit(program, device=program.device)
+
+        # Add noise to the circuit if a noise model was provided.
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, program.all_qubits()),
+            device=program.device,
+        )
 
         # Compute indices of measured qubits
         ordered_qubits = ops.QubitOrder.DEFAULT.order_for(program.all_qubits())
@@ -277,8 +285,12 @@ def compute_amplitudes_sweep(
         Returns:
             List of amplitudes.
         """
-        if not isinstance(program, qsimc.QSimCircuit):
-            program = qsimc.QSimCircuit(program, device=program.device)
+
+        # Add noise to the circuit if a noise model was provided.
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, program.all_qubits()),
+            device=program.device,
+        )
 
         # qsim numbers qubits in reverse order from cirq
         cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(
@@ -347,8 +359,12 @@ def simulate_sweep(
             initial_state = 0
         if not isinstance(initial_state, (int, np.ndarray)):
             raise TypeError("initial_state must be an int or state vector.")
-        if not isinstance(program, qsimc.QSimCircuit):
-            program = qsimc.QSimCircuit(program, device=program.device)
+
+        # Add noise to the circuit if a noise model was provided.
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, program.all_qubits()),
+            device=program.device,
+        )
 
         options = {}
         options.update(self.qsim_options)
@@ -476,8 +492,12 @@ def simulate_expectation_values_sweep(
             initial_state = 0
         if not isinstance(initial_state, (int, np.ndarray)):
             raise TypeError("initial_state must be an int or state vector.")
-        if not isinstance(program, qsimc.QSimCircuit):
-            program = qsimc.QSimCircuit(program, device=program.device)
+
+        # Add noise to the circuit if a noise model was provided.
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, program.all_qubits()),
+            device=program.device,
+        )
 
         options = {}
         options.update(self.qsim_options)
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 7766f017..5bf07c52 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -987,6 +987,37 @@ def test_noise_aggregation():
     assert cirq.approx_eq(qsim_evs, expected_evs, atol=0.05)
 
 
+def test_noise_model():
+    q0, q1 = cirq.LineQubit.range(2)
+
+    circuit = cirq.Circuit(cirq.X(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1, key="m"))
+    quiet_sim = qsimcirq.QSimSimulator()
+    quiet_results = quiet_sim.run(circuit, repetitions=100)
+    assert quiet_results.histogram(key="m")[0b11] == 100
+
+    class ReadoutError(cirq.NoiseModel):
+        def noisy_operation(self, operation: "cirq.Operation") -> "cirq.OP_TREE":
+            if isinstance(operation.gate, cirq.MeasurementGate):
+                return [cirq.X.on_each(*operation.qubits), operation]
+            return [operation]
+
+    noisy_sim = qsimcirq.QSimSimulator(noise=ReadoutError())
+    noisy_results = noisy_sim.run(circuit, repetitions=100)
+    # ReadoutError will flip both qubits.
+    assert noisy_results.histogram(key="m")[0b00] == 100
+
+    noisy_state = noisy_sim.simulate(circuit)
+    assert cirq.approx_eq(noisy_state.state_vector(), [1, 0, 0, 0])
+
+    obs = cirq.Z(q0) + cirq.Z(q1)
+    noisy_evs = noisy_sim.simulate_expectation_values(
+        circuit,
+        observables=obs,
+        permit_terminal_measurements=True,
+    )
+    assert noisy_evs == [2]
+
+
 def test_multi_qubit_fusion():
     q0, q1, q2, q3 = cirq.LineQubit.range(4)
     qubits = [q0, q1, q2, q3]

From a52578a07202f65b3d6b1565c14ea6455642efff Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 28 Jul 2021 09:57:46 -0700
Subject: [PATCH 014/246] sorted

---
 qsimcirq/qsim_simulator.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index bb7e9e3c..80196e7b 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -167,7 +167,7 @@ def _sample_measure_results(
 
         # Add noise to the circuit if a noise model was provided.
         program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, program.all_qubits()),
+            self.noise.noisy_moments(program, sorted(program.all_qubits())),
             device=program.device,
         )
 
@@ -288,7 +288,7 @@ def compute_amplitudes_sweep(
 
         # Add noise to the circuit if a noise model was provided.
         program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, program.all_qubits()),
+            self.noise.noisy_moments(program, sorted(program.all_qubits())),
             device=program.device,
         )
 
@@ -362,7 +362,7 @@ def simulate_sweep(
 
         # Add noise to the circuit if a noise model was provided.
         program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, program.all_qubits()),
+            self.noise.noisy_moments(program, sorted(program.all_qubits())),
             device=program.device,
         )
 
@@ -495,7 +495,7 @@ def simulate_expectation_values_sweep(
 
         # Add noise to the circuit if a noise model was provided.
         program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, program.all_qubits()),
+            self.noise.noisy_moments(program, sorted(program.all_qubits())),
             device=program.device,
         )
 

From ecd1c30e2b61e1b5b89f381e530c260e4a3742b6 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 4 Aug 2021 20:39:35 -0700
Subject: [PATCH 015/246] CpuFactory

---
 pybind_interface/pybind_main.cpp | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 37e6a20e..962e8eac 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -36,8 +36,8 @@ using namespace qsim;
 
 namespace {
 
-struct Factory {
-  Factory(unsigned num_threads) : num_threads(num_threads) {}
+struct CpuFactory {
+  CpuFactory(unsigned num_threads) : num_threads(num_threads) {}
 
   using Simulator = qsim::Simulator<For>;
   using StateSpace = Simulator::StateSpace;
@@ -380,6 +380,7 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
     return {};
   }
 
+  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -427,7 +428,8 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
     return {};
   }
 
-  using Simulator = qsim::Simulator<For>;
+  using Factory = CpuFactory;
+  using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
 
@@ -475,6 +477,7 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
 // Helper class for simulating circuits of all types.
 class SimulatorHelper {
  public:
+  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -738,6 +741,7 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
     return {};
   }
 
+  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -784,6 +788,7 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
     return {};
   }
 
+  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;

From a1413ac2905b2f6deb2538872092ef9a215f1319 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 4 Aug 2021 21:24:33 -0700
Subject: [PATCH 016/246] Update factory and move to subtypes

---
 pybind_interface/avx2/pybind_main_avx2.cpp    | 20 +++++++
 .../avx512/pybind_main_avx512.cpp             | 20 +++++++
 pybind_interface/basic/pybind_main_basic.cpp  | 20 +++++++
 pybind_interface/pybind_main.cpp              | 60 ++++++++-----------
 pybind_interface/sse/pybind_main_sse.cpp      | 20 +++++++
 5 files changed, 105 insertions(+), 35 deletions(-)

diff --git a/pybind_interface/avx2/pybind_main_avx2.cpp b/pybind_interface/avx2/pybind_main_avx2.cpp
index 29e5e81f..30a9e6ba 100644
--- a/pybind_interface/avx2/pybind_main_avx2.cpp
+++ b/pybind_interface/avx2/pybind_main_avx2.cpp
@@ -14,11 +14,31 @@
 
 #include "pybind_main_avx2.h"
 
+#include "../../lib/formux.h"
 #include "../../lib/simulator_avx.h"
 
 namespace qsim {
   template <typename For>
   using Simulator = SimulatorAVX<For>;
+
+  struct Factory {
+    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    Factory(unsigned num_threads, unsigned num_dblocks)
+      : num_threads(num_threads) {}
+
+    using Simulator = qsim::Simulator<For>;
+    using StateSpace = Simulator::StateSpace;
+
+    StateSpace CreateStateSpace() const {
+      return StateSpace(num_threads);
+    }
+
+    Simulator CreateSimulator() const {
+      return Simulator(num_threads);
+    }
+
+    unsigned num_threads;
+  };
 }
 
 #include "../pybind_main.cpp"
diff --git a/pybind_interface/avx512/pybind_main_avx512.cpp b/pybind_interface/avx512/pybind_main_avx512.cpp
index 97c50117..298ae2df 100644
--- a/pybind_interface/avx512/pybind_main_avx512.cpp
+++ b/pybind_interface/avx512/pybind_main_avx512.cpp
@@ -14,11 +14,31 @@
 
 #include "pybind_main_avx512.h"
 
+#include "../../lib/formux.h"
 #include "../../lib/simulator_avx512.h"
 
 namespace qsim {
   template <typename For>
   using Simulator = SimulatorAVX512<For>;
+
+  struct Factory {
+    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    Factory(unsigned num_threads, unsigned num_dblocks)
+      : num_threads(num_threads) {}
+
+    using Simulator = qsim::Simulator<For>;
+    using StateSpace = Simulator::StateSpace;
+
+    StateSpace CreateStateSpace() const {
+      return StateSpace(num_threads);
+    }
+
+    Simulator CreateSimulator() const {
+      return Simulator(num_threads);
+    }
+
+    unsigned num_threads;
+  };
 }
 
 #include "../pybind_main.cpp"
diff --git a/pybind_interface/basic/pybind_main_basic.cpp b/pybind_interface/basic/pybind_main_basic.cpp
index afeba392..0644cf04 100644
--- a/pybind_interface/basic/pybind_main_basic.cpp
+++ b/pybind_interface/basic/pybind_main_basic.cpp
@@ -14,11 +14,31 @@
 
 #include "pybind_main_basic.h"
 
+#include "../../lib/formux.h"
 #include "../../lib/simulator_basic.h"
 
 namespace qsim {
   template <typename For>
   using Simulator = SimulatorBasic<For>;
+
+  struct Factory {
+    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    Factory(unsigned num_threads, unsigned num_dblocks)
+      : num_threads(num_threads) {}
+
+    using Simulator = qsim::Simulator<For>;
+    using StateSpace = Simulator::StateSpace;
+
+    StateSpace CreateStateSpace() const {
+      return StateSpace(num_threads);
+    }
+
+    Simulator CreateSimulator() const {
+      return Simulator(num_threads);
+    }
+
+    unsigned num_threads;
+  };
 }
 
 #include "../pybind_main.cpp"
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 962e8eac..070c0f45 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -36,23 +36,6 @@ using namespace qsim;
 
 namespace {
 
-struct CpuFactory {
-  CpuFactory(unsigned num_threads) : num_threads(num_threads) {}
-
-  using Simulator = qsim::Simulator<For>;
-  using StateSpace = Simulator::StateSpace;
-
-  StateSpace CreateStateSpace() const {
-    return StateSpace(num_threads);
-  }
-
-  Simulator CreateSimulator() const {
-    return Simulator(num_threads);
-  }
-
-  unsigned num_threads;
-};
-
 template <typename T>
 T parseOptions(const py::dict &options, const char *key) {
   if (!options.contains(key)) {
@@ -380,7 +363,6 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
     return {};
   }
 
-  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -401,9 +383,11 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
                             Factory>;
 
   unsigned num_threads;
+  unsigned num_dblocks;
   Runner::Parameter param;
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
+    num_dblocks = 1;
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     param.seed = parseOptions<unsigned>(options, "s\0");
@@ -411,7 +395,7 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
     IO::errorf(exp.what());
     return {};
   }
-  Runner::Run(param, Factory(num_threads), circuit, measure);
+  Runner::Run(param, Factory(num_threads, num_dblocks), circuit, measure);
   return amplitudes;
 }
 
@@ -428,7 +412,6 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
     return {};
   }
 
-  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -443,10 +426,12 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
 
   Runner::Parameter param;
   unsigned num_threads;
+  unsigned num_dblocks;
   uint64_t seed;
 
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
+    num_dblocks = 1;
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     seed = parseOptions<unsigned>(options, "s\0");
@@ -455,8 +440,8 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
     return {};
   }
 
-  Simulator simulator = Factory(num_threads).CreateSimulator();
-  StateSpace state_space = Factory(num_threads).CreateStateSpace();
+  Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
+  StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
 
   auto measure = [&bitstrings, &ncircuit, &amplitudes, &state_space](
                   unsigned k, const State &state,
@@ -477,7 +462,6 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
 // Helper class for simulating circuits of all types.
 class SimulatorHelper {
  public:
-  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -538,7 +522,8 @@ class SimulatorHelper {
 
  private:
   SimulatorHelper(const py::dict &options, bool noisy)
-      : state_space(Factory(1).CreateStateSpace()), state(StateSpace::Null()),
+      : state_space(Factory(1, 1).CreateStateSpace()),
+        state(StateSpace::Null()),
         scratch(StateSpace::Null()) {
     is_valid = false;
     is_noisy = noisy;
@@ -552,11 +537,12 @@ class SimulatorHelper {
         num_qubits = circuit.num_qubits;
       }
       num_threads = parseOptions<unsigned>(options, "t\0");
+      num_dblocks = 1;
       max_fused_size = parseOptions<unsigned>(options, "f\0");
       verbosity = parseOptions<unsigned>(options, "v\0");
       seed = parseOptions<unsigned>(options, "s\0");
 
-      state_space = Factory(num_threads).CreateStateSpace();
+      state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
       state = state_space.Create(num_qubits);
       is_valid = true;
     } catch (const std::invalid_argument &exp) {
@@ -603,13 +589,14 @@ class SimulatorHelper {
       std::vector<uint64_t> stat;
       auto params = get_noisy_params();
 
-      Simulator simulator = Factory(num_threads).CreateSimulator();
-      StateSpace state_space = Factory(num_threads).CreateStateSpace();
+      Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
+      StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
 
       result = NoisyRunner::RunOnce(params, ncircuit, seed, state_space,
                                     simulator, scratch, state, stat);
     } else {
-      result = Runner::Run(get_params(), Factory(num_threads), circuit, state);
+      result = Runner::Run(
+        get_params(), Factory(num_threads, num_dblocks), circuit, state);
     }
     seed += 1;
     return result;
@@ -627,7 +614,7 @@ class SimulatorHelper {
   std::vector<std::complex<double>> get_expectation_value(
       const std::vector<std::tuple<std::vector<OpString<Gate>>,
                                    unsigned>>& opsums_and_qubit_counts) {
-    Simulator simulator = Factory(num_threads).CreateSimulator();
+    Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
     using Fuser = MultiQubitGateFuser<IO, Gate>;
 
     std::vector<std::complex<double>> results;
@@ -657,6 +644,7 @@ class SimulatorHelper {
 
   unsigned num_qubits;
   unsigned num_threads;
+  unsigned num_dblocks;
   unsigned noisy_reps;
   unsigned max_fused_size;
   unsigned verbosity;
@@ -741,7 +729,6 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
     return {};
   }
 
-  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -750,9 +737,11 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
                             Factory>;
 
   unsigned num_threads;
+  unsigned num_dblocks;
   Runner::Parameter param;
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
+    num_dblocks = 1;
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     param.seed = parseOptions<unsigned>(options, "s\0");
@@ -762,11 +751,11 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
   }
 
   std::vector<MeasurementResult> results;
-  StateSpace state_space = Factory(num_threads).CreateStateSpace();
+  StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
   State state = state_space.Create(circuit.num_qubits);
   state_space.SetStateZero(state);
 
-  if (!Runner::Run(param, Factory(num_threads), circuit, state, results)) {
+  if (!Runner::Run(param, Factory(num_threads, num_dblocks), circuit, state, results)) {
     IO::errorf("qsim sampling of the circuit errored out.\n");
     return {};
   }
@@ -788,7 +777,6 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
     return {};
   }
 
-  using Factory = CpuFactory;
   using Simulator = Factory::Simulator;
   using StateSpace = Simulator::StateSpace;
   using State = StateSpace::State;
@@ -798,10 +786,12 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
 
   Runner::Parameter param;
   unsigned num_threads;
+  unsigned num_dblocks;
   uint64_t seed;
 
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
+    num_dblocks = 1;
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     seed = parseOptions<unsigned>(options, "s\0");
@@ -811,8 +801,8 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
     return {};
   }
 
-  Simulator simulator = Factory(num_threads).CreateSimulator();
-  StateSpace state_space = Factory(num_threads).CreateStateSpace();
+  Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
+  StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
 
   std::vector<std::vector<unsigned>> results;
 
diff --git a/pybind_interface/sse/pybind_main_sse.cpp b/pybind_interface/sse/pybind_main_sse.cpp
index 0ff8c731..b69b44fc 100644
--- a/pybind_interface/sse/pybind_main_sse.cpp
+++ b/pybind_interface/sse/pybind_main_sse.cpp
@@ -14,11 +14,31 @@
 
 #include "pybind_main_sse.h"
 
+#include "../../lib/formux.h"
 #include "../../lib/simulator_sse.h"
 
 namespace qsim {
   template <typename For>
   using Simulator = SimulatorSSE<For>;
+
+  struct Factory {
+    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    Factory(unsigned num_threads, unsigned num_dblocks)
+      : num_threads(num_threads) {}
+
+    using Simulator = qsim::Simulator<For>;
+    using StateSpace = Simulator::StateSpace;
+
+    StateSpace CreateStateSpace() const {
+      return StateSpace(num_threads);
+    }
+
+    Simulator CreateSimulator() const {
+      return Simulator(num_threads);
+    }
+
+    unsigned num_threads;
+  };
 }
 
 #include "../pybind_main.cpp"

From e80f363e3cc6a6a5cded3b5476e60ba34068bf90 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 4 Aug 2021 21:39:37 -0700
Subject: [PATCH 017/246] Baseline CUDA test.

---
 pybind_interface/Makefile                     |  6 +++
 pybind_interface/avx2/pybind_main_avx2.cpp    |  2 +-
 .../avx512/pybind_main_avx512.cpp             |  2 +-
 pybind_interface/basic/pybind_main_basic.cpp  |  2 +-
 pybind_interface/cuda/CMakeLists.txt          | 29 +++++++++++++
 pybind_interface/cuda/pybind_main_cuda.cu     | 43 +++++++++++++++++++
 pybind_interface/cuda/pybind_main_cuda.h      | 17 ++++++++
 pybind_interface/decide/decide.cpp            |  8 ++++
 pybind_interface/sse/pybind_main_sse.cpp      |  2 +-
 qsimcirq/__init__.py                          | 10 +++++
 qsimcirq_tests/qsimcirq_test.py               | 18 ++++++++
 11 files changed, 135 insertions(+), 4 deletions(-)
 create mode 100644 pybind_interface/cuda/CMakeLists.txt
 create mode 100644 pybind_interface/cuda/pybind_main_cuda.cu
 create mode 100644 pybind_interface/cuda/pybind_main_cuda.h

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index 8e48ff57..a8cdba49 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -3,6 +3,7 @@ QSIMLIB_BASIC = ../qsimcirq/qsim_basic`python3-config --extension-suffix`
 QSIMLIB_SSE = ../qsimcirq/qsim_sse`python3-config --extension-suffix`
 QSIMLIB_AVX2 = ../qsimcirq/qsim_avx2`python3-config --extension-suffix`
 QSIMLIB_AVX512 = ../qsimcirq/qsim_avx512`python3-config --extension-suffix`
+QSIMLIB_CUDA = ../qsimcirq/qsim_cuda`python3-config --extension-suffix`
 QSIMLIB_DECIDE = ../qsimcirq/qsim_decide`python3-config --extension-suffix`
 
 
@@ -12,12 +13,16 @@ PYBINDFLAGS_SSE = -msse4.1 -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 -
 PYBINDFLAGS_AVX2 = -mavx2 -mfma -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 
+# The flags for the compilation of GPU-specific Pybind11 interfaces
+PYBINDFLAGS_CUDA = -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
+
 .PHONY: pybind
 pybind:
 	$(CXX) basic/pybind_main_basic.cpp -o $(QSIMLIB_BASIC) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
 	$(CXX) sse/pybind_main_sse.cpp -o $(QSIMLIB_SSE) $(CXXFLAGS) $(PYBINDFLAGS_SSE)
 	$(CXX) avx2/pybind_main_avx2.cpp -o $(QSIMLIB_AVX2) $(CXXFLAGS) $(PYBINDFLAGS_AVX2)
 	$(CXX) avx512/pybind_main_avx512.cpp -o $(QSIMLIB_AVX512) $(CXXFLAGS) $(PYBINDFLAGS_AVX512)
+	$(NVCC) cuda/pybind_main_cuda.cpp -o $(QSIMLIB_CUDA) $(NVCCFLAGS) -Xcompiler "$(PYBINDFLAGS_CUDA)"
 	$(CXX) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
 
 .PHONY: clean
@@ -26,4 +31,5 @@ clean:
 	-rm -f ./sse/*.x ./sse/*.a ./sse/*.so ./sse/*.mod $(QSIMLIB_SSE)
 	-rm -f ./avx2/*.x ./avx2/*.a ./avx2/*.so ./avx2/*.mod $(QSIMLIB_AVX2)
 	-rm -f ./avx512/*.x ./avx512/*.a ./avx512/*.so ./avx512/*.mod $(QSIMLIB_AVX512)
+	-rm -f ./cuda/*.x ./cuda/*.a ./cuda/*.so ./cuda/*.mod $(QSIMLIB_CUDA)
 	-rm -f ./decide/*.x ./decide/*.a ./decide/*.so ./decide/*.mod $(QSIMLIB_DECIDE)
diff --git a/pybind_interface/avx2/pybind_main_avx2.cpp b/pybind_interface/avx2/pybind_main_avx2.cpp
index 30a9e6ba..54ad2d30 100644
--- a/pybind_interface/avx2/pybind_main_avx2.cpp
+++ b/pybind_interface/avx2/pybind_main_avx2.cpp
@@ -22,7 +22,7 @@ namespace qsim {
   using Simulator = SimulatorAVX<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    // num_dblocks is unused, but kept for consistency with GPU version.
     Factory(unsigned num_threads, unsigned num_dblocks)
       : num_threads(num_threads) {}
 
diff --git a/pybind_interface/avx512/pybind_main_avx512.cpp b/pybind_interface/avx512/pybind_main_avx512.cpp
index 298ae2df..996de2c6 100644
--- a/pybind_interface/avx512/pybind_main_avx512.cpp
+++ b/pybind_interface/avx512/pybind_main_avx512.cpp
@@ -22,7 +22,7 @@ namespace qsim {
   using Simulator = SimulatorAVX512<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    // num_dblocks is unused, but kept for consistency with GPU version.
     Factory(unsigned num_threads, unsigned num_dblocks)
       : num_threads(num_threads) {}
 
diff --git a/pybind_interface/basic/pybind_main_basic.cpp b/pybind_interface/basic/pybind_main_basic.cpp
index 0644cf04..244688b5 100644
--- a/pybind_interface/basic/pybind_main_basic.cpp
+++ b/pybind_interface/basic/pybind_main_basic.cpp
@@ -22,7 +22,7 @@ namespace qsim {
   using Simulator = SimulatorBasic<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    // num_dblocks is unused, but kept for consistency with GPU version.
     Factory(unsigned num_threads, unsigned num_dblocks)
       : num_threads(num_threads) {}
 
diff --git a/pybind_interface/cuda/CMakeLists.txt b/pybind_interface/cuda/CMakeLists.txt
new file mode 100644
index 00000000..75e23fbb
--- /dev/null
+++ b/pybind_interface/cuda/CMakeLists.txt
@@ -0,0 +1,29 @@
+cmake_minimum_required(VERSION 3.11)
+project(qsim)
+
+IF (WIN32)
+    set(CMAKE_CXX_FLAGS "/O2 /openmp")
+ELSE()
+    set(CMAKE_CXX_FLAGS "-O3 -fopenmp")
+ENDIF()
+
+
+if(APPLE)
+    set(CMAKE_CXX_STANDARD 14)
+    include_directories("/usr/local/include" "/usr/local/opt/llvm/include")
+    link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
+endif()
+
+include(FetchContent)
+
+FetchContent_Declare(
+  pybind11
+  GIT_REPOSITORY https://github.com/pybind/pybind11
+  GIT_TAG v2.2.4
+)
+FetchContent_GetProperties(pybind11)
+if(NOT pybind11_POPULATED)
+  FetchContent_Populate(pybind11)
+  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
+endif()
+pybind11_add_module(qsim_cuda pybind_main_cuda.cpp)
diff --git a/pybind_interface/cuda/pybind_main_cuda.cu b/pybind_interface/cuda/pybind_main_cuda.cu
new file mode 100644
index 00000000..4fec9761
--- /dev/null
+++ b/pybind_interface/cuda/pybind_main_cuda.cu
@@ -0,0 +1,43 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include "pybind_main_cuda.h"
+
+#include "../../lib/simulator_cuda.h"
+
+namespace qsim {
+  template <typename For>
+  using Simulator = SimulatorCUDA<float>;
+
+  struct Factory {
+    using Simulator = qsim::Simulator;
+    using StateSpace = Simulator::StateSpace;
+
+    Factory(unsigned num_threads, unsigned num_dblocks)
+      : ss_params(num_threads, num_dblocks), sim_params(num_threads) {}
+
+    StateSpace CreateStateSpace() const {
+      return StateSpace(ss_params);
+    }
+
+    Simulator CreateSimulator() const {
+      return Simulator(sim_params);
+    }
+
+    const StateSpace::Parameter ss_params;
+    const Simulator::Parameter sim_params;
+  };
+}
+
+#include "../pybind_main.cpp"
diff --git a/pybind_interface/cuda/pybind_main_cuda.h b/pybind_interface/cuda/pybind_main_cuda.h
new file mode 100644
index 00000000..f6f463f5
--- /dev/null
+++ b/pybind_interface/cuda/pybind_main_cuda.h
@@ -0,0 +1,17 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include "../pybind_main.h"
+
+PYBIND11_MODULE(qsim_basic, m) { MODULE_BINDINGS }
diff --git a/pybind_interface/decide/decide.cpp b/pybind_interface/decide/decide.cpp
index 2fb41848..6b8b8776 100644
--- a/pybind_interface/decide/decide.cpp
+++ b/pybind_interface/decide/decide.cpp
@@ -45,6 +45,14 @@ int detect_instructions() {
   return static_cast<int>(instr);
 }
 
+enum GPUCapabilities { CUDA = 0, NO_GPU = 10 };
+
+int detect_gpu() {
+  // TODO: detect non-CUDA
+  GPUCapabilities gpu = CUDA;
+  return gpu;
+}
+
 PYBIND11_MODULE(qsim_decide, m) {
   m.doc() = "pybind11 plugin";  // optional module docstring
 
diff --git a/pybind_interface/sse/pybind_main_sse.cpp b/pybind_interface/sse/pybind_main_sse.cpp
index b69b44fc..21490f68 100644
--- a/pybind_interface/sse/pybind_main_sse.cpp
+++ b/pybind_interface/sse/pybind_main_sse.cpp
@@ -22,7 +22,7 @@ namespace qsim {
   using Simulator = SimulatorSSE<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GpuFactory.
+    // num_dblocks is unused, but kept for consistency with GPU version.
     Factory(unsigned num_threads, unsigned num_dblocks)
       : num_threads(num_threads) {}
 
diff --git a/qsimcirq/__init__.py b/qsimcirq/__init__.py
index d0518841..687d899a 100644
--- a/qsimcirq/__init__.py
+++ b/qsimcirq/__init__.py
@@ -15,7 +15,17 @@ def _load_simd_qsim():
     return qsim
 
 
+def _load_qsim_gpu():
+    instr = qsim_decide.detect_gpu()
+    if instr == 0:
+        qsim_gpu = importlib.import_module("qsimcirq.qsim_cuda")
+    else:
+        qsim_gpu = None
+    return qsim_gpu
+
+
 qsim = _load_simd_qsim()
+qsim_gpu = _load_qsim_gpu()
 
 from .qsim_circuit import add_op_to_opstring, add_op_to_circuit, QSimCircuit
 from .qsim_simulator import QSimSimulatorState, QSimSimulatorTrialResult, QSimSimulator
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 144fce5f..ba72935f 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1062,6 +1062,24 @@ def test_cirq_qsimh_simulate():
     assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
 
 
+def test_cirq_qsim_gpu_simulate():
+    # Dummy test.
+    print(qsimcirq.qsim_gpu)
+    assert False
+    # # Pick qubits.
+    # a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # # Create a circuit
+    # cirq_circuit = cirq.Circuit(cirq.CNOT(a, b), cirq.CNOT(b, a), cirq.X(a))
+
+    # qsimh_options = {"k": [0], "w": 0, "p": 1, "r": 1}
+    # qsimhSim = qsimcirq.QSimhSimulator(qsimh_options)
+    # result = qsimhSim.compute_amplitudes(
+    #     cirq_circuit, bitstrings=[0b00, 0b01, 0b10, 0b11]
+    # )
+    # assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
+
+
 def test_cirq_qsim_params():
     qubit = cirq.GridQubit(0, 0)
 

From 2a0a1a688fa7b03d83f33e8aa98f639da60b4fe4 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 5 Aug 2021 07:53:17 -0700
Subject: [PATCH 018/246] Test patches

---
 .../cuda/{pybind_main_cuda.cu => pybind_main_cuda.cpp}         | 0
 pybind_interface/cuda/pybind_main_cuda.h                       | 2 +-
 pybind_interface/decide/decide.cpp                             | 3 +++
 3 files changed, 4 insertions(+), 1 deletion(-)
 rename pybind_interface/cuda/{pybind_main_cuda.cu => pybind_main_cuda.cpp} (100%)

diff --git a/pybind_interface/cuda/pybind_main_cuda.cu b/pybind_interface/cuda/pybind_main_cuda.cpp
similarity index 100%
rename from pybind_interface/cuda/pybind_main_cuda.cu
rename to pybind_interface/cuda/pybind_main_cuda.cpp
diff --git a/pybind_interface/cuda/pybind_main_cuda.h b/pybind_interface/cuda/pybind_main_cuda.h
index f6f463f5..d7b2a2a2 100644
--- a/pybind_interface/cuda/pybind_main_cuda.h
+++ b/pybind_interface/cuda/pybind_main_cuda.h
@@ -14,4 +14,4 @@
 
 #include "../pybind_main.h"
 
-PYBIND11_MODULE(qsim_basic, m) { MODULE_BINDINGS }
+PYBIND11_MODULE(qsim_cuda, m) { MODULE_BINDINGS }
diff --git a/pybind_interface/decide/decide.cpp b/pybind_interface/decide/decide.cpp
index 6b8b8776..1355b11c 100644
--- a/pybind_interface/decide/decide.cpp
+++ b/pybind_interface/decide/decide.cpp
@@ -58,4 +58,7 @@ PYBIND11_MODULE(qsim_decide, m) {
 
   // Methods for returning amplitudes
   m.def("detect_instructions", &detect_instructions, "Detect SIMD");
+
+  // Detect available GPUs.
+  m.def("detect_gpu", &detect_gpu, "Detect GPU");
 }

From 2f3a585afcab57a9e1098484d1288594c8343763 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 5 Aug 2021 10:35:28 -0700
Subject: [PATCH 019/246] Minor issues.

---
 pybind_interface/Makefile                  | 4 ++--
 pybind_interface/cuda/pybind_main_cuda.cpp | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index a8cdba49..9c9bb6a9 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -11,7 +11,7 @@ QSIMLIB_DECIDE = ../qsimcirq/qsim_decide`python3-config --extension-suffix`
 PYBINDFLAGS_BASIC = -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_SSE = -msse4.1 -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_AVX2 = -mavx2 -mfma -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
-PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
+PYBINDFLAGS_AVX512 = -std=c++17 -Xcompiler "-mavx512f -Wall -shared -fPIC `python3 -m pybind11 --includes`"
 
 # The flags for the compilation of GPU-specific Pybind11 interfaces
 PYBINDFLAGS_CUDA = -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
@@ -22,7 +22,7 @@ pybind:
 	$(CXX) sse/pybind_main_sse.cpp -o $(QSIMLIB_SSE) $(CXXFLAGS) $(PYBINDFLAGS_SSE)
 	$(CXX) avx2/pybind_main_avx2.cpp -o $(QSIMLIB_AVX2) $(CXXFLAGS) $(PYBINDFLAGS_AVX2)
 	$(CXX) avx512/pybind_main_avx512.cpp -o $(QSIMLIB_AVX512) $(CXXFLAGS) $(PYBINDFLAGS_AVX512)
-	$(NVCC) cuda/pybind_main_cuda.cpp -o $(QSIMLIB_CUDA) $(NVCCFLAGS) -Xcompiler "$(PYBINDFLAGS_CUDA)"
+	$(NVCC) cuda/pybind_main_cuda.cpp -o $(QSIMLIB_CUDA) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA)
 	$(CXX) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
 
 .PHONY: clean
diff --git a/pybind_interface/cuda/pybind_main_cuda.cpp b/pybind_interface/cuda/pybind_main_cuda.cpp
index 4fec9761..b55d0d65 100644
--- a/pybind_interface/cuda/pybind_main_cuda.cpp
+++ b/pybind_interface/cuda/pybind_main_cuda.cpp
@@ -17,7 +17,6 @@
 #include "../../lib/simulator_cuda.h"
 
 namespace qsim {
-  template <typename For>
   using Simulator = SimulatorCUDA<float>;
 
   struct Factory {
@@ -25,7 +24,7 @@ namespace qsim {
     using StateSpace = Simulator::StateSpace;
 
     Factory(unsigned num_threads, unsigned num_dblocks)
-      : ss_params(num_threads, num_dblocks), sim_params(num_threads) {}
+      : ss_params{num_threads, num_dblocks}, sim_params{num_threads} {}
 
     StateSpace CreateStateSpace() const {
       return StateSpace(ss_params);

From 7d6d0cb70c102bc9e5a2f8260d41f1dd6c62774f Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 5 Aug 2021 10:46:59 -0700
Subject: [PATCH 020/246] Xcompiler is for CUDA

---
 pybind_interface/Makefile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index 9c9bb6a9..cbce2141 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -11,10 +11,10 @@ QSIMLIB_DECIDE = ../qsimcirq/qsim_decide`python3-config --extension-suffix`
 PYBINDFLAGS_BASIC = -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_SSE = -msse4.1 -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_AVX2 = -mavx2 -mfma -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
-PYBINDFLAGS_AVX512 = -std=c++17 -Xcompiler "-mavx512f -Wall -shared -fPIC `python3 -m pybind11 --includes`"
+PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 
 # The flags for the compilation of GPU-specific Pybind11 interfaces
-PYBINDFLAGS_CUDA = -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
+PYBINDFLAGS_CUDA = -std=c++17 -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
 
 .PHONY: pybind
 pybind:

From bbe5b583a4bcbf3cfc4c44368ca3f0e8ea765051 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 6 Aug 2021 09:14:19 -0700
Subject: [PATCH 021/246] Compile CUDA as CUDA

---
 pybind_interface/Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index cbce2141..89ea0607 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -14,7 +14,7 @@ PYBINDFLAGS_AVX2 = -mavx2 -mfma -Wall -shared -std=c++17 -fPIC `python3 -m pybin
 PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 
 # The flags for the compilation of GPU-specific Pybind11 interfaces
-PYBINDFLAGS_CUDA = -std=c++17 -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
+PYBINDFLAGS_CUDA = -std=c++17 -x cu -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
 
 .PHONY: pybind
 pybind:

From 173171a32575ddb7e274293d2cbfc3ba11c99b29 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 6 Aug 2021 09:34:01 -0700
Subject: [PATCH 022/246] Split GPU module bindings.

---
 pybind_interface/cuda/pybind_main_cuda.h |  2 +-
 pybind_interface/pybind_main.h           | 93 ++++++++++++++++++++++++
 2 files changed, 94 insertions(+), 1 deletion(-)

diff --git a/pybind_interface/cuda/pybind_main_cuda.h b/pybind_interface/cuda/pybind_main_cuda.h
index d7b2a2a2..b5b5979f 100644
--- a/pybind_interface/cuda/pybind_main_cuda.h
+++ b/pybind_interface/cuda/pybind_main_cuda.h
@@ -14,4 +14,4 @@
 
 #include "../pybind_main.h"
 
-PYBIND11_MODULE(qsim_cuda, m) { MODULE_BINDINGS }
+PYBIND11_MODULE(qsim_cuda, m) { GPU_MODULE_BINDINGS }
diff --git a/pybind_interface/pybind_main.h b/pybind_interface/pybind_main.h
index 8de3d455..c1ce850e 100644
--- a/pybind_interface/pybind_main.h
+++ b/pybind_interface/pybind_main.h
@@ -293,4 +293,97 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
                                                                                       \
       m.def("add_gate_to_opstring", &add_gate_to_opstring,                            \
             "Adds a gate to the given opstring.");
+
+#define GPU_MODULE_BINDINGS                                                                  \
+      m.doc() = "pybind11 plugin";  /* optional module docstring */                   \
+      /* Methods for returning amplitudes */                                          \
+      m.def("qsim_simulate", &qsim_simulate, "Call the qsim simulator");              \
+      m.def("qtrajectory_simulate", &qtrajectory_simulate,                            \
+            "Call the qtrajectory simulator");                                        \
+                                                                                      \
+      /* Methods for returning full state */                                          \
+      m.def("qsim_simulate_fullstate",                                                \
+            static_cast<py::array_t<float>(*)(const py::dict&, uint64_t)>(            \
+                &qsim_simulate_fullstate),                                            \
+            "Call the qsim simulator for full state vector simulation");              \
+      m.def("qsim_simulate_fullstate",                                                \
+            static_cast<py::array_t<float>(*)(const py::dict&,                        \
+                                              const py::array_t<float>&)>(            \
+                &qsim_simulate_fullstate),                                            \
+            "Call the qsim simulator for full state vector simulation");              \
+                                                                                      \
+      m.def("qtrajectory_simulate_fullstate",                                         \
+            static_cast<py::array_t<float>(*)(const py::dict&, uint64_t)>(            \
+                &qtrajectory_simulate_fullstate),                                     \
+            "Call the qtrajectory simulator for full state vector simulation");       \
+      m.def("qtrajectory_simulate_fullstate",                                         \
+            static_cast<py::array_t<float>(*)(const py::dict&,                        \
+                                              const py::array_t<float>&)>(            \
+                &qtrajectory_simulate_fullstate),                                     \
+            "Call the qtrajectory simulator for full state vector simulation");       \
+                                                                                      \
+      /* Methods for returning samples */                                             \
+      m.def("qsim_sample", &qsim_sample, "Call the qsim sampler");                    \
+      m.def("qtrajectory_sample", &qtrajectory_sample,                                \
+            "Call the qtrajectory sampler");                                          \
+                                                                                      \
+      using GateCirq = qsim::Cirq::GateCirq<float>;                                   \
+      using OpString = qsim::OpString<GateCirq>;                                      \
+                                                                                      \
+      /* Methods for returning expectation values */                                  \
+      m.def("qsim_simulate_expectation_values",                                       \
+            static_cast<std::vector<std::complex<double>>(*)(                         \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<std::vector<OpString>, unsigned>>&,      \
+                uint64_t)>(                                                           \
+              &qsim_simulate_expectation_values),                                     \
+            "Call the qsim simulator for expectation value simulation");              \
+      m.def("qsim_simulate_expectation_values",                                       \
+            static_cast<std::vector<std::complex<double>>(*)(                         \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<std::vector<OpString>, unsigned>>&,      \
+                const py::array_t<float>&)>(                                          \
+              &qsim_simulate_expectation_values),                                     \
+            "Call the qsim simulator for expectation value simulation");              \
+                                                                                      \
+      m.def("qtrajectory_simulate_expectation_values",                                \
+            static_cast<std::vector<std::complex<double>>(*)(                         \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<std::vector<OpString>, unsigned>>&,      \
+                uint64_t)>(                                                           \
+              &qtrajectory_simulate_expectation_values),                              \
+            "Call the qtrajectory simulator for expectation value simulation");       \
+      m.def("qtrajectory_simulate_expectation_values",                                \
+            static_cast<std::vector<std::complex<double>>(*)(                         \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<std::vector<OpString>, unsigned>>&,      \
+                const py::array_t<float>&)>(                                          \
+              &qtrajectory_simulate_expectation_values),                              \
+            "Call the qtrajectory simulator for expectation value simulation");       \
+                                                                                      \
+      /* Method for hybrid simulation */                                              \
+      m.def("qsimh_simulate", &qsimh_simulate, "Call the qsimh simulator");           \
+                                                                                      \
+      m.def("add_gate", &add_gate, "Adds a gate to the given circuit.");              \
+      m.def("add_diagonal_gate", &add_diagonal_gate,                                  \
+            "Adds a two- or three-qubit diagonal gate to the given circuit.");        \
+      m.def("add_matrix_gate", &add_matrix_gate,                                      \
+            "Adds a matrix-defined gate to the given circuit.");                      \
+      m.def("control_last_gate", &control_last_gate,                                  \
+            "Applies controls to the final gate of a circuit.");                      \
+                                                                                      \
+      m.def("add_gate_channel", &add_gate_channel,                                    \
+            "Adds a gate to the given noisy circuit.");                               \
+      m.def("add_diagonal_gate_channel", &add_diagonal_gate_channel,                  \
+            "Adds a two- or three-qubit diagonal gate to the given noisy circuit.");  \
+      m.def("add_matrix_gate_channel", &add_matrix_gate_channel,                      \
+            "Adds a matrix-defined gate to the given noisy circuit.");                \
+      m.def("control_last_gate_channel", &control_last_gate_channel,                  \
+            "Applies controls to the final channel of a noisy circuit.");             \
+                                                                                      \
+      m.def("add_channel", &add_channel,                                              \
+            "Adds a channel to the given noisy circuit.");                            \
+                                                                                      \
+      m.def("add_gate_to_opstring", &add_gate_to_opstring,                            \
+            "Adds a gate to the given opstring.");
 #endif

From d67f8322ded9ce4befdbda02a8b2371690d4de9f Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@gmail.com>
Date: Fri, 6 Aug 2021 17:47:17 +0000
Subject: [PATCH 023/246] Working on autoscaling.

---
 docs/tutorials/multinode/README.md            |   7 +-
 .../multinode/terraform/autoscaler.py         | 275 ++++++++++++++++++
 .../multinode/terraform/htcondor/noise.py     |  24 ++
 .../multinode/terraform/htcondor/noise.sub    |  12 +
 .../multinode/terraform/htcondor/resources.tf |   8 +-
 5 files changed, 320 insertions(+), 6 deletions(-)
 create mode 100644 docs/tutorials/multinode/terraform/autoscaler.py
 create mode 100644 docs/tutorials/multinode/terraform/htcondor/noise.py
 create mode 100644 docs/tutorials/multinode/terraform/htcondor/noise.sub

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index e960819f..cbe78f00 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -16,6 +16,9 @@ To generate a cost estimate based on your projected usage, use the [pricing calc
 When you finish this tutorial, you can avoid continued billing by deleting the resources 
 you created. For more information, see Cleaning up.
 
+> Note: the resources created in this tutorial will persist until deleted or the project is deleted. Google Cloud will charge for this time.
+
+
 ## Before you begin
 1. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project. To make this easy, try to choose a project where you are _Owner_ or _Editor_.
 
@@ -132,7 +135,7 @@ slot1@c-6klg.c.test-quantum-multinode.internal LINUX      X86_64 Unclaimed Idle
 If  the output shows "Unclaimed" machines, you are ready to submit a job with HTCondor.
 
 ```
-condor_submit circuit_q32.sub
+condor_submit circuit_q30.sub
 ```
 There should be a response indicating the job was submitted.
 ```
@@ -209,7 +212,7 @@ queue 20
 ```
 Now when you run the `condor_submit` command, 
 ```
-condor_submit circuit_q32.sub
+condor_submit circuit_q30.sub
 ```
 20 jobs will be visible from the `condor_q` command.
 
diff --git a/docs/tutorials/multinode/terraform/autoscaler.py b/docs/tutorials/multinode/terraform/autoscaler.py
new file mode 100644
index 00000000..af68cf45
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/autoscaler.py
@@ -0,0 +1,275 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Copyright 2018 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Script for resizing managed instance group (MIG) cluster size based
+# on the number of jobs in the Condor Queue.
+
+from pprint import pprint
+from googleapiclient import discovery
+from oauth2client.client import GoogleCredentials
+
+import os
+import math
+import argparse
+
+parser = argparse.ArgumentParser("autoscaler.py")
+parser.add_argument("-p", "--project_id", help="Project id", type=str)
+parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
+parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
+parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
+parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
+parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
+args = parser.parse_args()
+
+# Project ID
+project = args.project_id  # Ex:'slurm-var-demo'
+
+# Region where the managed instance group is located
+region = args.region  # Ex: 'us-central1'
+
+# Name of the zone where the managed instance group is located
+zone = args.zone  # Ex: 'us-central1-f'
+
+# The name of the managed instance group.
+instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
+
+# Default number of cores per intance, will be replaced with actual value
+cores_per_node = 4
+
+# Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
+size = 0
+
+# Debug level: 1-print debug information, 2 - print detail debug information
+debug = 0
+if (args.verbosity):
+    debug = args.verbosity
+
+# Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
+compute_instance_limit = 0
+if (args.computeinstancelimit):
+    compute_instance_limit = abs(args.computeinstancelimit)
+
+
+if debug > 1:
+    print('Launching autoscaler.py with the following arguments:')
+    print('project_id: ' + project)
+    print('region: ' + region)
+    print('zone: ' + zone)
+    print('group_manager: ' + instance_group_manager)
+    print('computeinstancelimit: ' + str(compute_instance_limit))
+    print('debuglevel: ' + str(debug))
+
+
+# Remove specified instance from MIG and decrease MIG size
+def deleteFromMig(instance):
+    instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' \
+        + project + '/zones/' + zone + '/instances/' + instance
+    instances_to_delete = {'instances': [instanceUrl]}
+
+    requestDelInstance = \
+        service.instanceGroupManagers().deleteInstances(project=project,
+            zone=zone, instanceGroupManager=instance_group_manager,
+            body=instances_to_delete)
+    response = requestDelInstance.execute()
+    if debug > 0:
+        print('Request to delete instance ' + instance)
+        pprint(response)
+
+    return response
+
+def getInstanceTemplateInfo():
+    requestTemplateName = \
+        service.instanceGroupManagers().get(project=project, zone=zone,
+            instanceGroupManager=instance_group_manager,
+            fields='instanceTemplate')
+    responseTemplateName = requestTemplateName.execute()
+    template_name = ''
+
+    if debug > 1:
+        print('Request for the template name')
+        pprint(responseTemplateName)
+
+    if len(responseTemplateName) > 0:
+        template_url = responseTemplateName.get('instanceTemplate')
+        template_url_partitioned = template_url.split('/')
+        template_name = \
+            template_url_partitioned[len(template_url_partitioned) - 1]
+
+    requestInstanceTemplate = \
+        service.instanceTemplates().get(project=project,
+            instanceTemplate=template_name, fields='properties')
+    responseInstanceTemplateInfo = requestInstanceTemplate.execute()
+
+    if debug > 1:
+        print('Template information')
+        pprint(responseInstanceTemplateInfo['properties'])
+
+    machine_type = responseInstanceTemplateInfo['properties']['machineType']
+    is_preemtible = responseInstanceTemplateInfo['properties']['scheduling']['preemptible']
+    if debug > 0:
+        print('Machine Type: ' + machine_type)
+        print('Is preemtible: ' + str(is_preemtible))
+    request = service.machineTypes().get(project=project, zone=zone,
+            machineType=machine_type)
+    response = request.execute()
+    guest_cpus = response['guestCpus']
+    if debug > 1:
+        print('Machine information')
+        pprint(responseInstanceTemplateInfo['properties'])
+    if debug > 0:
+        print('Guest CPUs: ' + str(guest_cpus))
+
+    instanceTemlateInfo = {'machine_type': machine_type,
+                           'is_preemtible': is_preemtible,
+                           'guest_cpus': guest_cpus}
+    return instanceTemlateInfo
+
+
+# Obtain credentials
+credentials = GoogleCredentials.get_application_default()
+service = discovery.build('compute', 'v1', credentials=credentials)
+
+# Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
+queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
+queue_length_resp = os.popen(queue_length_req).read().split()
+
+if len(queue_length_resp) > 1:
+    queue = int(queue_length_resp[0])
+    idle_jobs = int(queue_length_resp[1])
+    on_hold_jobs = int(queue_length_resp[2])
+else:
+    queue = 0
+    idle_jobs = 0
+    on_hold_jobs = 0
+
+print('Total queue length: ' + str(queue))
+print('Idle jobs: ' + str(idle_jobs))
+print('Jobs on hold: ' + str(on_hold_jobs))
+
+instanceTemlateInfo = getInstanceTemplateInfo()
+if debug > 1:
+    print('Information about the compute instance template')
+    pprint(instanceTemlateInfo)
+
+cores_per_node = instanceTemlateInfo['guest_cpus']
+print('Number of CPU per compute node: ' + str(cores_per_node))
+
+# Get state for for all jobs in Condor
+name_req = 'condor_status  -af name state'
+slot_names = os.popen(name_req).read().splitlines()
+if debug > 1:
+    print('Currently running jobs in Condor')
+    print(slot_names)
+
+# Adjust current queue length by the number of jos that are on-hold
+queue -=on_hold_jobs
+if on_hold_jobs>0:
+    print("Adjusted queue length: " + str(queue))
+
+# Calculate number instances to satisfy current job queue length
+if queue > 0:
+    size = int(math.ceil(float(queue) / float(cores_per_node)))
+    if debug>0:
+       print("Calucalting size of MIG: ⌈" + str(queue) + "/" + str(cores_per_node) + "⌉ = " + str(size))
+else:
+    size = 0
+
+# If compute instance limit is specified, can not start more instances then specified in the limit
+if compute_instance_limit > 0 and size > compute_instance_limit:
+    size = compute_instance_limit;
+    print("MIG target size will be limited by " + str(compute_instance_limit))
+
+print('New MIG target size: ' + str(size))
+
+# Get current number of instances in the MIG
+requestGroupInfo = service.instanceGroupManagers().get(project=project,
+        zone=zone, instanceGroupManager=instance_group_manager)
+responseGroupInfo = requestGroupInfo.execute()
+currentTarget = int(responseGroupInfo['targetSize'])
+print('Current MIG target size: ' + str(currentTarget))
+
+if debug > 1:
+    print('MIG Information:')
+    print(responseGroupInfo)
+
+if size == 0 and currentTarget == 0:
+    print('No jobs in the queue and no compute instances running. Nothing to do')
+    exit()
+
+if size == currentTarget:
+    print('Running correct number of compute nodes to handle number of jobs in the queue')
+    exit()
+
+
+if size < currentTarget:
+    print('Scaling down. Looking for nodes that can be shut down' )
+    # Find nodes that are not busy (all slots showing status as "Unclaimed")
+
+    node_busy = {}
+    for slot_name in slot_names:
+        name_status = slot_name.split()
+        if len(name_status) > 1:
+            name = name_status[0]
+            status = name_status[1]
+            slot = "NO-SLOT"
+            slot_server = name.split('@')
+            if len(slot_server) > 1:
+                slot = slot_server[0]
+                server = slot_server[1].split('.')[0]
+            else:
+                server = slot_server[0].split('.')[0]
+
+            if debug > 0:
+                print(slot + ', ' + server + ', ' + status + '\n')
+
+            if server not in node_busy:
+                if status == 'Unclaimed':
+                    node_busy[server] = False
+                else:
+                    node_busy[server] = True
+            else:
+                if status != 'Unclaimed':
+                    node_busy[server] = True
+                    
+    if debug > 1:
+        print('Compuute node busy status:')
+        print(node_busy)
+
+    # Shut down nodes that are not busy
+    for node in node_busy:
+        if not node_busy[node]:
+            print('Will shut down: ' + node + ' ...')
+            respDel = deleteFromMig(node)
+            if debug > 1:
+                print("Shut down request for compute node " + node)
+                pprint(respDel)
+                
+    if debug > 1:
+        print("Scaling down complete")
+
+if size > currentTarget:
+    print("Scaling up. Need to increase number of instances to " + str(size))
+    #Request to resize
+    request = service.instanceGroupManagers().resize(project=project,
+            zone=zone, 
+            instanceGroupManager=instance_group_manager,
+            size=size)
+    response = request.execute()
+    if debug > 1:
+        print('Requesting to increase MIG size')
+        pprint(response)
+        print("Scaling up complete")
diff --git a/docs/tutorials/multinode/terraform/htcondor/noise.py b/docs/tutorials/multinode/terraform/htcondor/noise.py
new file mode 100644
index 00000000..df87cc55
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/htcondor/noise.py
@@ -0,0 +1,24 @@
+#!/usr/bin/python3
+
+import cirq, qsimcirq
+
+# Create a Bell state, |00) + |11)
+q0, q1 = cirq.LineQubit.range(2)
+circuit = cirq.Circuit(
+    cirq.H(q0),
+    cirq.CNOT(q0, q1),
+    cirq.measure(q0, q1, key='m')
+)
+
+# Constructs a noise model that adds depolarizing noise after each gate.
+noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
+
+# Use the noise model to create a noisy circuit.
+noisy_circuit = cirq.Circuit(noise.noisy_moments(circuit, system_qubits=[q0, q1]))
+
+sim = qsimcirq.QSimSimulator()
+result = sim.run(noisy_circuit, repetitions=1000)
+# Outputs a histogram dict of result:count pairs.
+# Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
+# (For comparison, the noiseless circuit will only have 0s and 3s)
+print(result.histogram(key='m'))
\ No newline at end of file
diff --git a/docs/tutorials/multinode/terraform/htcondor/noise.sub b/docs/tutorials/multinode/terraform/htcondor/noise.sub
new file mode 100644
index 00000000..aa5fff28
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/htcondor/noise.sub
@@ -0,0 +1,12 @@
+universe                = docker
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim
+executable              = /usr/bin/python3
+arguments               = noise.py
+transfer_input_files    = noise.py
+should_transfer_files   = YES
+when_to_transfer_output = ON_EXIT
+output                  = out/out.$(Cluster)-$(Process)
+error                   = out/err.$(Cluster)-$(Process)
+log                     = out/log.$(Cluster)-$(Process)
+request_memory          = 1GB
+queue 100
diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index 30c68824..ab00a471 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -50,11 +50,11 @@ variable "metric_target_queue" {
 }
 variable "compute_instance_type" {
   type = string
-  default = "n2-standard-16"
+  default = "n1-standard-1"
 }
 variable "instance_type" {
   type = string
-  default = "n2-standard-4"
+  default = "n1-standard-1"
 }
 variable "service_account" {
   type = string
@@ -264,7 +264,7 @@ resource "google_compute_instance_group_manager" "condor-compute-igm" {
   target_size        = "1"
 
   update_policy {
-    max_surge_fixed         = 5
+    max_surge_fixed         = 2
     minimal_action          = "REPLACE"
     type                    = "OPPORTUNISTIC"
   }
@@ -290,7 +290,7 @@ resource "google_compute_autoscaler" "condor-compute-as" {
   zone    = var.zone
 
   autoscaling_policy {
-    cooldown_period = "60"
+    cooldown_period = 30
     max_replicas    = var.max_replicas
     min_replicas = var.min_replicas
 

From c079642741fe920fcbf6256cd6ffa041338b6940 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 6 Aug 2021 11:25:27 -0700
Subject: [PATCH 024/246] Prune GPU pybindings

---
 pybind_interface/pybind_main.h | 25 +------------------------
 1 file changed, 1 insertion(+), 24 deletions(-)

diff --git a/pybind_interface/pybind_main.h b/pybind_interface/pybind_main.h
index c1ce850e..90bcab6e 100644
--- a/pybind_interface/pybind_main.h
+++ b/pybind_interface/pybind_main.h
@@ -362,28 +362,5 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
             "Call the qtrajectory simulator for expectation value simulation");       \
                                                                                       \
       /* Method for hybrid simulation */                                              \
-      m.def("qsimh_simulate", &qsimh_simulate, "Call the qsimh simulator");           \
-                                                                                      \
-      m.def("add_gate", &add_gate, "Adds a gate to the given circuit.");              \
-      m.def("add_diagonal_gate", &add_diagonal_gate,                                  \
-            "Adds a two- or three-qubit diagonal gate to the given circuit.");        \
-      m.def("add_matrix_gate", &add_matrix_gate,                                      \
-            "Adds a matrix-defined gate to the given circuit.");                      \
-      m.def("control_last_gate", &control_last_gate,                                  \
-            "Applies controls to the final gate of a circuit.");                      \
-                                                                                      \
-      m.def("add_gate_channel", &add_gate_channel,                                    \
-            "Adds a gate to the given noisy circuit.");                               \
-      m.def("add_diagonal_gate_channel", &add_diagonal_gate_channel,                  \
-            "Adds a two- or three-qubit diagonal gate to the given noisy circuit.");  \
-      m.def("add_matrix_gate_channel", &add_matrix_gate_channel,                      \
-            "Adds a matrix-defined gate to the given noisy circuit.");                \
-      m.def("control_last_gate_channel", &control_last_gate_channel,                  \
-            "Applies controls to the final channel of a noisy circuit.");             \
-                                                                                      \
-      m.def("add_channel", &add_channel,                                              \
-            "Adds a channel to the given noisy circuit.");                            \
-                                                                                      \
-      m.def("add_gate_to_opstring", &add_gate_to_opstring,                            \
-            "Adds a gate to the given opstring.");
+      m.def("qsimh_simulate", &qsimh_simulate, "Call the qsimh simulator");
 #endif

From ed1619a9b36775d99d90c89f1d12b9581c5d5917 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 6 Aug 2021 11:26:03 -0700
Subject: [PATCH 025/246] Experimental GPU support.

---
 qsimcirq/qsim_simulator.py      | 23 +++++++++++++----------
 qsimcirq_tests/qsimcirq_test.py | 28 +++++++++++++---------------
 2 files changed, 26 insertions(+), 25 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index d3516f41..cbdabc87 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -33,7 +33,7 @@
 
 import numpy as np
 
-from . import qsim
+from . import qsim, qsim_gpu
 import qsimcirq.qsim_circuit as qsimc
 
 
@@ -93,6 +93,7 @@ def __init__(
                 applied to all circuits run using this simulator. Accepted keys and
                 their behavior are as follows:
                     - 'f': int (> 0). Maximum size of fused gates. Default: 2.
+                    - 'g': bool. If true, simulate with GPU. Default: false.
                     - 'r': int (> 0). Noisy repetitions (see below). Default: 1.
                     - 't': int (> 0). Number of threads to run on. Default: 1.
                     - 'v': int (>= 0). Log verbosity. Default: 0.
@@ -119,6 +120,8 @@ def __init__(
                 "used in QSimCircuit instantiation."
             )
         self._prng = value.parse_random_state(seed)
+        # module to use for simulation
+        self._sim_module = qsim_gpu if qsim_options['g'] else qsim
         self.qsim_options = {"t": 1, "f": 2, "v": 0, "r": 1}
         self.qsim_options.update(qsim_options)
         # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
@@ -220,10 +223,10 @@ def _sample_measure_results(
         noisy = _needs_trajectories(program)
         if noisy:
             translator_fn_name = "translate_cirq_to_qtrajectory"
-            sampler_fn = qsim.qtrajectory_sample
+            sampler_fn = self._sim_module.qtrajectory_sample
         else:
             translator_fn_name = "translate_cirq_to_qsim"
-            sampler_fn = qsim.qsim_sample
+            sampler_fn = self._sim_module.qsim_sample
 
         if not noisy and program.are_all_measurements_terminal() and repetitions > 1:
             print(
@@ -246,7 +249,7 @@ def _sample_measure_results(
                 ops.QubitOrder.DEFAULT,
             )
             options["s"] = self.get_seed()
-            final_state = qsim.qsim_simulate_fullstate(options, 0)
+            final_state = self._sim_module.qsim_simulate_fullstate(options, 0)
             full_results = sim.sample_state_vector(
                 final_state.view(np.complex64),
                 range(num_qubits),
@@ -319,10 +322,10 @@ def compute_amplitudes_sweep(
         trials_results = []
         if _needs_trajectories(program):
             translator_fn_name = "translate_cirq_to_qtrajectory"
-            simulator_fn = qsim.qtrajectory_simulate
+            simulator_fn = self._sim_module.qtrajectory_simulate
         else:
             translator_fn_name = "translate_cirq_to_qsim"
-            simulator_fn = qsim.qsim_simulate
+            simulator_fn = self._sim_module.qsim_simulate
 
         for prs in param_resolvers:
             solved_circuit = protocols.resolve_parameters(program, prs)
@@ -398,10 +401,10 @@ def simulate_sweep(
         trials_results = []
         if _needs_trajectories(program):
             translator_fn_name = "translate_cirq_to_qtrajectory"
-            fullstate_simulator_fn = qsim.qtrajectory_simulate_fullstate
+            fullstate_simulator_fn = self._sim_module.qtrajectory_simulate_fullstate
         else:
             translator_fn_name = "translate_cirq_to_qsim"
-            fullstate_simulator_fn = qsim.qsim_simulate_fullstate
+            fullstate_simulator_fn = self._sim_module.qsim_simulate_fullstate
 
         for prs in param_resolvers:
             solved_circuit = protocols.resolve_parameters(program, prs)
@@ -525,10 +528,10 @@ def simulate_expectation_values_sweep(
         results = []
         if _needs_trajectories(program):
             translator_fn_name = "translate_cirq_to_qtrajectory"
-            ev_simulator_fn = qsim.qtrajectory_simulate_expectation_values
+            ev_simulator_fn = self._sim_module.qtrajectory_simulate_expectation_values
         else:
             translator_fn_name = "translate_cirq_to_qsim"
-            ev_simulator_fn = qsim.qsim_simulate_expectation_values
+            ev_simulator_fn = self._sim_module.qsim_simulate_expectation_values
 
         for prs in param_resolvers:
             solved_circuit = protocols.resolve_parameters(program, prs)
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index ba72935f..914c7820 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1063,21 +1063,19 @@ def test_cirq_qsimh_simulate():
 
 
 def test_cirq_qsim_gpu_simulate():
-    # Dummy test.
-    print(qsimcirq.qsim_gpu)
-    assert False
-    # # Pick qubits.
-    # a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
-
-    # # Create a circuit
-    # cirq_circuit = cirq.Circuit(cirq.CNOT(a, b), cirq.CNOT(b, a), cirq.X(a))
-
-    # qsimh_options = {"k": [0], "w": 0, "p": 1, "r": 1}
-    # qsimhSim = qsimcirq.QSimhSimulator(qsimh_options)
-    # result = qsimhSim.compute_amplitudes(
-    #     cirq_circuit, bitstrings=[0b00, 0b01, 0b10, 0b11]
-    # )
-    # assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.CNOT(a, b), cirq.CNOT(b, a), cirq.X(a))
+
+    # Enable GPU acceleration.
+    gpu_options = {'g': True}
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
+    result = qsimGpuSim.compute_amplitudes(
+        cirq_circuit, bitstrings=[0b00, 0b01, 0b10, 0b11]
+    )
+    assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
 
 
 def test_cirq_qsim_params():

From 5b0de1d46d7558b6f9936c018a25304dbf15cec7 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Sat, 7 Aug 2021 19:28:03 +0000
Subject: [PATCH 026/246] Created Autoscaler Object.

---
 .../multinode/terraform/autoscaler.py         | 509 +++++++++---------
 1 file changed, 263 insertions(+), 246 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/autoscaler.py b/docs/tutorials/multinode/terraform/autoscaler.py
index af68cf45..f03ba406 100644
--- a/docs/tutorials/multinode/terraform/autoscaler.py
+++ b/docs/tutorials/multinode/terraform/autoscaler.py
@@ -18,6 +18,8 @@
 # Script for resizing managed instance group (MIG) cluster size based
 # on the number of jobs in the Condor Queue.
 
+from absl import app
+from absl import flags
 from pprint import pprint
 from googleapiclient import discovery
 from oauth2client.client import GoogleCredentials
@@ -26,250 +28,265 @@
 import math
 import argparse
 
-parser = argparse.ArgumentParser("autoscaler.py")
-parser.add_argument("-p", "--project_id", help="Project id", type=str)
-parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
-parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
-parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
-parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
-parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
-args = parser.parse_args()
 
-# Project ID
-project = args.project_id  # Ex:'slurm-var-demo'
-
-# Region where the managed instance group is located
-region = args.region  # Ex: 'us-central1'
-
-# Name of the zone where the managed instance group is located
-zone = args.zone  # Ex: 'us-central1-f'
-
-# The name of the managed instance group.
-instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
-
-# Default number of cores per intance, will be replaced with actual value
-cores_per_node = 4
-
-# Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
-size = 0
-
-# Debug level: 1-print debug information, 2 - print detail debug information
-debug = 0
-if (args.verbosity):
-    debug = args.verbosity
-
-# Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
-compute_instance_limit = 0
-if (args.computeinstancelimit):
-    compute_instance_limit = abs(args.computeinstancelimit)
-
-
-if debug > 1:
-    print('Launching autoscaler.py with the following arguments:')
-    print('project_id: ' + project)
-    print('region: ' + region)
-    print('zone: ' + zone)
-    print('group_manager: ' + instance_group_manager)
-    print('computeinstancelimit: ' + str(compute_instance_limit))
-    print('debuglevel: ' + str(debug))
-
-
-# Remove specified instance from MIG and decrease MIG size
-def deleteFromMig(instance):
-    instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' \
-        + project + '/zones/' + zone + '/instances/' + instance
-    instances_to_delete = {'instances': [instanceUrl]}
-
-    requestDelInstance = \
-        service.instanceGroupManagers().deleteInstances(project=project,
-            zone=zone, instanceGroupManager=instance_group_manager,
-            body=instances_to_delete)
-    response = requestDelInstance.execute()
-    if debug > 0:
-        print('Request to delete instance ' + instance)
-        pprint(response)
-
-    return response
-
-def getInstanceTemplateInfo():
-    requestTemplateName = \
-        service.instanceGroupManagers().get(project=project, zone=zone,
-            instanceGroupManager=instance_group_manager,
-            fields='instanceTemplate')
-    responseTemplateName = requestTemplateName.execute()
-    template_name = ''
-
-    if debug > 1:
-        print('Request for the template name')
-        pprint(responseTemplateName)
-
-    if len(responseTemplateName) > 0:
-        template_url = responseTemplateName.get('instanceTemplate')
-        template_url_partitioned = template_url.split('/')
-        template_name = \
-            template_url_partitioned[len(template_url_partitioned) - 1]
-
-    requestInstanceTemplate = \
-        service.instanceTemplates().get(project=project,
-            instanceTemplate=template_name, fields='properties')
-    responseInstanceTemplateInfo = requestInstanceTemplate.execute()
-
-    if debug > 1:
-        print('Template information')
-        pprint(responseInstanceTemplateInfo['properties'])
-
-    machine_type = responseInstanceTemplateInfo['properties']['machineType']
-    is_preemtible = responseInstanceTemplateInfo['properties']['scheduling']['preemptible']
-    if debug > 0:
-        print('Machine Type: ' + machine_type)
-        print('Is preemtible: ' + str(is_preemtible))
-    request = service.machineTypes().get(project=project, zone=zone,
-            machineType=machine_type)
-    response = request.execute()
-    guest_cpus = response['guestCpus']
-    if debug > 1:
-        print('Machine information')
-        pprint(responseInstanceTemplateInfo['properties'])
-    if debug > 0:
-        print('Guest CPUs: ' + str(guest_cpus))
-
-    instanceTemlateInfo = {'machine_type': machine_type,
-                           'is_preemtible': is_preemtible,
-                           'guest_cpus': guest_cpus}
-    return instanceTemlateInfo
-
-
-# Obtain credentials
-credentials = GoogleCredentials.get_application_default()
-service = discovery.build('compute', 'v1', credentials=credentials)
-
-# Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
-queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
-queue_length_resp = os.popen(queue_length_req).read().split()
-
-if len(queue_length_resp) > 1:
-    queue = int(queue_length_resp[0])
-    idle_jobs = int(queue_length_resp[1])
-    on_hold_jobs = int(queue_length_resp[2])
-else:
-    queue = 0
-    idle_jobs = 0
-    on_hold_jobs = 0
-
-print('Total queue length: ' + str(queue))
-print('Idle jobs: ' + str(idle_jobs))
-print('Jobs on hold: ' + str(on_hold_jobs))
-
-instanceTemlateInfo = getInstanceTemplateInfo()
-if debug > 1:
-    print('Information about the compute instance template')
-    pprint(instanceTemlateInfo)
-
-cores_per_node = instanceTemlateInfo['guest_cpus']
-print('Number of CPU per compute node: ' + str(cores_per_node))
-
-# Get state for for all jobs in Condor
-name_req = 'condor_status  -af name state'
-slot_names = os.popen(name_req).read().splitlines()
-if debug > 1:
-    print('Currently running jobs in Condor')
-    print(slot_names)
-
-# Adjust current queue length by the number of jos that are on-hold
-queue -=on_hold_jobs
-if on_hold_jobs>0:
-    print("Adjusted queue length: " + str(queue))
-
-# Calculate number instances to satisfy current job queue length
-if queue > 0:
-    size = int(math.ceil(float(queue) / float(cores_per_node)))
-    if debug>0:
-       print("Calucalting size of MIG: ⌈" + str(queue) + "/" + str(cores_per_node) + "⌉ = " + str(size))
-else:
-    size = 0
-
-# If compute instance limit is specified, can not start more instances then specified in the limit
-if compute_instance_limit > 0 and size > compute_instance_limit:
-    size = compute_instance_limit;
-    print("MIG target size will be limited by " + str(compute_instance_limit))
-
-print('New MIG target size: ' + str(size))
-
-# Get current number of instances in the MIG
-requestGroupInfo = service.instanceGroupManagers().get(project=project,
-        zone=zone, instanceGroupManager=instance_group_manager)
-responseGroupInfo = requestGroupInfo.execute()
-currentTarget = int(responseGroupInfo['targetSize'])
-print('Current MIG target size: ' + str(currentTarget))
-
-if debug > 1:
-    print('MIG Information:')
-    print(responseGroupInfo)
-
-if size == 0 and currentTarget == 0:
-    print('No jobs in the queue and no compute instances running. Nothing to do')
-    exit()
-
-if size == currentTarget:
-    print('Running correct number of compute nodes to handle number of jobs in the queue')
-    exit()
-
-
-if size < currentTarget:
-    print('Scaling down. Looking for nodes that can be shut down' )
-    # Find nodes that are not busy (all slots showing status as "Unclaimed")
-
-    node_busy = {}
-    for slot_name in slot_names:
-        name_status = slot_name.split()
-        if len(name_status) > 1:
-            name = name_status[0]
-            status = name_status[1]
-            slot = "NO-SLOT"
-            slot_server = name.split('@')
-            if len(slot_server) > 1:
-                slot = slot_server[0]
-                server = slot_server[1].split('.')[0]
-            else:
-                server = slot_server[0].split('.')[0]
-
-            if debug > 0:
-                print(slot + ', ' + server + ', ' + status + '\n')
-
-            if server not in node_busy:
-                if status == 'Unclaimed':
-                    node_busy[server] = False
-                else:
-                    node_busy[server] = True
-            else:
-                if status != 'Unclaimed':
-                    node_busy[server] = True
-                    
-    if debug > 1:
-        print('Compuute node busy status:')
-        print(node_busy)
-
-    # Shut down nodes that are not busy
-    for node in node_busy:
-        if not node_busy[node]:
-            print('Will shut down: ' + node + ' ...')
-            respDel = deleteFromMig(node)
-            if debug > 1:
-                print("Shut down request for compute node " + node)
-                pprint(respDel)
-                
-    if debug > 1:
-        print("Scaling down complete")
-
-if size > currentTarget:
-    print("Scaling up. Need to increase number of instances to " + str(size))
-    #Request to resize
-    request = service.instanceGroupManagers().resize(project=project,
-            zone=zone, 
-            instanceGroupManager=instance_group_manager,
-            size=size)
-    response = request.execute()
-    if debug > 1:
-        print('Requesting to increase MIG size')
-        pprint(response)
-        print("Scaling up complete")
+class AutoScaler():
+
+    def __init__(self):
+        parser = argparse.ArgumentParser("autoscaler.py")
+        parser.add_argument("-p", "--project_id", help="Project id", type=str)
+        parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
+        parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
+        parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
+        parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
+        parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
+        
+        args = parser.parse_args()
+        
+        # Project ID
+        self.project = args.project_id  # Ex:'slurm-var-demo'
+        
+        # Region where the managed instance group is located
+        self.region = args.region  # Ex: 'us-central1'
+        
+        # Name of the zone where the managed instance group is located
+        self.zone = args.zone  # Ex: 'us-central1-f'
+        
+        # The name of the managed instance group.
+        self.instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
+        
+        # Default number of cores per intance, will be replaced with actual value
+        self.cores_per_node = 4
+        
+        # Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
+        self.size = 0
+        
+        # Debug level: 1-print debug information, 2 - print detail debug information
+        self.debug = 0
+        if (args.verbosity):
+            self.debug = args.verbosity
+        
+        # Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
+        self.compute_instance_limit = 0
+        if (args.computeinstancelimit):
+            self.compute_instance_limit = abs(args.computeinstancelimit)
+        
+        
+        if self.debug > 1:
+            print('Launching autoscaler.py with the following arguments:')
+            print('project_id: ' + self.project)
+            print('region: ' + self.region)
+            print('zone: ' + self.zone)
+            print('group_manager: ' + self.instance_group_manager)
+            print('computeinstancelimit: ' + str(self.compute_instance_limit))
+            print('debuglevel: ' + str(self.debug))
+
+        # Obtain credentials
+        self.credentials = GoogleCredentials.get_application_default()
+        self.service = discovery.build('compute', 'v1', credentials=self.credentials)
+    
+    
+    # Remove specified instance from MIG and decrease MIG size
+    def deleteFromMig(self, instance):
+        instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' \
+            + self.project + '/zones/' + self.zone + '/instances/' + instance
+        instances_to_delete = {'instances': [instanceUrl]}
+    
+        requestDelInstance = \
+            self.service.instanceGroupManagers().deleteInstances(project=self.project,
+                zone=self.zone, instanceGroupManager=self.instance_group_manager,
+                body=instances_to_delete)
+        response = requestDelInstance.execute()
+        if self.debug > 0:
+            print('Request to delete instance ' + instance)
+            pprint(response)
+    
+        return response
+    
+    def getInstanceTemplateInfo(self):
+        requestTemplateName = \
+            self.service.instanceGroupManagers().get(project=self.project, zone=self.zone,
+                instanceGroupManager=self.instance_group_manager,
+                fields='instanceTemplate')
+        responseTemplateName = requestTemplateName.execute()
+        template_name = ''
+    
+        if self.debug > 1:
+            print('Request for the template name')
+            pprint(responseTemplateName)
+    
+        if len(responseTemplateName) > 0:
+            template_url = responseTemplateName.get('instanceTemplate')
+            template_url_partitioned = template_url.split('/')
+            template_name = \
+                template_url_partitioned[len(template_url_partitioned) - 1]
+    
+        requestInstanceTemplate = \
+            self.service.instanceTemplates().get(project=self.project,
+                instanceTemplate=template_name, fields='properties')
+        responseInstanceTemplateInfo = requestInstanceTemplate.execute()
+    
+        if self.debug > 1:
+            print('Template information')
+            pprint(responseInstanceTemplateInfo['properties'])
+    
+        machine_type = responseInstanceTemplateInfo['properties']['machineType']
+        is_preemtible = responseInstanceTemplateInfo['properties']['scheduling']['preemptible']
+        if self.debug > 0:
+            print('Machine Type: ' + machine_type)
+            print('Is preemtible: ' + str(is_preemtible))
+        request = self.service.machineTypes().get(project=self.project, zone=self.zone,
+                machineType=machine_type)
+        response = request.execute()
+        guest_cpus = response['guestCpus']
+        if self.debug > 1:
+            print('Machine information')
+            pprint(responseInstanceTemplateInfo['properties'])
+        if self.debug > 0:
+            print('Guest CPUs: ' + str(guest_cpus))
+    
+        instanceTemlateInfo = {'machine_type': machine_type,
+                            'is_preemtible': is_preemtible,
+                            'guest_cpus': guest_cpus}
+        return instanceTemlateInfo
+    
+    
+
+    def scale(self):
+        # Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
+        queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
+        queue_length_resp = os.popen(queue_length_req).read().split()
+        
+        if len(queue_length_resp) > 1:
+            queue = int(queue_length_resp[0])
+            idle_jobs = int(queue_length_resp[1])
+            on_hold_jobs = int(queue_length_resp[2])
+        else:
+            queue = 0
+            idle_jobs = 0
+            on_hold_jobs = 0
+        
+        print('Total queue length: ' + str(queue))
+        print('Idle jobs: ' + str(idle_jobs))
+        print('Jobs on hold: ' + str(on_hold_jobs))
+        
+        instanceTemlateInfo = self.getInstanceTemplateInfo()
+        if self.debug > 1:
+            print('Information about the compute instance template')
+            pprint(instanceTemlateInfo)
+        
+        self.cores_per_node = instanceTemlateInfo['guest_cpus']
+        print('Number of CPU per compute node: ' + str(self.cores_per_node))
+        
+        # Get state for for all jobs in Condor
+        name_req = 'condor_status  -af name state'
+        slot_names = os.popen(name_req).read().splitlines()
+        if self.debug > 1:
+            print('Currently running jobs in Condor')
+            print(slot_names)
+        
+        # Adjust current queue length by the number of jos that are on-hold
+        queue -=on_hold_jobs
+        if on_hold_jobs>0:
+            print("Adjusted queue length: " + str(queue))
+        
+        # Calculate number instances to satisfy current job queue length
+        if queue > 0:
+            self.size = int(math.ceil(float(queue) / float(self.cores_per_node)))
+            if self.debug>0:
+                print("Calucalting size of MIG: ⌈" + str(queue) + "/" + str(self.cores_per_node) + "⌉ = " + str(self.size))
+        else:
+            self.size = 0
+        
+        # If compute instance limit is specified, can not start more instances then specified in the limit
+        if self.compute_instance_limit > 0 and self.size > self.compute_instance_limit:
+            self.size = self.compute_instance_limit
+            print("MIG target size will be limited by " + str(self.compute_instance_limit))
+        
+        print('New MIG target size: ' + str(self.size))
+        
+        # Get current number of instances in the MIG
+        requestGroupInfo = self.service.instanceGroupManagers().get(project=self.project,
+                zone=self.zone, instanceGroupManager=self.instance_group_manager)
+        responseGroupInfo = requestGroupInfo.execute()
+        currentTarget = int(responseGroupInfo['targetSize'])
+        print('Current MIG target size: ' + str(currentTarget))
+        
+        if self.debug > 1:
+            print('MIG Information:')
+            print(responseGroupInfo)
+        
+        if self.size == 0 and currentTarget == 0:
+            print('No jobs in the queue and no compute instances running. Nothing to do')
+            exit()
+        
+        if self.size == currentTarget:
+            print('Running correct number of compute nodes to handle number of jobs in the queue')
+            exit()
+        
+        
+        if self.size < currentTarget:
+            print('Scaling down. Looking for nodes that can be shut down' )
+            # Find nodes that are not busy (all slots showing status as "Unclaimed")
+        
+            node_busy = {}
+            for slot_name in slot_names:
+                name_status = slot_name.split()
+                if len(name_status) > 1:
+                    name = name_status[0]
+                    status = name_status[1]
+                    slot = "NO-SLOT"
+                    slot_server = name.split('@')
+                    if len(slot_server) > 1:
+                        slot = slot_server[0]
+                        server = slot_server[1].split('.')[0]
+                    else:
+                        server = slot_server[0].split('.')[0]
+        
+                    if self.debug > 0:
+                        print(slot + ', ' + server + ', ' + status + '\n')
+        
+                    if server not in node_busy:
+                        if status == 'Unclaimed':
+                            node_busy[server] = False
+                        else:
+                            node_busy[server] = True
+                    else:
+                        if status != 'Unclaimed':
+                            node_busy[server] = True
+                            
+            if self.debug > 1:
+                print('Compuute node busy status:')
+                print(node_busy)
+        
+            # Shut down nodes that are not busy
+            for node in node_busy:
+                if not node_busy[node]:
+                    print('Will shut down: ' + node + ' ...')
+                    respDel = self.deleteFromMig(node)
+                    if self.debug > 1:
+                        print("Shut down request for compute node " + node)
+                        pprint(respDel)
+                        
+            if self.debug > 1:
+                print("Scaling down complete")
+        
+        if self.size > currentTarget:
+            print("Scaling up. Need to increase number of instances to " + str(self.size))
+            #Request to resize
+            request = self.service.instanceGroupManagers().resize(project=self.project,
+                    zone=self.zone, 
+                    instanceGroupManager=self.instance_group_manager,
+                    size=self.size)
+            response = request.execute()
+            if self.debug > 1:
+                print('Requesting to increase MIG size')
+                pprint(response)
+                print("Scaling up complete")
+def main():
+
+    scaler = AutoScaler()
+    scaler.scale()
+
+
+if __name__ == "__main__":
+    app.run(main)
\ No newline at end of file

From 9c507754f7605f91d689f9898f6aa97e446db443 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Sat, 7 Aug 2021 19:48:05 +0000
Subject: [PATCH 027/246] FIxed arg parsing and recorded pip installs

---
 .../multinode/terraform/autoscaler.py         | 80 ++++++++++---------
 .../terraform/htcondor/startup-centos.sh      |  7 ++
 2 files changed, 48 insertions(+), 39 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/autoscaler.py b/docs/tutorials/multinode/terraform/autoscaler.py
index f03ba406..a3cf1b12 100644
--- a/docs/tutorials/multinode/terraform/autoscaler.py
+++ b/docs/tutorials/multinode/terraform/autoscaler.py
@@ -28,49 +28,21 @@
 import math
 import argparse
 
+parser = argparse.ArgumentParser("autoscaler.py")
+parser.add_argument("-p", "--project_id", help="Project id", type=str)
+parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
+parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
+parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
+parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
+parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
+
+args = parser.parse_args()
+        
 
 class AutoScaler():
 
     def __init__(self):
-        parser = argparse.ArgumentParser("autoscaler.py")
-        parser.add_argument("-p", "--project_id", help="Project id", type=str)
-        parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
-        parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
-        parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
-        parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
-        parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
-        
-        args = parser.parse_args()
-        
-        # Project ID
-        self.project = args.project_id  # Ex:'slurm-var-demo'
-        
-        # Region where the managed instance group is located
-        self.region = args.region  # Ex: 'us-central1'
-        
-        # Name of the zone where the managed instance group is located
-        self.zone = args.zone  # Ex: 'us-central1-f'
-        
-        # The name of the managed instance group.
-        self.instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
-        
-        # Default number of cores per intance, will be replaced with actual value
-        self.cores_per_node = 4
-        
-        # Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
-        self.size = 0
-        
-        # Debug level: 1-print debug information, 2 - print detail debug information
-        self.debug = 0
-        if (args.verbosity):
-            self.debug = args.verbosity
-        
-        # Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
-        self.compute_instance_limit = 0
-        if (args.computeinstancelimit):
-            self.compute_instance_limit = abs(args.computeinstancelimit)
-        
-        
+
         if self.debug > 1:
             print('Launching autoscaler.py with the following arguments:')
             print('project_id: ' + self.project)
@@ -285,6 +257,36 @@ def scale(self):
 def main():
 
     scaler = AutoScaler()
+
+    # Project ID
+    scaler.project = args.project_id  # Ex:'slurm-var-demo'
+    
+    # Region where the managed instance group is located
+    scaler.region = args.region  # Ex: 'us-central1'
+    
+    # Name of the zone where the managed instance group is located
+    scaler.zone = args.zone  # Ex: 'us-central1-f'
+    
+    # The name of the managed instance group.
+    scaler.instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
+    
+    # Default number of cores per intance, will be replaced with actual value
+    scaler.cores_per_node = 4
+    
+    # Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
+    scaler.size = 0
+    
+    # Debug level: 1-print debug information, 2 - print detail debug information
+    scaler.debug = 0
+    if (args.verbosity):
+        scaler.debug = args.verbosity
+    
+    # Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
+    scaler.compute_instance_limit = 0
+    if (args.computeinstancelimit):
+        scaler.compute_instance_limit = abs(args.computeinstancelimit)
+    
+    
     scaler.scale()
 
 
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
index 66220888..cc5dbedc 100644
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -167,3 +167,10 @@ chmod 666 /var/log/condor/jobs/stats.log
 fi
 
 service google-fluentd restart
+
+# Add Python Libraries and Autoscaler
+if [ "$SERVER_TYPE" == "submit" ]; then
+  python3 -m pip install --upgrade oauth2client
+  python3 -m pip install --upgrade google-api-python-client
+  python3 -m pip install --upgrade absl-py
+fi
\ No newline at end of file

From 2e3d31b9da8dcad43a0ada261d1655764f72565a Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 9 Aug 2021 00:41:19 +0000
Subject: [PATCH 028/246] Fixed Arg parsing

---
 .../multinode/terraform/autoscaler.py         | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/autoscaler.py b/docs/tutorials/multinode/terraform/autoscaler.py
index a3cf1b12..8669b7da 100644
--- a/docs/tutorials/multinode/terraform/autoscaler.py
+++ b/docs/tutorials/multinode/terraform/autoscaler.py
@@ -28,30 +28,20 @@
 import math
 import argparse
 
-parser = argparse.ArgumentParser("autoscaler.py")
-parser.add_argument("-p", "--project_id", help="Project id", type=str)
-parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
-parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
-parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
-parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
-parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
+parser = argparse.ArgumentParser()
+parser.add_argument("--p", help="Project id", type=str)
+parser.add_argument("--r", help="GCP region where the managed instance group is located", type=str)
+parser.add_argument("--z", help="Name of GCP zone where the managed instance group is located", type=str)
+parser.add_argument("--g", help="Name of the managed instance group", type=str)
+parser.add_argument("--c", help="Maximum number of compute instances", type=int)
+parser.add_argument("--v", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
 
 args = parser.parse_args()
         
-
 class AutoScaler():
 
     def __init__(self):
 
-        if self.debug > 1:
-            print('Launching autoscaler.py with the following arguments:')
-            print('project_id: ' + self.project)
-            print('region: ' + self.region)
-            print('zone: ' + self.zone)
-            print('group_manager: ' + self.instance_group_manager)
-            print('computeinstancelimit: ' + str(self.compute_instance_limit))
-            print('debuglevel: ' + str(self.debug))
-
         # Obtain credentials
         self.credentials = GoogleCredentials.get_application_default()
         self.service = discovery.build('compute', 'v1', credentials=self.credentials)
@@ -124,6 +114,16 @@ def getInstanceTemplateInfo(self):
     
 
     def scale(self):
+        # diagnosis
+        if self.debug > 1:
+            print('Launching autoscaler.py with the following arguments:')
+            print('project_id: ' + self.project)
+            print('region: ' + self.region)
+            print('zone: ' + self.zone)
+            print('group_manager: ' + self.instance_group_manager)
+            print('computeinstancelimit: ' + str(self.compute_instance_limit))
+            print('debuglevel: ' + str(self.debug))
+
         # Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
         queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
         queue_length_resp = os.popen(queue_length_req).read().split()
@@ -259,16 +259,16 @@ def main():
     scaler = AutoScaler()
 
     # Project ID
-    scaler.project = args.project_id  # Ex:'slurm-var-demo'
+    scaler.project = args.p  # Ex:'slurm-var-demo'
     
     # Region where the managed instance group is located
-    scaler.region = args.region  # Ex: 'us-central1'
+    scaler.region = args.r  # Ex: 'us-central1'
     
     # Name of the zone where the managed instance group is located
-    scaler.zone = args.zone  # Ex: 'us-central1-f'
+    scaler.zone = args.z # Ex: 'us-central1-f'
     
     # The name of the managed instance group.
-    scaler.instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
+    scaler.instance_group_manager = args.g  # Ex: 'condor-compute-igm'
     
     # Default number of cores per intance, will be replaced with actual value
     scaler.cores_per_node = 4
@@ -278,17 +278,17 @@ def main():
     
     # Debug level: 1-print debug information, 2 - print detail debug information
     scaler.debug = 0
-    if (args.verbosity):
-        scaler.debug = args.verbosity
+    if (args.v):
+        scaler.debug = args.v
     
     # Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
     scaler.compute_instance_limit = 0
-    if (args.computeinstancelimit):
-        scaler.compute_instance_limit = abs(args.computeinstancelimit)
+    if (args.c):
+        scaler.compute_instance_limit = abs(args.c)
     
     
     scaler.scale()
 
 
 if __name__ == "__main__":
-    app.run(main)
\ No newline at end of file
+    main()
\ No newline at end of file

From 1384232526f8ce624341a654af8e36e1d295b8d7 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 9 Aug 2021 08:32:13 -0700
Subject: [PATCH 029/246] Test three modes

---
 qsimcirq/qsim_simulator.py      |  6 ++++-
 qsimcirq_tests/qsimcirq_test.py | 40 ++++++++++++++++++++++++++++++++-
 2 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index cbdabc87..66c68272 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -121,7 +121,11 @@ def __init__(
             )
         self._prng = value.parse_random_state(seed)
         # module to use for simulation
-        self._sim_module = qsim_gpu if qsim_options['g'] else qsim
+        self._sim_module = (
+            qsim_gpu
+            if 'g' in qsim_options and qsim_options['g']
+            else qsim
+        )
         self.qsim_options = {"t": 1, "f": 2, "v": 0, "r": 1}
         self.qsim_options.update(qsim_options)
         # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 914c7820..22266f3e 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1062,7 +1062,7 @@ def test_cirq_qsimh_simulate():
     assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
 
 
-def test_cirq_qsim_gpu_simulate():
+def test_cirq_qsim_gpu_amplitudes():
     # Pick qubits.
     a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
 
@@ -1078,6 +1078,44 @@ def test_cirq_qsim_gpu_simulate():
     assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
 
 
+def test_cirq_qsim_gpu_simulate():
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
+
+    # Enable GPU acceleration.
+    gpu_options = {'g': True}
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
+    result = qsimGpuSim.simulate(cirq_circuit)
+    assert result.state_vector().shape == (4,)
+
+    cirqSim = cirq.Simulator()
+    cirq_result = cirqSim.simulate(cirq_circuit)
+    assert cirq.linalg.allclose_up_to_global_phase(
+        result.state_vector(), cirq_result.state_vector(), atol=1.0e-6
+    )
+
+
+def test_cirq_qsim_gpu_expectation_values():
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
+    obs = [cirq.Z(a) * cirq.Z(b)]
+
+    # Enable GPU acceleration.
+    gpu_options = {'g': True}
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
+    result = qsimGpuSim.simulate_expectation_values(cirq_circuit, obs)
+
+    cirqSim = cirq.Simulator()
+    cirq_result = cirqSim.simulate_expectation_values(cirq_circuit, obs)
+    assert np.allclose(result, cirq_result)
+
+
 def test_cirq_qsim_params():
     qubit = cirq.GridQubit(0, 0)
 

From 687ca0850657511c2dab17eb3834947967c02b27 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 9 Aug 2021 11:29:30 -0700
Subject: [PATCH 030/246] Copy GPU state for python

---
 lib/vectorspace.h                |  4 ++++
 lib/vectorspace_cuda.h           |  4 ++++
 pybind_interface/pybind_main.cpp | 18 +++++++++++++-----
 3 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/lib/vectorspace.h b/lib/vectorspace.h
index dc871d9f..5a5a6c94 100644
--- a/lib/vectorspace.h
+++ b/lib/vectorspace.h
@@ -74,6 +74,10 @@ class VectorSpace {
       return num_qubits_;
     }
 
+    bool requires_copy_to_host() const {
+      return false;
+    }
+
    private:
     Pointer ptr_;
     unsigned num_qubits_;
diff --git a/lib/vectorspace_cuda.h b/lib/vectorspace_cuda.h
index c064a90b..ac228c63 100644
--- a/lib/vectorspace_cuda.h
+++ b/lib/vectorspace_cuda.h
@@ -67,6 +67,10 @@ class VectorSpaceCUDA {
       return num_qubits_;
     }
 
+    bool requires_copy_to_host() const {
+      return true;
+    }
+
    private:
     Pointer ptr_;
     unsigned num_qubits_;
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 070c0f45..af36483d 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -604,11 +604,19 @@ class SimulatorHelper {
 
   py::array_t<float> release_state_to_python() {
     state_space.InternalToNormalOrder(state);
-    uint64_t fsv_size = 2 * (uint64_t{1} << num_qubits);
-    float* fsv = state.release();
-    auto capsule = py::capsule(
-        fsv, [](void *data) { detail::free(data); });
-    return py::array_t<float>(fsv_size, fsv, capsule);
+    if (state.requires_copy_to_host()) {
+      uint64_t fsv_size = state_space.MinSize(state.num_qubits());
+      auto* fsv = new float[fsv_size];
+      state_space.Copy(state, fsv);
+      auto capsule = py::capsule(fsv, [](void *data) {});
+      return py::array_t<float>(fsv_size, fsv, capsule);
+    } else {
+      uint64_t fsv_size = 2 * (uint64_t{1} << num_qubits);
+      float* fsv = state.release();
+      auto capsule = py::capsule(
+          fsv, [](void *data) { detail::free(data); });
+      return py::array_t<float>(fsv_size, fsv, capsule);
+    }
   }
 
   std::vector<std::complex<double>> get_expectation_value(

From 47d2e1a574dd172c7d58ec5f6c9c1e0f39201b19 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 9 Aug 2021 12:29:40 -0700
Subject: [PATCH 031/246] Min size to actual size conversion.

---
 pybind_interface/pybind_main.cpp | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index af36483d..ed788ee2 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -604,14 +604,21 @@ class SimulatorHelper {
 
   py::array_t<float> release_state_to_python() {
     state_space.InternalToNormalOrder(state);
+    uint64_t fsv_size = 2 * (uint64_t{1} << num_qubits);
     if (state.requires_copy_to_host()) {
-      uint64_t fsv_size = state_space.MinSize(state.num_qubits());
+      uint64_t storage_size = state_space.MinSize(state.num_qubits());
       auto* fsv = new float[fsv_size];
-      state_space.Copy(state, fsv);
+      if (storage_size != fsv_size) {
+        auto* temp = new float[storage_size];
+        state_space.Copy(state, temp);
+        memcpy(fsv, temp, fsv_size * sizeof(float));
+        delete [] temp;
+      } else {
+        state_space.Copy(state, fsv);
+      }
       auto capsule = py::capsule(fsv, [](void *data) {});
       return py::array_t<float>(fsv_size, fsv, capsule);
     } else {
-      uint64_t fsv_size = 2 * (uint64_t{1} << num_qubits);
       float* fsv = state.release();
       auto capsule = py::capsule(
           fsv, [](void *data) { detail::free(data); });

From 4c9b5adf820204af9c043e7e0a042d19f853843d Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 9 Aug 2021 12:43:46 -0700
Subject: [PATCH 032/246] Surface dblocks in simulator options.

---
 pybind_interface/pybind_main.cpp |  2 +-
 qsimcirq/qsim_simulator.py       | 11 ++++-------
 qsimcirq_tests/qsimcirq_test.py  |  6 +++---
 3 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index ed788ee2..288b5b47 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -387,7 +387,7 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
   Runner::Parameter param;
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = 1;
+    num_dblocks = parseOptions<unsigned>(options, "g\0");
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     param.seed = parseOptions<unsigned>(options, "s\0");
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 66c68272..b1f57153 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -93,7 +93,8 @@ def __init__(
                 applied to all circuits run using this simulator. Accepted keys and
                 their behavior are as follows:
                     - 'f': int (> 0). Maximum size of fused gates. Default: 2.
-                    - 'g': bool. If true, simulate with GPU. Default: false.
+                    - 'g': int (>= 0). GPU dblocks to use. If set to zero,
+                           GPUs will not be used for simulation. Default: 0.
                     - 'r': int (> 0). Noisy repetitions (see below). Default: 1.
                     - 't': int (> 0). Number of threads to run on. Default: 1.
                     - 'v': int (>= 0). Log verbosity. Default: 0.
@@ -121,13 +122,9 @@ def __init__(
             )
         self._prng = value.parse_random_state(seed)
         # module to use for simulation
-        self._sim_module = (
-            qsim_gpu
-            if 'g' in qsim_options and qsim_options['g']
-            else qsim
-        )
-        self.qsim_options = {"t": 1, "f": 2, "v": 0, "r": 1}
+        self.qsim_options = {"t": 1, "g": 0, "f": 2, "v": 0, "r": 1}
         self.qsim_options.update(qsim_options)
+        self._sim_module = qsim_gpu if qsim_options['g'] > 0 else qsim
         # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
         self._translated_circuits = deque(maxlen=circuit_memoization_size)
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 22266f3e..4a3dafb7 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1070,7 +1070,7 @@ def test_cirq_qsim_gpu_amplitudes():
     cirq_circuit = cirq.Circuit(cirq.CNOT(a, b), cirq.CNOT(b, a), cirq.X(a))
 
     # Enable GPU acceleration.
-    gpu_options = {'g': True}
+    gpu_options = {'g': 32}
     qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
     result = qsimGpuSim.compute_amplitudes(
         cirq_circuit, bitstrings=[0b00, 0b01, 0b10, 0b11]
@@ -1086,7 +1086,7 @@ def test_cirq_qsim_gpu_simulate():
     cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
 
     # Enable GPU acceleration.
-    gpu_options = {'g': True}
+    gpu_options = {'g': 32}
     qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
     result = qsimGpuSim.simulate(cirq_circuit)
     assert result.state_vector().shape == (4,)
@@ -1107,7 +1107,7 @@ def test_cirq_qsim_gpu_expectation_values():
     obs = [cirq.Z(a) * cirq.Z(b)]
 
     # Enable GPU acceleration.
-    gpu_options = {'g': True}
+    gpu_options = {'g': 32}
     qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
     result = qsimGpuSim.simulate_expectation_values(cirq_circuit, obs)
 

From 720e9f296189ce8b22bcc6538e6e283aeeeea2fd Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 9 Aug 2021 12:46:11 -0700
Subject: [PATCH 033/246] Surface dblocks, part 2.

---
 pybind_interface/pybind_main.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 288b5b47..8c9ee116 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -431,7 +431,7 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
 
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = 1;
+    num_dblocks = parseOptions<unsigned>(options, "g\0");
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     seed = parseOptions<unsigned>(options, "s\0");
@@ -537,7 +537,7 @@ class SimulatorHelper {
         num_qubits = circuit.num_qubits;
       }
       num_threads = parseOptions<unsigned>(options, "t\0");
-      num_dblocks = 1;
+      num_dblocks = parseOptions<unsigned>(options, "g\0");
       max_fused_size = parseOptions<unsigned>(options, "f\0");
       verbosity = parseOptions<unsigned>(options, "v\0");
       seed = parseOptions<unsigned>(options, "s\0");
@@ -756,7 +756,7 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
   Runner::Parameter param;
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = 1;
+    num_dblocks = parseOptions<unsigned>(options, "g\0");
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     param.seed = parseOptions<unsigned>(options, "s\0");
@@ -806,7 +806,7 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
 
   try {
     num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = 1;
+    num_dblocks = parseOptions<unsigned>(options, "g\0");
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     seed = parseOptions<unsigned>(options, "s\0");

From c8e60ca3ff2c868b17396ff0ef0a06bb891840c4 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 9 Aug 2021 13:24:43 -0700
Subject: [PATCH 034/246] Surface dblocks, part 3.

---
 qsimcirq/qsim_simulator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index b1f57153..38f2cbe8 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -124,7 +124,7 @@ def __init__(
         # module to use for simulation
         self.qsim_options = {"t": 1, "g": 0, "f": 2, "v": 0, "r": 1}
         self.qsim_options.update(qsim_options)
-        self._sim_module = qsim_gpu if qsim_options['g'] > 0 else qsim
+        self._sim_module = qsim_gpu if self.qsim_options['g'] > 0 else qsim
         # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
         self._translated_circuits = deque(maxlen=circuit_memoization_size)
 

From 3e8c7b6c41cbad8f2cddc55728abf36c0c8f380d Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 9 Aug 2021 20:39:55 +0000
Subject: [PATCH 035/246] added autoscaler

---
 .../terraform/{ => htcondor}/autoscaler.py    |  1 +
 .../multinode/terraform/htcondor/resources.tf | 39 +++++++++++++------
 2 files changed, 28 insertions(+), 12 deletions(-)
 rename docs/tutorials/multinode/terraform/{ => htcondor}/autoscaler.py (99%)

diff --git a/docs/tutorials/multinode/terraform/autoscaler.py b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
similarity index 99%
rename from docs/tutorials/multinode/terraform/autoscaler.py
rename to docs/tutorials/multinode/terraform/htcondor/autoscaler.py
index 8669b7da..68c7a01d 100644
--- a/docs/tutorials/multinode/terraform/autoscaler.py
+++ b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
@@ -258,6 +258,7 @@ def main():
 
     scaler = AutoScaler()
 
+    exit()
     # Project ID
     scaler.project = args.p  # Ex:'slurm-var-demo'
     
diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index ab00a471..cad60189 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -30,7 +30,7 @@ variable "zone" {
 }
 variable "min_replicas" {
     type = number
-    default = 1
+    default = 0
 }
 variable "max_replicas" {
     type = number
@@ -199,7 +199,8 @@ resource "google_compute_instance" "condor-submit" {
   service_account {
       email = var.service_account
   #  email  = "487217491196-compute@developer.gserviceaccount.com"
-    scopes = ["https://www.googleapis.com/auth/monitoring.write", "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/servicecontrol", "https://www.googleapis.com/auth/devstorage.read_only", "https://www.googleapis.com/auth/logging.write", "https://www.googleapis.com/auth/service.management.readonly", "https://www.googleapis.com/auth/trace.append"]
+    #scopes = ["https://www.googleapis.com/auth/monitoring.write", "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/servicecontrol", "https://www.googleapis.com/auth/devstorage.read_only", "https://www.googleapis.com/auth/logging.write", "https://www.googleapis.com/auth/service.management.readonly", "https://www.googleapis.com/auth/trace.append"]
+    scopes = ["https://www.googleapis.com/auth/cloud-platform"]
   }
 
   shielded_instance_config {
@@ -210,6 +211,17 @@ resource "google_compute_instance" "condor-submit" {
 
   tags = ["${var.cluster_name}-submit"]
   zone = var.zone
+  provisioner "file" {
+    source = "autoscaler.py"
+    destination = "/opt/autoscaler.py"
+  
+    #connection {
+    #  type = "ssh"
+    #  user = "jon"
+    #  private_key = "${file("./creds/gcloud_instance")}"
+    #  agent = "false"
+    #}
+  }
 }
 resource "google_compute_instance_template" "condor-compute" {
   can_ip_forward = "false"
@@ -283,6 +295,7 @@ resource "google_compute_instance_group_manager" "condor-compute-igm" {
   ]
   zone = var.zone
 }
+/*
 resource "google_compute_autoscaler" "condor-compute-as" {
   name    = "${var.cluster_name}-compute-as"
   project = var.project
@@ -298,16 +311,16 @@ resource "google_compute_autoscaler" "condor-compute-as" {
       target = 0.2
     }
 
-    # metric {
-    #   name   = "custom.googleapis.com/q0"
-    #   target = var.metric_target_queue
-    #   type   = "GAUGE"
-    # }
-    # metric {
-    #   name   = "custom.googleapis.com/la0"
-    #   target = var.metric_target_loadavg
-    #   type   = "GAUGE"
-    # }
+    metric {
+       name   = "custom.googleapis.com/q0"
+       target = var.metric_target_queue
+       type   = "GAUGE"
+    }
+    metric {
+       name   = "custom.googleapis.com/la0"
+       target = var.metric_target_loadavg
+       type   = "GAUGE"
+    }
 
   }
 
@@ -320,3 +333,5 @@ resource "google_compute_autoscaler" "condor-compute-as" {
    google_compute_instance_group_manager.condor-compute-igm
   ]
 }
+*/
+

From 94773c59150f7902d810807b63ec554571f7309d Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 9 Aug 2021 20:50:46 +0000
Subject: [PATCH 036/246] Creating python vi startup.sh

---
 .../multinode/terraform/htcondor/resources.tf |  11 -
 .../terraform/htcondor/startup-centos.sh      | 280 +++++++++++++++++-
 2 files changed, 279 insertions(+), 12 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index cad60189..634a5814 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -211,17 +211,6 @@ resource "google_compute_instance" "condor-submit" {
 
   tags = ["${var.cluster_name}-submit"]
   zone = var.zone
-  provisioner "file" {
-    source = "autoscaler.py"
-    destination = "/opt/autoscaler.py"
-  
-    #connection {
-    #  type = "ssh"
-    #  user = "jon"
-    #  private_key = "${file("./creds/gcloud_instance")}"
-    #  agent = "false"
-    #}
-  }
 }
 resource "google_compute_instance_template" "condor-compute" {
   can_ip_forward = "false"
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
index cc5dbedc..1336b547 100644
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -173,4 +173,282 @@ if [ "$SERVER_TYPE" == "submit" ]; then
   python3 -m pip install --upgrade oauth2client
   python3 -m pip install --upgrade google-api-python-client
   python3 -m pip install --upgrade absl-py
-fi
\ No newline at end of file
+fi
+
+cat <<EOFZ > /opt/autoscaler.py
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Copyright 2018 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Script for resizing managed instance group (MIG) cluster size based
+# on the number of jobs in the Condor Queue.
+
+from pprint import pprint
+from googleapiclient import discovery
+from oauth2client.client import GoogleCredentials
+
+import os
+import math
+import argparse
+
+parser = argparse.ArgumentParser("autoscaler.py")
+parser.add_argument("-p", "--project_id", help="Project id", type=str)
+parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
+parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
+parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
+parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
+parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
+args = parser.parse_args()
+
+# Project ID
+project = args.project_id  # Ex:'slurm-var-demo'
+
+# Region where the managed instance group is located
+region = args.region  # Ex: 'us-central1'
+
+# Name of the zone where the managed instance group is located
+zone = args.zone  # Ex: 'us-central1-f'
+
+# The name of the managed instance group.
+instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
+
+# Default number of cores per intance, will be replaced with actual value
+cores_per_node = 4
+
+# Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
+size = 0
+
+# Debug level: 1-print debug information, 2 - print detail debug information
+debug = 0
+if (args.verbosity):
+    debug = args.verbosity
+
+# Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
+compute_instance_limit = 0
+if (args.computeinstancelimit):
+    compute_instance_limit = abs(args.computeinstancelimit)
+
+
+if debug > 1:
+    print('Launching autoscaler.py with the following arguments:')
+    print('project_id: ' + project)
+    print('region: ' + region)
+    print('zone: ' + zone)
+    print('group_manager: ' + instance_group_manager)
+    print('computeinstancelimit: ' + str(compute_instance_limit))
+    print('debuglevel: ' + str(debug))
+
+
+# Remove specified instance from MIG and decrease MIG size
+def deleteFromMig(instance):
+    instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' \
+        + project + '/zones/' + zone + '/instances/' + instance
+    instances_to_delete = {'instances': [instanceUrl]}
+
+    requestDelInstance = \
+        service.instanceGroupManagers().deleteInstances(project=project,
+            zone=zone, instanceGroupManager=instance_group_manager,
+            body=instances_to_delete)
+    response = requestDelInstance.execute()
+    if debug > 0:
+        print('Request to delete instance ' + instance)
+        pprint(response)
+
+    return response
+
+def getInstanceTemplateInfo():
+    requestTemplateName = \
+        service.instanceGroupManagers().get(project=project, zone=zone,
+            instanceGroupManager=instance_group_manager,
+            fields='instanceTemplate')
+    responseTemplateName = requestTemplateName.execute()
+    template_name = ''
+
+    if debug > 1:
+        print('Request for the template name')
+        pprint(responseTemplateName)
+
+    if len(responseTemplateName) > 0:
+        template_url = responseTemplateName.get('instanceTemplate')
+        template_url_partitioned = template_url.split('/')
+        template_name = \
+            template_url_partitioned[len(template_url_partitioned) - 1]
+
+    requestInstanceTemplate = \
+        service.instanceTemplates().get(project=project,
+            instanceTemplate=template_name, fields='properties')
+    responseInstanceTemplateInfo = requestInstanceTemplate.execute()
+
+    if debug > 1:
+        print('Template information')
+        pprint(responseInstanceTemplateInfo['properties'])
+
+    machine_type = responseInstanceTemplateInfo['properties']['machineType']
+    is_preemtible = responseInstanceTemplateInfo['properties']['scheduling']['preemptible']
+    if debug > 0:
+        print('Machine Type: ' + machine_type)
+        print('Is preemtible: ' + str(is_preemtible))
+    request = service.machineTypes().get(project=project, zone=zone,
+            machineType=machine_type)
+    response = request.execute()
+    guest_cpus = response['guestCpus']
+    if debug > 1:
+        print('Machine information')
+        pprint(responseInstanceTemplateInfo['properties'])
+    if debug > 0:
+        print('Guest CPUs: ' + str(guest_cpus))
+
+    instanceTemlateInfo = {'machine_type': machine_type,
+                           'is_preemtible': is_preemtible,
+                           'guest_cpus': guest_cpus}
+    return instanceTemlateInfo
+
+
+# Obtain credentials
+credentials = GoogleCredentials.get_application_default()
+service = discovery.build('compute', 'v1', credentials=credentials)
+
+# Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
+queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
+queue_length_resp = os.popen(queue_length_req).read().split()
+
+if len(queue_length_resp) > 1:
+    queue = int(queue_length_resp[0])
+    idle_jobs = int(queue_length_resp[1])
+    on_hold_jobs = int(queue_length_resp[2])
+else:
+    queue = 0
+    idle_jobs = 0
+    on_hold_jobs = 0
+
+print('Total queue length: ' + str(queue))
+print('Idle jobs: ' + str(idle_jobs))
+print('Jobs on hold: ' + str(on_hold_jobs))
+
+instanceTemlateInfo = getInstanceTemplateInfo()
+if debug > 1:
+    print('Information about the compute instance template')
+    pprint(instanceTemlateInfo)
+
+cores_per_node = instanceTemlateInfo['guest_cpus']
+print('Number of CPU per compute node: ' + str(cores_per_node))
+
+# Get state for for all jobs in Condor
+name_req = 'condor_status  -af name state'
+slot_names = os.popen(name_req).read().splitlines()
+if debug > 1:
+    print('Currently running jobs in Condor')
+    print(slot_names)
+
+# Adjust current queue length by the number of jos that are on-hold
+queue -=on_hold_jobs
+if on_hold_jobs>0:
+    print("Adjusted queue length: " + str(queue))
+
+# Calculate number instances to satisfy current job queue length
+if queue > 0:
+    size = int(math.ceil(float(queue) / float(cores_per_node)))
+    if debug>0:
+       print("Calucalting size of MIG: ⌈" + str(queue) + "/" + str(cores_per_node) + "⌉ = " + str(size))
+else:
+    size = 0
+
+# If compute instance limit is specified, can not start more instances then specified in the limit
+if compute_instance_limit > 0 and size > compute_instance_limit:
+    size = compute_instance_limit;
+    print("MIG target size will be limited by " + str(compute_instance_limit))
+
+print('New MIG target size: ' + str(size))
+
+# Get current number of instances in the MIG
+requestGroupInfo = service.instanceGroupManagers().get(project=project,
+        zone=zone, instanceGroupManager=instance_group_manager)
+responseGroupInfo = requestGroupInfo.execute()
+currentTarget = int(responseGroupInfo['targetSize'])
+print('Current MIG target size: ' + str(currentTarget))
+
+if debug > 1:
+    print('MIG Information:')
+    print(responseGroupInfo)
+
+if size == 0 and currentTarget == 0:
+    print('No jobs in the queue and no compute instances running. Nothing to do')
+    exit()
+
+if size == currentTarget:
+    print('Running correct number of compute nodes to handle number of jobs in the queue')
+    exit()
+
+
+if size < currentTarget:
+    print('Scaling down. Looking for nodes that can be shut down' )
+    # Find nodes that are not busy (all slots showing status as "Unclaimed")
+
+    node_busy = {}
+    for slot_name in slot_names:
+        name_status = slot_name.split()
+        if len(name_status) > 1:
+            name = name_status[0]
+            status = name_status[1]
+            slot = "NO-SLOT"
+            slot_server = name.split('@')
+            if len(slot_server) > 1:
+                slot = slot_server[0]
+                server = slot_server[1].split('.')[0]
+            else:
+                server = slot_server[0].split('.')[0]
+
+            if debug > 0:
+                print(slot + ', ' + server + ', ' + status + '\n')
+
+            if server not in node_busy:
+                if status == 'Unclaimed':
+                    node_busy[server] = False
+                else:
+                    node_busy[server] = True
+            else:
+                if status != 'Unclaimed':
+                    node_busy[server] = True
+                    
+    if debug > 1:
+        print('Compuute node busy status:')
+        print(node_busy)
+
+    # Shut down nodes that are not busy
+    for node in node_busy:
+        if not node_busy[node]:
+            print('Will shut down: ' + node + ' ...')
+            respDel = deleteFromMig(node)
+            if debug > 1:
+                print("Shut down request for compute node " + node)
+                pprint(respDel)
+                
+    if debug > 1:
+        print("Scaling down complete")
+
+if size > currentTarget:
+    print("Scaling up. Need to increase number of instances to " + str(size))
+    #Request to resize
+    request = service.instanceGroupManagers().resize(project=project,
+            zone=zone, 
+            instanceGroupManager=instance_group_manager,
+            size=size)
+    response = request.execute()
+    if debug > 1:
+        print('Requesting to increase MIG size')
+        pprint(response)
+        print("Scaling up complete")
+EOFZ

From b6cfa1fedfd07ddeec6ea382ad6643e549e5f22f Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 9 Aug 2021 21:06:51 +0000
Subject: [PATCH 037/246] Set min num nodes to 0

---
 docs/tutorials/multinode/terraform/main.tf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
index 72ac2f8d..c883028c 100644
--- a/docs/tutorials/multinode/terraform/main.tf
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -18,7 +18,7 @@ module "htcondor" {
   zone = var.zone
   osversion = "7"
   max_replicas=20
-  min_replicas=1
+  min_replicas=0
   service_account="htcondor@${var.project}.iam.gserviceaccount.com"
   use_preemptibles=false
   osproject ="centos-cloud"

From 805837b836f71b3f53631e780ff3625bf51c2ede Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 09:00:32 -0700
Subject: [PATCH 038/246] Overhaul qsim options.

---
 pybind_interface/avx2/pybind_main_avx2.cpp    |   9 +-
 .../avx512/pybind_main_avx512.cpp             |   9 +-
 pybind_interface/basic/pybind_main_basic.cpp  |   9 +-
 pybind_interface/cuda/pybind_main_cuda.cpp    |   8 +-
 pybind_interface/pybind_main.cpp              | 120 +++++++++++++-----
 pybind_interface/sse/pybind_main_sse.cpp      |   9 +-
 qsimcirq/__init__.py                          |   7 +-
 qsimcirq/qsim_simulator.py                    |  83 +++++++++---
 qsimcirq_tests/qsimcirq_test.py               |  18 ++-
 9 files changed, 201 insertions(+), 71 deletions(-)

diff --git a/pybind_interface/avx2/pybind_main_avx2.cpp b/pybind_interface/avx2/pybind_main_avx2.cpp
index 54ad2d30..5729d163 100644
--- a/pybind_interface/avx2/pybind_main_avx2.cpp
+++ b/pybind_interface/avx2/pybind_main_avx2.cpp
@@ -22,9 +22,12 @@ namespace qsim {
   using Simulator = SimulatorAVX<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GPU version.
-    Factory(unsigned num_threads, unsigned num_dblocks)
-      : num_threads(num_threads) {}
+    // num_state_threads and num_dblocks are unused, but kept for consistency
+    // with the GPU Factory.
+    Factory(
+      unsigned num_sim_threads,
+      unsigned num_state_threads,
+      unsigned num_dblocks) : num_threads(num_sim_threads) {}
 
     using Simulator = qsim::Simulator<For>;
     using StateSpace = Simulator::StateSpace;
diff --git a/pybind_interface/avx512/pybind_main_avx512.cpp b/pybind_interface/avx512/pybind_main_avx512.cpp
index 996de2c6..0073a1e0 100644
--- a/pybind_interface/avx512/pybind_main_avx512.cpp
+++ b/pybind_interface/avx512/pybind_main_avx512.cpp
@@ -22,9 +22,12 @@ namespace qsim {
   using Simulator = SimulatorAVX512<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GPU version.
-    Factory(unsigned num_threads, unsigned num_dblocks)
-      : num_threads(num_threads) {}
+    // num_state_threads and num_dblocks are unused, but kept for consistency
+    // with the GPU Factory.
+    Factory(
+      unsigned num_sim_threads,
+      unsigned num_state_threads,
+      unsigned num_dblocks) : num_threads(num_sim_threads) {}
 
     using Simulator = qsim::Simulator<For>;
     using StateSpace = Simulator::StateSpace;
diff --git a/pybind_interface/basic/pybind_main_basic.cpp b/pybind_interface/basic/pybind_main_basic.cpp
index 244688b5..55cb5484 100644
--- a/pybind_interface/basic/pybind_main_basic.cpp
+++ b/pybind_interface/basic/pybind_main_basic.cpp
@@ -22,9 +22,12 @@ namespace qsim {
   using Simulator = SimulatorBasic<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GPU version.
-    Factory(unsigned num_threads, unsigned num_dblocks)
-      : num_threads(num_threads) {}
+    // num_state_threads and num_dblocks are unused, but kept for consistency
+    // with the GPU Factory.
+    Factory(
+      unsigned num_sim_threads,
+      unsigned num_state_threads,
+      unsigned num_dblocks) : num_threads(num_sim_threads) {}
 
     using Simulator = qsim::Simulator<For>;
     using StateSpace = Simulator::StateSpace;
diff --git a/pybind_interface/cuda/pybind_main_cuda.cpp b/pybind_interface/cuda/pybind_main_cuda.cpp
index b55d0d65..825082f5 100644
--- a/pybind_interface/cuda/pybind_main_cuda.cpp
+++ b/pybind_interface/cuda/pybind_main_cuda.cpp
@@ -23,8 +23,12 @@ namespace qsim {
     using Simulator = qsim::Simulator;
     using StateSpace = Simulator::StateSpace;
 
-    Factory(unsigned num_threads, unsigned num_dblocks)
-      : ss_params{num_threads, num_dblocks}, sim_params{num_threads} {}
+    Factory(
+      unsigned num_sim_threads,
+      unsigned num_state_threads,
+      unsigned num_dblocks
+    ) : ss_params{num_state_threads, num_dblocks},
+        sim_params{num_sim_threads} {}
 
     StateSpace CreateStateSpace() const {
       return StateSpace(ss_params);
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 8c9ee116..2a28d1ac 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -382,12 +382,20 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
   using Runner = QSimRunner<IO, MultiQubitGateFuser<IO, Cirq::GateCirq<float>>,
                             Factory>;
 
-  unsigned num_threads;
-  unsigned num_dblocks;
+  bool use_gpu;
+  unsigned num_sim_threads;
+  unsigned num_state_threads = 0;
+  unsigned num_dblocks = 0;
   Runner::Parameter param;
   try {
-    num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = parseOptions<unsigned>(options, "g\0");
+    use_gpu = parseOptions<unsigned>(options, "g\0");
+    if (use_gpu) {
+      num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
+      num_state_threads = parseOptions<unsigned>(options, "gsst\0");
+      num_dblocks = parseOptions<unsigned>(options, "gdb\0");
+    } else {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     param.seed = parseOptions<unsigned>(options, "s\0");
@@ -395,7 +403,9 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
     IO::errorf(exp.what());
     return {};
   }
-  Runner::Run(param, Factory(num_threads, num_dblocks), circuit, measure);
+  Runner::Run(
+    param, Factory(num_sim_threads, num_state_threads, num_dblocks), circuit,
+    measure);
   return amplitudes;
 }
 
@@ -425,13 +435,21 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
                                                   Simulator>;
 
   Runner::Parameter param;
-  unsigned num_threads;
-  unsigned num_dblocks;
+  bool use_gpu;
+  unsigned num_sim_threads;
+  unsigned num_state_threads = 0;
+  unsigned num_dblocks = 0;
   uint64_t seed;
 
   try {
-    num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = parseOptions<unsigned>(options, "g\0");
+    use_gpu = parseOptions<unsigned>(options, "g\0");
+    if (use_gpu) {
+      num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
+      num_state_threads = parseOptions<unsigned>(options, "gsst\0");
+      num_dblocks = parseOptions<unsigned>(options, "gdb\0");
+    } else {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     seed = parseOptions<unsigned>(options, "s\0");
@@ -440,8 +458,10 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
     return {};
   }
 
-  Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
-  StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
+  Simulator simulator = Factory(
+    num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
+  StateSpace state_space = Factory(
+    num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
 
   auto measure = [&bitstrings, &ncircuit, &amplitudes, &state_space](
                   unsigned k, const State &state,
@@ -522,7 +542,7 @@ class SimulatorHelper {
 
  private:
   SimulatorHelper(const py::dict &options, bool noisy)
-      : state_space(Factory(1, 1).CreateStateSpace()),
+      : state_space(Factory(1, 1, 1).CreateStateSpace()),
         state(StateSpace::Null()),
         scratch(StateSpace::Null()) {
     is_valid = false;
@@ -536,13 +556,21 @@ class SimulatorHelper {
         circuit = getCircuit(options);
         num_qubits = circuit.num_qubits;
       }
-      num_threads = parseOptions<unsigned>(options, "t\0");
-      num_dblocks = parseOptions<unsigned>(options, "g\0");
+
+      use_gpu = parseOptions<unsigned>(options, "g\0");
+      if (use_gpu) {
+        num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
+        num_state_threads = parseOptions<unsigned>(options, "gsst\0");
+        num_dblocks = parseOptions<unsigned>(options, "gdb\0");
+      } else {
+        num_sim_threads = parseOptions<unsigned>(options, "t\0");
+      }
       max_fused_size = parseOptions<unsigned>(options, "f\0");
       verbosity = parseOptions<unsigned>(options, "v\0");
       seed = parseOptions<unsigned>(options, "s\0");
 
-      state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
+      state_space = Factory(
+        num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
       state = state_space.Create(num_qubits);
       is_valid = true;
     } catch (const std::invalid_argument &exp) {
@@ -562,7 +590,7 @@ class SimulatorHelper {
                 float* fsv) {
       fsv[i] = ptr[i];
     };
-    For(num_threads).Run(input_vector.size(), f, ptr, state.get());
+    For(num_sim_threads).Run(input_vector.size(), f, ptr, state.get());
     state_space.NormalToInternalOrder(state);
   }
 
@@ -589,14 +617,18 @@ class SimulatorHelper {
       std::vector<uint64_t> stat;
       auto params = get_noisy_params();
 
-      Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
-      StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
+      Simulator simulator = Factory(
+        num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
+      StateSpace state_space = Factory(
+        num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
 
       result = NoisyRunner::RunOnce(params, ncircuit, seed, state_space,
                                     simulator, scratch, state, stat);
     } else {
       result = Runner::Run(
-        get_params(), Factory(num_threads, num_dblocks), circuit, state);
+        get_params(),
+        Factory(num_sim_threads, num_state_threads, num_dblocks),
+        circuit, state);
     }
     seed += 1;
     return result;
@@ -629,7 +661,8 @@ class SimulatorHelper {
   std::vector<std::complex<double>> get_expectation_value(
       const std::vector<std::tuple<std::vector<OpString<Gate>>,
                                    unsigned>>& opsums_and_qubit_counts) {
-    Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
+    Simulator simulator = Factory(
+      num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
     using Fuser = MultiQubitGateFuser<IO, Gate>;
 
     std::vector<std::complex<double>> results;
@@ -657,8 +690,10 @@ class SimulatorHelper {
   State state;
   State scratch;
 
+  bool use_gpu;
   unsigned num_qubits;
-  unsigned num_threads;
+  unsigned num_sim_threads;
+  unsigned num_state_threads;
   unsigned num_dblocks;
   unsigned noisy_reps;
   unsigned max_fused_size;
@@ -751,12 +786,20 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
   using Runner = QSimRunner<IO, MultiQubitGateFuser<IO, Cirq::GateCirq<float>>,
                             Factory>;
 
-  unsigned num_threads;
-  unsigned num_dblocks;
+  bool use_gpu;
+  unsigned num_sim_threads;
+  unsigned num_state_threads = 0;
+  unsigned num_dblocks = 0;
   Runner::Parameter param;
   try {
-    num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = parseOptions<unsigned>(options, "g\0");
+    use_gpu = parseOptions<unsigned>(options, "g\0");
+    if (use_gpu) {
+      num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
+      num_state_threads = parseOptions<unsigned>(options, "gsst\0");
+      num_dblocks = parseOptions<unsigned>(options, "gdb\0");
+    } else {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     param.seed = parseOptions<unsigned>(options, "s\0");
@@ -766,11 +809,14 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
   }
 
   std::vector<MeasurementResult> results;
-  StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
+  StateSpace state_space = Factory(
+    num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
   State state = state_space.Create(circuit.num_qubits);
   state_space.SetStateZero(state);
 
-  if (!Runner::Run(param, Factory(num_threads, num_dblocks), circuit, state, results)) {
+  if (!Runner::Run(
+        param, Factory(num_sim_threads, num_state_threads, num_dblocks),
+        circuit, state, results)) {
     IO::errorf("qsim sampling of the circuit errored out.\n");
     return {};
   }
@@ -800,13 +846,21 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
                                                   Simulator>;
 
   Runner::Parameter param;
-  unsigned num_threads;
+  bool use_gpu;
+  unsigned num_sim_threads;
+  unsigned num_state_threads;
   unsigned num_dblocks;
   uint64_t seed;
 
   try {
-    num_threads = parseOptions<unsigned>(options, "t\0");
-    num_dblocks = parseOptions<unsigned>(options, "g\0");
+    use_gpu = parseOptions<unsigned>(options, "g\0");
+    if (use_gpu) {
+      num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
+      num_state_threads = parseOptions<unsigned>(options, "gsst\0");
+      num_dblocks = parseOptions<unsigned>(options, "gdb\0");
+    } else {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
     seed = parseOptions<unsigned>(options, "s\0");
@@ -816,8 +870,10 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
     return {};
   }
 
-  Simulator simulator = Factory(num_threads, num_dblocks).CreateSimulator();
-  StateSpace state_space = Factory(num_threads, num_dblocks).CreateStateSpace();
+  Simulator simulator = Factory(
+    num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
+  StateSpace state_space = Factory(
+    num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
 
   std::vector<std::vector<unsigned>> results;
 
diff --git a/pybind_interface/sse/pybind_main_sse.cpp b/pybind_interface/sse/pybind_main_sse.cpp
index 21490f68..4c72a65a 100644
--- a/pybind_interface/sse/pybind_main_sse.cpp
+++ b/pybind_interface/sse/pybind_main_sse.cpp
@@ -22,9 +22,12 @@ namespace qsim {
   using Simulator = SimulatorSSE<For>;
 
   struct Factory {
-    // num_dblocks is unused, but kept for consistency with GPU version.
-    Factory(unsigned num_threads, unsigned num_dblocks)
-      : num_threads(num_threads) {}
+    // num_state_threads and num_dblocks are unused, but kept for consistency
+    // with the GPU Factory.
+    Factory(
+      unsigned num_sim_threads,
+      unsigned num_state_threads,
+      unsigned num_dblocks) : num_threads(num_sim_threads) {}
 
     using Simulator = qsim::Simulator<For>;
     using StateSpace = Simulator::StateSpace;
diff --git a/qsimcirq/__init__.py b/qsimcirq/__init__.py
index 687d899a..f1542018 100644
--- a/qsimcirq/__init__.py
+++ b/qsimcirq/__init__.py
@@ -28,7 +28,12 @@ def _load_qsim_gpu():
 qsim_gpu = _load_qsim_gpu()
 
 from .qsim_circuit import add_op_to_opstring, add_op_to_circuit, QSimCircuit
-from .qsim_simulator import QSimSimulatorState, QSimSimulatorTrialResult, QSimSimulator
+from .qsim_simulator import (
+    QSimOptions,
+    QSimSimulatorState,
+    QSimSimulatorTrialResult,
+    QSimSimulator,
+)
 from .qsimh_simulator import QSimhSimulator
 
 from qsimcirq._version import (
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 38f2cbe8..63ab5998 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 from collections import deque
+from dataclasses import dataclass
 from typing import Any, Dict, List, Optional, Sequence, Tuple, Union
 
 from cirq import (
@@ -74,6 +75,59 @@ def _needs_trajectories(circuit: circuits.Circuit) -> bool:
     return False
 
 
+@dataclass
+class QSimOptions:
+    """Container for options to the QSimSimulator.
+
+    Options for the simulator can also be provided as a {string: value} dict,
+    using the format shown in the 'as_dict' function for this class.
+
+    Args:
+        max_fused_gate_size: maximum number of qubits allowed per fused gate.
+            Depending on the capabilities of the device qsim runs on, this
+            usually has best performance when set to 3 or 4.
+        cpu_threads: number of threads to use when running on CPU. For best
+            performance, this should equal the number of cores on the device.
+        ev_noisy_repetitions: number of repetitions used for estimating
+            expectation values of a noisy circuit. Does not affect other
+            simulation modes.
+        use_gpu: whether to use GPU instead of CPU for simulation. The "gpu_*"
+            arguments below are only considered if this is set to True.
+        gpu_sim_threads: number of threads to use for the GPU Simulator.
+            This must be a power of 2 in the range [32, 256].
+        gpu_state_threads: number of threads to use for the GPU StateSpace.
+            This must be a power of 2 in the range [32, 1024].
+        gpu_data_blocks: number of data blocks to use on GPU. Below 16 data
+            blocks, performance is noticeably reduced.
+        verbosity: Logging verbosity.
+    """
+
+    max_fused_gate_size: int = 2
+    cpu_threads: int = 1
+    ev_noisy_repetitions: int = 1
+    use_gpu: bool = False
+    gpu_sim_threads: int = 32
+    gpu_state_threads: int = 32
+    gpu_data_blocks: int = 16
+    verbosity: int = 0
+
+    def as_dict(self):
+        """Generates an options dict from this object.
+
+        Options to QSimSimulator can also be provided in this format directly.
+        """
+        return {
+            "f": self.max_fused_gate_size,
+            "t": self.cpu_threads,
+            "r": self.ev_noisy_repetitions,
+            "g": self.use_gpu,
+            "gsmt": self.gpu_sim_threads,
+            "gsst": self.gpu_state_threads,
+            "gdb": self.gpu_data_blocks,
+            "v": self.verbosity,
+        }
+
+
 class QSimSimulator(
     SimulatesSamples,
     SimulatesAmplitudes,
@@ -82,26 +136,16 @@ class QSimSimulator(
 ):
     def __init__(
         self,
-        qsim_options: dict = {},
+        qsim_options: Union[None, Dict, QSimOptions] = None,
         seed: value.RANDOM_STATE_OR_SEED_LIKE = None,
         circuit_memoization_size: int = 0,
     ):
         """Creates a new QSimSimulator using the given options and seed.
 
         Args:
-            qsim_options: A map of circuit options for the simulator. These will be
-                applied to all circuits run using this simulator. Accepted keys and
-                their behavior are as follows:
-                    - 'f': int (> 0). Maximum size of fused gates. Default: 2.
-                    - 'g': int (>= 0). GPU dblocks to use. If set to zero,
-                           GPUs will not be used for simulation. Default: 0.
-                    - 'r': int (> 0). Noisy repetitions (see below). Default: 1.
-                    - 't': int (> 0). Number of threads to run on. Default: 1.
-                    - 'v': int (>= 0). Log verbosity. Default: 0.
-                See qsim/docs/usage.md for more details on these options.
-                "Noisy repetitions" specifies how many repetitions to aggregate
-                over when calculating expectation values for a noisy circuit.
-                Note that this does not apply to other simulation types.
+            qsim_options: An options dict or QSimOptions object with options
+                to use for all circuits run using this simulator. See the
+                QSimOptions class for details.
             seed: A random state or seed object, as defined in cirq.value.
             circuit_memoization_size: The number of last translated circuits
                 to be memoized from simulation executions, to eliminate
@@ -115,16 +159,21 @@ def __init__(
         Raises:
             ValueError if internal keys 'c', 'i' or 's' are included in 'qsim_options'.
         """
+        if isinstance(qsim_options, QSimOptions):
+            qsim_options = qsim_options.as_dict()
+        else:
+            qsim_options = qsim_options or {}
+
         if any(k in qsim_options for k in ("c", "i", "s")):
             raise ValueError(
                 'Keys {"c", "i", "s"} are reserved for internal use and cannot be '
                 "used in QSimCircuit instantiation."
             )
         self._prng = value.parse_random_state(seed)
-        # module to use for simulation
-        self.qsim_options = {"t": 1, "g": 0, "f": 2, "v": 0, "r": 1}
+        self.qsim_options = QSimOptions().as_dict()
         self.qsim_options.update(qsim_options)
-        self._sim_module = qsim_gpu if self.qsim_options['g'] > 0 else qsim
+        # module to use for simulation
+        self._sim_module = qsim_gpu if self.qsim_options["g"] > 0 else qsim
         # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
         self._translated_circuits = deque(maxlen=circuit_memoization_size)
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 4a3dafb7..da6a87a3 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -976,7 +976,8 @@ def test_noise_aggregation():
 
     # Test expectation value aggregation over repetitions of a noisy circuit.
     # Repetitions are handled in C++, so overhead costs are minimal.
-    qsim_simulator = qsimcirq.QSimSimulator(qsim_options={"r": 10000}, seed=1)
+    qsim_options = qsimcirq.QSimOptions(ev_noisy_repetitions=10000)
+    qsim_simulator = qsimcirq.QSimSimulator(qsim_options=qsim_options, seed=1)
     qsim_evs = qsim_simulator.simulate_expectation_values(circuit, [psum1, psum2])
     assert len(qsim_evs) == 2
 
@@ -1008,10 +1009,12 @@ def test_multi_qubit_fusion():
         cirq.Y(q1) ** 0.5,
     )
 
-    qsimSim = qsimcirq.QSimSimulator(qsim_options={"f": 2})
+    options = qsimcirq.QSimOptions(max_fused_gate_size=2)
+    qsimSim = qsimcirq.QSimSimulator(qsim_options=options)
     result_2q_fusion = qsimSim.simulate(cirq_circuit, qubit_order=qubits)
 
-    qsimSim = qsimcirq.QSimSimulator(qsim_options={"f": 4})
+    options.max_fused_gate_size = 4
+    qsimSim = qsimcirq.QSimSimulator(qsim_options=options)
     result_4q_fusion = qsimSim.simulate(cirq_circuit, qubit_order=qubits)
     assert cirq.linalg.allclose_up_to_global_phase(
         result_2q_fusion.state_vector(), result_4q_fusion.state_vector()
@@ -1022,7 +1025,8 @@ def test_multi_qubit_fusion():
 def test_cirq_qsim_simulate_random_unitary(mode: str):
 
     q0, q1 = cirq.LineQubit.range(2)
-    qsimSim = qsimcirq.QSimSimulator(qsim_options={"t": 16, "v": 0})
+    options = qsimcirq.QSimOptions(cpu_threads=16, verbosity=0)
+    qsimSim = qsimcirq.QSimSimulator(qsim_options=options)
     for iter in range(10):
         random_circuit = cirq.testing.random_circuit(
             qubits=[q0, q1], n_moments=8, op_density=0.99, random_state=iter
@@ -1070,7 +1074,7 @@ def test_cirq_qsim_gpu_amplitudes():
     cirq_circuit = cirq.Circuit(cirq.CNOT(a, b), cirq.CNOT(b, a), cirq.X(a))
 
     # Enable GPU acceleration.
-    gpu_options = {'g': 32}
+    gpu_options = qsimcirq.QSimOptions(use_gpu=True)
     qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
     result = qsimGpuSim.compute_amplitudes(
         cirq_circuit, bitstrings=[0b00, 0b01, 0b10, 0b11]
@@ -1086,7 +1090,7 @@ def test_cirq_qsim_gpu_simulate():
     cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
 
     # Enable GPU acceleration.
-    gpu_options = {'g': 32}
+    gpu_options = qsimcirq.QSimOptions(use_gpu=True)
     qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
     result = qsimGpuSim.simulate(cirq_circuit)
     assert result.state_vector().shape == (4,)
@@ -1107,7 +1111,7 @@ def test_cirq_qsim_gpu_expectation_values():
     obs = [cirq.Z(a) * cirq.Z(b)]
 
     # Enable GPU acceleration.
-    gpu_options = {'g': 32}
+    gpu_options = qsimcirq.QSimOptions(use_gpu=True)
     qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
     result = qsimGpuSim.simulate_expectation_values(cirq_circuit, obs)
 

From 7a8b96bc746b1f5ecde3144601f2c014114d0cc6 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 09:20:24 -0700
Subject: [PATCH 039/246] Apply recommended pybind_main cleanup

---
 pybind_interface/pybind_main.cpp | 16 +++++-----------
 1 file changed, 5 insertions(+), 11 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 2a28d1ac..f3884a73 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -638,17 +638,11 @@ class SimulatorHelper {
     state_space.InternalToNormalOrder(state);
     uint64_t fsv_size = 2 * (uint64_t{1} << num_qubits);
     if (state.requires_copy_to_host()) {
-      uint64_t storage_size = state_space.MinSize(state.num_qubits());
-      auto* fsv = new float[fsv_size];
-      if (storage_size != fsv_size) {
-        auto* temp = new float[storage_size];
-        state_space.Copy(state, temp);
-        memcpy(fsv, temp, fsv_size * sizeof(float));
-        delete [] temp;
-      } else {
-        state_space.Copy(state, fsv);
-      }
-      auto capsule = py::capsule(fsv, [](void *data) {});
+      auto* fsv = new float[state_space.MinSize(state.num_qubits())];
+      state_space.Copy(state, fsv);
+      // Cast on delete to silence warnings.
+      auto capsule = py::capsule(
+        fsv, [](void *data) { delete [] (float*)data; });
       return py::array_t<float>(fsv_size, fsv, capsule);
     } else {
       float* fsv = state.release();

From f00327635d647944529bc1c48e9399dea9d44f03 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 09:26:40 -0700
Subject: [PATCH 040/246] Initialize before use.

---
 pybind_interface/pybind_main.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index f3884a73..7bde45de 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -842,8 +842,8 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
   Runner::Parameter param;
   bool use_gpu;
   unsigned num_sim_threads;
-  unsigned num_state_threads;
-  unsigned num_dblocks;
+  unsigned num_state_threads = 0;
+  unsigned num_dblocks = 0;
   uint64_t seed;
 
   try {

From 05e4260fda91fae77f4cbb1ba239a3720760ac36 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 11:38:27 -0700
Subject: [PATCH 041/246] WIP GPU-less support

---
 pybind_interface/Makefile          |  4 +++-
 pybind_interface/decide/decide.cpp | 10 +++++++++-
 qsimcirq/qsim_simulator.py         |  7 ++++++-
 qsimcirq_tests/qsimcirq_test.py    | 18 ++++++++++++++++++
 4 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index 89ea0607..ce2b0b5d 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -22,7 +22,9 @@ pybind:
 	$(CXX) sse/pybind_main_sse.cpp -o $(QSIMLIB_SSE) $(CXXFLAGS) $(PYBINDFLAGS_SSE)
 	$(CXX) avx2/pybind_main_avx2.cpp -o $(QSIMLIB_AVX2) $(CXXFLAGS) $(PYBINDFLAGS_AVX2)
 	$(CXX) avx512/pybind_main_avx512.cpp -o $(QSIMLIB_AVX512) $(CXXFLAGS) $(PYBINDFLAGS_AVX512)
-	$(NVCC) cuda/pybind_main_cuda.cpp -o $(QSIMLIB_CUDA) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA)
+	if [ -n "$(which $NVCC)" ] ; then\
+		$(NVCC) cuda/pybind_main_cuda.cpp -o $(QSIMLIB_CUDA) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA);\
+	fi
 	$(CXX) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
 
 .PHONY: clean
diff --git a/pybind_interface/decide/decide.cpp b/pybind_interface/decide/decide.cpp
index 1355b11c..937c24ac 100644
--- a/pybind_interface/decide/decide.cpp
+++ b/pybind_interface/decide/decide.cpp
@@ -47,9 +47,17 @@ int detect_instructions() {
 
 enum GPUCapabilities { CUDA = 0, NO_GPU = 10 };
 
+// For now, GPU detection is performed at compile time, as our wheels are
+// generated on Github Actions runners which do not have GPU support.
+//
+// Users wishing to use qsim with GPU will need to compile locally on a device
+// which has the necessary CUDA toolkit.
 int detect_gpu() {
-  // TODO: detect non-CUDA
+  #ifdef __NVCC__
   GPUCapabilities gpu = CUDA;
+  #else
+  GPUCapabilities gpu = NO_GPU;
+  #endif
   return gpu;
 }
 
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 63ab5998..ed8af1db 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -173,7 +173,12 @@ def __init__(
         self.qsim_options = QSimOptions().as_dict()
         self.qsim_options.update(qsim_options)
         # module to use for simulation
-        self._sim_module = qsim_gpu if self.qsim_options["g"] > 0 else qsim
+        if self.qsim_options["g"] and qsim_gpu is None:
+            raise ValueError(
+                "GPU execution requested, but not supported. If your device "
+                "has GPU support, you may need to compile qsim locally."
+            )
+        self._sim_module = qsim_gpu if self.qsim_options["g"] else qsim
         # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
         self._translated_circuits = deque(maxlen=circuit_memoization_size)
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index da6a87a3..a1fdfe49 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1066,7 +1066,21 @@ def test_cirq_qsimh_simulate():
     assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
 
 
+def test_qsim_gpu_unavailable():
+    if qsimcirq.qsim_gpu is not None:
+        pytest.skip("GPU is available; skipping test.")
+    
+    # Attempt to create a simulator with GPU support.
+    gpu_options = qsimcirq.QSimOptions(use_gpu=True)
+    with pytest.raises(
+        ValueError, match="GPU execution requested, but not supported",
+    ):
+        _ = qsimcirq.QSimSimulator(qsim_options=gpu_options)
+
+
 def test_cirq_qsim_gpu_amplitudes():
+    if qsimcirq.qsim_gpu is None:
+        pytest.skip("GPU is not available for testing.")
     # Pick qubits.
     a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
 
@@ -1083,6 +1097,8 @@ def test_cirq_qsim_gpu_amplitudes():
 
 
 def test_cirq_qsim_gpu_simulate():
+    if qsimcirq.qsim_gpu is None:
+        pytest.skip("GPU is not available for testing.")
     # Pick qubits.
     a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
 
@@ -1103,6 +1119,8 @@ def test_cirq_qsim_gpu_simulate():
 
 
 def test_cirq_qsim_gpu_expectation_values():
+    if qsimcirq.qsim_gpu is None:
+        pytest.skip("GPU is not available for testing.")
     # Pick qubits.
     a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
 

From c9febcc586217388ac717cf5664bbe0226a3111b Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 11:46:39 -0700
Subject: [PATCH 042/246] Fill extra factory params

---
 pybind_interface/pybind_main.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 41d4ebd0..1d3b951f 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -948,7 +948,7 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options) {
   // Define container for amplitudes
   std::vector<std::complex<float>> amplitudes(bitstrings.size(), 0);
 
-  Factory factory(param.num_threads);
+  Factory factory(param.num_threads, 0, 0);
 
   if (Runner::Run(param, factory, circuit, parts, bitstrings, amplitudes)) {
     return amplitudes;

From 4918948faa35f33d452c83492e617fb2656af8d1 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 13:30:21 -0700
Subject: [PATCH 043/246] Learning to make

---
 pybind_interface/Makefile       | 25 ++++++++++++++++++++-----
 qsimcirq_tests/qsimcirq_test.py |  5 +++--
 2 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index ce2b0b5d..283d4ab9 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -16,17 +16,32 @@ PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind
 # The flags for the compilation of GPU-specific Pybind11 interfaces
 PYBINDFLAGS_CUDA = -std=c++17 -x cu -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
 
-.PHONY: pybind
-pybind:
+# Check for nvcc to decide compilation mode.
+ifeq ($(shell which $(NVCC)),)
+pybind: pybind-cpu decide-cpu
+else
+pybind: pybind-cpu pybind-gpu decide-gpu
+endif
+
+.PHONY: pybind-cpu
+pybind-cpu:
 	$(CXX) basic/pybind_main_basic.cpp -o $(QSIMLIB_BASIC) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
 	$(CXX) sse/pybind_main_sse.cpp -o $(QSIMLIB_SSE) $(CXXFLAGS) $(PYBINDFLAGS_SSE)
 	$(CXX) avx2/pybind_main_avx2.cpp -o $(QSIMLIB_AVX2) $(CXXFLAGS) $(PYBINDFLAGS_AVX2)
 	$(CXX) avx512/pybind_main_avx512.cpp -o $(QSIMLIB_AVX512) $(CXXFLAGS) $(PYBINDFLAGS_AVX512)
-	if [ -n "$(which $NVCC)" ] ; then\
-		$(NVCC) cuda/pybind_main_cuda.cpp -o $(QSIMLIB_CUDA) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA);\
-	fi
+
+.PHONY: decide-cpu
+decide-cpu:
 	$(CXX) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
 
+.PHONY: pybind-gpu
+pybind-gpu:
+	$(NVCC) cuda/pybind_main_cuda.cpp -o $(QSIMLIB_CUDA) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA)
+
+.PHONY: decide-gpu
+decide-gpu:
+	$(NVCC) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
+
 .PHONY: clean
 clean:
 	-rm -f ./basic/*.x ./basic/*.a ./basic/*.so ./basic/*.mod $(QSIMLIB_BASIC)
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index a1fdfe49..0415a40a 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1069,11 +1069,12 @@ def test_cirq_qsimh_simulate():
 def test_qsim_gpu_unavailable():
     if qsimcirq.qsim_gpu is not None:
         pytest.skip("GPU is available; skipping test.")
-    
+
     # Attempt to create a simulator with GPU support.
     gpu_options = qsimcirq.QSimOptions(use_gpu=True)
     with pytest.raises(
-        ValueError, match="GPU execution requested, but not supported",
+        ValueError,
+        match="GPU execution requested, but not supported",
     ):
         _ = qsimcirq.QSimSimulator(qsim_options=gpu_options)
 

From ef784c3108b0699ca5402ae745377fdf3a36980d Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 13:48:10 -0700
Subject: [PATCH 044/246] Flag fixes.

---
 pybind_interface/Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index 283d4ab9..e3663d90 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -40,7 +40,7 @@ pybind-gpu:
 
 .PHONY: decide-gpu
 decide-gpu:
-	$(NVCC) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(CXXFLAGS) $(PYBINDFLAGS_BASIC)
+	$(NVCC) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA)
 
 .PHONY: clean
 clean:

From 7d3fee8ee6ef96f3ca8492385f457615d0fc37d1 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 Aug 2021 13:54:44 -0700
Subject: [PATCH 045/246] Test old options compatibility

---
 qsimcirq_tests/qsimcirq_test.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 0415a40a..41873c67 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1139,6 +1139,20 @@ def test_cirq_qsim_gpu_expectation_values():
     assert np.allclose(result, cirq_result)
 
 
+def test_cirq_qsim_old_options():
+    old_options = {"f": 3, "t": 4, "r": 100, "v": 1}
+    old_sim = qsimcirq.QSimSimulator(qsim_options=old_options)
+
+    new_options = qsimcirq.QSimOptions(
+        max_fused_gate_size=3,
+        cpu_threads=4,
+        ev_noisy_repetitions=100,
+        verbosity=1,
+    )
+    new_sim = qsimcirq.QSimSimulator(qsim_options=new_options)
+    assert new_sim.qsim_options == old_sim.qsim_options
+
+
 def test_cirq_qsim_params():
     qubit = cirq.GridQubit(0, 0)
 

From d2bdfd9a36b3b91dcf4ee8edfccfc29202ac71ef Mon Sep 17 00:00:00 2001
From: Laurynas Tamulevicius <laurynast@google.com>
Date: Sat, 14 Aug 2021 13:55:25 +0100
Subject: [PATCH 046/246] Fix windows release flow by omitting build for cp35

---
 .github/workflows/release_wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/release_wheels.yml b/.github/workflows/release_wheels.yml
index c92a617d..1550d20e 100644
--- a/.github/workflows/release_wheels.yml
+++ b/.github/workflows/release_wheels.yml
@@ -31,7 +31,7 @@ jobs:
             name: win_amd64
             architecture: x64
             cibw:
-              build: "cp*win_amd64"
+              build: "cp36-win_amd64 cp37-win_amd64 cp38-win_amd64 cp39-win_amd64"
     env:
       CIBW_BUILD: "${{ matrix.cibw.build || '*' }}"
       CIBW_ARCHS: "${{ matrix.cibw.arch || 'auto' }}"

From 0cdfa9b60b6f02abe5a45a13a7057ff4642e4939 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Mon, 16 Aug 2021 14:10:22 +0200
Subject: [PATCH 047/246] Update fuser.

---
 lib/fuser_mqubit.h         | 41 ++++++++++++++----
 tests/fuser_mqubit_test.cc | 89 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 122 insertions(+), 8 deletions(-)

diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index 66273893..8db3ceae 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -393,17 +393,42 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
         FuseGateSequences(
             max_fused_size, num_qubits, scratch, gates_seq, stat, fused_gates);
       } else {
+        unsigned prev_time = 0;
+
+        std::vector<GateF*> orphaned_gates;
+        orphaned_gates.reserve(num_qubits);
+
         for (auto& fgate : gates_seq) {
-          if (fgate.gates.size() > 0) {
-            // Assume fgate.qubits (gate.qubits) are sorted.
-            fused_gates.push_back({fgate.parent->kind, fgate.parent->time,
-                                   std::move(fgate.qubits), fgate.parent,
-                                   std::move(fgate.gates)});
-
-            if (fgate.visited != kMeaCnt) {
-              ++stat.num_fused_gates;
+          if (fgate.gates.size() == 0) continue;
+
+          if (prev_time != fgate.parent->time) {
+            if (orphaned_gates.size() > 0) {
+              FuseOrphanedGates(
+                  max_fused_size, stat, orphaned_gates, fused_gates);
+              orphaned_gates.resize(0);
             }
+
+            prev_time = fgate.parent->time;
           }
+
+          if (fgate.qubits.size() == 1 && max_fused_size > 1
+              && fgate.visited != kMeaCnt && !fgate.parent->unfusible) {
+            orphaned_gates.push_back(&fgate);
+            continue;
+          }
+
+          // Assume fgate.qubits (gate.qubits) are sorted.
+          fused_gates.push_back({fgate.parent->kind, fgate.parent->time,
+                                 std::move(fgate.qubits), fgate.parent,
+                                 std::move(fgate.gates)});
+
+          if (fgate.visited != kMeaCnt) {
+            ++stat.num_fused_gates;
+          }
+        }
+
+        if (orphaned_gates.size() > 0) {
+          FuseOrphanedGates(max_fused_size, stat, orphaned_gates, fused_gates);
         }
       }
     }
diff --git a/tests/fuser_mqubit_test.cc b/tests/fuser_mqubit_test.cc
index d63e20af..761b1654 100644
--- a/tests/fuser_mqubit_test.cc
+++ b/tests/fuser_mqubit_test.cc
@@ -980,6 +980,95 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
   }
 }
 
+TEST(FuserMultiQubitTest, OrphanedGates) {
+  using Fuser = MultiQubitGateFuser<IO, DummyGate>;
+
+  std::vector<DummyGate> circuit;
+  circuit.reserve(6);
+
+  Fuser::Parameter param;
+  param.verbosity = 0;
+
+  for (unsigned num_qubits = 2; num_qubits <= 6; ++ num_qubits) {
+    circuit.resize(0);
+
+    for (unsigned q = 0; q < num_qubits; ++q) {
+      circuit.push_back(CreateDummyGate(0, {q}));
+    }
+
+    for (unsigned f = 2; f <= num_qubits; ++f) {
+      param.max_fused_size = f;
+      auto fused_gates = Fuser::FuseGates(
+          param, num_qubits, circuit.begin(), circuit.end());
+
+      EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
+      EXPECT_EQ(fused_gates.size(), (num_qubits - 1) / f + 1);
+    }
+  }
+
+  {
+    unsigned num_qubits = 4;
+    std::vector<DummyGate> circuit = {
+      CreateDummyGate(0, {0}),
+      CreateDummyGate(0, {1}),
+      CreateDummyGate(0, {2}),
+      CreateDummyGate(0, {3}),
+      CreateDummyGate(1, {0, 3}),
+    };
+
+    param.max_fused_size = 2;
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end());
+
+    EXPECT_EQ(fused_gates.size(), 2);
+  }
+
+  {
+    unsigned num_qubits = 4;
+    std::vector<DummyGate> circuit = {
+      CreateDummyGate(0, {0, 3}),
+      CreateDummyGate(1, {0}),
+      CreateDummyGate(1, {1}),
+      CreateDummyGate(1, {2}),
+      CreateDummyGate(1, {3}),
+    };
+
+    param.max_fused_size = 2;
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end());
+
+    EXPECT_EQ(fused_gates.size(), 2);
+  }
+
+  {
+    unsigned num_qubits = 3;
+    std::vector<DummyGate> circuit = {
+      CreateDummyGate(0, {0}),
+      CreateDummyControlledGate(0, {1}, {2}),
+    };
+
+    param.max_fused_size = 2;
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end());
+
+    EXPECT_EQ(fused_gates.size(), 2);
+  }
+
+  {
+    unsigned num_qubits = 3;
+    std::vector<DummyGate> circuit = {
+      CreateDummyGate(0, {0}),
+      CreateDummyMeasurementGate(0, {2}),
+    };
+
+    param.max_fused_size = 2;
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end());
+
+    EXPECT_EQ(fused_gates.size(), 2);
+  }
+}
+
 }  // namespace qsim
 
 int main(int argc, char** argv) {

From e828bd876685b4f6bc3ee7224507f6e4f1dc9fe2 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 07:09:46 -0700
Subject: [PATCH 048/246] Update ubuntu version in all GHA workflows

---
 .github/workflows/cirq_compatibility.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cirq_compatibility.yml b/.github/workflows/cirq_compatibility.yml
index f9a9df71..04e13559 100644
--- a/.github/workflows/cirq_compatibility.yml
+++ b/.github/workflows/cirq_compatibility.yml
@@ -7,7 +7,7 @@ on:
 jobs:
   consistency:
     name: Nightly Compatibility
-    runs-on: ubuntu-16.04
+    runs-on: ubuntu-18.04
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-python@v1

From 5f7029de1fe9d77b3eb7aa623f4f176c58fb4498 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 07:55:07 -0700
Subject: [PATCH 049/246] Use same bazel version as TFQ.

Kokoro tests stil require update.
---
 .github/workflows/bazeltest.yml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/bazeltest.yml b/.github/workflows/bazeltest.yml
index 9b29cda3..a7fb03f1 100644
--- a/.github/workflows/bazeltest.yml
+++ b/.github/workflows/bazeltest.yml
@@ -26,8 +26,8 @@ jobs:
         run: git submodule update --init --recursive
       - name: Install Bazel on CI
         run: |
-          wget https://github.com/bazelbuild/bazel/releases/download/0.26.0/bazel_0.26.0-linux-x86_64.deb
-          sudo dpkg -i bazel_0.26.0-linux-x86_64.deb
+          wget https://github.com/bazelbuild/bazel/releases/download/3.7.2/bazel_3.7.2-linux-x86_64.deb
+          sudo dpkg -i bazel_3.7.2-linux-x86_64.deb
       - name: Run C++ tests
         run: |
           bazel test --config=${{ matrix.hardware_opt }} \
@@ -52,8 +52,8 @@ jobs:
         run: git submodule update --init --recursive
       - name: Install Bazel on CI
         run: |
-          wget https://github.com/bazelbuild/bazel/releases/download/0.26.0/bazel_0.26.0-linux-x86_64.deb
-          sudo dpkg -i bazel_0.26.0-linux-x86_64.deb
+          wget https://github.com/bazelbuild/bazel/releases/download/3.7.2/bazel_3.7.2-linux-x86_64.deb
+          sudo dpkg -i bazel_3.7.2-linux-x86_64.deb
       - name: Run C++ tests
         run: |
           bazel test --config=avx --config=openmp \
@@ -69,8 +69,8 @@ jobs:
         run: git submodule update --init --recursive
       - name: Install Bazel on CI
         run: |
-          wget https://github.com/bazelbuild/bazel/releases/download/0.26.0/bazel_0.26.0-linux-x86_64.deb
-          sudo dpkg -i bazel_0.26.0-linux-x86_64.deb
+          wget https://github.com/bazelbuild/bazel/releases/download/3.7.2/bazel_3.7.2-linux-x86_64.deb
+          sudo dpkg -i bazel_3.7.2-linux-x86_64.deb
       - name: Install google-perftools for tcmalloc
         run: sudo apt-get install libgoogle-perftools-dev
       - name: Run C++ tests

From e68da688c292dfe4269d1661a29d1db9ecaa0da5 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 08:00:10 -0700
Subject: [PATCH 050/246] Allow AVX512 + sanitizer, part 1/4

---
 tests/simulator_avx512_test.cc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/simulator_avx512_test.cc b/tests/simulator_avx512_test.cc
index 9265038a..fbc9510e 100644
--- a/tests/simulator_avx512_test.cc
+++ b/tests/simulator_avx512_test.cc
@@ -16,7 +16,7 @@
 
 #include "gtest/gtest.h"
 
-#if defined(__AVX512F__) && !defined(_WIN32) && !defined(__SANITIZE_ADDRESS__)
+#if defined(__AVX512F__) && !defined(_WIN32)
 
 #ifdef _OPENMP
 #include "../lib/parfor.h"
@@ -94,7 +94,7 @@ TYPED_TEST(SimulatorAVX512Test, ExpectationValue2) {
 
 }  // namespace qsim
 
-#endif  // defined(__AVX512F__) && !defined(_WIN32) && !defined(__SANITIZE_ADDRESS__)
+#endif  // defined(__AVX512F__) && !defined(_WIN32)
 
 int main(int argc, char** argv) {
   ::testing::InitGoogleTest(&argc, argv);

From a85b34e9ab7f2855d7fb86cec6d1f9c4ac4bcd16 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 08:00:28 -0700
Subject: [PATCH 051/246] Allow AVX512 + sanitizer, part 2/4

---
 tests/statespace_avx512_test.cc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/statespace_avx512_test.cc b/tests/statespace_avx512_test.cc
index d018eb79..6bbb1f58 100644
--- a/tests/statespace_avx512_test.cc
+++ b/tests/statespace_avx512_test.cc
@@ -16,7 +16,7 @@
 
 #include "gtest/gtest.h"
 
-#if defined(__AVX512F__) && !defined(_WIN32) && !defined(__SANITIZE_ADDRESS__)
+#if defined(__AVX512F__) && !defined(_WIN32)
 
 #ifdef _OPENMP
 #include "../lib/parfor.h"
@@ -115,7 +115,7 @@ TYPED_TEST(StateSpaceAVX512Test, ThreadThrashing) {
 
 }  // namespace qsim
 
-#endif  // defined(__AVX512F__) && !defined(_WIN32) && !defined(__SANITIZE_ADDRESS__)
+#endif  // defined(__AVX512F__) && !defined(_WIN32)
 
 int main(int argc, char** argv) {
   ::testing::InitGoogleTest(&argc, argv);

From 6bfd7483fe06a18f2d1d8a92caf4695c4c34797e Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 08:00:57 -0700
Subject: [PATCH 052/246] Allow AVX512 + sanitizer, part 3/4

---
 tests/unitary_calculator_avx512_test.cc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/unitary_calculator_avx512_test.cc b/tests/unitary_calculator_avx512_test.cc
index e7cad957..56982688 100644
--- a/tests/unitary_calculator_avx512_test.cc
+++ b/tests/unitary_calculator_avx512_test.cc
@@ -16,7 +16,7 @@
 
 #include "gtest/gtest.h"
 
-#if defined(__AVX512F__) && !defined(_WIN32) && !defined(__SANITIZE_ADDRESS__)
+#if defined(__AVX512F__) && !defined(_WIN32)
 
 #include "../lib/formux.h"
 #include "../lib/unitary_calculator_avx512.h"

From fc4ce0dada1e8833135f8aff23e1e20a6632ce3b Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 08:01:22 -0700
Subject: [PATCH 053/246] Allow AVX512 + sanitizer, part 4/4

---
 tests/unitaryspace_avx512_test.cc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/unitaryspace_avx512_test.cc b/tests/unitaryspace_avx512_test.cc
index 21f2b0be..6301ec4d 100644
--- a/tests/unitaryspace_avx512_test.cc
+++ b/tests/unitaryspace_avx512_test.cc
@@ -16,7 +16,7 @@
 
 #include "gtest/gtest.h"
 
-#if defined(__AVX512F__) && !defined(_WIN32) && !defined(__SANITIZE_ADDRESS__)
+#if defined(__AVX512F__) && !defined(_WIN32)
 
 #include "../lib/formux.h"
 #include "../lib/unitaryspace_avx512.h"

From 79d8c0ca94897a8d14791a42c8419739dfe0b256 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 09:39:21 -0700
Subject: [PATCH 054/246] Update version to 0.10.2

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index 30919655..d9e1c77d 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.10.1"
+__version__ = "0.10.2"

From 089f070e5b12ff1bc1b5612a30c758f3ba71ed32 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 10:36:09 -0700
Subject: [PATCH 055/246] Save time in Docker tests

---
 pybind_interface/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pybind_interface/Dockerfile b/pybind_interface/Dockerfile
index c74fbacc..994bc2a5 100644
--- a/pybind_interface/Dockerfile
+++ b/pybind_interface/Dockerfile
@@ -6,7 +6,7 @@ RUN apt-get install -y python3-dev python3-pybind11 python3-pytest python3-pip
 
 # The --force flag is used mainly so that the old numpy installation from pybind
 # gets replaced with the one cirq requires
-RUN pip3 install cirq --force
+RUN pip3 install cirq-core --force
 
 # Copy relevant files
 COPY ./pybind_interface/ /qsim/pybind_interface/

From 50b80e2e8a59bfce8d29d17266044bed291da716 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 16 Aug 2021 11:15:39 -0700
Subject: [PATCH 056/246] prefer-binary

---
 pybind_interface/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pybind_interface/Dockerfile b/pybind_interface/Dockerfile
index 994bc2a5..b826d197 100644
--- a/pybind_interface/Dockerfile
+++ b/pybind_interface/Dockerfile
@@ -6,7 +6,7 @@ RUN apt-get install -y python3-dev python3-pybind11 python3-pytest python3-pip
 
 # The --force flag is used mainly so that the old numpy installation from pybind
 # gets replaced with the one cirq requires
-RUN pip3 install cirq-core --force
+RUN pip3 install --prefer-binary cirq-core --force
 
 # Copy relevant files
 COPY ./pybind_interface/ /qsim/pybind_interface/

From 9ba2c1019423634bd0a6f00508886a0184fc5355 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 17 Aug 2021 11:17:16 -0700
Subject: [PATCH 057/246] Review comments

---
 pybind_interface/Makefile          |  2 +-
 pybind_interface/decide/decide.cpp |  2 +-
 pybind_interface/pybind_main.cpp   | 35 ++++++++++++------------------
 qsimcirq/qsim_simulator.py         | 12 +++++-----
 4 files changed, 22 insertions(+), 29 deletions(-)

diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index e3663d90..daebea5e 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -14,7 +14,7 @@ PYBINDFLAGS_AVX2 = -mavx2 -mfma -Wall -shared -std=c++17 -fPIC `python3 -m pybin
 PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 
 # The flags for the compilation of GPU-specific Pybind11 interfaces
-PYBINDFLAGS_CUDA = -std=c++17 -x cu -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
+PYBINDFLAGS_CUDA = -std=c++14 -x cu -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
 
 # Check for nvcc to decide compilation mode.
 ifeq ($(shell which $(NVCC)),)
diff --git a/pybind_interface/decide/decide.cpp b/pybind_interface/decide/decide.cpp
index 937c24ac..890f7a41 100644
--- a/pybind_interface/decide/decide.cpp
+++ b/pybind_interface/decide/decide.cpp
@@ -33,7 +33,7 @@ int detect_instructions() {
   }
   if (nIds >= 7) {
     cpuid(info, 7);
-    if ((info[1] & (1 <<  5) )!= 0) {
+    if ((info[1] & (1 <<  5))!= 0) {
       instr = AVX2;
     }
     if ((info[1] & (1 << 16)) != 0) {
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 1d3b951f..16da8aec 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -458,10 +458,9 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
     return {};
   }
 
-  Simulator simulator = Factory(
-    num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
-  StateSpace state_space = Factory(
-    num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
+  Factory factory(num_sim_threads, num_state_threads, num_dblocks);
+  Simulator simulator = factory.CreateSimulator();
+  StateSpace state_space = factory.CreateStateSpace();
 
   auto measure = [&bitstrings, &ncircuit, &amplitudes, &state_space](
                   unsigned k, const State &state,
@@ -613,22 +612,19 @@ class SimulatorHelper {
   bool simulate(const StateType& input_state) {
     init_state(input_state);
     bool result = false;
+
+    Factory factory(num_sim_threads, num_state_threads, num_dblocks);
     if (is_noisy) {
       std::vector<uint64_t> stat;
       auto params = get_noisy_params();
 
-      Simulator simulator = Factory(
-        num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
-      StateSpace state_space = Factory(
-        num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
+      Simulator simulator = factory.CreateSimulator();
+      StateSpace state_space = factory.CreateStateSpace();
 
       result = NoisyRunner::RunOnce(params, ncircuit, seed, state_space,
                                     simulator, scratch, state, stat);
     } else {
-      result = Runner::Run(
-        get_params(),
-        Factory(num_sim_threads, num_state_threads, num_dblocks),
-        circuit, state);
+      result = Runner::Run(get_params(), factory, circuit, state);
     }
     seed += 1;
     return result;
@@ -803,14 +799,12 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
   }
 
   std::vector<MeasurementResult> results;
-  StateSpace state_space = Factory(
-    num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
+  Factory factory(num_sim_threads, num_state_threads, num_dblocks);
+  StateSpace state_space = factory.CreateStateSpace();
   State state = state_space.Create(circuit.num_qubits);
   state_space.SetStateZero(state);
 
-  if (!Runner::Run(
-        param, Factory(num_sim_threads, num_state_threads, num_dblocks),
-        circuit, state, results)) {
+  if (!Runner::Run(param, factory, circuit, state, results)) {
     IO::errorf("qsim sampling of the circuit errored out.\n");
     return {};
   }
@@ -864,10 +858,9 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
     return {};
   }
 
-  Simulator simulator = Factory(
-    num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
-  StateSpace state_space = Factory(
-    num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
+  Factory factory(num_sim_threads, num_state_threads, num_dblocks);
+  Simulator simulator = factory.CreateSimulator();
+  StateSpace state_space = factory.CreateStateSpace();
 
   std::vector<std::vector<unsigned>> results;
 
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index ee7a593d..f079f55e 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -135,10 +135,10 @@ class QSimOptions:
             simulation modes.
         use_gpu: whether to use GPU instead of CPU for simulation. The "gpu_*"
             arguments below are only considered if this is set to True.
-        gpu_sim_threads: number of threads to use for the GPU Simulator.
-            This must be a power of 2 in the range [32, 256].
-        gpu_state_threads: number of threads to use for the GPU StateSpace.
-            This must be a power of 2 in the range [32, 1024].
+        gpu_sim_threads: number of threads per CUDA block to use for the GPU
+            Simulator. This must be a power of 2 in the range [32, 256].
+        gpu_state_threads: number of threads per CUDA block to use for the GPU
+            StateSpace. This must be a power of 2 in the range [32, 1024].
         gpu_data_blocks: number of data blocks to use on GPU. Below 16 data
             blocks, performance is noticeably reduced.
         verbosity: Logging verbosity.
@@ -148,8 +148,8 @@ class QSimOptions:
     cpu_threads: int = 1
     ev_noisy_repetitions: int = 1
     use_gpu: bool = False
-    gpu_sim_threads: int = 32
-    gpu_state_threads: int = 32
+    gpu_sim_threads: int = 256
+    gpu_state_threads: int = 512
     gpu_data_blocks: int = 16
     verbosity: int = 0
 

From 5f3c31f2a3e12b1ca264180d09cc55638b099ecd Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 17 Aug 2021 11:54:34 -0700
Subject: [PATCH 058/246] Fix init_state

---
 pybind_interface/pybind_main.cpp |  7 +------
 qsimcirq_tests/qsimcirq_test.py  | 23 +++++++++++++++++++++++
 2 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 16da8aec..95c09f77 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -584,12 +584,7 @@ class SimulatorHelper {
   }
 
   void init_state(const py::array_t<float> &input_vector) {
-    const float* ptr = input_vector.data();
-    auto f = [](unsigned n, unsigned m, uint64_t i, const float* ptr,
-                float* fsv) {
-      fsv[i] = ptr[i];
-    };
-    For(num_sim_threads).Run(input_vector.size(), f, ptr, state.get());
+    state_space.Copy(input_vector.data(), state);
     state_space.NormalToInternalOrder(state);
   }
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 41873c67..e11de449 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1139,6 +1139,29 @@ def test_cirq_qsim_gpu_expectation_values():
     assert np.allclose(result, cirq_result)
 
 
+def test_cirq_qsim_gpu_input_state():
+    if qsimcirq.qsim_gpu is None:
+        pytest.skip("GPU is not available for testing.")
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
+
+    # Enable GPU acceleration.
+    gpu_options = qsimcirq.QSimOptions(use_gpu=True)
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=gpu_options)
+    initial_state = np.asarray([0.5] * 4, dtype=np.complex64)
+    result = qsimGpuSim.simulate(cirq_circuit, initial_state=initial_state)
+    assert result.state_vector().shape == (4,)
+
+    cirqSim = cirq.Simulator()
+    cirq_result = cirqSim.simulate(cirq_circuit, initial_state=initial_state)
+    assert cirq.linalg.allclose_up_to_global_phase(
+        result.state_vector(), cirq_result.state_vector(), atol=1.0e-6
+    )
+
+
 def test_cirq_qsim_old_options():
     old_options = {"f": 3, "t": 4, "r": 100, "v": 1}
     old_sim = qsimcirq.QSimSimulator(qsim_options=old_options)

From 7225b5c052d9af43019a0d7774763317e2b18637 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 17 Aug 2021 13:19:59 -0700
Subject: [PATCH 059/246] GPU doc update.

---
 docs/cirq_interface.md | 31 +++++++++++++++++++++++++------
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/docs/cirq_interface.md b/docs/cirq_interface.md
index 20291fe8..c8058eda 100644
--- a/docs/cirq_interface.md
+++ b/docs/cirq_interface.md
@@ -76,11 +76,11 @@ This circuit can then be simulated using either `QSimSimulator` or
 acquiring the complete state of a reasonably-sized circuit (~25 qubits on an
 average PC, or up to 40 qubits on high-performance VMs).
 Options for the simulator, including number of threads and verbosity, can be
-set with the `qsim_options` field using the `qsim_base` flag format defined in
-the [usage docs](./usage.md).
+set with the `qsim_options` field, which accepts a `QSimOptions` object as
+defined in [qsim_simulator.py](https://github.com/quantumlib/qsim/blob/master/qsimcirq/qsim_simulator.py).
 
 ```
-qsim_options = {'t': 8, 'v': 0}
+qsim_options = qsimcirq.QSimOptions(cpu_threads=8, verbosity=0)
 my_sim = qsimcirq.QSimSimulator(qsim_options)
 myres = my_sim.simulate(program=my_circuit)
 ```
@@ -136,8 +136,8 @@ outlined in the [usage docs](./usage.md).
 
 ## Additional features
 
-The qsim-Cirq interface provides basic support for gate decomposition and
-circuit parameterization.
+The qsim-Cirq interface supports arbitrary gates and circuit parameterization.
+Additionally, GPU execution of circuits can be requested if GPUs are available.
 
 ### Gate decompositions
 
@@ -148,7 +148,26 @@ matrices, if one is specified.
 
 ### Parametrized circuits
 
-QSimCircuit objects can also contain
+`QSimCircuit` objects can also contain
 [parameterized gates](https://cirq.readthedocs.io/en/stable/docs/tutorials/basics.html#Using-parameter-sweeps)
 which have values assigned by Cirq's `ParamResolver`. See the link above for
 details on how to use this feature.
+
+### GPU execution
+
+`QSimSimulator` provides optional support for GPU execution of circuits, which
+may improve performance. In order to use this feature, qsim must be compiled on
+a device with the [CUDA toolkit](https://developer.nvidia.com/cuda-downloads)
+and run on a device with available NVIDIA GPUs.
+
+Compilation for GPU follows the same steps outlined in the
+[Compiling qsimcirq](./cirq_interface.md#compiling-qsimcirq) section.
+
+`QSimOptions` provides four parameters to configure GPU execution:
+* use_gpu: whether to use GPU instead of CPU for simulation.
+* gpu_sim_threads: number of threads per CUDA block to use for the GPU
+Simulator. This must be a power of 2 in the range [32, 256].
+* gpu_state_threads: number of threads per CUDA block to use for the GPU
+StateSpace. This must be a power of 2 in the range [32, 1024].
+* gpu_data_blocks: number of data blocks to use on GPU. Below 16 data blocks,
+performance is noticeably reduced.

From cbb51346bbf67160bb51083d8aefe840398e6b74 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 18 Aug 2021 08:15:45 -0700
Subject: [PATCH 060/246] Clarify options.

---
 docs/cirq_interface.md | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/docs/cirq_interface.md b/docs/cirq_interface.md
index c8058eda..4f5d190a 100644
--- a/docs/cirq_interface.md
+++ b/docs/cirq_interface.md
@@ -75,11 +75,16 @@ This circuit can then be simulated using either `QSimSimulator` or
 `QSimSimulator` uses a Schrödinger full state-vector simulator, suitable for
 acquiring the complete state of a reasonably-sized circuit (~25 qubits on an
 average PC, or up to 40 qubits on high-performance VMs).
+
 Options for the simulator, including number of threads and verbosity, can be
 set with the `qsim_options` field, which accepts a `QSimOptions` object as
-defined in [qsim_simulator.py](https://github.com/quantumlib/qsim/blob/master/qsimcirq/qsim_simulator.py).
+defined in
+[qsim_simulator.py](https://github.com/quantumlib/qsim/blob/master/qsimcirq/qsim_simulator.py).
+These options can also be passed as a {str: val} dict, using the format
+described by that class.
 
 ```
+# equivalent to {'t': 8, 'v': 0}
 qsim_options = qsimcirq.QSimOptions(cpu_threads=8, verbosity=0)
 my_sim = qsimcirq.QSimSimulator(qsim_options)
 myres = my_sim.simulate(program=my_circuit)
@@ -163,11 +168,16 @@ and run on a device with available NVIDIA GPUs.
 Compilation for GPU follows the same steps outlined in the
 [Compiling qsimcirq](./cirq_interface.md#compiling-qsimcirq) section.
 
-`QSimOptions` provides four parameters to configure GPU execution:
-* use_gpu: whether to use GPU instead of CPU for simulation.
-* gpu_sim_threads: number of threads per CUDA block to use for the GPU
+`QSimOptions` provides four parameters to configure GPU execution. Only
+`use_gpu` is required to enable GPU execution:
+* `use_gpu`: if True, use GPU instead of CPU for simulation.
+
+The remaining parameters use default values which provide good performance in
+most cases, but can optionally be set to fine-tune perfomance for a specific
+device or circuit.
+* `gpu_sim_threads`: number of threads per CUDA block to use for the GPU
 Simulator. This must be a power of 2 in the range [32, 256].
-* gpu_state_threads: number of threads per CUDA block to use for the GPU
+* `gpu_state_threads`: number of threads per CUDA block to use for the GPU
 StateSpace. This must be a power of 2 in the range [32, 1024].
-* gpu_data_blocks: number of data blocks to use on GPU. Below 16 data blocks,
+* `gpu_data_blocks`: number of data blocks to use on GPU. Below 16 data blocks,
 performance is noticeably reduced.

From 0e2e650eccde3208f1b39f85dc57eb864420ab81 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Wed, 18 Aug 2021 16:35:20 +0000
Subject: [PATCH 061/246] Added autoscaler.py. MIG autoscaler not working.

---
 .../terraform/htcondor/autoscaler.py          |  36 +--
 .../multinode/terraform/htcondor/resources.tf |  15 +-
 .../terraform/htcondor/startup-centos.sh      | 280 +-----------------
 docs/tutorials/multinode/terraform/init.sh    |  29 ++
 docs/tutorials/multinode/terraform/main.tf    |   1 +
 5 files changed, 71 insertions(+), 290 deletions(-)
 create mode 100644 docs/tutorials/multinode/terraform/init.sh

diff --git a/docs/tutorials/multinode/terraform/htcondor/autoscaler.py b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
index 68c7a01d..12036066 100644
--- a/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
+++ b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
@@ -29,12 +29,13 @@
 import argparse
 
 parser = argparse.ArgumentParser()
-parser.add_argument("--p", help="Project id", type=str)
-parser.add_argument("--r", help="GCP region where the managed instance group is located", type=str)
-parser.add_argument("--z", help="Name of GCP zone where the managed instance group is located", type=str)
-parser.add_argument("--g", help="Name of the managed instance group", type=str)
-parser.add_argument("--c", help="Maximum number of compute instances", type=int)
-parser.add_argument("--v", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
+parser.add_argument("--p", required=True, help="Project id", type=str)
+parser.add_argument("--z", required=True, help="Name of GCP zone where the managed instance group is located", type=str)
+parser.add_argument("--g", required=True, help="Name of the managed instance group", type=str)
+parser.add_argument("--c", required=True, help="Maximum number of compute instances", type=int)
+parser.add_argument("--v", default=0, help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
+parser.add_argument("--d", default=0, help="Dry Run, default=0, if 1, then no scaling actions", type=int, choices=[0, 1])
+
 
 args = parser.parse_args()
         
@@ -57,12 +58,15 @@ def deleteFromMig(self, instance):
             self.service.instanceGroupManagers().deleteInstances(project=self.project,
                 zone=self.zone, instanceGroupManager=self.instance_group_manager,
                 body=instances_to_delete)
-        response = requestDelInstance.execute()
-        if self.debug > 0:
-            print('Request to delete instance ' + instance)
-            pprint(response)
-    
-        return response
+
+        # execute if not a dry-run
+        if not self.dryrun:
+            response = requestDelInstance.execute()
+            if self.debug > 0:
+                print('Request to delete instance ' + instance)
+                pprint(response)
+            return response
+        return "Dry Run"
     
     def getInstanceTemplateInfo(self):
         requestTemplateName = \
@@ -118,7 +122,6 @@ def scale(self):
         if self.debug > 1:
             print('Launching autoscaler.py with the following arguments:')
             print('project_id: ' + self.project)
-            print('region: ' + self.region)
             print('zone: ' + self.zone)
             print('group_manager: ' + self.instance_group_manager)
             print('computeinstancelimit: ' + str(self.compute_instance_limit))
@@ -258,13 +261,9 @@ def main():
 
     scaler = AutoScaler()
 
-    exit()
     # Project ID
     scaler.project = args.p  # Ex:'slurm-var-demo'
     
-    # Region where the managed instance group is located
-    scaler.region = args.r  # Ex: 'us-central1'
-    
     # Name of the zone where the managed instance group is located
     scaler.zone = args.z # Ex: 'us-central1-f'
     
@@ -276,6 +275,9 @@ def main():
     
     # Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
     scaler.size = 0
+
+    # Dry run: : 0, run scaling; 1, only provide info.
+    scaler.dryrun = args.d > 0
     
     # Debug level: 1-print debug information, 2 - print detail debug information
     scaler.debug = 0
diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index 634a5814..42cff48e 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -61,6 +61,7 @@ variable "service_account" {
   default = "default"
 }
 locals{
+  autoscaler = file("${path.module}/autoscaler.py")
   compute_startup = templatefile(
     "${path.module}/startup-centos.sh", 
     {
@@ -68,7 +69,10 @@ locals{
       "cluster_name" = var.cluster_name,
       "htserver_type" = "compute", 
       "osversion" = var.osversion, 
+      "zone" = var.zone, 
       "condorversion" = var.condorversion, 
+      "max_replicas" = var.max_replicas, 
+      "autoscaler" = "",
       "admin_email" = var.admin_email
     })
   submit_startup = templatefile(
@@ -79,6 +83,9 @@ locals{
       "htserver_type" = "submit", 
       "osversion" = var.osversion, 
       "condorversion" = var.condorversion, 
+      "zone" = var.zone, 
+      "max_replicas" = var.max_replicas, 
+      "autoscaler" = local.autoscaler,
       "admin_email" = var.admin_email
     })
   manager_startup = templatefile(
@@ -88,7 +95,10 @@ locals{
       "cluster_name" = var.cluster_name,
       "htserver_type" = "manager", 
       "osversion" = var.osversion, 
+      "zone" = var.zone, 
+      "max_replicas" = var.max_replicas, 
       "condorversion" = var.condorversion, 
+      "autoscaler" = "",
       "admin_email" = var.admin_email
     })
 }
@@ -262,7 +272,7 @@ resource "google_compute_instance_group_manager" "condor-compute-igm" {
   name               = var.cluster_name
 
   project            = var.project
-  target_size        = "1"
+  target_size        = "0"
 
   update_policy {
     max_surge_fixed         = 2
@@ -324,3 +334,6 @@ resource "google_compute_autoscaler" "condor-compute-as" {
 }
 */
 
+output "startup_script" {
+  value = local.submit_startup
+}
\ No newline at end of file
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
index 1336b547..71f5d423 100644
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -169,286 +169,22 @@ fi
 service google-fluentd restart
 
 # Add Python Libraries and Autoscaler
+
 if [ "$SERVER_TYPE" == "submit" ]; then
   python3 -m pip install --upgrade oauth2client
   python3 -m pip install --upgrade google-api-python-client
   python3 -m pip install --upgrade absl-py
-fi
 
 cat <<EOFZ > /opt/autoscaler.py
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-
-# Copyright 2018 Google Inc. All Rights Reserved.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-# Script for resizing managed instance group (MIG) cluster size based
-# on the number of jobs in the Condor Queue.
-
-from pprint import pprint
-from googleapiclient import discovery
-from oauth2client.client import GoogleCredentials
-
-import os
-import math
-import argparse
-
-parser = argparse.ArgumentParser("autoscaler.py")
-parser.add_argument("-p", "--project_id", help="Project id", type=str)
-parser.add_argument("-r", "--region", help="GCP region where the managed instance group is located", type=str)
-parser.add_argument("-z", "--zone", help="Name of GCP zone where the managed instance group is located", type=str)
-parser.add_argument("-g", "--group_manager", help="Name of the managed instance group", type=str)
-parser.add_argument("-c", "--computeinstancelimit", help="Maximum number of compute instances", type=int)
-parser.add_argument("-v", "--verbosity", help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
-args = parser.parse_args()
-
-# Project ID
-project = args.project_id  # Ex:'slurm-var-demo'
-
-# Region where the managed instance group is located
-region = args.region  # Ex: 'us-central1'
-
-# Name of the zone where the managed instance group is located
-zone = args.zone  # Ex: 'us-central1-f'
-
-# The name of the managed instance group.
-instance_group_manager = args.group_manager  # Ex: 'condor-compute-igm'
-
-# Default number of cores per intance, will be replaced with actual value
-cores_per_node = 4
-
-# Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
-size = 0
-
-# Debug level: 1-print debug information, 2 - print detail debug information
-debug = 0
-if (args.verbosity):
-    debug = args.verbosity
-
-# Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
-compute_instance_limit = 0
-if (args.computeinstancelimit):
-    compute_instance_limit = abs(args.computeinstancelimit)
-
-
-if debug > 1:
-    print('Launching autoscaler.py with the following arguments:')
-    print('project_id: ' + project)
-    print('region: ' + region)
-    print('zone: ' + zone)
-    print('group_manager: ' + instance_group_manager)
-    print('computeinstancelimit: ' + str(compute_instance_limit))
-    print('debuglevel: ' + str(debug))
-
-
-# Remove specified instance from MIG and decrease MIG size
-def deleteFromMig(instance):
-    instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' \
-        + project + '/zones/' + zone + '/instances/' + instance
-    instances_to_delete = {'instances': [instanceUrl]}
-
-    requestDelInstance = \
-        service.instanceGroupManagers().deleteInstances(project=project,
-            zone=zone, instanceGroupManager=instance_group_manager,
-            body=instances_to_delete)
-    response = requestDelInstance.execute()
-    if debug > 0:
-        print('Request to delete instance ' + instance)
-        pprint(response)
-
-    return response
-
-def getInstanceTemplateInfo():
-    requestTemplateName = \
-        service.instanceGroupManagers().get(project=project, zone=zone,
-            instanceGroupManager=instance_group_manager,
-            fields='instanceTemplate')
-    responseTemplateName = requestTemplateName.execute()
-    template_name = ''
-
-    if debug > 1:
-        print('Request for the template name')
-        pprint(responseTemplateName)
-
-    if len(responseTemplateName) > 0:
-        template_url = responseTemplateName.get('instanceTemplate')
-        template_url_partitioned = template_url.split('/')
-        template_name = \
-            template_url_partitioned[len(template_url_partitioned) - 1]
-
-    requestInstanceTemplate = \
-        service.instanceTemplates().get(project=project,
-            instanceTemplate=template_name, fields='properties')
-    responseInstanceTemplateInfo = requestInstanceTemplate.execute()
-
-    if debug > 1:
-        print('Template information')
-        pprint(responseInstanceTemplateInfo['properties'])
-
-    machine_type = responseInstanceTemplateInfo['properties']['machineType']
-    is_preemtible = responseInstanceTemplateInfo['properties']['scheduling']['preemptible']
-    if debug > 0:
-        print('Machine Type: ' + machine_type)
-        print('Is preemtible: ' + str(is_preemtible))
-    request = service.machineTypes().get(project=project, zone=zone,
-            machineType=machine_type)
-    response = request.execute()
-    guest_cpus = response['guestCpus']
-    if debug > 1:
-        print('Machine information')
-        pprint(responseInstanceTemplateInfo['properties'])
-    if debug > 0:
-        print('Guest CPUs: ' + str(guest_cpus))
-
-    instanceTemlateInfo = {'machine_type': machine_type,
-                           'is_preemtible': is_preemtible,
-                           'guest_cpus': guest_cpus}
-    return instanceTemlateInfo
-
-
-# Obtain credentials
-credentials = GoogleCredentials.get_application_default()
-service = discovery.build('compute', 'v1', credentials=credentials)
-
-# Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
-queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
-queue_length_resp = os.popen(queue_length_req).read().split()
-
-if len(queue_length_resp) > 1:
-    queue = int(queue_length_resp[0])
-    idle_jobs = int(queue_length_resp[1])
-    on_hold_jobs = int(queue_length_resp[2])
-else:
-    queue = 0
-    idle_jobs = 0
-    on_hold_jobs = 0
-
-print('Total queue length: ' + str(queue))
-print('Idle jobs: ' + str(idle_jobs))
-print('Jobs on hold: ' + str(on_hold_jobs))
-
-instanceTemlateInfo = getInstanceTemplateInfo()
-if debug > 1:
-    print('Information about the compute instance template')
-    pprint(instanceTemlateInfo)
-
-cores_per_node = instanceTemlateInfo['guest_cpus']
-print('Number of CPU per compute node: ' + str(cores_per_node))
-
-# Get state for for all jobs in Condor
-name_req = 'condor_status  -af name state'
-slot_names = os.popen(name_req).read().splitlines()
-if debug > 1:
-    print('Currently running jobs in Condor')
-    print(slot_names)
-
-# Adjust current queue length by the number of jos that are on-hold
-queue -=on_hold_jobs
-if on_hold_jobs>0:
-    print("Adjusted queue length: " + str(queue))
-
-# Calculate number instances to satisfy current job queue length
-if queue > 0:
-    size = int(math.ceil(float(queue) / float(cores_per_node)))
-    if debug>0:
-       print("Calucalting size of MIG: ⌈" + str(queue) + "/" + str(cores_per_node) + "⌉ = " + str(size))
-else:
-    size = 0
-
-# If compute instance limit is specified, can not start more instances then specified in the limit
-if compute_instance_limit > 0 and size > compute_instance_limit:
-    size = compute_instance_limit;
-    print("MIG target size will be limited by " + str(compute_instance_limit))
-
-print('New MIG target size: ' + str(size))
-
-# Get current number of instances in the MIG
-requestGroupInfo = service.instanceGroupManagers().get(project=project,
-        zone=zone, instanceGroupManager=instance_group_manager)
-responseGroupInfo = requestGroupInfo.execute()
-currentTarget = int(responseGroupInfo['targetSize'])
-print('Current MIG target size: ' + str(currentTarget))
-
-if debug > 1:
-    print('MIG Information:')
-    print(responseGroupInfo)
-
-if size == 0 and currentTarget == 0:
-    print('No jobs in the queue and no compute instances running. Nothing to do')
-    exit()
-
-if size == currentTarget:
-    print('Running correct number of compute nodes to handle number of jobs in the queue')
-    exit()
-
-
-if size < currentTarget:
-    print('Scaling down. Looking for nodes that can be shut down' )
-    # Find nodes that are not busy (all slots showing status as "Unclaimed")
+${autoscaler}
+EOFZ
 
-    node_busy = {}
-    for slot_name in slot_names:
-        name_status = slot_name.split()
-        if len(name_status) > 1:
-            name = name_status[0]
-            status = name_status[1]
-            slot = "NO-SLOT"
-            slot_server = name.split('@')
-            if len(slot_server) > 1:
-                slot = slot_server[0]
-                server = slot_server[1].split('.')[0]
-            else:
-                server = slot_server[0].split('.')[0]
+# Create cron entry for autoscaler. Log to /var/log/messages
 
-            if debug > 0:
-                print(slot + ', ' + server + ', ' + status + '\n')
+echo "* * * * * python3 /opt/autoscaler.py --p ${project} --z ${zone} --g ${cluster_name} --c ${max_replicas} | logger " |crontab -
 
-            if server not in node_busy:
-                if status == 'Unclaimed':
-                    node_busy[server] = False
-                else:
-                    node_busy[server] = True
-            else:
-                if status != 'Unclaimed':
-                    node_busy[server] = True
-                    
-    if debug > 1:
-        print('Compuute node busy status:')
-        print(node_busy)
+fi
 
-    # Shut down nodes that are not busy
-    for node in node_busy:
-        if not node_busy[node]:
-            print('Will shut down: ' + node + ' ...')
-            respDel = deleteFromMig(node)
-            if debug > 1:
-                print("Shut down request for compute node " + node)
-                pprint(respDel)
-                
-    if debug > 1:
-        print("Scaling down complete")
+# Now we can let everyone know that the setup is complete.
 
-if size > currentTarget:
-    print("Scaling up. Need to increase number of instances to " + str(size))
-    #Request to resize
-    request = service.instanceGroupManagers().resize(project=project,
-            zone=zone, 
-            instanceGroupManager=instance_group_manager,
-            size=size)
-    response = request.execute()
-    if debug > 1:
-        print('Requesting to increase MIG size')
-        pprint(response)
-        print("Scaling up complete")
-EOFZ
+wall "******* HTCondor system configuration complete ********"
\ No newline at end of file
diff --git a/docs/tutorials/multinode/terraform/init.sh b/docs/tutorials/multinode/terraform/init.sh
new file mode 100644
index 00000000..82461e55
--- /dev/null
+++ b/docs/tutorials/multinode/terraform/init.sh
@@ -0,0 +1,29 @@
+export TF_VAR_project=quantum-htcondor-13
+export TF_VAR_project_id=us-east4-c
+export TF_VAR_zone=us-east4-c
+export TF_VAR_region=us-east4
+export TF_VAR_project_id=${TF_VAR_project}
+export TF_VAR_service_account="htcondor@"${TF_VAR_project}".iam.gserviceaccount.com"
+
+
+gcloud config set project $TF_VAR_project
+gcloud services enable compute.googleapis.com
+gcloud services enable monitoring.googleapis.com
+gcloud config set compute/zone $TF_VAR_zone
+gcloud config set compute/region $TF_VAR_region
+
+gcloud config list
+
+
+gcloud iam service-accounts create htcondor --display-name="Run HTCondor" 
+
+# Add roles
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/compute.admin
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/iam.serviceAccountUser
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/monitoring.admin
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/logging.admin
+gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/autoscaling.metricsWriter
+
+# Save key file locally.
+gcloud iam service-accounts keys create ~/.${TF_VAR_project_id}.json --iam-account=${TF_VAR_service_account}
+export GOOGLE_APPLICATION_CREDENTIALS=~/.${TF_VAR_project_id}.json
\ No newline at end of file
diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
index c883028c..0c0a8f87 100644
--- a/docs/tutorials/multinode/terraform/main.tf
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -19,6 +19,7 @@ module "htcondor" {
   osversion = "7"
   max_replicas=20
   min_replicas=0
+  compute_instance_type = "custom-2-11264"
   service_account="htcondor@${var.project}.iam.gserviceaccount.com"
   use_preemptibles=false
   osproject ="centos-cloud"

From 98e9771df5e1045eed87745b54b620fa9d6da4bc Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Wed, 18 Aug 2021 18:57:23 +0000
Subject: [PATCH 062/246] updated readme

---
 docs/tutorials/multinode/terraform/README.md | 161 +++++++++++++++----
 1 file changed, 131 insertions(+), 30 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index 3669fcfd..b4464ddf 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -1,49 +1,150 @@
-# HTCondor on GCP
+# Multinode quantum simulation using HTCondor on GCP
+This tutorial will take you through the process of running many qsim simulations
+on Google Cloud. In some situations, it is required to run many instances of the same 
+simulation. This could be used to provide a parameter sweep or to evaluation noise characteristics.
 
+## Create a project
+In a seperate tutorial the method to create Google Cloud project is explained in detail. 
+[Please refer to this tutorial for guidance](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup).
+
+When you have a project created, move on to the next step.
+
+## Configure your enviroment
+
+In your procject using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
 ```
-gcloud config set project [[PROJECT_ID]]
-gcloud config set compute/region [[YOUR_REGION]]
-gcloud config set compute/zone [[YOUR_ZONE]]
+git clone https://github.com/jrossthomson/qsim.git
 ```
 
+Change directory to the tutorial:
 ```
-git clone https://github.com/lsst-dm/google-poc-2020.git
-cd google-poc-2020
+cd qsim/docs/tutorials/multinode/terraform
 ```
+This is where you will use terraform to create the HTCondor cluster required to run your jobs.
 
+### Edit init file to setup environment
+
+You can now edit `init.sh` to change the name of the project you are using. You can also change the zone and region as you see fit. More information is available [here](https://cloud.google.com/compute/docs/regions-zones).
+
+Change the variables to reflect your project, most important is the first line:
 ```
-gcloud iam service-accounts create htcondor
+export TF_VAR_project=my-quantum-htcondor-project
 ```
+The project id needs to be globally unique and to be the same as the project you just created.
+
+The edited `init.sh` file should be "sourced" in the cloud shell:
 
 ```
-gcloud projects add-iam-policy-binding \
-       --member serviceAccount:htcondor@[[PROJECT]]  \
-       --role roles/iam.serviceAccountUser
+source init.sh
 ```
+Repsond in the affirmative to any pop-ups that request permissions on the Cloud platform.
 
+The final outcome of this script will include:
 
-## Updating the main.tf Terraform file
+* A gcloud config setup correctly
+* A service account created
+* The appropriate permissions assigned to the service account
+* A key file created to enable the use of Google Cloud automation.
 
-The as-is file from the git repository will not work without modifying the _main.tf_ to the values relevant to your project. 
+This will take about 60 seconds. At the end you will see output about permissions and the configuration of the account.
 
+## Run terraform
+
+When this is complete, you can initialize teraform to begin your cluster creations:
+```
+terraform init
+```
+A correct result will contain:
+```
+Terraform has been successfully initialized!
+```
+Some terraform commands are wrapped in a makefile, so you can now create your cluster:
+```
+make apply
 ```
-variable "cluster_name" {
-  type = string
-  default = "condor"
-  description = "Name used to prefix resources in cluster."
-  
-}
+A successful run will show:
+```
+Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
+```
+## Connect to the Submit node for HTCondor
+You will now be able list the VMs created:
+```
+gcloud compute instances list
+```
+You will log in to the `submit` node:
+```
+gcloud compute ssh c-submit
+```
+Now you are logged in to your HTCondor cluster.
 
-module "htcondor" {
-  source = "./htcondor/"
-  cluster_name = var.cluster_name
-  osimage = "lsst"
-  osversion = "7"
-  zone="[[YOUR_ZONE]]"
-  project="[[PROJECT_ID]]"
-  max_replicas=20
-  min_replicas=1
-  service_account="htcondor@[[PROJECT_ID]].iam.gserviceaccount.com"
-  use_preemptibles=true
-}
+### Checking the status 
+You can verify if the HTCondor install is completed:
 ```
+condor_q
+```
+You will see output:
+```
+-- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
+OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
+
+Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+Total for drj: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+```
+If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
+
+## Clone the repo on your cluster
+
+Again on the `submit` node you you can install the repo to get access to previously created submission files:
+```
+git clone https://github.com/jrossthomson/qsim.git
+```
+Then cd to the tutorial directory.
+```
+cd qsim/docs/tutorials/multinode
+```
+Now it is possible to submit a job:
+```
+condor_submit circuit_q24.sub
+```
+If successful, the output will be:
+```
+Submitting job(s).
+1 job(s) submitted to cluster 1.
+```
+This may take a few minutes, but when completed the command:
+```
+ls out
+```
+will list the files:
+```
+err.1-0  log.1-0  out.1-0  placeholder
+```
+You can also see the progress of the job throught the log file:
+```
+tail -f out/log.1-0
+```
+After the job s completed, the ouput of the job can be seen:
+```
+cat out/out.1-0
+```
+To run multiple simulations, you can change the submit file by editing the file `circuit_q24.sub`:
+```
+universe                = docker
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
+arguments               = -c circuit_q24
+transfer_input_files    = ../../../circuits/circuit_q24
+should_transfer_files   = YES
+when_to_transfer_output = ON_EXIT
+output                  = out/out.$(Cluster)-$(Process)
+error                   = out/err.$(Cluster)-$(Process)
+log                     = out/log.$(Cluster)-$(Process)
+request_memory          = 1GB
+queue 1
+```
+Change the final line to `queue 100`. Then submit the job again:
+```
+condor_submit circuit_q24.sub
+```
+Now many jobs will be submitted.
+

From 95d778c802c4848767a76d172b2453fa2fc98816 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Wed, 18 Aug 2021 19:17:05 +0000
Subject: [PATCH 063/246] UPdated both readmes

---
 docs/tutorials/multinode/README.md           | 294 ++++++-------------
 docs/tutorials/multinode/terraform/README.md |   7 +
 2 files changed, 93 insertions(+), 208 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index cbe78f00..31fd2c03 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -1,279 +1,157 @@
-# Run a multinode quantum simulation
+# Multinode quantum simulation using HTCondor on GCP
+This tutorial will take you through the process of running many qsim simulations
+on Google Cloud. In some situations, it is required to run many instances of the same 
+simulation. This could be used to provide a parameter sweep or to evaluation noise characteristics.
+
 ## Objectives
 
 * Use Terraform to deploy a HTCondor cluster
 * Run a multinode simulation using HTCondor
 * Query cluster information and monitor running jobs in HTCondor
-* Autoscale nodes to runt jobs that new more Simulation capacit
-
-## Costs
-
-This tutorial uses the following billable components of Google Cloud:
-
-* [Compute Engine](https://cloud.google.com/compute/all-pricing)
-
-To generate a cost estimate based on your projected usage, use the [pricing calculator](https://cloud.google.com/products/calculator).
-When you finish this tutorial, you can avoid continued billing by deleting the resources 
-you created. For more information, see Cleaning up.
-
-> Note: the resources created in this tutorial will persist until deleted or the project is deleted. Google Cloud will charge for this time.
-
-
-## Before you begin
-1. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project. To make this easy, try to choose a project where you are _Owner_ or _Editor_.
 
-      > Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
-Go to [project selector](https://console.cloud.google.com/projectselector2/home/dashboard)
 
-1. Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.
-1. Enable the [Compute Engine and Deployment Manager APIs](https://console.cloud.google.com/flows/enableapi?apiid=compute,deploymentmanager.googleapis.com).
-1. In the Cloud Console, [activate Cloud Shell](https://console.cloud.google.com/?cloudshell=true)
+## Create a project
+In a seperate tutorial the method to create Google Cloud project is explained in detail. 
+[Please refer to this tutorial for guidance](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup).
 
-At the bottom of the Cloud Console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Cloud SDK already installed, including the gcloud command-line tool, and with values already set for your current project. It can take a few seconds for the session to initialize.
+When you have a project created, move on to the next step.
 
-## Setting up your environment in Cloud Shell
-Select a region and zone for your cluster to run. [This guide can help](https://cloud.google.com/compute/docs/regions-zones).
-
-Once selected, define the following environment variables in Cloud Shell.
+## Configure your enviroment
 
+In your procject using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
 ```
-export TF_VAR_project=[[YOUR_PROJECT_ID]]
-export TF_VAR_region=[[YOUR_REGION]]
-export TF_VAR_zone=[[YOUR_ZONE]]
+git clone https://github.com/jrossthomson/qsim.git
 ```
-With those variables defined, you can configure `gcloud`. Cut and paste the gcloud config commands in your Cloud Shell.
 
+Change directory to the tutorial:
 ```
-gcloud config set project $TF_VAR_project
-gcloud config set compute/region $TF_VAR_region
-gcloud config set compute/zone $TF_VAR_zone
+cd qsim/docs/tutorials/multinode/terraform
 ```
-With that completed, you can create a service account that will run the HTCondor cluster.
+This is where you will use terraform to create the HTCondor cluster required to run your jobs.
+
+### Edit init file to setup environment
 
+You can now edit `init.sh` to change the name of the project you are using. You can also change the zone and region as you see fit. More information is available [here](https://cloud.google.com/compute/docs/regions-zones).
+
+Change the variables to reflect your project, most important is the first line:
 ```
-gcloud iam service-accounts create htcondor
+export TF_VAR_project=my-quantum-htcondor-project
 ```
-Then give the service accounts the permissions that will allow HTCondor to run correctly. 
+The project id needs to be globally unique and to be the same as the project you just created.
+
+The edited `init.sh` file should be "sourced" in the cloud shell:
+
 ```
-gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/iam.serviceAccountUser \
- --member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
-gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/compute.admin \
---member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
-gcloud projects add-iam-policy-binding ${TF_VAR_project} --role roles/monitoring.admin \
---member="serviceAccount:htcondor@${TF_VAR_project}.iam.gserviceaccount.com"
+source init.sh
 ```
+Repsond in the affirmative to any pop-ups that request permissions on the Cloud platform.
 
-## Clone the repository and build the cluster
+The final outcome of this script will include:
 
-The `qsim` repository has all the code required to create the repository and to run the simulations.
+* A gcloud config setup correctly
+* A service account created
+* The appropriate permissions assigned to the service account
+* A key file created to enable the use of Google Cloud automation.
 
-1. Clone the repo and change to the working directory.
-     ```
-     git clone https://github.com/jrossthomson/qsim.git
-     cd qsim/docs/tutorials/multinode/terraform
-     ```
+This will take about 60 seconds. At the end you will see output about permissions and the configuration of the account.
 
-1. Build the cluster with Terraform
-     ```
-     terraform init
-     make apply
-     ```
+## Run terraform
 
-This process will create 3 VMs instances and an autoscaling Managed Instance Group. To see the instances use the glcoud command in the Cloud Shell.
+When this is complete, you can initialize teraform to begin your cluster creations:
 ```
-gcloud compute instances list
+terraform init
 ```
-The output should be something like the output here:
+A correct result will contain:
 ```
-NAME       ZONE        MACHINE_TYPE    PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP     STATUS
-c-8xlg     us-east4-c  n2-standard-16               10.150.0.21  34.86.120.132   RUNNING
-c-manager  us-east4-c  n2-standard-4                10.150.0.16  35.188.250.134  RUNNING
-c-submit   us-east4-c  n2-standard-4                10.150.0.17  35.245.189.252  RUNNING
+Terraform has been successfully initialized!
 ```
-
-The Mangaged Instance Group can be seen with gcloud.
+Some terraform commands are wrapped in a makefile, so you can now create your cluster:
 ```
-gcloud compute instance-groups list
+make apply
 ```
-And the output like the following.
+A successful run will show:
 ```
-NAME  LOCATION    SCOPE  NETWORK  MANAGED  INSTANCES
-c     us-east4-c  zone   default  Yes      1
+Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
 ```
-## Run a job on the cluster
-The next step is to run a job on the HTCondor cluster. Jobs are submitted on the `c-submit` VM instance known as the Submit Node in HTCondor. You connect to the Submit Node using gcloud SSH.
+## Connect to the Submit node for HTCondor
+You will now be able list the VMs created:
 ```
-gcloud compute ssh c-submit
+gcloud compute instances list
 ```
-There will now be a prompt with something like `username@c-submit`.
-
-For convenience there is prepared HTCondor job submission files in the Github repo. To get these, 
-clone the repository on the Submit Node, and change to the tutorial directory.
+You will log in to the `submit` node:
 ```
-     git clone https://github.com/jrossthomson/qsim.git
-     cd qsim/docs/tutorials/multinode
+gcloud compute ssh c-submit
 ```
+Now you are logged in to your HTCondor cluster.
 
-It is very likely that the HTCondor installation is not completely finished at this point: it takes several minutes. The `condor_status` command will tell you if the cluster is ready to run jobs. 
-
+### Checking the status 
+You can verify if the HTCondor install is completed:
 ```
-condor_status
+condor_q
 ```
-The output from the command should resemble this.
+You will see output:
 ```
-Name                                           OpSys      Arch   State     Activity LoadAv Mem    ActvtyTime
-
-slot1@c-6klg.c.test-quantum-multinode.internal LINUX      X86_64 Unclaimed Idle      0.000 64263  0+00:19:33
-
-               Machines Owner Claimed Unclaimed Matched Preempting  Drain
+-- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
+OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
 
-  X86_64/LINUX        1     0       0         1       0          0      0
-
-         Total        1     0       0         1       0          0      0
+Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+Total for drj: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
 ```
+If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
 
-If  the output shows "Unclaimed" machines, you are ready to submit a job with HTCondor.
+## Clone the repo on your cluster
 
+Again on the `submit` node you you can install the repo to get access to previously created submission files:
+```
+git clone https://github.com/jrossthomson/qsim.git
+```
+Then cd to the tutorial directory.
+```
+cd qsim/docs/tutorials/multinode
 ```
-condor_submit circuit_q30.sub
+Now it is possible to submit a job:
 ```
-There should be a response indicating the job was submitted.
+condor_submit circuit_q24.sub
+```
+If successful, the output will be:
 ```
 Submitting job(s).
 1 job(s) submitted to cluster 1.
 ```
-Now you can see if the job is running correctly.
+This may take a few minutes, but when completed the command:
 ```
-condor_q
+ls out
 ```
-The output will be similar to the snippet below.
+will list the files:
 ```
--- Schedd: c-submit.c.test-quantum-multinode.internal : <10.150.0.6:9618?... @ 05/20/21 15:04:24
-OWNER        BATCH_NAME    SUBMITTED   DONE   RUN    IDLE  TOTAL JOB_IDS
-jrossthomson ID: 1        5/20 15:04      _      1      _      1 1.0
-
-Total for query: 1 jobs; 0 completed, 0 removed, 0 idle, 1 running, 0 held, 0 suspended
-Total for jrossthomson: 1 jobs; 0 completed, 0 removed, 0 idle, 1 running, 0 held, 0 suspended
-Total for all users: 1 jobs; 0 completed, 0 removed, 0 idle, 1 running, 0 held, 0 suspended
+err.1-0  log.1-0  out.1-0  placeholder
 ```
-When this is completed you should see output in the `out` directory.
+You can also see the progress of the job throught the log file:
 ```
-ls out/
-err.1-0  log.1-0  out.1-0
+tail -f out/log.1-0
 ```
-The contents of `out.1-0` will have the content you are expecting from the simulation. This will take about 10 minutes to be complete.
+After the job s completed, the ouput of the job can be seen:
 ```
 cat out/out.1-0
-000:   -4.734056e-05   1.2809795e-05   2.4052194e-09
-001:  -3.6258607e-06   2.3642724e-07   1.3202764e-11
-010:  -2.9523137e-05    2.280164e-05   1.3915304e-09
-011:  -1.3954962e-05   9.4717652e-06   2.8445529e-10
-100:  -6.8555892e-06  -6.7632163e-07   4.7456514e-11
-101:  -2.0390624e-05   3.1813841e-05   1.4278979e-09
-110:   1.5711608e-05  -7.5214862e-06   3.0342737e-10
-111:   9.2345472e-06  -2.7716227e-05   8.5346613e-10
-```
-## Sumitting many jobs
-
-The job just submitted only ran a single instance of a qsim simulation. The main purpose of the present study is to
-run many (up to thousands of) simulations to provide a broad study with statistical significance.
-
-A simple way to submit many jobs is to use the `queue` command in the HTCondor. For this step edit the file `circuit_q30.sub`
-in your favorite editor, such as vim or nano. You will see the full submission file.
 ```
-universe                = docker/jross
-
+To run multiple simulations, you can change the submit file by editing the file `circuit_q24.sub`:
+```
+universe                = docker
 docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
-arguments               = -c circuit_q30
-transfer_input_files    = ../../../circuits/circuit_q30
+arguments               = -c circuit_q24
+transfer_input_files    = ../../../circuits/circuit_q24
 should_transfer_files   = YES
 when_to_transfer_output = ON_EXIT
 output                  = out/out.$(Cluster)-$(Process)
 error                   = out/err.$(Cluster)-$(Process)
 log                     = out/log.$(Cluster)-$(Process)
-request_memory          = 10GB
+request_memory          = 1GB
 queue 1
 ```
-The submission file is running the public qsim `docker image` from [QuantumAI](https://quantumai.google/qsim). 
-The command that is running utimately is running the `qsim` base executable.
-```
-qsim_base.x -c circuit_q30
-```
-This is achieved by running the _docker_image_ as listed with the `arguments` "-c circuit_q30". The 
-circuit file `circuit_q30` is transferred to the compute nodes via the `transfer_input_files` command. 
-
-> If you are interested
-> in an introduction to HTCondor in general, there is a 
-> [great introduction from CERN](https://indico.cern.ch/event/611296/contributions/2604376/attachments/1471164/2276521/TannenbaumT_UserTutorial.pdf). For details on job submission syntax there is a section of the [HTCondor Manual](https://htcondor.readthedocs.io/en/latest/users-manual/submitting-a-job.html) dedicated to this.
-
-To expand the simulation to run 20 instances of the docker image, the change required is to modify the `queue` command.
-```
-queue 20
-```
-Now when you run the `condor_submit` command, 
-```
-condor_submit circuit_q30.sub
-```
-20 jobs will be visible from the `condor_q` command.
-
-The really cool part is that now when you look at the list of VM instance you see that the system has 
-automatically scaled up the number of VM machines to support the 20 jobs you have requested to run, or as we normally refer to it,
-performs __autoscaling__.
-
-```
-gcloud compute instances list
-NAME       ZONE        MACHINE_TYPE    PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP     STATUS
-c-2q8w     us-east4-c  n2-standard-16               10.150.0.15  35.245.204.243  RUNNING
-c-40dz     us-east4-c  n2-standard-16               10.150.0.11  34.86.33.206    RUNNING
-c-4x4g     us-east4-c  n2-standard-16               10.150.0.14  35.245.201.254  RUNNING
-c-6klg     us-east4-c  n2-standard-16               10.150.0.8   34.86.161.51    RUNNING
-c-748q     us-east4-c  n2-standard-16               10.150.0.12  35.245.74.106   RUNNING
-c-dgt0     us-east4-c  n2-standard-16               10.150.0.13  34.86.102.113   RUNNING
-c-manager  us-east4-c  n2-standard-4                10.150.0.7   35.221.59.182   RUNNING
-c-submit   us-east4-c  n2-standard-4                10.150.0.6   35.245.203.14   RUNNING
-c-vdsz     us-east4-c  n2-standard-16               10.150.0.10  35.236.211.189  RUNNING
-c-x4bd     us-east4-c  n2-standard-16               10.150.0.9   34.86.246.195   RUNNING
-```
-
-When all these 20 jobs are complete, you can see the output in the `out` directory.
-```
-ls out/out.*
-out/out.2-0  out/out.2-10  out/out.2-12  out/out.2-14  out/out.2-16  out/out.2-18  out/out.2-2  out/out.2-4  out/out.2-6  out/out.2-8
-out/out.2-1  out/out.2-11  out/out.2-12  out/out.2-15  out/out.2-17  out/out.2-19  out/out.2-2  out/out.2-5  out/out.2-7  out/out.2-9
-
-```
-The output of the simulation is in these files.
-
-Finally, after the system has been idle for several minutes, you will see that the number of VM instances with autoscale 
-back to a single Compute Node, the  Manager Node and the Submit node. This helps to control costs by removing VMs when
-you do not need them.
-
-## Next steps
-Further work here will allow you to run multiple simulations for different work. There are several things to look at.
-
-* Creating and running with your own container
-* Running with multiple input files
-* Selecting different configurations of the submit file
-
-## Cleaning up
-The easiest way to eliminate billing is to delete the Cloud project you created for the tutorial. Alternatively, 
-you can delete the individual resources.
-
-### Delete the project
-> __Caution:__ Deleting a project has the following effects:
-> Everything in the project is deleted. If you used an existing project for this tutorial, when you delete it, you also delete any other work you've done in the project.
-> Custom project IDs are lost. When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as an appspot.com URL, delete selected resources inside the project instead of deleting the whole project.
-
-1. In the Cloud Console, go to the Manage resources page.
-     > Go to [Manage resources](https://console.cloud.google.com/iam-admin/projects)
-
-1. In the project list, select the project that you want to delete, and then click Delete.
-1. In the dialog, type the project ID, and then click Shut down to delete the project.
-
-### Delete the Slurm cluster
-The second option is to delete the HTCondor cluster. In the `qsim/docs/tutorials/multinode/terraform` directory, run the make command.
+Change the final line to `queue 100`. Then submit the job again:
 ```
-     make destroy
+condor_submit circuit_q24.sub
 ```
-This will remove the HTCondor cluster.
+Now many jobs will be submitted.
 
diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index b4464ddf..31fd2c03 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -3,6 +3,13 @@ This tutorial will take you through the process of running many qsim simulations
 on Google Cloud. In some situations, it is required to run many instances of the same 
 simulation. This could be used to provide a parameter sweep or to evaluation noise characteristics.
 
+## Objectives
+
+* Use Terraform to deploy a HTCondor cluster
+* Run a multinode simulation using HTCondor
+* Query cluster information and monitor running jobs in HTCondor
+
+
 ## Create a project
 In a seperate tutorial the method to create Google Cloud project is explained in detail. 
 [Please refer to this tutorial for guidance](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup).

From 51cc80cc1f35b80bccc9b68e833c6815f5712d58 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 19 Aug 2021 08:47:42 -0700
Subject: [PATCH 064/246] Prevent unused variable error.

---
 tests/mps_simulator_test.cc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/mps_simulator_test.cc b/tests/mps_simulator_test.cc
index 0bbff966..1aa7def7 100644
--- a/tests/mps_simulator_test.cc
+++ b/tests/mps_simulator_test.cc
@@ -26,7 +26,7 @@ namespace mps {
 namespace {
 
 TEST(MPSSimulator, Create) {
-  auto sim = MPSSimulator<For, float>(1);
+  MPSSimulator<For, float>(1);
 }
 
 TEST(MPSSimulator, Apply1RightArbitrary) {

From d522d954ba3d363d71cedb513282026b048a2ea2 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 19 Aug 2021 09:20:02 -0700
Subject: [PATCH 065/246] cuda_library

---
 lib/BUILD | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/lib/BUILD b/lib/BUILD
index 3316f531..26d93c72 100644
--- a/lib/BUILD
+++ b/lib/BUILD
@@ -2,7 +2,14 @@ package(default_visibility = ["//visibility:public"])
 
 ##### Aggregate libraries #####
 
+# Libraries of the following form:
+#   # cuda_library
+#   cc_library(...)
+# are converted to cuda_library rules when imported to the Google codebase.
+# Do not modify this tag.
+
 # Full qsim library
+# cuda_library
 cc_library(
     name = "qsim_lib",
     hdrs = [
@@ -171,6 +178,7 @@ cc_library(
     hdrs = ["util.h"],
 )
 
+# cuda_library
 cc_library(
     name = "util_cuda",
     hdrs = ["util_cuda.h"],
@@ -331,6 +339,7 @@ cc_library(
     hdrs = ["vectorspace.h"],
 )
 
+# cuda_library
 cc_library(
     name = "vectorspace_cuda",
     hdrs = ["vectorspace_cuda.h"],
@@ -384,6 +393,7 @@ cc_library(
     ],
 )
 
+# cuda_library
 cc_library(
     name = "statespace_cuda",
     hdrs = [
@@ -435,6 +445,7 @@ cc_library(
     ],
 )
 
+# cuda_library
 cc_library(
     name = "simulator_cuda",
     hdrs = [

From ba2ce80dadf71a89c23a9d1a518d7bd2444ed95c Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 19 Aug 2021 09:37:12 -0700
Subject: [PATCH 066/246] Move cuda_library note

---
 lib/BUILD | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/BUILD b/lib/BUILD
index 26d93c72..2b1288a8 100644
--- a/lib/BUILD
+++ b/lib/BUILD
@@ -1,13 +1,13 @@
 package(default_visibility = ["//visibility:public"])
 
-##### Aggregate libraries #####
-
 # Libraries of the following form:
 #   # cuda_library
 #   cc_library(...)
 # are converted to cuda_library rules when imported to the Google codebase.
 # Do not modify this tag.
 
+##### Aggregate libraries #####
+
 # Full qsim library
 # cuda_library
 cc_library(

From e15c1688f1ca89746b0b4867c6a279c41a103e79 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Thu, 19 Aug 2021 21:22:07 +0000
Subject: [PATCH 067/246] Added noise sims

---
 docs/tutorials/multinode/noise.py            | 51 ++++++++++++++++++++
 docs/tutorials/multinode/noise.sub           | 11 +++++
 docs/tutorials/multinode/noise2.py           | 18 +++++++
 docs/tutorials/multinode/noise3.py           | 22 +++++++++
 docs/tutorials/multinode/terraform/README.md | 14 +++---
 docs/tutorials/multinode/terraform/init.sh   |  2 +-
 6 files changed, 110 insertions(+), 8 deletions(-)
 create mode 100644 docs/tutorials/multinode/noise.py
 create mode 100644 docs/tutorials/multinode/noise.sub
 create mode 100644 docs/tutorials/multinode/noise2.py
 create mode 100644 docs/tutorials/multinode/noise3.py

diff --git a/docs/tutorials/multinode/noise.py b/docs/tutorials/multinode/noise.py
new file mode 100644
index 00000000..ecbd751d
--- /dev/null
+++ b/docs/tutorials/multinode/noise.py
@@ -0,0 +1,51 @@
+import cirq
+import qsimcirq
+import time
+
+q0, q1 = cirq.LineQubit.range(2)
+
+circuit = cirq.Circuit(
+    # Perform a Hadamard on both qubits
+    cirq.H(q0), cirq.H(q1),
+    # Apply amplitude damping to q0 with probability 0.1
+    cirq.amplitude_damp(gamma=0.1).on(q0),
+    # Apply phase damping to q1 with probability 0.1
+    cirq.phase_damp(gamma=0.1).on(q1),
+)
+qsim_simulator = qsimcirq.QSimSimulator()
+results = qsim_simulator.simulate(circuit)
+print(results.final_state_vector)
+
+
+# Simulate measuring at the end of the circuit.
+measured_circuit = circuit + cirq.measure(q0, q1, key='m')
+measure_results = qsim_simulator.run(measured_circuit, repetitions=5)
+print(measure_results)
+
+# Calculate only the amplitudes of the |00) and |01) states.
+amp_results = qsim_simulator.compute_amplitudes(
+    circuit, bitstrings=[0b00, 0b01])
+print(amp_results)
+
+# Calculate only the amplitudes of the |00) and |01) states.
+amp_results = qsim_simulator.compute_amplitudes(
+    circuit, bitstrings=[0b00, 0b01])
+print(amp_results)
+
+
+# Set the "noisy repetitions" to 100.
+# This parameter only affects expectation value calculations.
+options = {'r': 100}
+# Also set the random seed to get reproducible results.
+seed = int(time.time())
+print(seed)
+ev_simulator = qsimcirq.QSimSimulator(qsim_options=options, seed=seed)
+# Define observables to measure: <Z> for q0 and <X> for q1.
+pauli_sum1 = cirq.Z(q0)
+pauli_sum2 = cirq.X(q1)
+# Calculate expectation values for the given observables.
+ev_results = ev_simulator.simulate_expectation_values(
+    circuit,
+    observables=[pauli_sum1, pauli_sum2],
+)
+print(ev_results)
\ No newline at end of file
diff --git a/docs/tutorials/multinode/noise.sub b/docs/tutorials/multinode/noise.sub
new file mode 100644
index 00000000..cccc85b0
--- /dev/null
+++ b/docs/tutorials/multinode/noise.sub
@@ -0,0 +1,11 @@
+universe                = docker
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
+arguments               = python3  noise3.py
+should_transfer_files   = YES
+transfer_input_files    = noise3.py
+when_to_transfer_output = ON_EXIT
+output                  = out/out.$(Cluster)-$(Process)
+error                   = out/err.$(Cluster)-$(Process)
+log                     = out/log.$(Cluster)-$(Process)
+request_memory          = 10GB
+queue 50
\ No newline at end of file
diff --git a/docs/tutorials/multinode/noise2.py b/docs/tutorials/multinode/noise2.py
new file mode 100644
index 00000000..db593b7a
--- /dev/null
+++ b/docs/tutorials/multinode/noise2.py
@@ -0,0 +1,18 @@
+import cirq
+import qsimcirq
+import time
+
+circuit = cirq.testing.random_circuit(
+    qubits=3, n_moments=3, op_density=1, random_state=11
+)
+
+# Display the noiseless circuit.
+print("Circuit without noise:")
+print(circuit)
+
+# Add noise to the circuit.
+noisy = circuit.with_noise(cirq.depolarize(p=0.01))
+
+# Display it.
+print("\nCircuit with noise:")
+print(noisy)
\ No newline at end of file
diff --git a/docs/tutorials/multinode/noise3.py b/docs/tutorials/multinode/noise3.py
new file mode 100644
index 00000000..38d741a3
--- /dev/null
+++ b/docs/tutorials/multinode/noise3.py
@@ -0,0 +1,22 @@
+import cirq, qsimcirq
+
+# Create a Bell state, |00) + |11)
+q0, q1 = cirq.LineQubit.range(2)
+circuit = cirq.Circuit(
+    cirq.H(q0),
+    cirq.CNOT(q0, q1),
+    cirq.measure(q0, q1, key='m')
+)
+
+# Constructs a noise model that adds depolarizing noise after each gate.
+noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
+
+# Use the noise model to create a noisy circuit.
+noisy_circuit = cirq.Circuit(noise.noisy_moments(circuit, system_qubits=[q0, q1]))
+
+sim = qsimcirq.QSimSimulator()
+result = sim.run(noisy_circuit, repetitions=1000)
+# Outputs a histogram dict of result:count pairs.
+# Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
+# (For comparison, the noiseless circuit will only have 0s and 3s)
+print(result.histogram(key='m'))
\ No newline at end of file
diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index 31fd2c03..443f1271 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -18,7 +18,7 @@ When you have a project created, move on to the next step.
 
 ## Configure your enviroment
 
-In your procject using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
+In your project using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
 ```
 git clone https://github.com/jrossthomson/qsim.git
 ```
@@ -135,19 +135,19 @@ After the job s completed, the ouput of the job can be seen:
 ```
 cat out/out.1-0
 ```
-To run multiple simulations, you can change the submit file by editing the file `circuit_q24.sub`:
+To run multiple simulations, you can run the submit file `noise.sub`:
 ```
 universe                = docker
-docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
-arguments               = -c circuit_q24
-transfer_input_files    = ../../../circuits/circuit_q24
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
+arguments               = python3 noise3.py
 should_transfer_files   = YES
+transfer_input_files    = noise3.py
 when_to_transfer_output = ON_EXIT
 output                  = out/out.$(Cluster)-$(Process)
 error                   = out/err.$(Cluster)-$(Process)
 log                     = out/log.$(Cluster)-$(Process)
-request_memory          = 1GB
-queue 1
+request_memory          = 10GB
+queue 50
 ```
 Change the final line to `queue 100`. Then submit the job again:
 ```
diff --git a/docs/tutorials/multinode/terraform/init.sh b/docs/tutorials/multinode/terraform/init.sh
index 82461e55..0d10befe 100644
--- a/docs/tutorials/multinode/terraform/init.sh
+++ b/docs/tutorials/multinode/terraform/init.sh
@@ -1,4 +1,4 @@
-export TF_VAR_project=quantum-htcondor-13
+export TF_VAR_project=quantum-htcondor-15
 export TF_VAR_project_id=us-east4-c
 export TF_VAR_zone=us-east4-c
 export TF_VAR_region=us-east4

From 47ec0b077ab8614500a499641843efe89ba99413 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Thu, 19 Aug 2021 21:45:58 +0000
Subject: [PATCH 068/246] Updated docs.

---
 docs/tutorials/multinode/terraform/README.md | 43 ++++++++++++++++++--
 1 file changed, 40 insertions(+), 3 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index 443f1271..5459045a 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -135,6 +135,7 @@ After the job s completed, the ouput of the job can be seen:
 ```
 cat out/out.1-0
 ```
+## Running noisy simulations
 To run multiple simulations, you can run the submit file `noise.sub`:
 ```
 universe                = docker
@@ -149,9 +150,45 @@ log                     = out/log.$(Cluster)-$(Process)
 request_memory          = 10GB
 queue 50
 ```
-Change the final line to `queue 100`. Then submit the job again:
+The final line in this submit file has `queue 50`. This means 50 instances of this simulation will be run. The job can be submitted with the `condor_submit` command.
 ```
-condor_submit circuit_q24.sub
+condor_submit noise.sub
+```
+The output will look as follows:
+```
+Submitting job(s)..................................................
+50 job(s) submitted to cluster 2.
+```
+If this is the second _submit_ you have run, you can see the output of the all the simualtions. The output will be in the `out` directory. 
+```
+cat out/out.2-*
+```
+You can see the results of the simulations.
+```
+Counter({3: 462, 0: 452, 2: 50, 1: 36})
+Counter({0: 475, 3: 435, 1: 49, 2: 41})
+Counter({0: 450, 3: 440, 1: 59, 2: 51})
+Counter({0: 459, 3: 453, 2: 51, 1: 37})
+Counter({3: 471, 0: 450, 2: 46, 1: 33})
+Counter({3: 467, 0: 441, 1: 54, 2: 38})
+Counter({3: 455, 0: 455, 1: 50, 2: 40})
+Counter({3: 466, 0: 442, 2: 51, 1: 41})
+.
+.
+.
 ```
-Now many jobs will be submitted.
+Note that because this is a noise driven circuit, the results of each simulation are different.
+
+To run your own simulations, simply create a noisy circuit in your _qsim_ python file.
+
+There are many more examples of circuits to be run [here](https://quantumai.google/cirq/noise)
+
+## Shutting down
+When you are done with this tutorial, it is important to remove the resources. You can do this with _terraform_
+```
+make destroy
+```
+> The most effective way to ensure you are not charged is to delete the project. [The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
+
+
 

From d36b26c47b81959b90a45f3958206ce934487c80 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Thu, 19 Aug 2021 21:48:47 +0000
Subject: [PATCH 069/246] Duplicating readme files

---
 docs/tutorials/multinode/README.md | 58 ++++++++++++++++++++++++------
 1 file changed, 48 insertions(+), 10 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 31fd2c03..28a81271 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -1,3 +1,4 @@
+
 # Multinode quantum simulation using HTCondor on GCP
 This tutorial will take you through the process of running many qsim simulations
 on Google Cloud. In some situations, it is required to run many instances of the same 
@@ -18,7 +19,7 @@ When you have a project created, move on to the next step.
 
 ## Configure your enviroment
 
-In your procject using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
+In your project using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
 ```
 git clone https://github.com/jrossthomson/qsim.git
 ```
@@ -135,23 +136,60 @@ After the job s completed, the ouput of the job can be seen:
 ```
 cat out/out.1-0
 ```
-To run multiple simulations, you can change the submit file by editing the file `circuit_q24.sub`:
+## Running noisy simulations
+To run multiple simulations, you can run the submit file `noise.sub`:
 ```
 universe                = docker
-docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
-arguments               = -c circuit_q24
-transfer_input_files    = ../../../circuits/circuit_q24
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
+arguments               = python3 noise3.py
 should_transfer_files   = YES
+transfer_input_files    = noise3.py
 when_to_transfer_output = ON_EXIT
 output                  = out/out.$(Cluster)-$(Process)
 error                   = out/err.$(Cluster)-$(Process)
 log                     = out/log.$(Cluster)-$(Process)
-request_memory          = 1GB
-queue 1
+request_memory          = 10GB
+queue 50
 ```
-Change the final line to `queue 100`. Then submit the job again:
+The final line in this submit file has `queue 50`. This means 50 instances of this simulation will be run. The job can be submitted with the `condor_submit` command.
 ```
-condor_submit circuit_q24.sub
+condor_submit noise.sub
+```
+The output will look as follows:
+```
+Submitting job(s)..................................................
+50 job(s) submitted to cluster 2.
+```
+If this is the second _submit_ you have run, you can see the output of the all the simualtions. The output will be in the `out` directory. 
+```
+cat out/out.2-*
+```
+You can see the results of the simulations.
+```
+Counter({3: 462, 0: 452, 2: 50, 1: 36})
+Counter({0: 475, 3: 435, 1: 49, 2: 41})
+Counter({0: 450, 3: 440, 1: 59, 2: 51})
+Counter({0: 459, 3: 453, 2: 51, 1: 37})
+Counter({3: 471, 0: 450, 2: 46, 1: 33})
+Counter({3: 467, 0: 441, 1: 54, 2: 38})
+Counter({3: 455, 0: 455, 1: 50, 2: 40})
+Counter({3: 466, 0: 442, 2: 51, 1: 41})
+.
+.
+.
 ```
-Now many jobs will be submitted.
+Note that because this is a noise driven circuit, the results of each simulation are different.
+
+To run your own simulations, simply create a noisy circuit in your _qsim_ python file.
+
+There are many more examples of circuits to be run [here](https://quantumai.google/cirq/noise)
+
+## Shutting down
+When you are done with this tutorial, it is important to remove the resources. You can do this with _terraform_
+```
+make destroy
+```
+> The most effective way to ensure you are not charged is to delete the project. [The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
+
+
 

From 7792aec4290f2973937f757b209c82b913257f94 Mon Sep 17 00:00:00 2001
From: Laurynas Tamulevicius <laurynas.tamulevicius@gmail.com>
Date: Thu, 19 Aug 2021 22:53:32 +0100
Subject: [PATCH 070/246] Update the installation docs

Change installation docs according to work on cross-platform support.
---
 docs/install_qsimcirq.md | 45 +++++++++++++++++++++-------------------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/docs/install_qsimcirq.md b/docs/install_qsimcirq.md
index 9fe69d4e..82cfc0d5 100644
--- a/docs/install_qsimcirq.md
+++ b/docs/install_qsimcirq.md
@@ -1,49 +1,52 @@
 # Installing qsimcirq
 
-The qsim-Cirq Python interface is available as a PyPI package for Linux users.
-For all other users, Dockerfiles are provided to install qsim in a contained
+The qsim-Cirq Python interface is available as a PyPI package for Linux, MacOS and Windows users.
+For all others, Dockerfiles are provided to install qsim in a contained
 environment.
 
 **Note:** The core qsim library (under
 [lib/](https://github.com/quantumlib/qsim/blob/master/lib)) can be included
 directly in C++ code without installing this interface.
 
-## Linux installation
+## Before installation
 
 Prior to installation, consider opening a
 [virtual environment](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/).
 
-The qsim-Cirq interface uses [CMake](https://cmake.org/) to ensure stable
-compilation of its C++ libraries across a variety of Linux distributions.
-CMake can be installed from their website, or with the command
-`apt-get install cmake`.
-
-Other prerequisites (including pybind11 and pytest) are included in the
+Prerequisites are included in the
 [`requirements.txt`](https://github.com/quantumlib/qsim/blob/master/requirements.txt)
 file, and will be automatically installed along with qsimcirq.
 
-To install the qsim-Cirq interface on Linux, simply run `pip3 install qsimcirq`.
-For examples of how to use this package, see the tests in
-[qsim/qsimcirq_tests/](https://github.com/quantumlib/qsim/blob/master/qsimcirq_tests/).
+## Linux installation
+
+We provide `qsimcirq` Python wheels on 64-bit `x86` architectures with `Python 3.{5,6,7,8,9}`.
+
+Simply run `pip3 install qsimcirq`.
 
-## MacOS and Windows installation
+## MacOS installation
 
-For users interested in running qsim on a MacOS or Windows device, we strongly
-recommend using the [Docker config](./docker.md) provided with this
-repository.
+We provide `qsimcirq` Python wheels on `x86` architectures with `Python 3.{5,6,7,8,9}`.
 
-### Experimental install process
+Simply run `pip3 install qsimcirq`.
 
-Alternatively, MacOS and Windows users can follow the Linux install process,
-but it is currently untested on those platforms. Users are encouraged to report
-any issues seen with this process.
+## Windows installation
+
+We provide `qsimcirq` Python wheels on 64-bit `x86` and `amd64` architectures with `Python 3.{5,6,7,8,9}`.
+
+Simply run `pip3 install qsimcirq`.
+
+## There's no compatible wheel for my machine!
+
+If existing wheels do no meet your needs please open an issue with your machine configuration (i.e. CPU architecture, Python version) and consider using the [Docker config](./docker.md) provided with this repository.
 
 ## Testing
 
-After installing qsimcirq on your machine, you can test the installation by
+After installing `qsimcirq` on your machine, you can test the installation by
 copying [qsimcirq_tests/qsimcirq_test.py](qsimcirq_tests/qsimcirq_test.py)
 to your machine and running `python3 -m pytest qsimcirq_test.py`.
 
+It also has examples of how how to use this package.
+
 **Note:** Because of how Python searches for modules, the test file cannot
 be run from inside a clone of the qsim repository, or from any parent
 directory of such a repository. Failure to meet this criteria may result

From 3782b02b882ea80bf1d099c0492e6b1f8d65600e Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 20 Aug 2021 06:33:06 -0700
Subject: [PATCH 071/246] Split qsim_lib into CUDA/CC versions

---
 lib/BUILD | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 58 insertions(+), 2 deletions(-)

diff --git a/lib/BUILD b/lib/BUILD
index 2b1288a8..99c93e96 100644
--- a/lib/BUILD
+++ b/lib/BUILD
@@ -8,10 +8,66 @@ package(default_visibility = ["//visibility:public"])
 
 ##### Aggregate libraries #####
 
-# Full qsim library
-# cuda_library
+# Full qsim library, minus CUDA
 cc_library(
     name = "qsim_lib",
+    hdrs = [
+        "bits.h",
+        "bitstring.h",
+        "channel.h",
+        "channels_cirq.h",
+        "circuit_noisy.h",
+        "circuit_qsim_parser.h",
+        "circuit.h",
+        "expect.h",
+        "formux.h",
+        "fuser.h",
+        "fuser_basic.h",
+        "fuser_mqubit.h",
+        "gate.h",
+        "gate_appl.h",
+        "gates_cirq.h",
+        "gates_qsim.h",
+        "hybrid.h",
+        "io_file.h",
+        "io.h",
+        "matrix.h",
+        "mps_simulator.h",
+        "mps_statespace.h",
+        "parfor.h",
+        "qtrajectory.h",
+        "run_qsim.h",
+        "run_qsimh.h",
+        "seqfor.h",
+        "simmux.h",
+        "simulator_avx.h",
+        "simulator_avx512.h",
+        "simulator_basic.h",
+        "simulator_sse.h",
+        "statespace_avx.h",
+        "statespace_avx512.h",
+        "statespace_basic.h",
+        "statespace_sse.h",
+        "statespace.h",
+        "umux.h",
+        "unitaryspace.h",
+        "unitaryspace_avx.h",
+        "unitaryspace_avx512.h",
+        "unitaryspace_basic.h",
+        "unitaryspace_sse.h",
+        "unitary_calculator_avx.h",
+        "unitary_calculator_avx512.h",
+        "unitary_calculator_basic.h",
+        "unitary_calculator_sse.h",
+        "util.h",
+        "vectorspace.h",
+    ],
+)
+
+# Full qsim library, including CUDA
+# cuda_library
+cc_library(
+    name = "qsim_cuda_lib",
     hdrs = [
         "bits.h",
         "bitstring.h",

From e6ef4cae27bf9c1ee767ef88cb2cb51cfd2ea030 Mon Sep 17 00:00:00 2001
From: J Ross Thomson <39315853+jrossthomson@users.noreply.github.com>
Date: Fri, 20 Aug 2021 11:06:30 -0400
Subject: [PATCH 072/246] Update README.md

---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 28a81271..1535b51e 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -19,7 +19,7 @@ When you have a project created, move on to the next step.
 
 ## Configure your enviroment
 
-In your project using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
+In your project using the Cloud Shell (https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
 ```
 git clone https://github.com/jrossthomson/qsim.git
 ```

From e381bc1e4cd387064047a8731dad822678323d87 Mon Sep 17 00:00:00 2001
From: J Ross Thomson <39315853+jrossthomson@users.noreply.github.com>
Date: Fri, 20 Aug 2021 11:07:04 -0400
Subject: [PATCH 073/246] Update README.md

---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 1535b51e..d33e446a 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -19,7 +19,7 @@ When you have a project created, move on to the next step.
 
 ## Configure your enviroment
 
-In your project using the Cloud Shell (https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
+In your project using the Cloud Shell (https://console.cloud.google.com/home/dashboard?cloudshell=true), clone this Github repo.
 ```
 git clone https://github.com/jrossthomson/qsim.git
 ```

From b70a82ca7669b9c147d84e9bda7abaea84d6bfc0 Mon Sep 17 00:00:00 2001
From: J Ross Thomson <39315853+jrossthomson@users.noreply.github.com>
Date: Fri, 20 Aug 2021 11:12:48 -0400
Subject: [PATCH 074/246] Update README.md

Wanted to add Cloud Shelll link with target=blank, but this does not work.
---
 docs/tutorials/multinode/README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index d33e446a..b8d7252b 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -19,7 +19,8 @@ When you have a project created, move on to the next step.
 
 ## Configure your enviroment
 
-In your project using the Cloud Shell (https://console.cloud.google.com/home/dashboard?cloudshell=true), clone this Github repo.
+In your project using the 
+[Cloud Shell](https://console.cloud.google.com/home/dashboard?cloudshell=true), clone this Github repo.
 ```
 git clone https://github.com/jrossthomson/qsim.git
 ```

From 0aab96ab16054bb51663a35db9f9eba0357b9f34 Mon Sep 17 00:00:00 2001
From: J Ross Thomson <39315853+jrossthomson@users.noreply.github.com>
Date: Fri, 20 Aug 2021 11:13:30 -0400
Subject: [PATCH 075/246] Update README.md

---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index b8d7252b..d7760938 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -31,7 +31,7 @@ cd qsim/docs/tutorials/multinode/terraform
 ```
 This is where you will use terraform to create the HTCondor cluster required to run your jobs.
 
-### Edit init file to setup environment
+### Edit init.sh file to setup environment
 
 You can now edit `init.sh` to change the name of the project you are using. You can also change the zone and region as you see fit. More information is available [here](https://cloud.google.com/compute/docs/regions-zones).
 

From 615ee603f3aade3cbbd24c2568812f3fdae37672 Mon Sep 17 00:00:00 2001
From: J Ross Thomson <39315853+jrossthomson@users.noreply.github.com>
Date: Fri, 20 Aug 2021 16:30:04 -0400
Subject: [PATCH 076/246] Update README.md

---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index d7760938..561b1746 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -161,7 +161,7 @@ The output will look as follows:
 Submitting job(s)..................................................
 50 job(s) submitted to cluster 2.
 ```
-If this is the second _submit_ you have run, you can see the output of the all the simualtions. The output will be in the `out` directory. 
+If this is the second _submit_ you have run, you can see the output of the all the simulations. The output will be in the `out` directory. 
 ```
 cat out/out.2-*
 ```

From 2fb475294e513be2e7e0cdab5685b1064ff60265 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Mon, 23 Aug 2021 19:39:32 +0200
Subject: [PATCH 077/246] Set flush-to-zero and denormals-are-zeros flags.

---
 apps/qsim_amplitudes.cc          | 12 +++++++--
 apps/qsim_base.cc                | 20 +++++++++++----
 apps/qsim_von_neumann.cc         | 20 +++++++++++----
 apps/qsimh_amplitudes.cc         | 12 +++++++--
 apps/qsimh_base.cc               | 12 +++++++--
 docs/cirq_interface.md           | 12 +++++++++
 docs/usage.md                    | 22 ++++++++++-------
 lib/util.h                       | 21 ++++++++++++++++
 pybind_interface/pybind_main.cpp | 42 ++++++++++++++++++++++++++++++++
 qsimcirq/qsim_simulator.py       |  5 ++++
 qsimcirq_tests/qsimcirq_test.py  | 14 +++++++++--
 tests/BUILD                      |  1 +
 tests/simulator_testfixture.h    | 41 ++++++++++++++++++++++++++++---
 13 files changed, 203 insertions(+), 31 deletions(-)

diff --git a/apps/qsim_amplitudes.cc b/apps/qsim_amplitudes.cc
index 29268633..01d50b96 100644
--- a/apps/qsim_amplitudes.cc
+++ b/apps/qsim_amplitudes.cc
@@ -34,7 +34,7 @@
 constexpr char usage[] = "usage:\n  ./qsim_amplitudes -c circuit_file "
                          "-d times_to_save_results -i input_files "
                          "-o output_files -s seed -t num_threads "
-                         "-f max_fused_size -v verbosity\n";
+                         "-f max_fused_size -v verbosity -z\n";
 
 struct Options {
   std::string circuit_file;
@@ -45,6 +45,7 @@ struct Options {
   unsigned num_threads = 1;
   unsigned max_fused_size = 2;
   unsigned verbosity = 0;
+  bool denormals_are_zeros = false;
 };
 
 Options GetOptions(int argc, char* argv[]) {
@@ -56,7 +57,7 @@ Options GetOptions(int argc, char* argv[]) {
     return std::atoi(word.c_str());
   };
 
-  while ((k = getopt(argc, argv, "c:d:i:s:o:t:f:v:")) != -1) {
+  while ((k = getopt(argc, argv, "c:d:i:s:o:t:f:v:z")) != -1) {
     switch (k) {
       case 'c':
         opt.circuit_file = optarg;
@@ -82,6 +83,9 @@ Options GetOptions(int argc, char* argv[]) {
       case 'v':
         opt.verbosity = std::atoi(optarg);
         break;
+      case 'z':
+        opt.denormals_are_zeros = true;
+        break;
       default:
         qsim::IO::errorf(usage);
         exit(1);
@@ -162,6 +166,10 @@ int main(int argc, char* argv[]) {
     return 1;
   }
 
+  if (opt.denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  }
+
   struct Factory {
     Factory(unsigned num_threads) : num_threads(num_threads) {}
 
diff --git a/apps/qsim_base.cc b/apps/qsim_base.cc
index 062dfdde..8d365e9a 100644
--- a/apps/qsim_base.cc
+++ b/apps/qsim_base.cc
@@ -26,6 +26,11 @@
 #include "../lib/io_file.h"
 #include "../lib/run_qsim.h"
 #include "../lib/simmux.h"
+#include "../lib/util.h"
+
+constexpr char usage[] = "usage:\n  ./qsim_base -c circuit -d maxtime "
+                         "-s seed -t threads -f max_fused_size "
+                         "-v verbosity -z\n";
 
 struct Options {
   std::string circuit_file;
@@ -34,18 +39,15 @@ struct Options {
   unsigned num_threads = 1;
   unsigned max_fused_size = 2;
   unsigned verbosity = 0;
+  bool denormals_are_zeros = false;
 };
 
 Options GetOptions(int argc, char* argv[]) {
-  constexpr char usage[] = "usage:\n  ./qsim_base -c circuit -d maxtime "
-                           "-s seed -t threads -f max_fused_size "
-                           "-v verbosity\n";
-
   Options opt;
 
   int k;
 
-  while ((k = getopt(argc, argv, "c:d:s:t:f:v:")) != -1) {
+  while ((k = getopt(argc, argv, "c:d:s:t:f:v:z")) != -1) {
     switch (k) {
       case 'c':
         opt.circuit_file = optarg;
@@ -65,6 +67,9 @@ Options GetOptions(int argc, char* argv[]) {
       case 'v':
         opt.verbosity = std::atoi(optarg);
         break;
+      case 'z':
+        opt.denormals_are_zeros = true;
+        break;
       default:
         qsim::IO::errorf(usage);
         exit(1);
@@ -77,6 +82,7 @@ Options GetOptions(int argc, char* argv[]) {
 bool ValidateOptions(const Options& opt) {
   if (opt.circuit_file.empty()) {
     qsim::IO::errorf("circuit file is not provided.\n");
+    qsim::IO::errorf(usage);
     return false;
   }
 
@@ -114,6 +120,10 @@ int main(int argc, char* argv[]) {
     return 1;
   }
 
+  if (opt.denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  }
+
   struct Factory {
     Factory(unsigned num_threads) : num_threads(num_threads) {}
 
diff --git a/apps/qsim_von_neumann.cc b/apps/qsim_von_neumann.cc
index df9b32fb..c2264909 100644
--- a/apps/qsim_von_neumann.cc
+++ b/apps/qsim_von_neumann.cc
@@ -28,6 +28,11 @@
 #include "../lib/io_file.h"
 #include "../lib/run_qsim.h"
 #include "../lib/simmux.h"
+#include "../lib/util.h"
+
+constexpr char usage[] = "usage:\n  ./qsim_von_neumann -c circuit -d maxtime "
+                         "-s seed -t threads -f max_fused_size "
+                         "-v verbosity -z\n";
 
 struct Options {
   std::string circuit_file;
@@ -36,18 +41,15 @@ struct Options {
   unsigned num_threads = 1;
   unsigned max_fused_size = 2;
   unsigned verbosity = 0;
+  bool denormals_are_zeros = false;
 };
 
 Options GetOptions(int argc, char* argv[]) {
-  constexpr char usage[] = "usage:\n  ./qsim_von_neumann -c circuit -d maxtime "
-                           "-s seed -t threads -f max_fused_size "
-                           "-v verbosity\n";
-
   Options opt;
 
   int k;
 
-  while ((k = getopt(argc, argv, "c:d:s:t:f:v:")) != -1) {
+  while ((k = getopt(argc, argv, "c:d:s:t:f:v:z")) != -1) {
     switch (k) {
       case 'c':
         opt.circuit_file = optarg;
@@ -67,6 +69,9 @@ Options GetOptions(int argc, char* argv[]) {
       case 'v':
         opt.verbosity = std::atoi(optarg);
         break;
+      case 'z':
+        opt.denormals_are_zeros = true;
+        break;
       default:
         qsim::IO::errorf(usage);
         exit(1);
@@ -79,6 +84,7 @@ Options GetOptions(int argc, char* argv[]) {
 bool ValidateOptions(const Options& opt) {
   if (opt.circuit_file.empty()) {
     qsim::IO::errorf("circuit file is not provided.\n");
+    qsim::IO::errorf(usage);
     return false;
   }
 
@@ -99,6 +105,10 @@ int main(int argc, char* argv[]) {
     return 1;
   }
 
+  if (opt.denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  }
+
   struct Factory {
     Factory(unsigned num_threads) : num_threads(num_threads) {}
 
diff --git a/apps/qsimh_amplitudes.cc b/apps/qsimh_amplitudes.cc
index cf57f121..cfb5b09a 100644
--- a/apps/qsimh_amplitudes.cc
+++ b/apps/qsimh_amplitudes.cc
@@ -35,7 +35,7 @@ constexpr char usage[] = "usage:\n  ./qsimh_amplitudes -c circuit_file "
                          "-d maxtime -k part1_qubits "
                          "-w prefix -p num_prefix_gates -r num_root_gates "
                          "-i input_file -o output_file -t num_threads "
-                         "-v verbosity\n";
+                         "-v verbosity -z\n";
 
 struct Options {
   std::string circuit_file;
@@ -48,6 +48,7 @@ struct Options {
   unsigned num_root_gatexs = 0;
   unsigned num_threads = 1;
   unsigned verbosity = 0;
+  bool denormals_are_zeros = false;
 };
 
 Options GetOptions(int argc, char* argv[]) {
@@ -59,7 +60,7 @@ Options GetOptions(int argc, char* argv[]) {
     return std::atoi(word.c_str());
   };
 
-  while ((k = getopt(argc, argv, "c:d:k:w:p:r:i:o:t:v:")) != -1) {
+  while ((k = getopt(argc, argv, "c:d:k:w:p:r:i:o:t:v:z")) != -1) {
     switch (k) {
       case 'c':
         opt.circuit_file = optarg;
@@ -91,6 +92,9 @@ Options GetOptions(int argc, char* argv[]) {
       case 'v':
         opt.verbosity = std::atoi(optarg);
         break;
+      case 'z':
+        opt.denormals_are_zeros = true;
+        break;
       default:
         qsim::IO::errorf(usage);
         exit(1);
@@ -180,6 +184,10 @@ int main(int argc, char* argv[]) {
   }
   auto parts = GetParts(circuit.num_qubits, opt.part1);
 
+  if (opt.denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  }
+
   std::vector<Bitstring> bitstrings;
   auto num_qubits = circuit.num_qubits;
   if (!BitstringsFromFile<IOFile>(num_qubits, opt.input_file, bitstrings)) {
diff --git a/apps/qsimh_base.cc b/apps/qsimh_base.cc
index 7b9190d8..c1656a8b 100644
--- a/apps/qsimh_base.cc
+++ b/apps/qsimh_base.cc
@@ -34,7 +34,7 @@
 constexpr char usage[] = "usage:\n  ./qsimh_base -c circuit_file "
                          "-d maximum_time -k part1_qubits "
                          "-w prefix -p num_prefix_gates -r num_root_gates "
-                         "-t num_threads -v verbosity\n";
+                         "-t num_threads -v verbosity -z\n";
 
 struct Options {
   std::string circuit_file;
@@ -45,6 +45,7 @@ struct Options {
   unsigned num_root_gatexs = 0;
   unsigned num_threads = 1;
   unsigned verbosity = 0;
+  bool denormals_are_zeros = false;
 };
 
 Options GetOptions(int argc, char* argv[]) {
@@ -56,7 +57,7 @@ Options GetOptions(int argc, char* argv[]) {
     return std::atoi(word.c_str());
   };
 
-  while ((k = getopt(argc, argv, "c:d:k:w:p:r:t:v:")) != -1) {
+  while ((k = getopt(argc, argv, "c:d:k:w:p:r:t:v:z")) != -1) {
     switch (k) {
       case 'c':
         opt.circuit_file = optarg;
@@ -82,6 +83,9 @@ Options GetOptions(int argc, char* argv[]) {
       case 'v':
         opt.verbosity = std::atoi(optarg);
         break;
+      case 'z':
+        opt.denormals_are_zeros = true;
+        break;
       default:
         qsim::IO::errorf(usage);
         exit(1);
@@ -142,6 +146,10 @@ int main(int argc, char* argv[]) {
   }
   auto parts = GetParts(circuit.num_qubits, opt.part1);
 
+  if (opt.denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  }
+
   uint64_t num_bitstrings =
       std::min(uint64_t{8}, uint64_t{1} << circuit.num_qubits);
 
diff --git a/docs/cirq_interface.md b/docs/cirq_interface.md
index 4f5d190a..659ec2db 100644
--- a/docs/cirq_interface.md
+++ b/docs/cirq_interface.md
@@ -117,6 +117,18 @@ the circuit once for each repetition unless all measurements are terminal. This
 ensures that nondeterminism from intermediate measurements is properly
 reflected in the results.
 
+In rare cases when the state vector and the gate matrices have many zero
+entries (denormal numbers), a significant performance slowdown can occur.
+Set the `denormals_are_zeros` option to `True` to prevent this issue
+potentially at the cost of a tiny precision loss:
+
+```
+# equivalent to {'t': 8, 'v': 0, 'z': True}
+qsim_options = qsimcirq.QSimOptions(cpu_threads=8, verbosity=0, denormals_are_zeros=True)
+my_sim = qsimcirq.QSimSimulator(qsim_options)
+myres = my_sim.simulate(program=my_circuit)
+```
+
 #### QSimhSimulator
 
 `QSimhSimulator` uses a hybrid Schrödinger-Feynman simulator. This limits it to
diff --git a/docs/usage.md b/docs/usage.md
index 7bc5e525..8c30d08e 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -13,7 +13,7 @@ Sample circuits are provided in
 ## qsim_base usage
 
 ```
-./qsim_base.x -c circuit_file -d maxtime -t num_threads -f max_fused_size -v verbosity
+./qsim_base.x -c circuit_file -d maxtime -t num_threads -f max_fused_size -v verbosity -z
 ```
 
 | Flag | Description |
@@ -23,6 +23,7 @@ Sample circuits are provided in
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
 |`-v verbosity` | verbosity level (0,1,>1)|
+|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_base computes all the amplitudes and just prints the first eight of them
 (or a smaller number for 1- or 2-qubit circuits).
@@ -35,7 +36,7 @@ Example:
 ## qsim_von_neumann usage
 
 ```
-./qsim_von_neumann.x -c circuit_file -d maxtime -t num_threads -f max_fused_size -v verbosity
+./qsim_von_neumann.x -c circuit_file -d maxtime -t num_threads -f max_fused_size -v verbosity -z
 ```
 
 
@@ -46,6 +47,7 @@ Example:
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
 |`-v verbosity` | verbosity level (0,1,>1)|
+|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_von_neumann computes all the amplitudes and calculates the von Neumann
 entropy. Note that this can be quite slow for large circuits and small thread
@@ -64,18 +66,19 @@ Example:
                     -i input_files \
                     -o output_files \
                     -f max_fused_size \
-                    -t num_threads -v verbosity
+                    -t num_threads -v verbosity -z
 ```
 
 | Flag | Description |
 |-------|------------|
 |`-c circuit_file` | circuit file to run|
-|`-d times_to_save_results`  | comma-separated list of circuit times to save results at|
+|`-d times_to_save_results` | comma-separated list of circuit times to save results at|
 |`-i input_files` | comma-separated list of bitstring input files|
 |`-o output_files` | comma-separated list of amplitude output files|
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
 |`-v verbosity` | verbosity level (0,1,>1)|
+|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_amplitudes reads input files of bitstrings, computes the corresponding
 amplitudes at specified times and writes them to output files.
@@ -97,20 +100,20 @@ Example:
                -w prefix \
                -p num_prefix_gates \
                -r num_root_gates \
-               -t num_threads -v verbosity
+               -t num_threads -v verbosity -z
 ```
 
 | Flag | Description |
 |-------|------------|
 |`-c circuit_file` | circuit file to run|
 |`-d maxtime` | maximum time |
-|`-k part1_qubits` |  comma-separated list of qubit indices for part 1 |
+|`-k part1_qubits` |  comma-separated list of qubit indices for part 1|
 |`-w prefix`| prefix value |
 |`-p num_prefix_gates` | number of prefix gates|
 |`-r num_root_gates` | number of root gates|
 |`-t num_threads` | number of threads to use|
 |`-v verbosity` | verbosity level (0,>0)|
-
+|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsimh_base just computes and just prints the first eight amplitudes. The hybrid
 Schrödinger-Feynman method is used. The lattice is split into two parts.
@@ -176,14 +179,14 @@ maximum "time".
                      -p num_prefix_gates \
                      -r num_root_gates \
                      -i input_file -o output_file \
-                     -t num_threads -v verbosity
+                     -t num_threads -v verbosity -z
 ```
 
 | Flag | Description |
 |-------|------------|
 |`-c circuit_file` | circuit file to run|
 |`-d maxtime` | maximum time |
-|`-k part1_qubits` |  comma-separated list of qubit indices for part 1 |
+|`-k part1_qubits` | comma-separated list of qubit indices for part 1|
 |`-w prefix`| prefix value |
 |`-p num_prefix_gates` | number of prefix gates|
 |`-r num_root_gates` | number of root gates|
@@ -191,6 +194,7 @@ maximum "time".
 |`-o output_file` | amplitude output file|
 |`-t num_threads` | number of threads to use|
 |`-v verbosity` | verbosity level (0,>0)|
+|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsimh_amplitudes reads the input file of bitstrings, computes the corresponding
 amplitudes and writes them to the output file. The hybrid Schrödinger-Feynman
diff --git a/lib/util.h b/lib/util.h
index 726a0192..19fbb9fd 100644
--- a/lib/util.h
+++ b/lib/util.h
@@ -15,6 +15,10 @@
 #ifndef UTIL_H_
 #define UTIL_H_
 
+#ifdef __SSE__
+# include <immintrin.h>
+#endif
+
 #include <algorithm>
 #include <chrono>
 #include <random>
@@ -84,6 +88,23 @@ inline std::vector<DistrRealType> GenerateRandomValues(
   return rs;
 }
 
+// This function sets flush-to-zero and denormals-are-zeros MXCSR control
+// flags. This prevents rare cases of performance slowdown potentially at
+// the cost of a tiny precision loss.
+void SetFlushToZeroAndDenormalsAreZeros() {
+#ifdef __SSE2__
+  _mm_setcsr(_mm_getcsr() | 0x8040);
+#endif
+}
+
+// This function clears flush-to-zero and denormals-are-zeros MXCSR control
+// flags.
+void ClearFlushToZeroAndDenormalsAreZeros() {
+#ifdef __SSE2__
+  _mm_setcsr(_mm_getcsr() & ~unsigned{0x8040});
+#endif
+}
+
 }  // namespace qsim
 
 #endif  // UTIL_H_
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 95c09f77..67a74cae 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -383,12 +383,14 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
                             Factory>;
 
   bool use_gpu;
+  bool denormals_are_zeros;
   unsigned num_sim_threads;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
   Runner::Parameter param;
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
     if (use_gpu) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
@@ -403,6 +405,13 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
     IO::errorf(exp.what());
     return {};
   }
+
+  if (denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  } else {
+    ClearFlushToZeroAndDenormalsAreZeros();
+  }
+
   Runner::Run(
     param, Factory(num_sim_threads, num_state_threads, num_dblocks), circuit,
     measure);
@@ -436,6 +445,7 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
 
   Runner::Parameter param;
   bool use_gpu;
+  bool denormals_are_zeros;
   unsigned num_sim_threads;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
@@ -443,6 +453,7 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
 
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
     if (use_gpu) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
@@ -470,6 +481,12 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
     }
   };
 
+  if (denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  } else {
+    ClearFlushToZeroAndDenormalsAreZeros();
+  }
+
   if (!Runner::RunBatch(param, ncircuit, seed, seed + 1, state_space,
                         simulator, measure)) {
     IO::errorf("qtrajectory simulation of the circuit errored out.\n");
@@ -544,6 +561,7 @@ class SimulatorHelper {
       : state_space(Factory(1, 1, 1).CreateStateSpace()),
         state(StateSpace::Null()),
         scratch(StateSpace::Null()) {
+    bool denormals_are_zeros;
     is_valid = false;
     is_noisy = noisy;
     try {
@@ -557,6 +575,7 @@ class SimulatorHelper {
       }
 
       use_gpu = parseOptions<unsigned>(options, "g\0");
+      denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
       if (use_gpu) {
         num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
         num_state_threads = parseOptions<unsigned>(options, "gsst\0");
@@ -572,6 +591,12 @@ class SimulatorHelper {
         num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
       state = state_space.Create(num_qubits);
       is_valid = true;
+
+      if (denormals_are_zeros) {
+        SetFlushToZeroAndDenormalsAreZeros();
+      } else {
+        ClearFlushToZeroAndDenormalsAreZeros();
+      }
     } catch (const std::invalid_argument &exp) {
       // If this triggers, is_valid is false.
       IO::errorf(exp.what());
@@ -609,6 +634,7 @@ class SimulatorHelper {
     bool result = false;
 
     Factory factory(num_sim_threads, num_state_threads, num_dblocks);
+
     if (is_noisy) {
       std::vector<uint64_t> stat;
       auto params = get_noisy_params();
@@ -772,12 +798,14 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
                             Factory>;
 
   bool use_gpu;
+  bool denormals_are_zeros;
   unsigned num_sim_threads;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
   Runner::Parameter param;
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
     if (use_gpu) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
@@ -799,6 +827,12 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
   State state = state_space.Create(circuit.num_qubits);
   state_space.SetStateZero(state);
 
+  if (denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  } else {
+    ClearFlushToZeroAndDenormalsAreZeros();
+  }
+
   if (!Runner::Run(param, factory, circuit, state, results)) {
     IO::errorf("qsim sampling of the circuit errored out.\n");
     return {};
@@ -830,6 +864,7 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
 
   Runner::Parameter param;
   bool use_gpu;
+  bool denormals_are_zeros;
   unsigned num_sim_threads;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
@@ -837,6 +872,7 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
 
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
     if (use_gpu) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
@@ -883,6 +919,12 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
     }
   };
 
+  if (denormals_are_zeros) {
+    SetFlushToZeroAndDenormalsAreZeros();
+  } else {
+    ClearFlushToZeroAndDenormalsAreZeros();
+  }
+
   if (!Runner::RunBatch(param, ncircuit, seed, seed + 1,
                         state_space, simulator, measure)) {
     IO::errorf("qtrajectory sampling of the circuit errored out.\n");
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index f079f55e..a7b52335 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -142,6 +142,9 @@ class QSimOptions:
         gpu_data_blocks: number of data blocks to use on GPU. Below 16 data
             blocks, performance is noticeably reduced.
         verbosity: Logging verbosity.
+        denormals_are_zeros: if true, set flush-to-zero and denormals-are-zeros
+            MXCSR control flags. This prevents rare cases of performance
+            slowdown potentially at the cost of a tiny precision loss.
     """
 
     max_fused_gate_size: int = 2
@@ -152,6 +155,7 @@ class QSimOptions:
     gpu_state_threads: int = 512
     gpu_data_blocks: int = 16
     verbosity: int = 0
+    denormals_are_zeros: bool = False
 
     def as_dict(self):
         """Generates an options dict from this object.
@@ -167,6 +171,7 @@ def as_dict(self):
             "gsst": self.gpu_state_threads,
             "gdb": self.gpu_data_blocks,
             "v": self.verbosity,
+            "z": self.denormals_are_zeros,
         }
 
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index e11de449..2d627033 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1485,12 +1485,22 @@ def test_cirq_qsim_global_shift():
     cirq_result = simulator.simulate(circuit)
 
     qsim_simulator = qsimcirq.QSimSimulator()
-    qsim_result = qsim_simulator.simulate(circuit)
+    qsim_result1 = qsim_simulator.simulate(circuit)
 
     assert cirq.linalg.allclose_up_to_global_phase(
-        qsim_result.state_vector(), cirq_result.state_vector()
+        qsim_result1.state_vector(), cirq_result.state_vector()
     )
 
+    qsim_simulator.qsim_options["u"] = True
+    qsim_result2 = qsim_simulator.simulate(circuit)
+
+    assert (qsim_result1.state_vector() == qsim_result2.state_vector()).all()
+
+    qsim_simulator.qsim_options["u"] = False
+    qsim_result3 = qsim_simulator.simulate(circuit)
+
+    assert (qsim_result1.state_vector() == qsim_result3.state_vector()).all()
+
 
 @pytest.mark.parametrize("mode", ["noiseless", "noisy"])
 def test_cirq_qsim_circuit_memoization_compute_amplitudes(mode: str):
diff --git a/tests/BUILD b/tests/BUILD
index 71a4f916..53f72ab4 100644
--- a/tests/BUILD
+++ b/tests/BUILD
@@ -265,6 +265,7 @@ cc_library(
         "//lib:gate_appl",
         "//lib:gates_qsim",
         "//lib:io",
+        "//lib:util",
     ],
     testonly = 1,
 )
diff --git a/tests/simulator_testfixture.h b/tests/simulator_testfixture.h
index ba575f4a..17b571ec 100644
--- a/tests/simulator_testfixture.h
+++ b/tests/simulator_testfixture.h
@@ -27,6 +27,7 @@
 #include "../lib/gate_appl.h"
 #include "../lib/gates_qsim.h"
 #include "../lib/io.h"
+#include "../lib/util.h"
 
 namespace qsim {
 
@@ -460,11 +461,11 @@ void TestCircuitWithControlledGates(const Factory& factory) {
   StateSpace state_space = factory.CreateStateSpace();
   Simulator simulator = factory.CreateSimulator();
 
-  auto state = state_space.Create(num_qubits);
-  state_space.SetStateZero(state);
+  auto state1 = state_space.Create(num_qubits);
+  state_space.SetStateZero(state1);
 
   for (const auto& gate : gates) {
-    ApplyGate(simulator, gate, state);
+    ApplyGate(simulator, gate, state1);
   }
 
 /*
@@ -717,10 +718,42 @@ if __name__ == '__main__':
   unsigned size = 1 << num_qubits;
 
   for (unsigned i = 0; i < size; ++i) {
-    auto a = StateSpace::GetAmpl(state, i);
+    auto a = StateSpace::GetAmpl(state1, i);
     EXPECT_NEAR(std::real(a), expected_results[i][0], 1e-6);
     EXPECT_NEAR(std::imag(a), expected_results[i][1], 1e-6);
   }
+
+  SetFlushToZeroAndDenormalsAreZeros();
+
+  auto state2 = state_space.Create(num_qubits);
+  state_space.SetStateZero(state2);
+
+  for (const auto& gate : gates) {
+    ApplyGate(simulator, gate, state2);
+  }
+
+  for (unsigned i = 0; i < size; ++i) {
+    auto a1 = StateSpace::GetAmpl(state1, i);
+    auto a2 = StateSpace::GetAmpl(state2, i);
+    EXPECT_EQ(std::real(a1), std::real(a2));
+    EXPECT_EQ(std::imag(a1), std::imag(a2));
+  }
+
+  ClearFlushToZeroAndDenormalsAreZeros();
+
+  auto state3 = state_space.Create(num_qubits);
+  state_space.SetStateZero(state3);
+
+  for (const auto& gate : gates) {
+    ApplyGate(simulator, gate, state3);
+  }
+
+  for (unsigned i = 0; i < size; ++i) {
+    auto a1 = StateSpace::GetAmpl(state1, i);
+    auto a2 = StateSpace::GetAmpl(state3, i);
+    EXPECT_EQ(std::real(a1), std::real(a2));
+    EXPECT_EQ(std::imag(a1), std::imag(a2));
+  }
 }
 
 template <typename Factory>

From df527863af059e082dab3c8ba39ae779d32c71ec Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Mon, 23 Aug 2021 19:50:01 +0200
Subject: [PATCH 078/246] Fix typos.

---
 docs/cirq_interface.md          |  8 ++++----
 docs/usage.md                   | 10 +++++-----
 qsimcirq_tests/qsimcirq_test.py |  4 ++--
 3 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/cirq_interface.md b/docs/cirq_interface.md
index 659ec2db..5184ed3d 100644
--- a/docs/cirq_interface.md
+++ b/docs/cirq_interface.md
@@ -117,10 +117,10 @@ the circuit once for each repetition unless all measurements are terminal. This
 ensures that nondeterminism from intermediate measurements is properly
 reflected in the results.
 
-In rare cases when the state vector and the gate matrices have many zero
-entries (denormal numbers), a significant performance slowdown can occur.
-Set the `denormals_are_zeros` option to `True` to prevent this issue
-potentially at the cost of a tiny precision loss:
+In rare cases when the state vector and gate matrices have many zero entries
+(denormal numbers), a significant performance slowdown can occur. Set
+the `denormals_are_zeros` option to `True` to prevent this issue potentially
+at the cost of a tiny precision loss:
 
 ```
 # equivalent to {'t': 8, 'v': 0, 'z': True}
diff --git a/docs/usage.md b/docs/usage.md
index 8c30d08e..06b8712e 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -23,7 +23,7 @@ Sample circuits are provided in
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
 |`-v verbosity` | verbosity level (0,1,>1)|
-|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
+|`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_base computes all the amplitudes and just prints the first eight of them
 (or a smaller number for 1- or 2-qubit circuits).
@@ -47,7 +47,7 @@ Example:
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
 |`-v verbosity` | verbosity level (0,1,>1)|
-|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
+|`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_von_neumann computes all the amplitudes and calculates the von Neumann
 entropy. Note that this can be quite slow for large circuits and small thread
@@ -78,7 +78,7 @@ Example:
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
 |`-v verbosity` | verbosity level (0,1,>1)|
-|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
+|`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_amplitudes reads input files of bitstrings, computes the corresponding
 amplitudes at specified times and writes them to output files.
@@ -113,7 +113,7 @@ Example:
 |`-r num_root_gates` | number of root gates|
 |`-t num_threads` | number of threads to use|
 |`-v verbosity` | verbosity level (0,>0)|
-|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
+|`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsimh_base just computes and just prints the first eight amplitudes. The hybrid
 Schrödinger-Feynman method is used. The lattice is split into two parts.
@@ -194,7 +194,7 @@ maximum "time".
 |`-o output_file` | amplitude output file|
 |`-t num_threads` | number of threads to use|
 |`-v verbosity` | verbosity level (0,>0)|
-|`-z | set flush-to-zero and denormals-are-zeros MXCSR control flags|
+|`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsimh_amplitudes reads the input file of bitstrings, computes the corresponding
 amplitudes and writes them to the output file. The hybrid Schrödinger-Feynman
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 2d627033..b6acd09a 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1491,12 +1491,12 @@ def test_cirq_qsim_global_shift():
         qsim_result1.state_vector(), cirq_result.state_vector()
     )
 
-    qsim_simulator.qsim_options["u"] = True
+    qsim_simulator.qsim_options["z"] = True
     qsim_result2 = qsim_simulator.simulate(circuit)
 
     assert (qsim_result1.state_vector() == qsim_result2.state_vector()).all()
 
-    qsim_simulator.qsim_options["u"] = False
+    qsim_simulator.qsim_options["z"] = False
     qsim_result3 = qsim_simulator.simulate(circuit)
 
     assert (qsim_result1.state_vector() == qsim_result3.state_vector()).all()

From 7f51ae14c77897a92dae0643c2146296b5b7581c Mon Sep 17 00:00:00 2001
From: Laurynas Tamulevicius <laurynas.tamulevicius@gmail.com>
Date: Tue, 24 Aug 2021 09:44:03 +0100
Subject: [PATCH 079/246] Update install_qsimcirq.md

Removed Python 3.5 references
---
 docs/install_qsimcirq.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/install_qsimcirq.md b/docs/install_qsimcirq.md
index 82cfc0d5..9ae35d21 100644
--- a/docs/install_qsimcirq.md
+++ b/docs/install_qsimcirq.md
@@ -19,19 +19,19 @@ file, and will be automatically installed along with qsimcirq.
 
 ## Linux installation
 
-We provide `qsimcirq` Python wheels on 64-bit `x86` architectures with `Python 3.{5,6,7,8,9}`.
+We provide `qsimcirq` Python wheels on 64-bit `x86` architectures with `Python 3.{6,7,8,9}`.
 
 Simply run `pip3 install qsimcirq`.
 
 ## MacOS installation
 
-We provide `qsimcirq` Python wheels on `x86` architectures with `Python 3.{5,6,7,8,9}`.
+We provide `qsimcirq` Python wheels on `x86` architectures with `Python 3.{6,7,8,9}`.
 
 Simply run `pip3 install qsimcirq`.
 
 ## Windows installation
 
-We provide `qsimcirq` Python wheels on 64-bit `x86` and `amd64` architectures with `Python 3.{5,6,7,8,9}`.
+We provide `qsimcirq` Python wheels on 64-bit `x86` and `amd64` architectures with `Python 3.{6,7,8,9}`.
 
 Simply run `pip3 install qsimcirq`.
 

From f9670323b65e0b0f58f375e52bc5199389b4ad8c Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 30 Aug 2021 21:02:39 +0000
Subject: [PATCH 080/246] Added more detail on the readme

---
 docs/tutorials/multinode/terraform/README.md | 120 ++++++++++++++-----
 docs/tutorials/multinode/terraform/init.sh   |  11 +-
 2 files changed, 99 insertions(+), 32 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index 5459045a..800e08ef 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -1,50 +1,88 @@
 # Multinode quantum simulation using HTCondor on GCP
-This tutorial will take you through the process of running many qsim simulations
-on Google Cloud. In some situations, it is required to run many instances of the same 
-simulation. This could be used to provide a parameter sweep or to evaluation noise characteristics.
+This tutorial will take you through the process of running multiple simultaneous
+`qsim` simulations on Google Cloud. In some situations, it is required to run
+many instances of the same simulation. This could be used to provide a parameter
+sweep or to evaluation noise characteristics.
+
+One of the key competencies of a quantum computing effort is the ability to run
+simulations. While quantum computing hardware is still years from general
+availability, quantum computing simulation with `qsim` and `Cirq` is available for
+researchers exploring a quantum program. It is expected that simulation will be
+a gating requirement to make use of physical hardware, to prove out algorithms
+both for computability and stability under noisy conditions. Many thousands of
+simulation runs will typically be required to prove out the gating requirements
+for each circuit, sometimes requiring years of simulation in advance of any
+practical use of the quantum hardware.
 
 ## Objectives
 
-* Use Terraform to deploy a HTCondor cluster
+* Use `terraform` to deploy a HTCondor cluster
 * Run a multinode simulation using HTCondor
 * Query cluster information and monitor running jobs in HTCondor
+* Use `terraform` to destroy the cluster
 
 
-## Create a project
+## Step 1: Create a project
 In a seperate tutorial the method to create Google Cloud project is explained in detail. 
 [Please refer to this tutorial for guidance](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup).
 
 When you have a project created, move on to the next step.
 
-## Configure your enviroment
+## Step 2: Configure your enviroment
 
-In your project using the Cloud Console(https://console.google.com/home/dashboard?cloudshell=true), clone this Github repo.
-```
+Although this tutorial can be run from your local computer, we recommend the use
+of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
+
+Once you have created  a project in the previous step, 
+the Cloud Console with Cloud Shell activeated can be reached through this link: (https://console.google.com/home/dashboard?cloudshell=true)
+
+### Clone this repo
+
+In your Clous Shell window, clone this Github repo.
+``` bash
 git clone https://github.com/jrossthomson/qsim.git
 ```
 
+### Change directory
 Change directory to the tutorial:
-```
+``` bash
 cd qsim/docs/tutorials/multinode/terraform
 ```
-This is where you will use terraform to create the HTCondor cluster required to run your jobs.
+This is where you will use `terraform` to create the HTCondor cluster required to run your jobs.
 
-### Edit init file to setup environment
+### Edit `init.sh` file to customize your environment
 
-You can now edit `init.sh` to change the name of the project you are using. You can also change the zone and region as you see fit. More information is available [here](https://cloud.google.com/compute/docs/regions-zones).
+You can now edit `init.sh` to change the name of the project you are using. You
+can also change the zone and region as you see fit. More information is
+available [here](https://cloud.google.com/compute/docs/regions-zones).
 
-Change the variables to reflect your project, most important is the first line:
+Use your favorite text file editor, either the integrated [Cloud Shell
+Editor](https://cloud.google.com/shell/docs/editor-overview), `vim`, `emacs` or `nano`.
+For example:
+``` bash
+vim init.sh
+```
+The file has many lines, but only edit the first 4.
+``` bash
+export TF_VAR_project=quantum-htcondor-15
+export TF_VAR_project_id=us-east4-c
+export TF_VAR_zone=us-east4-c
+export TF_VAR_region=us-east4
 ```
+
+The most important is the first line, indicating the name of the project you created above.
+``` bash
 export TF_VAR_project=my-quantum-htcondor-project
 ```
 The project id needs to be globally unique and to be the same as the project you just created.
 
+### Source the `init.sh` file
 The edited `init.sh` file should be "sourced" in the cloud shell:
 
-```
+``` bash
 source init.sh
 ```
-Repsond in the affirmative to any pop-ups that request permissions on the Cloud platform.
+Respond `Agree` to any pop-ups that request permissions on the Google Cloud platform.
 
 The final outcome of this script will include:
 
@@ -53,36 +91,53 @@ The final outcome of this script will include:
 * The appropriate permissions assigned to the service account
 * A key file created to enable the use of Google Cloud automation.
 
-This will take about 60 seconds. At the end you will see output about permissions and the configuration of the account.
+This will take up to 60 seconds. At the end you will see output about
+permissions and the configuration of the account.
 
-## Run terraform
+##  Step 3: Run terraform
 
-When this is complete, you can initialize teraform to begin your cluster creations:
-```
+After the previous steps are completed, you can initialize `terraform` to begin your cluster creation.
+The first step is to initialize the `terraform` state.
+``` bash
 terraform init
 ```
-A correct result will contain:
+A successful result will contain the text:
 ```
 Terraform has been successfully initialized!
 ```
-Some terraform commands are wrapped in a makefile, so you can now create your cluster:
-```
+### Run the `make` command
+For convenience, some terraform commands are prepared in a `Makefile`. This means
+you can now create your cluster, with a simple `make` command.
+```bash
 make apply
 ```
 A successful run will show:
 ```
 Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
 ```
-## Connect to the Submit node for HTCondor
-You will now be able list the VMs created:
+## Step4: Connect to the _submit_ node for HTCondor
+Although there are ways to run `HTCondor` commands from your local machine, 
+the normal path  is to login to the _submit_ node. From there you can run 
+commands to submit and monitor jobs on HTCondor.
+
+### List VMs that were created by
+
+You can list the VMs created. One of them will be the submit node. It will be the VM with
+"submit" in the name.
+
 ```
 gcloud compute instances list
 ```
-You will log in to the `submit` node:
-```
+Identify the node name, then log in to the `submit` node. If you used the
+standard install, the cluster name is "c". In that case you would connect using
+the `gcloud ssh` command.
+```bash
 gcloud compute ssh c-submit
 ```
-Now you are logged in to your HTCondor cluster.
+Now you are logged in to your HTCondor cluster. You will see a command prompt something like
+```bash
+[mylogin@c-submit ~]$
+```
 
 ### Checking the status 
 You can verify if the HTCondor install is completed:
@@ -100,9 +155,15 @@ Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held,
 ```
 If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
 
-## Clone the repo on your cluster
+## Step 5: Get the sample code and run it
+The HTCondor cluster is now ready for your jobs to be run. If you are familiar with HTCondor and you want to run your own jobs, you may do so. 
+
+If you don't have jobs to run, you can get sample jobs from this Github repo. You will clone the repo to 
+the submit node and run a job.
+
+##  Clone the repo on your cluster
 
-Again on the `submit` node you you can install the repo to get access to previously created submission files:
+on the `submit` node you you can install the repo to get access to previously created submission files:
 ```
 git clone https://github.com/jrossthomson/qsim.git
 ```
@@ -110,6 +171,7 @@ Then cd to the tutorial directory.
 ```
 cd qsim/docs/tutorials/multinode
 ```
+### Submit a job
 Now it is possible to submit a job:
 ```
 condor_submit circuit_q24.sub
diff --git a/docs/tutorials/multinode/terraform/init.sh b/docs/tutorials/multinode/terraform/init.sh
index 0d10befe..fdf46d3d 100644
--- a/docs/tutorials/multinode/terraform/init.sh
+++ b/docs/tutorials/multinode/terraform/init.sh
@@ -1,11 +1,15 @@
+# ---- Edit below -----#
+
 export TF_VAR_project=quantum-htcondor-15
 export TF_VAR_project_id=us-east4-c
 export TF_VAR_zone=us-east4-c
 export TF_VAR_region=us-east4
+
+# ---- Do not edit below -----#
+
 export TF_VAR_project_id=${TF_VAR_project}
 export TF_VAR_service_account="htcondor@"${TF_VAR_project}".iam.gserviceaccount.com"
 
-
 gcloud config set project $TF_VAR_project
 gcloud services enable compute.googleapis.com
 gcloud services enable monitoring.googleapis.com
@@ -14,7 +18,6 @@ gcloud config set compute/region $TF_VAR_region
 
 gcloud config list
 
-
 gcloud iam service-accounts create htcondor --display-name="Run HTCondor" 
 
 # Add roles
@@ -24,6 +27,8 @@ gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount
 gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/logging.admin
 gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/autoscaling.metricsWriter
 
+"""
 # Save key file locally.
 gcloud iam service-accounts keys create ~/.${TF_VAR_project_id}.json --iam-account=${TF_VAR_service_account}
-export GOOGLE_APPLICATION_CREDENTIALS=~/.${TF_VAR_project_id}.json
\ No newline at end of file
+export GOOGLE_APPLICATION_CREDENTIALS=~/.${TF_VAR_project_id}.json
+"""
\ No newline at end of file

From 7a349a2902cad68d0e57b6fcd49385483319e018 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 30 Aug 2021 22:07:13 +0000
Subject: [PATCH 081/246] remove local saving key file and expanded readme

---
 docs/tutorials/multinode/terraform/README.md | 100 ++++++++++++++++---
 docs/tutorials/multinode/terraform/init.sh   |   6 --
 2 files changed, 88 insertions(+), 18 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index 800e08ef..3d8a34ef 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -128,13 +128,18 @@ You can list the VMs created. One of them will be the submit node. It will be th
 ```
 gcloud compute instances list
 ```
-Identify the node name, then log in to the `submit` node. If you used the
-standard install, the cluster name is "c". In that case you would connect using
-the `gcloud ssh` command.
+You will see two instances listed:
+* c-manager: the core controller node
+* c-submit: the submit node where you will run interactive work.
+
+Identify then log in to the `submit` node. If you used the standard install, the
+cluster name is "c". In that case you would connect using the `gcloud ssh`
+command.
 ```bash
 gcloud compute ssh c-submit
 ```
-Now you are logged in to your HTCondor cluster. You will see a command prompt something like
+Now you are logged in to your HTCondor cluster. You will see a command prompt
+something like:
 ```bash
 [mylogin@c-submit ~]$
 ```
@@ -181,7 +186,13 @@ If successful, the output will be:
 Submitting job(s).
 1 job(s) submitted to cluster 1.
 ```
-This may take a few minutes, but when completed the command:
+You can see the job in queue by with the `condor_q` command.
+```
+condor_q
+```
+The job will take several minutes to finish. The time includes creating a VM
+compute node, installing the HTCondor system and running the job. When completed
+the files will be in the `out` directory.
 ```
 ls out
 ```
@@ -197,8 +208,28 @@ After the job s completed, the ouput of the job can be seen:
 ```
 cat out/out.1-0
 ```
-## Running noisy simulations
-To run multiple simulations, you can run the submit file `noise.sub`:
+## Step5: Run multi-node noise simulations
+Noise simulations make use of a [Monte Carlo
+method](https://en.wikipedia.org/wiki/Monte_Carlo_method) for [quantum
+trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory). 
+
+The primary goal of these simulations is to understand the behavior of the
+quantum circuit taking into account the effects of noise. There are many
+potential sources of noise in a quantum circuit, including thermal noise, 1/f
+noise or shot noise, as well as perturbations from cosmic rays. Understanding
+and calibrating noise in quantum computing is an active field of investigation,
+and it will require well characterized simulations.
+
+To run multiple simulations, you can run the submit file `noise.sub`.  The
+submit file is shown below. It is key to note that this is running  a `docker`
+container. Also, the `queue 50` command at the end of the file submits 50
+separate instances of the container. Since this job is noise driven, the output
+of each simulation with be different. A typical analysis of the output would be 
+a statistical study of the means and variations, perhaps looking for parameter 
+ranges where circuits are particularly susceptible to noise.
+
+
+### The noise.sub file
 ```
 universe                = docker
 docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
@@ -212,7 +243,7 @@ log                     = out/log.$(Cluster)-$(Process)
 request_memory          = 10GB
 queue 50
 ```
-The final line in this submit file has `queue 50`. This means 50 instances of this simulation will be run. The job can be submitted with the `condor_submit` command.
+The job can be submitted with the `condor_submit` command.
 ```
 condor_submit noise.sub
 ```
@@ -221,7 +252,21 @@ The output will look as follows:
 Submitting job(s)..................................................
 50 job(s) submitted to cluster 2.
 ```
-If this is the second _submit_ you have run, you can see the output of the all the simualtions. The output will be in the `out` directory. 
+To monitor the ongoing process of jobs running, you can take advantage of the
+Linux `watch` command and run `condor_q` repeatedly. When complete you watch can
+be exited with cntrl-c.
+```
+watch "condor_q; condor_status"
+```
+The output of this command will show you the jobs in the queue as well as the
+VMs being created to run the jobs. There is a limit of 20 VMs for this
+configuration of the cluster. This can be modified for future runs.
+
+When the command shows the queue is empty, the command can be stopped with cntl-c.
+
+If this is the second _submit_ you have run, you can see the output of the all
+the simualtions. The output will be in the `out` directory. 
+
 ```
 cat out/out.2-*
 ```
@@ -241,15 +286,46 @@ Counter({3: 466, 0: 442, 2: 51, 1: 41})
 ```
 Note that because this is a noise driven circuit, the results of each simulation are different.
 
-To run your own simulations, simply create a noisy circuit in your _qsim_ python file.
+## Next steps
+
+To run your own simulations, simply create a noisy circuit in your  _qsim_ python file.
+The file being run in this was `noise3.py`. You can take this example and expand
+to your own circuit. 
+
+```python
+import cirq, qsimcirq
+
+# Create a Bell state, |00) + |11)
+q0, q1 = cirq.LineQubit.range(2)
+circuit = cirq.Circuit(
+    cirq.H(q0),
+    cirq.CNOT(q0, q1),
+    cirq.measure(q0, q1, key='m')
+)
+
+# Constructs a noise model that adds depolarizing noise after each gate.
+noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
+
+# Use the noise model to create a noisy circuit.
+noisy_circuit = cirq.Circuit(noise.noisy_moments(circuit, system_qubits=[q0, q1]))
+
+sim = qsimcirq.QSimSimulator()
+result = sim.run(noisy_circuit, repetitions=1000)
+# Outputs a histogram dict of result:count pairs.
+# Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
+# (For comparison, the noiseless circuit will only have 0s and 3s)
+print(result.histogram(key='m'))
+```
 
 There are many more examples of circuits to be run [here](https://quantumai.google/cirq/noise)
 
-## Shutting down
-When you are done with this tutorial, it is important to remove the resources. You can do this with _terraform_
+## FINAL STEP: Shutting down 
+
+> **IMPORTANT**:  To avoid excess billing for this project, it is important to shut down the cluster. This is easily done using the make command built for this purpose.
 ```
 make destroy
 ```
+
 > The most effective way to ensure you are not charged is to delete the project. [The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
 
 
diff --git a/docs/tutorials/multinode/terraform/init.sh b/docs/tutorials/multinode/terraform/init.sh
index fdf46d3d..43a6471b 100644
--- a/docs/tutorials/multinode/terraform/init.sh
+++ b/docs/tutorials/multinode/terraform/init.sh
@@ -26,9 +26,3 @@ gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount
 gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/monitoring.admin
 gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/logging.admin
 gcloud projects add-iam-policy-binding ${TF_VAR_project} --member serviceAccount:${TF_VAR_service_account} --role roles/autoscaling.metricsWriter
-
-"""
-# Save key file locally.
-gcloud iam service-accounts keys create ~/.${TF_VAR_project_id}.json --iam-account=${TF_VAR_service_account}
-export GOOGLE_APPLICATION_CREDENTIALS=~/.${TF_VAR_project_id}.json
-"""
\ No newline at end of file

From 17f013b5ce79ef153722798fdfef3afe0a260f64 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 30 Aug 2021 22:24:38 +0000
Subject: [PATCH 082/246] Syncing both Readmes

---
 docs/tutorials/multinode/README.md | 214 +++++++++++++++++++++++------
 1 file changed, 175 insertions(+), 39 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 561b1746..3d8a34ef 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -1,52 +1,88 @@
-
 # Multinode quantum simulation using HTCondor on GCP
-This tutorial will take you through the process of running many qsim simulations
-on Google Cloud. In some situations, it is required to run many instances of the same 
-simulation. This could be used to provide a parameter sweep or to evaluation noise characteristics.
+This tutorial will take you through the process of running multiple simultaneous
+`qsim` simulations on Google Cloud. In some situations, it is required to run
+many instances of the same simulation. This could be used to provide a parameter
+sweep or to evaluation noise characteristics.
+
+One of the key competencies of a quantum computing effort is the ability to run
+simulations. While quantum computing hardware is still years from general
+availability, quantum computing simulation with `qsim` and `Cirq` is available for
+researchers exploring a quantum program. It is expected that simulation will be
+a gating requirement to make use of physical hardware, to prove out algorithms
+both for computability and stability under noisy conditions. Many thousands of
+simulation runs will typically be required to prove out the gating requirements
+for each circuit, sometimes requiring years of simulation in advance of any
+practical use of the quantum hardware.
 
 ## Objectives
 
-* Use Terraform to deploy a HTCondor cluster
+* Use `terraform` to deploy a HTCondor cluster
 * Run a multinode simulation using HTCondor
 * Query cluster information and monitor running jobs in HTCondor
+* Use `terraform` to destroy the cluster
 
 
-## Create a project
+## Step 1: Create a project
 In a seperate tutorial the method to create Google Cloud project is explained in detail. 
 [Please refer to this tutorial for guidance](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup).
 
 When you have a project created, move on to the next step.
 
-## Configure your enviroment
+## Step 2: Configure your enviroment
 
-In your project using the 
-[Cloud Shell](https://console.cloud.google.com/home/dashboard?cloudshell=true), clone this Github repo.
-```
+Although this tutorial can be run from your local computer, we recommend the use
+of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
+
+Once you have created  a project in the previous step, 
+the Cloud Console with Cloud Shell activeated can be reached through this link: (https://console.google.com/home/dashboard?cloudshell=true)
+
+### Clone this repo
+
+In your Clous Shell window, clone this Github repo.
+``` bash
 git clone https://github.com/jrossthomson/qsim.git
 ```
 
+### Change directory
 Change directory to the tutorial:
-```
+``` bash
 cd qsim/docs/tutorials/multinode/terraform
 ```
-This is where you will use terraform to create the HTCondor cluster required to run your jobs.
+This is where you will use `terraform` to create the HTCondor cluster required to run your jobs.
 
-### Edit init.sh file to setup environment
+### Edit `init.sh` file to customize your environment
 
-You can now edit `init.sh` to change the name of the project you are using. You can also change the zone and region as you see fit. More information is available [here](https://cloud.google.com/compute/docs/regions-zones).
+You can now edit `init.sh` to change the name of the project you are using. You
+can also change the zone and region as you see fit. More information is
+available [here](https://cloud.google.com/compute/docs/regions-zones).
 
-Change the variables to reflect your project, most important is the first line:
+Use your favorite text file editor, either the integrated [Cloud Shell
+Editor](https://cloud.google.com/shell/docs/editor-overview), `vim`, `emacs` or `nano`.
+For example:
+``` bash
+vim init.sh
+```
+The file has many lines, but only edit the first 4.
+``` bash
+export TF_VAR_project=quantum-htcondor-15
+export TF_VAR_project_id=us-east4-c
+export TF_VAR_zone=us-east4-c
+export TF_VAR_region=us-east4
 ```
+
+The most important is the first line, indicating the name of the project you created above.
+``` bash
 export TF_VAR_project=my-quantum-htcondor-project
 ```
 The project id needs to be globally unique and to be the same as the project you just created.
 
+### Source the `init.sh` file
 The edited `init.sh` file should be "sourced" in the cloud shell:
 
-```
+``` bash
 source init.sh
 ```
-Repsond in the affirmative to any pop-ups that request permissions on the Cloud platform.
+Respond `Agree` to any pop-ups that request permissions on the Google Cloud platform.
 
 The final outcome of this script will include:
 
@@ -55,36 +91,58 @@ The final outcome of this script will include:
 * The appropriate permissions assigned to the service account
 * A key file created to enable the use of Google Cloud automation.
 
-This will take about 60 seconds. At the end you will see output about permissions and the configuration of the account.
+This will take up to 60 seconds. At the end you will see output about
+permissions and the configuration of the account.
 
-## Run terraform
+##  Step 3: Run terraform
 
-When this is complete, you can initialize teraform to begin your cluster creations:
-```
+After the previous steps are completed, you can initialize `terraform` to begin your cluster creation.
+The first step is to initialize the `terraform` state.
+``` bash
 terraform init
 ```
-A correct result will contain:
+A successful result will contain the text:
 ```
 Terraform has been successfully initialized!
 ```
-Some terraform commands are wrapped in a makefile, so you can now create your cluster:
-```
+### Run the `make` command
+For convenience, some terraform commands are prepared in a `Makefile`. This means
+you can now create your cluster, with a simple `make` command.
+```bash
 make apply
 ```
 A successful run will show:
 ```
 Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
 ```
-## Connect to the Submit node for HTCondor
-You will now be able list the VMs created:
+## Step4: Connect to the _submit_ node for HTCondor
+Although there are ways to run `HTCondor` commands from your local machine, 
+the normal path  is to login to the _submit_ node. From there you can run 
+commands to submit and monitor jobs on HTCondor.
+
+### List VMs that were created by
+
+You can list the VMs created. One of them will be the submit node. It will be the VM with
+"submit" in the name.
+
 ```
 gcloud compute instances list
 ```
-You will log in to the `submit` node:
-```
+You will see two instances listed:
+* c-manager: the core controller node
+* c-submit: the submit node where you will run interactive work.
+
+Identify then log in to the `submit` node. If you used the standard install, the
+cluster name is "c". In that case you would connect using the `gcloud ssh`
+command.
+```bash
 gcloud compute ssh c-submit
 ```
-Now you are logged in to your HTCondor cluster.
+Now you are logged in to your HTCondor cluster. You will see a command prompt
+something like:
+```bash
+[mylogin@c-submit ~]$
+```
 
 ### Checking the status 
 You can verify if the HTCondor install is completed:
@@ -102,9 +160,15 @@ Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held,
 ```
 If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
 
-## Clone the repo on your cluster
+## Step 5: Get the sample code and run it
+The HTCondor cluster is now ready for your jobs to be run. If you are familiar with HTCondor and you want to run your own jobs, you may do so. 
+
+If you don't have jobs to run, you can get sample jobs from this Github repo. You will clone the repo to 
+the submit node and run a job.
 
-Again on the `submit` node you you can install the repo to get access to previously created submission files:
+##  Clone the repo on your cluster
+
+on the `submit` node you you can install the repo to get access to previously created submission files:
 ```
 git clone https://github.com/jrossthomson/qsim.git
 ```
@@ -112,6 +176,7 @@ Then cd to the tutorial directory.
 ```
 cd qsim/docs/tutorials/multinode
 ```
+### Submit a job
 Now it is possible to submit a job:
 ```
 condor_submit circuit_q24.sub
@@ -121,7 +186,13 @@ If successful, the output will be:
 Submitting job(s).
 1 job(s) submitted to cluster 1.
 ```
-This may take a few minutes, but when completed the command:
+You can see the job in queue by with the `condor_q` command.
+```
+condor_q
+```
+The job will take several minutes to finish. The time includes creating a VM
+compute node, installing the HTCondor system and running the job. When completed
+the files will be in the `out` directory.
 ```
 ls out
 ```
@@ -137,8 +208,28 @@ After the job s completed, the ouput of the job can be seen:
 ```
 cat out/out.1-0
 ```
-## Running noisy simulations
-To run multiple simulations, you can run the submit file `noise.sub`:
+## Step5: Run multi-node noise simulations
+Noise simulations make use of a [Monte Carlo
+method](https://en.wikipedia.org/wiki/Monte_Carlo_method) for [quantum
+trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory). 
+
+The primary goal of these simulations is to understand the behavior of the
+quantum circuit taking into account the effects of noise. There are many
+potential sources of noise in a quantum circuit, including thermal noise, 1/f
+noise or shot noise, as well as perturbations from cosmic rays. Understanding
+and calibrating noise in quantum computing is an active field of investigation,
+and it will require well characterized simulations.
+
+To run multiple simulations, you can run the submit file `noise.sub`.  The
+submit file is shown below. It is key to note that this is running  a `docker`
+container. Also, the `queue 50` command at the end of the file submits 50
+separate instances of the container. Since this job is noise driven, the output
+of each simulation with be different. A typical analysis of the output would be 
+a statistical study of the means and variations, perhaps looking for parameter 
+ranges where circuits are particularly susceptible to noise.
+
+
+### The noise.sub file
 ```
 universe                = docker
 docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
@@ -152,7 +243,7 @@ log                     = out/log.$(Cluster)-$(Process)
 request_memory          = 10GB
 queue 50
 ```
-The final line in this submit file has `queue 50`. This means 50 instances of this simulation will be run. The job can be submitted with the `condor_submit` command.
+The job can be submitted with the `condor_submit` command.
 ```
 condor_submit noise.sub
 ```
@@ -161,7 +252,21 @@ The output will look as follows:
 Submitting job(s)..................................................
 50 job(s) submitted to cluster 2.
 ```
-If this is the second _submit_ you have run, you can see the output of the all the simulations. The output will be in the `out` directory. 
+To monitor the ongoing process of jobs running, you can take advantage of the
+Linux `watch` command and run `condor_q` repeatedly. When complete you watch can
+be exited with cntrl-c.
+```
+watch "condor_q; condor_status"
+```
+The output of this command will show you the jobs in the queue as well as the
+VMs being created to run the jobs. There is a limit of 20 VMs for this
+configuration of the cluster. This can be modified for future runs.
+
+When the command shows the queue is empty, the command can be stopped with cntl-c.
+
+If this is the second _submit_ you have run, you can see the output of the all
+the simualtions. The output will be in the `out` directory. 
+
 ```
 cat out/out.2-*
 ```
@@ -181,15 +286,46 @@ Counter({3: 466, 0: 442, 2: 51, 1: 41})
 ```
 Note that because this is a noise driven circuit, the results of each simulation are different.
 
-To run your own simulations, simply create a noisy circuit in your _qsim_ python file.
+## Next steps
+
+To run your own simulations, simply create a noisy circuit in your  _qsim_ python file.
+The file being run in this was `noise3.py`. You can take this example and expand
+to your own circuit. 
+
+```python
+import cirq, qsimcirq
+
+# Create a Bell state, |00) + |11)
+q0, q1 = cirq.LineQubit.range(2)
+circuit = cirq.Circuit(
+    cirq.H(q0),
+    cirq.CNOT(q0, q1),
+    cirq.measure(q0, q1, key='m')
+)
+
+# Constructs a noise model that adds depolarizing noise after each gate.
+noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
+
+# Use the noise model to create a noisy circuit.
+noisy_circuit = cirq.Circuit(noise.noisy_moments(circuit, system_qubits=[q0, q1]))
+
+sim = qsimcirq.QSimSimulator()
+result = sim.run(noisy_circuit, repetitions=1000)
+# Outputs a histogram dict of result:count pairs.
+# Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
+# (For comparison, the noiseless circuit will only have 0s and 3s)
+print(result.histogram(key='m'))
+```
 
 There are many more examples of circuits to be run [here](https://quantumai.google/cirq/noise)
 
-## Shutting down
-When you are done with this tutorial, it is important to remove the resources. You can do this with _terraform_
+## FINAL STEP: Shutting down 
+
+> **IMPORTANT**:  To avoid excess billing for this project, it is important to shut down the cluster. This is easily done using the make command built for this purpose.
 ```
 make destroy
 ```
+
 > The most effective way to ensure you are not charged is to delete the project. [The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
 
 

From 0b058c13a98daeb46c7961b824e344a6c8b0b2ac Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Mon, 30 Aug 2021 22:26:20 +0000
Subject: [PATCH 083/246] Typo

---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 3d8a34ef..53072b94 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -38,7 +38,7 @@ the Cloud Console with Cloud Shell activeated can be reached through this link:
 
 ### Clone this repo
 
-In your Clous Shell window, clone this Github repo.
+In your Cloud Shell window, clone this Github repo.
 ``` bash
 git clone https://github.com/jrossthomson/qsim.git
 ```

From 0066b3fa60cf74b3798a3640cc0901d86aa4ec05 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Tue, 31 Aug 2021 14:39:20 +0000
Subject: [PATCH 084/246] Moved readme to upper directory.

---
 docs/tutorials/multinode/terraform/README.md | 331 +------------------
 1 file changed, 1 insertion(+), 330 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/README.md b/docs/tutorials/multinode/terraform/README.md
index 3d8a34ef..094f1ee8 100644
--- a/docs/tutorials/multinode/terraform/README.md
+++ b/docs/tutorials/multinode/terraform/README.md
@@ -1,332 +1,3 @@
 # Multinode quantum simulation using HTCondor on GCP
-This tutorial will take you through the process of running multiple simultaneous
-`qsim` simulations on Google Cloud. In some situations, it is required to run
-many instances of the same simulation. This could be used to provide a parameter
-sweep or to evaluation noise characteristics.
-
-One of the key competencies of a quantum computing effort is the ability to run
-simulations. While quantum computing hardware is still years from general
-availability, quantum computing simulation with `qsim` and `Cirq` is available for
-researchers exploring a quantum program. It is expected that simulation will be
-a gating requirement to make use of physical hardware, to prove out algorithms
-both for computability and stability under noisy conditions. Many thousands of
-simulation runs will typically be required to prove out the gating requirements
-for each circuit, sometimes requiring years of simulation in advance of any
-practical use of the quantum hardware.
-
-## Objectives
-
-* Use `terraform` to deploy a HTCondor cluster
-* Run a multinode simulation using HTCondor
-* Query cluster information and monitor running jobs in HTCondor
-* Use `terraform` to destroy the cluster
-
-
-## Step 1: Create a project
-In a seperate tutorial the method to create Google Cloud project is explained in detail. 
-[Please refer to this tutorial for guidance](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup).
-
-When you have a project created, move on to the next step.
-
-## Step 2: Configure your enviroment
-
-Although this tutorial can be run from your local computer, we recommend the use
-of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
-
-Once you have created  a project in the previous step, 
-the Cloud Console with Cloud Shell activeated can be reached through this link: (https://console.google.com/home/dashboard?cloudshell=true)
-
-### Clone this repo
-
-In your Clous Shell window, clone this Github repo.
-``` bash
-git clone https://github.com/jrossthomson/qsim.git
-```
-
-### Change directory
-Change directory to the tutorial:
-``` bash
-cd qsim/docs/tutorials/multinode/terraform
-```
-This is where you will use `terraform` to create the HTCondor cluster required to run your jobs.
-
-### Edit `init.sh` file to customize your environment
-
-You can now edit `init.sh` to change the name of the project you are using. You
-can also change the zone and region as you see fit. More information is
-available [here](https://cloud.google.com/compute/docs/regions-zones).
-
-Use your favorite text file editor, either the integrated [Cloud Shell
-Editor](https://cloud.google.com/shell/docs/editor-overview), `vim`, `emacs` or `nano`.
-For example:
-``` bash
-vim init.sh
-```
-The file has many lines, but only edit the first 4.
-``` bash
-export TF_VAR_project=quantum-htcondor-15
-export TF_VAR_project_id=us-east4-c
-export TF_VAR_zone=us-east4-c
-export TF_VAR_region=us-east4
-```
-
-The most important is the first line, indicating the name of the project you created above.
-``` bash
-export TF_VAR_project=my-quantum-htcondor-project
-```
-The project id needs to be globally unique and to be the same as the project you just created.
-
-### Source the `init.sh` file
-The edited `init.sh` file should be "sourced" in the cloud shell:
-
-``` bash
-source init.sh
-```
-Respond `Agree` to any pop-ups that request permissions on the Google Cloud platform.
-
-The final outcome of this script will include:
-
-* A gcloud config setup correctly
-* A service account created
-* The appropriate permissions assigned to the service account
-* A key file created to enable the use of Google Cloud automation.
-
-This will take up to 60 seconds. At the end you will see output about
-permissions and the configuration of the account.
-
-##  Step 3: Run terraform
-
-After the previous steps are completed, you can initialize `terraform` to begin your cluster creation.
-The first step is to initialize the `terraform` state.
-``` bash
-terraform init
-```
-A successful result will contain the text:
-```
-Terraform has been successfully initialized!
-```
-### Run the `make` command
-For convenience, some terraform commands are prepared in a `Makefile`. This means
-you can now create your cluster, with a simple `make` command.
-```bash
-make apply
-```
-A successful run will show:
-```
-Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
-```
-## Step4: Connect to the _submit_ node for HTCondor
-Although there are ways to run `HTCondor` commands from your local machine, 
-the normal path  is to login to the _submit_ node. From there you can run 
-commands to submit and monitor jobs on HTCondor.
-
-### List VMs that were created by
-
-You can list the VMs created. One of them will be the submit node. It will be the VM with
-"submit" in the name.
-
-```
-gcloud compute instances list
-```
-You will see two instances listed:
-* c-manager: the core controller node
-* c-submit: the submit node where you will run interactive work.
-
-Identify then log in to the `submit` node. If you used the standard install, the
-cluster name is "c". In that case you would connect using the `gcloud ssh`
-command.
-```bash
-gcloud compute ssh c-submit
-```
-Now you are logged in to your HTCondor cluster. You will see a command prompt
-something like:
-```bash
-[mylogin@c-submit ~]$
-```
-
-### Checking the status 
-You can verify if the HTCondor install is completed:
-```
-condor_q
-```
-You will see output:
-```
--- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
-OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
-
-Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
-Total for drj: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
-Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
-```
-If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
-
-## Step 5: Get the sample code and run it
-The HTCondor cluster is now ready for your jobs to be run. If you are familiar with HTCondor and you want to run your own jobs, you may do so. 
-
-If you don't have jobs to run, you can get sample jobs from this Github repo. You will clone the repo to 
-the submit node and run a job.
-
-##  Clone the repo on your cluster
-
-on the `submit` node you you can install the repo to get access to previously created submission files:
-```
-git clone https://github.com/jrossthomson/qsim.git
-```
-Then cd to the tutorial directory.
-```
-cd qsim/docs/tutorials/multinode
-```
-### Submit a job
-Now it is possible to submit a job:
-```
-condor_submit circuit_q24.sub
-```
-If successful, the output will be:
-```
-Submitting job(s).
-1 job(s) submitted to cluster 1.
-```
-You can see the job in queue by with the `condor_q` command.
-```
-condor_q
-```
-The job will take several minutes to finish. The time includes creating a VM
-compute node, installing the HTCondor system and running the job. When completed
-the files will be in the `out` directory.
-```
-ls out
-```
-will list the files:
-```
-err.1-0  log.1-0  out.1-0  placeholder
-```
-You can also see the progress of the job throught the log file:
-```
-tail -f out/log.1-0
-```
-After the job s completed, the ouput of the job can be seen:
-```
-cat out/out.1-0
-```
-## Step5: Run multi-node noise simulations
-Noise simulations make use of a [Monte Carlo
-method](https://en.wikipedia.org/wiki/Monte_Carlo_method) for [quantum
-trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory). 
-
-The primary goal of these simulations is to understand the behavior of the
-quantum circuit taking into account the effects of noise. There are many
-potential sources of noise in a quantum circuit, including thermal noise, 1/f
-noise or shot noise, as well as perturbations from cosmic rays. Understanding
-and calibrating noise in quantum computing is an active field of investigation,
-and it will require well characterized simulations.
-
-To run multiple simulations, you can run the submit file `noise.sub`.  The
-submit file is shown below. It is key to note that this is running  a `docker`
-container. Also, the `queue 50` command at the end of the file submits 50
-separate instances of the container. Since this job is noise driven, the output
-of each simulation with be different. A typical analysis of the output would be 
-a statistical study of the means and variations, perhaps looking for parameter 
-ranges where circuits are particularly susceptible to noise.
-
-
-### The noise.sub file
-```
-universe                = docker
-docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
-arguments               = python3 noise3.py
-should_transfer_files   = YES
-transfer_input_files    = noise3.py
-when_to_transfer_output = ON_EXIT
-output                  = out/out.$(Cluster)-$(Process)
-error                   = out/err.$(Cluster)-$(Process)
-log                     = out/log.$(Cluster)-$(Process)
-request_memory          = 10GB
-queue 50
-```
-The job can be submitted with the `condor_submit` command.
-```
-condor_submit noise.sub
-```
-The output will look as follows:
-```
-Submitting job(s)..................................................
-50 job(s) submitted to cluster 2.
-```
-To monitor the ongoing process of jobs running, you can take advantage of the
-Linux `watch` command and run `condor_q` repeatedly. When complete you watch can
-be exited with cntrl-c.
-```
-watch "condor_q; condor_status"
-```
-The output of this command will show you the jobs in the queue as well as the
-VMs being created to run the jobs. There is a limit of 20 VMs for this
-configuration of the cluster. This can be modified for future runs.
-
-When the command shows the queue is empty, the command can be stopped with cntl-c.
-
-If this is the second _submit_ you have run, you can see the output of the all
-the simualtions. The output will be in the `out` directory. 
-
-```
-cat out/out.2-*
-```
-You can see the results of the simulations.
-```
-Counter({3: 462, 0: 452, 2: 50, 1: 36})
-Counter({0: 475, 3: 435, 1: 49, 2: 41})
-Counter({0: 450, 3: 440, 1: 59, 2: 51})
-Counter({0: 459, 3: 453, 2: 51, 1: 37})
-Counter({3: 471, 0: 450, 2: 46, 1: 33})
-Counter({3: 467, 0: 441, 1: 54, 2: 38})
-Counter({3: 455, 0: 455, 1: 50, 2: 40})
-Counter({3: 466, 0: 442, 2: 51, 1: 41})
-.
-.
-.
-```
-Note that because this is a noise driven circuit, the results of each simulation are different.
-
-## Next steps
-
-To run your own simulations, simply create a noisy circuit in your  _qsim_ python file.
-The file being run in this was `noise3.py`. You can take this example and expand
-to your own circuit. 
-
-```python
-import cirq, qsimcirq
-
-# Create a Bell state, |00) + |11)
-q0, q1 = cirq.LineQubit.range(2)
-circuit = cirq.Circuit(
-    cirq.H(q0),
-    cirq.CNOT(q0, q1),
-    cirq.measure(q0, q1, key='m')
-)
-
-# Constructs a noise model that adds depolarizing noise after each gate.
-noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
-
-# Use the noise model to create a noisy circuit.
-noisy_circuit = cirq.Circuit(noise.noisy_moments(circuit, system_qubits=[q0, q1]))
-
-sim = qsimcirq.QSimSimulator()
-result = sim.run(noisy_circuit, repetitions=1000)
-# Outputs a histogram dict of result:count pairs.
-# Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
-# (For comparison, the noiseless circuit will only have 0s and 3s)
-print(result.histogram(key='m'))
-```
-
-There are many more examples of circuits to be run [here](https://quantumai.google/cirq/noise)
-
-## FINAL STEP: Shutting down 
-
-> **IMPORTANT**:  To avoid excess billing for this project, it is important to shut down the cluster. This is easily done using the make command built for this purpose.
-```
-make destroy
-```
-
-> The most effective way to ensure you are not charged is to delete the project. [The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
-
-
 
+Please refer to the [README in the parent directory](../README.md).
\ No newline at end of file

From ab099c46e54fdb2bbf0e1579b68be308dfe1eec8 Mon Sep 17 00:00:00 2001
From: J Ross Thomson <39315853+jrossthomson@users.noreply.github.com>
Date: Tue, 31 Aug 2021 10:41:32 -0400
Subject: [PATCH 085/246] Update README.md

Small indent change.
---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 53072b94..341d4e39 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -166,7 +166,7 @@ The HTCondor cluster is now ready for your jobs to be run. If you are familiar w
 If you don't have jobs to run, you can get sample jobs from this Github repo. You will clone the repo to 
 the submit node and run a job.
 
-##  Clone the repo on your cluster
+###  Clone the repo on your cluster
 
 on the `submit` node you you can install the repo to get access to previously created submission files:
 ```

From 31106cecae583aff79003933a3ee77a442f80308 Mon Sep 17 00:00:00 2001
From: Burt Holzman <burt@fnal.gov>
Date: Tue, 7 Sep 2021 15:49:01 -0500
Subject: [PATCH 086/246] Fix typo in multinode README for cloudshell URL

---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 341d4e39..a9c49cec 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -34,7 +34,7 @@ Although this tutorial can be run from your local computer, we recommend the use
 of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
 
 Once you have created  a project in the previous step, 
-the Cloud Console with Cloud Shell activeated can be reached through this link: (https://console.google.com/home/dashboard?cloudshell=true)
+the Cloud Console with Cloud Shell activeated can be reached through this link: (https://console.cloud.google.com/home/dashboard?cloudshell=true)
 
 ### Clone this repo
 

From f0ed97c20410adb487342c3a79e94d3341f585f9 Mon Sep 17 00:00:00 2001
From: Burt Holzman <burt@fnal.gov>
Date: Fri, 10 Sep 2021 11:02:50 -0500
Subject: [PATCH 087/246] Add support for regional instance groups

To enable regional (rather than zonal) instance groups, set
TF_VAR_multizone to True and TF_VAR_numzones to the number
of zones in the region.
---
 .../terraform/htcondor/autoscaler.py          | 46 +++++++++---
 .../multinode/terraform/htcondor/resources.tf | 75 +++++++++++++++----
 .../terraform/htcondor/startup-centos.sh      |  3 +-
 docs/tutorials/multinode/terraform/init.sh    |  3 +-
 docs/tutorials/multinode/terraform/main.tf    | 13 ++++
 5 files changed, 110 insertions(+), 30 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/htcondor/autoscaler.py b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
index 12036066..151d8d5e 100644
--- a/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
+++ b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
@@ -31,6 +31,8 @@
 parser = argparse.ArgumentParser()
 parser.add_argument("--p", required=True, help="Project id", type=str)
 parser.add_argument("--z", required=True, help="Name of GCP zone where the managed instance group is located", type=str)
+parser.add_argument("--r", required=True, help="Name of GCP region where the managed instance group is located", type=str)
+parser.add_argument("--mz", required=False, help="Enabled multizone (regional) managed instance group", action="store_true")
 parser.add_argument("--g", required=True, help="Name of the managed instance group", type=str)
 parser.add_argument("--c", required=True, help="Maximum number of compute instances", type=int)
 parser.add_argument("--v", default=0, help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
@@ -41,23 +43,33 @@
         
 class AutoScaler():
 
-    def __init__(self):
+    def __init__(self, multizone=False):
 
+        self.multizone = multizone
         # Obtain credentials
         self.credentials = GoogleCredentials.get_application_default()
         self.service = discovery.build('compute', 'v1', credentials=self.credentials)
     
+        if self.multizone:
+            self.instanceGroupManagers = self.service.regionInstanceGroupManagers()
+        else:
+            self.instanceGroupManagers = self.service.instanceGroupManagers()
     
     # Remove specified instance from MIG and decrease MIG size
     def deleteFromMig(self, instance):
-        instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' \
-            + self.project + '/zones/' + self.zone + '/instances/' + instance
+        instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' + self.project
+        if (self.multizone):
+            instanceUrl += '/regions/' + self.region
+        else:
+            instanceUrl += '/zones/' + self.zone
+        instanceUrl += '/instances/' + instance
+
         instances_to_delete = {'instances': [instanceUrl]}
     
         requestDelInstance = \
-            self.service.instanceGroupManagers().deleteInstances(project=self.project,
-                zone=self.zone, instanceGroupManager=self.instance_group_manager,
-                body=instances_to_delete)
+            self.instanceGroupManagers.deleteInstances(project=self.project,
+            **self.zoneargs, instanceGroupManager=self.instance_group_manager,
+            body=instances_to_delete)
 
         # execute if not a dry-run
         if not self.dryrun:
@@ -70,7 +82,7 @@ def deleteFromMig(self, instance):
     
     def getInstanceTemplateInfo(self):
         requestTemplateName = \
-            self.service.instanceGroupManagers().get(project=self.project, zone=self.zone,
+                self.instanceGroupManagers.get(project=self.project, **self.zoneargs,
                 instanceGroupManager=self.instance_group_manager,
                 fields='instanceTemplate')
         responseTemplateName = requestTemplateName.execute()
@@ -123,10 +135,17 @@ def scale(self):
             print('Launching autoscaler.py with the following arguments:')
             print('project_id: ' + self.project)
             print('zone: ' + self.zone)
+            print('region: ' + self.region)
+            print(f'multizone: {self.multizone}')
             print('group_manager: ' + self.instance_group_manager)
             print('computeinstancelimit: ' + str(self.compute_instance_limit))
             print('debuglevel: ' + str(self.debug))
 
+        if self.multizone:
+            self.zoneargs = {'region': self.region}
+        else:
+            self.zoneargs = {'zone': self.zone}
+
         # Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
         queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
         queue_length_resp = os.popen(queue_length_req).read().split()
@@ -180,8 +199,8 @@ def scale(self):
         print('New MIG target size: ' + str(self.size))
         
         # Get current number of instances in the MIG
-        requestGroupInfo = self.service.instanceGroupManagers().get(project=self.project,
-                zone=self.zone, instanceGroupManager=self.instance_group_manager)
+        requestGroupInfo = self.instanceGroupManagers.get(project=self.project,
+                **self.zoneargs, instanceGroupManager=self.instance_group_manager)
         responseGroupInfo = requestGroupInfo.execute()
         currentTarget = int(responseGroupInfo['targetSize'])
         print('Current MIG target size: ' + str(currentTarget))
@@ -248,8 +267,8 @@ def scale(self):
         if self.size > currentTarget:
             print("Scaling up. Need to increase number of instances to " + str(self.size))
             #Request to resize
-            request = self.service.instanceGroupManagers().resize(project=self.project,
-                    zone=self.zone, 
+            request = self.instanceGroupManagers.resize(project=self.project,
+                    **self.zoneargs,
                     instanceGroupManager=self.instance_group_manager,
                     size=self.size)
             response = request.execute()
@@ -259,7 +278,7 @@ def scale(self):
                 print("Scaling up complete")
 def main():
 
-    scaler = AutoScaler()
+    scaler = AutoScaler(args.mz)
 
     # Project ID
     scaler.project = args.p  # Ex:'slurm-var-demo'
@@ -267,6 +286,9 @@ def main():
     # Name of the zone where the managed instance group is located
     scaler.zone = args.z # Ex: 'us-central1-f'
     
+    # Name of the region where the managed instance group is located
+    scaler.region = args.r # Ex: 'us-central1'
+
     # The name of the managed instance group.
     scaler.instance_group_manager = args.g  # Ex: 'condor-compute-igm'
     
diff --git a/docs/tutorials/multinode/terraform/htcondor/resources.tf b/docs/tutorials/multinode/terraform/htcondor/resources.tf
index 42cff48e..0b4212d9 100644
--- a/docs/tutorials/multinode/terraform/htcondor/resources.tf
+++ b/docs/tutorials/multinode/terraform/htcondor/resources.tf
@@ -28,6 +28,15 @@ variable "project" {
 variable "zone" {
     type = string
 }
+variable "region" {
+    type = string
+}
+variable "numzones" {
+    type = string
+}
+variable "multizone" {
+    type = bool
+}
 variable "min_replicas" {
     type = number
     default = 0
@@ -67,11 +76,13 @@ locals{
     {
       "project" = var.project,
       "cluster_name" = var.cluster_name,
-      "htserver_type" = "compute", 
-      "osversion" = var.osversion, 
-      "zone" = var.zone, 
-      "condorversion" = var.condorversion, 
-      "max_replicas" = var.max_replicas, 
+      "htserver_type" = "compute",
+      "osversion" = var.osversion,
+      "zone" = var.zone,
+      "region" = var.region,
+      "multizone" = var.multizone,
+      "condorversion" = var.condorversion,
+      "max_replicas" = var.max_replicas,
       "autoscaler" = "",
       "admin_email" = var.admin_email
     })
@@ -80,11 +91,13 @@ locals{
     {
       "project" = var.project,
       "cluster_name" = var.cluster_name,
-      "htserver_type" = "submit", 
-      "osversion" = var.osversion, 
-      "condorversion" = var.condorversion, 
-      "zone" = var.zone, 
-      "max_replicas" = var.max_replicas, 
+      "htserver_type" = "submit",
+      "osversion" = var.osversion,
+      "condorversion" = var.condorversion,
+      "zone" = var.zone,
+      "region" = var.region,
+      "multizone" = var.multizone,
+      "max_replicas" = var.max_replicas,
       "autoscaler" = local.autoscaler,
       "admin_email" = var.admin_email
     })
@@ -93,11 +106,13 @@ locals{
     {
       "project" = var.project,
       "cluster_name" = var.cluster_name,
-      "htserver_type" = "manager", 
-      "osversion" = var.osversion, 
-      "zone" = var.zone, 
-      "max_replicas" = var.max_replicas, 
-      "condorversion" = var.condorversion, 
+      "htserver_type" = "manager",
+      "osversion" = var.osversion,
+      "zone" = var.zone,
+      "region" = var.region,
+      "multizone" = var.multizone,
+      "max_replicas" = var.max_replicas,
+      "condorversion" = var.condorversion,
       "autoscaler" = "",
       "admin_email" = var.admin_email
     })
@@ -268,6 +283,7 @@ resource "google_compute_instance_template" "condor-compute" {
   tags = ["${var.cluster_name}-compute"]
 }
 resource "google_compute_instance_group_manager" "condor-compute-igm" {
+  count = var.multizone ? 0 : 1
   base_instance_name = var.cluster_name
   name               = var.cluster_name
 
@@ -294,6 +310,35 @@ resource "google_compute_instance_group_manager" "condor-compute-igm" {
   ]
   zone = var.zone
 }
+
+resource "google_compute_region_instance_group_manager" "condor-compute-igm" {
+  count = var.multizone ? 1 : 0
+  base_instance_name = var.cluster_name
+  name               = var.cluster_name
+
+  project            = var.project
+  target_size        = "0"
+
+  update_policy {
+    max_surge_fixed         = var.numzones
+    minimal_action          = "REPLACE"
+    type                    = "OPPORTUNISTIC"
+  }
+
+  version {
+    instance_template = google_compute_instance_template.condor-compute.self_link
+    name              = ""
+  }
+  timeouts {
+    create = "60m"
+    delete = "2h"
+  }
+  # Yup, didn't want to use this, but I was getting create and destroy errors.
+  depends_on = [
+   google_compute_instance_template.condor-compute
+  ]
+  region = var.region
+}
 /*
 resource "google_compute_autoscaler" "condor-compute-as" {
   name    = "${var.cluster_name}-compute-as"
diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
index 71f5d423..bec6eb6c 100644
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -169,7 +169,6 @@ fi
 service google-fluentd restart
 
 # Add Python Libraries and Autoscaler
-
 if [ "$SERVER_TYPE" == "submit" ]; then
   python3 -m pip install --upgrade oauth2client
   python3 -m pip install --upgrade google-api-python-client
@@ -181,7 +180,7 @@ EOFZ
 
 # Create cron entry for autoscaler. Log to /var/log/messages
 
-echo "* * * * * python3 /opt/autoscaler.py --p ${project} --z ${zone} --g ${cluster_name} --c ${max_replicas} | logger " |crontab -
+echo "* * * * * python3 /opt/autoscaler.py --p ${project} --z ${zone} --r ${region} %{ if multizone }--mz %{ endif }--g ${cluster_name} --c ${max_replicas} | logger " |crontab -
 
 fi
 
diff --git a/docs/tutorials/multinode/terraform/init.sh b/docs/tutorials/multinode/terraform/init.sh
index 43a6471b..c9d5d4bd 100644
--- a/docs/tutorials/multinode/terraform/init.sh
+++ b/docs/tutorials/multinode/terraform/init.sh
@@ -4,7 +4,8 @@ export TF_VAR_project=quantum-htcondor-15
 export TF_VAR_project_id=us-east4-c
 export TF_VAR_zone=us-east4-c
 export TF_VAR_region=us-east4
-
+export TF_VAR_multizone=true
+export TF_VAR_numzones=4  # for regional/multizone, set to the number of regions in the zone
 # ---- Do not edit below -----#
 
 export TF_VAR_project_id=${TF_VAR_project}
diff --git a/docs/tutorials/multinode/terraform/main.tf b/docs/tutorials/multinode/terraform/main.tf
index 0c0a8f87..9e92cc74 100644
--- a/docs/tutorials/multinode/terraform/main.tf
+++ b/docs/tutorials/multinode/terraform/main.tf
@@ -4,6 +4,16 @@ variable "project" {
 variable "zone" {
   type=string
 }
+variable "region" {
+  type=string
+}
+variable "multizone" {
+  type=bool
+}
+variable "numzones" {
+  type=string
+}
+
 variable "cluster_name" {
   type = string
   default = "c"
@@ -16,6 +26,9 @@ module "htcondor" {
   cluster_name = var.cluster_name
   project = var.project
   zone = var.zone
+  region = var.region
+  multizone = var.multizone
+  numzones = var.numzones
   osversion = "7"
   max_replicas=20
   min_replicas=0

From 1ddd29ca41f7dec0636ddaf1ab321933e49dbaea Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Wed, 15 Sep 2021 17:40:45 +0200
Subject: [PATCH 088/246] Add host specifier.

---
 lib/util_cuda.h | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/lib/util_cuda.h b/lib/util_cuda.h
index 43da065c..591d852d 100644
--- a/lib/util_cuda.h
+++ b/lib/util_cuda.h
@@ -34,15 +34,16 @@ inline void ErrorAssert(cudaError_t code, const char* file, unsigned line) {
 
 template <typename T>
 struct Complex {
-  __device__ __forceinline__ Complex() {}
+  __host__ __device__ __forceinline__ Complex() {}
 
-  __device__ __forceinline__ Complex(const T& re) : re(re), im(0) {}
+  __host__ __device__ __forceinline__ Complex(const T& re) : re(re), im(0) {}
 
-  __device__ __forceinline__ Complex(const T& re, const T& im)
+  __host__ __device__ __forceinline__ Complex(const T& re, const T& im)
       : re(re), im(im) {}
 
   template <typename U>
-  __device__ __forceinline__ Complex<T>& operator=(const Complex<U>& r) {
+  __host__ __device__ __forceinline__ Complex<T>& operator=(
+      const Complex<U>& r) {
     re = r.re;
     im = r.im;
 
@@ -54,13 +55,13 @@ struct Complex {
 };
 
 template <typename T>
-__device__ __forceinline__ Complex<T> operator+(
+__host__ __device__ __forceinline__ Complex<T> operator+(
     const Complex<T>& l, const Complex<T>& r) {
   return Complex<T>(l.re + r.re, l.im + r.im);
 }
 
 template <typename T, typename U>
-__device__ __forceinline__ Complex<T> operator+(
+__host__ __device__ __forceinline__ Complex<T> operator+(
     const Complex<T>& l, const Complex<U>& r) {
   return Complex<T>(l.re + r.re, l.im + r.im);
 }

From 95da6823ef6e35d651c1ae62123464c53020aa21 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Wed, 15 Sep 2021 16:16:34 +0000
Subject: [PATCH 089/246] Split 'Guide and Tutorials' book into 'Tutorials'
 book and 'Guide' book. #424

---
 docs/_book.yaml | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/docs/_book.yaml b/docs/_book.yaml
index 3f344eb1..ba841ebe 100644
--- a/docs/_book.yaml
+++ b/docs/_book.yaml
@@ -8,7 +8,14 @@ upper_tabs:
   lower_tabs:
     # Subsite tabs
     other:
-    - name: "Guide & Tutorials"
+    - name: "Tutorials"
+      - title: "Get started with qsimcirq"
+        path: /qsim/tutorials/qsimcirq
+      - title: "Quantum simulation on GCP with Cirq and qsim"
+        path: /qsim/tutorials/qsimcirq_gcp
+      - title: "Simulate a large quantum circuit"
+        path: /qsim/tutorials/q32d14
+    - name: "Guide"
       contents:
       - title: "qsim and qsimh"
         path: /qsim/overview
@@ -30,15 +37,6 @@ upper_tabs:
         path: /qsim/docker
       - title: "Release process"
         path: /qsim/release
-
-      - heading: "Tutorials"
-      - title: "Get started with qsimcirq"
-        path: /qsim/tutorials/qsimcirq
-      - title: "Quantum simulation on GCP with Cirq and qsim"
-        path: /qsim/tutorials/qsimcirq_gcp
-      - title: "Simulate a large quantum circuit"
-        path: /qsim/tutorials/q32d14
-
     - name: "Python Reference"
       skip_translation: true
       contents:

From 9109c87ce3c7a82129c3038db9c9a4df296b3f89 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 15 Sep 2021 13:19:22 -0700
Subject: [PATCH 090/246] Update version to 0.10.3

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index d9e1c77d..0d4f6478 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.10.2"
+__version__ = "0.10.3"

From 60235289ff27b5ac0264d42b90b72f5c07972deb Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Thu, 16 Sep 2021 13:56:07 +0000
Subject: [PATCH 091/246] Fix typos

---
 docs/tutorials/multinode/README.md | 37 +++++++++++++++++++-----------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index a9c49cec..17675b37 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -2,7 +2,7 @@
 This tutorial will take you through the process of running multiple simultaneous
 `qsim` simulations on Google Cloud. In some situations, it is required to run
 many instances of the same simulation. This could be used to provide a parameter
-sweep or to evaluation noise characteristics.
+sweep or to evaluate noise characteristics.
 
 One of the key competencies of a quantum computing effort is the ability to run
 simulations. While quantum computing hardware is still years from general
@@ -17,18 +17,29 @@ practical use of the quantum hardware.
 ## Objectives
 
 * Use `terraform` to deploy a HTCondor cluster
-* Run a multinode simulation using HTCondor
+* Run a multi-node simulation using HTCondor
 * Query cluster information and monitor running jobs in HTCondor
 * Use `terraform` to destroy the cluster
 
 
 ## Step 1: Create a project
-In a seperate tutorial the method to create Google Cloud project is explained in detail. 
-[Please refer to this tutorial for guidance](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup).
+If necessary, you can run this tutorial in an existing project, but to avoid collisions or damage to existing work, it is often better to create a new project.
+
+In this [GCP setup tutorial](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup), the method to create Google Cloud project is explained in detail.
 
 When you have a project created, move on to the next step.
 
-## Step 2: Configure your enviroment
+> IMPORTANT: For this tutorial, it is best if you have `Owner` privilege on the project. If you do not have owner rights, the following roles will be required:
+```bash
+roles/compute.admin
+roles/iam.serviceAccountUser
+roles/monitoring.admin
+roles/logging.admin
+roles/autoscaling.metricsWrite
+```
+Your Cloud admin will be able to provide these roles.
+
+## Step 2: Configure your environment
 
 Although this tutorial can be run from your local computer, we recommend the use
 of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
@@ -186,7 +197,7 @@ If successful, the output will be:
 Submitting job(s).
 1 job(s) submitted to cluster 1.
 ```
-You can see the job in queue by with the `condor_q` command.
+You can see the job in queue with the `condor_q` command.
 ```
 condor_q
 ```
@@ -200,11 +211,11 @@ will list the files:
 ```
 err.1-0  log.1-0  out.1-0  placeholder
 ```
-You can also see the progress of the job throught the log file:
+You can also see the progress of the job through the log file:
 ```
 tail -f out/log.1-0
 ```
-After the job s completed, the ouput of the job can be seen:
+After the job is completed, the output of the job can be seen:
 ```
 cat out/out.1-0
 ```
@@ -224,7 +235,7 @@ To run multiple simulations, you can run the submit file `noise.sub`.  The
 submit file is shown below. It is key to note that this is running  a `docker`
 container. Also, the `queue 50` command at the end of the file submits 50
 separate instances of the container. Since this job is noise driven, the output
-of each simulation with be different. A typical analysis of the output would be 
+of each simulation will be different. A typical analysis of the output would be 
 a statistical study of the means and variations, perhaps looking for parameter 
 ranges where circuits are particularly susceptible to noise.
 
@@ -253,7 +264,7 @@ Submitting job(s)..................................................
 50 job(s) submitted to cluster 2.
 ```
 To monitor the ongoing process of jobs running, you can take advantage of the
-Linux `watch` command and run `condor_q` repeatedly. When complete you watch can
+Linux `watch` command and run `condor_q` repeatedly. When complete watch can
 be exited with cntrl-c.
 ```
 watch "condor_q; condor_status"
@@ -262,10 +273,10 @@ The output of this command will show you the jobs in the queue as well as the
 VMs being created to run the jobs. There is a limit of 20 VMs for this
 configuration of the cluster. This can be modified for future runs.
 
-When the command shows the queue is empty, the command can be stopped with cntl-c.
+When the command shows the queue is empty, the command can be stopped with cntrl-c.
 
-If this is the second _submit_ you have run, you can see the output of the all
-the simualtions. The output will be in the `out` directory. 
+If this is the second _submit_ you have run, you can see the output of all
+the simulations. The output will be in the `out` directory. 
 
 ```
 cat out/out.2-*

From 1957a4f779e5a5b9625cc2f951496393f672c353 Mon Sep 17 00:00:00 2001
From: Ross Thomson <jrossthomson@google.com>
Date: Thu, 16 Sep 2021 14:16:13 +0000
Subject: [PATCH 092/246] Removed un-needed files.

---
 docs/_book.yaml                    |  2 ++
 docs/tutorials/multinode/noise.py  | 51 ------------------------------
 docs/tutorials/multinode/noise2.py | 18 -----------
 3 files changed, 2 insertions(+), 69 deletions(-)
 delete mode 100644 docs/tutorials/multinode/noise.py
 delete mode 100644 docs/tutorials/multinode/noise2.py

diff --git a/docs/_book.yaml b/docs/_book.yaml
index 3f344eb1..dd0838e1 100644
--- a/docs/_book.yaml
+++ b/docs/_book.yaml
@@ -38,6 +38,8 @@ upper_tabs:
         path: /qsim/tutorials/qsimcirq_gcp
       - title: "Simulate a large quantum circuit"
         path: /qsim/tutorials/q32d14
+      - title: "Multinode quantum simulation using HTCondor on GCP"
+        path: /qsim/tutorials/multinode
 
     - name: "Python Reference"
       skip_translation: true
diff --git a/docs/tutorials/multinode/noise.py b/docs/tutorials/multinode/noise.py
deleted file mode 100644
index ecbd751d..00000000
--- a/docs/tutorials/multinode/noise.py
+++ /dev/null
@@ -1,51 +0,0 @@
-import cirq
-import qsimcirq
-import time
-
-q0, q1 = cirq.LineQubit.range(2)
-
-circuit = cirq.Circuit(
-    # Perform a Hadamard on both qubits
-    cirq.H(q0), cirq.H(q1),
-    # Apply amplitude damping to q0 with probability 0.1
-    cirq.amplitude_damp(gamma=0.1).on(q0),
-    # Apply phase damping to q1 with probability 0.1
-    cirq.phase_damp(gamma=0.1).on(q1),
-)
-qsim_simulator = qsimcirq.QSimSimulator()
-results = qsim_simulator.simulate(circuit)
-print(results.final_state_vector)
-
-
-# Simulate measuring at the end of the circuit.
-measured_circuit = circuit + cirq.measure(q0, q1, key='m')
-measure_results = qsim_simulator.run(measured_circuit, repetitions=5)
-print(measure_results)
-
-# Calculate only the amplitudes of the |00) and |01) states.
-amp_results = qsim_simulator.compute_amplitudes(
-    circuit, bitstrings=[0b00, 0b01])
-print(amp_results)
-
-# Calculate only the amplitudes of the |00) and |01) states.
-amp_results = qsim_simulator.compute_amplitudes(
-    circuit, bitstrings=[0b00, 0b01])
-print(amp_results)
-
-
-# Set the "noisy repetitions" to 100.
-# This parameter only affects expectation value calculations.
-options = {'r': 100}
-# Also set the random seed to get reproducible results.
-seed = int(time.time())
-print(seed)
-ev_simulator = qsimcirq.QSimSimulator(qsim_options=options, seed=seed)
-# Define observables to measure: <Z> for q0 and <X> for q1.
-pauli_sum1 = cirq.Z(q0)
-pauli_sum2 = cirq.X(q1)
-# Calculate expectation values for the given observables.
-ev_results = ev_simulator.simulate_expectation_values(
-    circuit,
-    observables=[pauli_sum1, pauli_sum2],
-)
-print(ev_results)
\ No newline at end of file
diff --git a/docs/tutorials/multinode/noise2.py b/docs/tutorials/multinode/noise2.py
deleted file mode 100644
index db593b7a..00000000
--- a/docs/tutorials/multinode/noise2.py
+++ /dev/null
@@ -1,18 +0,0 @@
-import cirq
-import qsimcirq
-import time
-
-circuit = cirq.testing.random_circuit(
-    qubits=3, n_moments=3, op_density=1, random_state=11
-)
-
-# Display the noiseless circuit.
-print("Circuit without noise:")
-print(circuit)
-
-# Add noise to the circuit.
-noisy = circuit.with_noise(cirq.depolarize(p=0.01))
-
-# Display it.
-print("\nCircuit with noise:")
-print(noisy)
\ No newline at end of file

From e7e67a0cebf39dcb25501b85310f887f67fb6097 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 16 Sep 2021 12:36:58 -0700
Subject: [PATCH 093/246] Prevent ODR violations in util.h

---
 lib/util.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/util.h b/lib/util.h
index 19fbb9fd..933730c3 100644
--- a/lib/util.h
+++ b/lib/util.h
@@ -91,7 +91,7 @@ inline std::vector<DistrRealType> GenerateRandomValues(
 // This function sets flush-to-zero and denormals-are-zeros MXCSR control
 // flags. This prevents rare cases of performance slowdown potentially at
 // the cost of a tiny precision loss.
-void SetFlushToZeroAndDenormalsAreZeros() {
+inline void SetFlushToZeroAndDenormalsAreZeros() {
 #ifdef __SSE2__
   _mm_setcsr(_mm_getcsr() | 0x8040);
 #endif
@@ -99,7 +99,7 @@ void SetFlushToZeroAndDenormalsAreZeros() {
 
 // This function clears flush-to-zero and denormals-are-zeros MXCSR control
 // flags.
-void ClearFlushToZeroAndDenormalsAreZeros() {
+inline void ClearFlushToZeroAndDenormalsAreZeros() {
 #ifdef __SSE2__
   _mm_setcsr(_mm_getcsr() & ~unsigned{0x8040});
 #endif

From 7839ff3333fbcebb763c24eab0c149e218429353 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 21 Sep 2021 08:45:32 -0700
Subject: [PATCH 094/246] Initial technical fixes

---
 docs/tutorials/multinode/README.md            | 60 ++++---------------
 docs/tutorials/multinode/circuit_q24.sub      | 11 ----
 .../{circuit_q30.sub => noiseless.sub}        |  8 +--
 docs/tutorials/multinode/noiseless3.py        | 15 +++++
 4 files changed, 32 insertions(+), 62 deletions(-)
 delete mode 100644 docs/tutorials/multinode/circuit_q24.sub
 rename docs/tutorials/multinode/{circuit_q30.sub => noiseless.sub} (74%)
 create mode 100644 docs/tutorials/multinode/noiseless3.py

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 17675b37..f7ab47e8 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -4,16 +4,6 @@ This tutorial will take you through the process of running multiple simultaneous
 many instances of the same simulation. This could be used to provide a parameter
 sweep or to evaluate noise characteristics.
 
-One of the key competencies of a quantum computing effort is the ability to run
-simulations. While quantum computing hardware is still years from general
-availability, quantum computing simulation with `qsim` and `Cirq` is available for
-researchers exploring a quantum program. It is expected that simulation will be
-a gating requirement to make use of physical hardware, to prove out algorithms
-both for computability and stability under noisy conditions. Many thousands of
-simulation runs will typically be required to prove out the gating requirements
-for each circuit, sometimes requiring years of simulation in advance of any
-practical use of the quantum hardware.
-
 ## Objectives
 
 * Use `terraform` to deploy a HTCondor cluster
@@ -190,7 +180,7 @@ cd qsim/docs/tutorials/multinode
 ### Submit a job
 Now it is possible to submit a job:
 ```
-condor_submit circuit_q24.sub
+condor_submit noiseless.sub
 ```
 If successful, the output will be:
 ```
@@ -234,10 +224,10 @@ and it will require well characterized simulations.
 To run multiple simulations, you can run the submit file `noise.sub`.  The
 submit file is shown below. It is key to note that this is running  a `docker`
 container. Also, the `queue 50` command at the end of the file submits 50
-separate instances of the container. Since this job is noise driven, the output
-of each simulation will be different. A typical analysis of the output would be 
-a statistical study of the means and variations, perhaps looking for parameter 
-ranges where circuits are particularly susceptible to noise.
+separate instances of the container. Each simulation will be different due to
+the stochastic nature of noisy simulations. A typical analysis of the output
+would be a statistical study of the means and variations, perhaps looking for
+parameter ranges where circuits are particularly susceptible to noise.
 
 
 ### The noise.sub file
@@ -295,49 +285,25 @@ Counter({3: 466, 0: 442, 2: 51, 1: 41})
 .
 .
 ```
-Note that because this is a noise driven circuit, the results of each simulation are different.
 
 ## Next steps
 
-To run your own simulations, simply create a noisy circuit in your  _qsim_ python file.
-The file being run in this was `noise3.py`. You can take this example and expand
-to your own circuit. 
-
-```python
-import cirq, qsimcirq
-
-# Create a Bell state, |00) + |11)
-q0, q1 = cirq.LineQubit.range(2)
-circuit = cirq.Circuit(
-    cirq.H(q0),
-    cirq.CNOT(q0, q1),
-    cirq.measure(q0, q1, key='m')
-)
-
-# Constructs a noise model that adds depolarizing noise after each gate.
-noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
-
-# Use the noise model to create a noisy circuit.
-noisy_circuit = cirq.Circuit(noise.noisy_moments(circuit, system_qubits=[q0, q1]))
-
-sim = qsimcirq.QSimSimulator()
-result = sim.run(noisy_circuit, repetitions=1000)
-# Outputs a histogram dict of result:count pairs.
-# Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
-# (For comparison, the noiseless circuit will only have 0s and 3s)
-print(result.histogram(key='m'))
-```
+The file being run in the previous example was `noise3.py`. To run your own
+simulations, simply create a new python file with your circuit and change the
+`noise3.py` references in `noise.sub` to point to the new file.
 
-There are many more examples of circuits to be run [here](https://quantumai.google/cirq/noise)
+A detailed discussion of how to construct various types of noise in Cirq can be
+found [here](https://quantumai.google/cirq/noise).
 
-## FINAL STEP: Shutting down 
+## Final step: Shutting down
 
 > **IMPORTANT**:  To avoid excess billing for this project, it is important to shut down the cluster. This is easily done using the make command built for this purpose.
 ```
 make destroy
 ```
 
-> The most effective way to ensure you are not charged is to delete the project. [The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
+> The most effective way to prevent further charges is to delete the project.
+[The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
 
 
 
diff --git a/docs/tutorials/multinode/circuit_q24.sub b/docs/tutorials/multinode/circuit_q24.sub
deleted file mode 100644
index a8d6b3ff..00000000
--- a/docs/tutorials/multinode/circuit_q24.sub
+++ /dev/null
@@ -1,11 +0,0 @@
-universe                = docker
-docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
-arguments               = -c circuit_q24
-transfer_input_files    = ../../../circuits/circuit_q24
-should_transfer_files   = YES
-when_to_transfer_output = ON_EXIT
-output                  = out/out.$(Cluster)-$(Process)
-error                   = out/err.$(Cluster)-$(Process)
-log                     = out/log.$(Cluster)-$(Process)
-request_memory          = 1GB
-queue 1
diff --git a/docs/tutorials/multinode/circuit_q30.sub b/docs/tutorials/multinode/noiseless.sub
similarity index 74%
rename from docs/tutorials/multinode/circuit_q30.sub
rename to docs/tutorials/multinode/noiseless.sub
index 756295c7..f4bde2c8 100644
--- a/docs/tutorials/multinode/circuit_q30.sub
+++ b/docs/tutorials/multinode/noiseless.sub
@@ -1,11 +1,11 @@
 universe                = docker
-docker_image            = gcr.io/quantum-builds/github.com/quantumlib/qsim
-arguments               = -c circuit_q30
-transfer_input_files    = ../../../circuits/circuit_q30
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
+arguments               = python3  noiseless3.py
 should_transfer_files   = YES
+transfer_input_files    = noiseless3.py
 when_to_transfer_output = ON_EXIT
 output                  = out/out.$(Cluster)-$(Process)
 error                   = out/err.$(Cluster)-$(Process)
 log                     = out/log.$(Cluster)-$(Process)
 request_memory          = 10GB
-queue 1
+queue 1
\ No newline at end of file
diff --git a/docs/tutorials/multinode/noiseless3.py b/docs/tutorials/multinode/noiseless3.py
new file mode 100644
index 00000000..4960ccdb
--- /dev/null
+++ b/docs/tutorials/multinode/noiseless3.py
@@ -0,0 +1,15 @@
+import cirq, qsimcirq
+
+# Create a Bell state, |00) + |11)
+q0, q1 = cirq.LineQubit.range(2)
+circuit = cirq.Circuit(
+    cirq.H(q0),
+    cirq.CNOT(q0, q1),
+    cirq.measure(q0, q1, key='m')
+)
+
+sim = qsimcirq.QSimSimulator()
+result = sim.run(circuit, repetitions=1000)
+# Outputs a histogram dict of result:count pairs.
+# Expected result is a bunch of 0s and 3s, with no 1s or 2s.
+print(result.histogram(key='m'))
\ No newline at end of file

From 95804984180714c4951bc429e3d9371d5d793950 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 21 Sep 2021 08:47:32 -0700
Subject: [PATCH 095/246] Autoformat python

---
 docs/tutorials/multinode/noise3.py            |   8 +-
 docs/tutorials/multinode/noiseless3.py        |   8 +-
 .../terraform/htcondor/autoscaler.py          | 349 ++++++++++--------
 .../multinode/terraform/htcondor/noise.py     |   8 +-
 4 files changed, 210 insertions(+), 163 deletions(-)

diff --git a/docs/tutorials/multinode/noise3.py b/docs/tutorials/multinode/noise3.py
index 38d741a3..f3abbdd5 100644
--- a/docs/tutorials/multinode/noise3.py
+++ b/docs/tutorials/multinode/noise3.py
@@ -2,11 +2,7 @@
 
 # Create a Bell state, |00) + |11)
 q0, q1 = cirq.LineQubit.range(2)
-circuit = cirq.Circuit(
-    cirq.H(q0),
-    cirq.CNOT(q0, q1),
-    cirq.measure(q0, q1, key='m')
-)
+circuit = cirq.Circuit(cirq.H(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1, key="m"))
 
 # Constructs a noise model that adds depolarizing noise after each gate.
 noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
@@ -19,4 +15,4 @@
 # Outputs a histogram dict of result:count pairs.
 # Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
 # (For comparison, the noiseless circuit will only have 0s and 3s)
-print(result.histogram(key='m'))
\ No newline at end of file
+print(result.histogram(key="m"))
diff --git a/docs/tutorials/multinode/noiseless3.py b/docs/tutorials/multinode/noiseless3.py
index 4960ccdb..f35dcb5c 100644
--- a/docs/tutorials/multinode/noiseless3.py
+++ b/docs/tutorials/multinode/noiseless3.py
@@ -2,14 +2,10 @@
 
 # Create a Bell state, |00) + |11)
 q0, q1 = cirq.LineQubit.range(2)
-circuit = cirq.Circuit(
-    cirq.H(q0),
-    cirq.CNOT(q0, q1),
-    cirq.measure(q0, q1, key='m')
-)
+circuit = cirq.Circuit(cirq.H(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1, key="m"))
 
 sim = qsimcirq.QSimSimulator()
 result = sim.run(circuit, repetitions=1000)
 # Outputs a histogram dict of result:count pairs.
 # Expected result is a bunch of 0s and 3s, with no 1s or 2s.
-print(result.histogram(key='m'))
\ No newline at end of file
+print(result.histogram(key="m"))
diff --git a/docs/tutorials/multinode/terraform/htcondor/autoscaler.py b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
index 151d8d5e..7795d8c9 100644
--- a/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
+++ b/docs/tutorials/multinode/terraform/htcondor/autoscaler.py
@@ -30,126 +30,165 @@
 
 parser = argparse.ArgumentParser()
 parser.add_argument("--p", required=True, help="Project id", type=str)
-parser.add_argument("--z", required=True, help="Name of GCP zone where the managed instance group is located", type=str)
-parser.add_argument("--r", required=True, help="Name of GCP region where the managed instance group is located", type=str)
-parser.add_argument("--mz", required=False, help="Enabled multizone (regional) managed instance group", action="store_true")
-parser.add_argument("--g", required=True, help="Name of the managed instance group", type=str)
-parser.add_argument("--c", required=True, help="Maximum number of compute instances", type=int)
-parser.add_argument("--v", default=0, help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info", type=int, choices=[0, 1, 2])
-parser.add_argument("--d", default=0, help="Dry Run, default=0, if 1, then no scaling actions", type=int, choices=[0, 1])
+parser.add_argument(
+    "--z",
+    required=True,
+    help="Name of GCP zone where the managed instance group is located",
+    type=str,
+)
+parser.add_argument(
+    "--r",
+    required=True,
+    help="Name of GCP region where the managed instance group is located",
+    type=str,
+)
+parser.add_argument(
+    "--mz",
+    required=False,
+    help="Enabled multizone (regional) managed instance group",
+    action="store_true",
+)
+parser.add_argument(
+    "--g", required=True, help="Name of the managed instance group", type=str
+)
+parser.add_argument(
+    "--c", required=True, help="Maximum number of compute instances", type=int
+)
+parser.add_argument(
+    "--v",
+    default=0,
+    help="Increase output verbosity. 1-show basic debug info. 2-show detail debug info",
+    type=int,
+    choices=[0, 1, 2],
+)
+parser.add_argument(
+    "--d",
+    default=0,
+    help="Dry Run, default=0, if 1, then no scaling actions",
+    type=int,
+    choices=[0, 1],
+)
 
 
 args = parser.parse_args()
-        
-class AutoScaler():
 
+
+class AutoScaler:
     def __init__(self, multizone=False):
 
         self.multizone = multizone
         # Obtain credentials
         self.credentials = GoogleCredentials.get_application_default()
-        self.service = discovery.build('compute', 'v1', credentials=self.credentials)
-    
+        self.service = discovery.build("compute", "v1", credentials=self.credentials)
+
         if self.multizone:
             self.instanceGroupManagers = self.service.regionInstanceGroupManagers()
         else:
             self.instanceGroupManagers = self.service.instanceGroupManagers()
-    
+
     # Remove specified instance from MIG and decrease MIG size
     def deleteFromMig(self, instance):
-        instanceUrl = 'https://www.googleapis.com/compute/v1/projects/' + self.project
-        if (self.multizone):
-            instanceUrl += '/regions/' + self.region
+        instanceUrl = "https://www.googleapis.com/compute/v1/projects/" + self.project
+        if self.multizone:
+            instanceUrl += "/regions/" + self.region
         else:
-            instanceUrl += '/zones/' + self.zone
-        instanceUrl += '/instances/' + instance
+            instanceUrl += "/zones/" + self.zone
+        instanceUrl += "/instances/" + instance
+
+        instances_to_delete = {"instances": [instanceUrl]}
 
-        instances_to_delete = {'instances': [instanceUrl]}
-    
-        requestDelInstance = \
-            self.instanceGroupManagers.deleteInstances(project=self.project,
-            **self.zoneargs, instanceGroupManager=self.instance_group_manager,
-            body=instances_to_delete)
+        requestDelInstance = self.instanceGroupManagers.deleteInstances(
+            project=self.project,
+            **self.zoneargs,
+            instanceGroupManager=self.instance_group_manager,
+            body=instances_to_delete,
+        )
 
         # execute if not a dry-run
         if not self.dryrun:
             response = requestDelInstance.execute()
             if self.debug > 0:
-                print('Request to delete instance ' + instance)
+                print("Request to delete instance " + instance)
                 pprint(response)
             return response
         return "Dry Run"
-    
+
     def getInstanceTemplateInfo(self):
-        requestTemplateName = \
-                self.instanceGroupManagers.get(project=self.project, **self.zoneargs,
-                instanceGroupManager=self.instance_group_manager,
-                fields='instanceTemplate')
+        requestTemplateName = self.instanceGroupManagers.get(
+            project=self.project,
+            **self.zoneargs,
+            instanceGroupManager=self.instance_group_manager,
+            fields="instanceTemplate",
+        )
         responseTemplateName = requestTemplateName.execute()
-        template_name = ''
-    
+        template_name = ""
+
         if self.debug > 1:
-            print('Request for the template name')
+            print("Request for the template name")
             pprint(responseTemplateName)
-    
+
         if len(responseTemplateName) > 0:
-            template_url = responseTemplateName.get('instanceTemplate')
-            template_url_partitioned = template_url.split('/')
-            template_name = \
-                template_url_partitioned[len(template_url_partitioned) - 1]
-    
-        requestInstanceTemplate = \
-            self.service.instanceTemplates().get(project=self.project,
-                instanceTemplate=template_name, fields='properties')
+            template_url = responseTemplateName.get("instanceTemplate")
+            template_url_partitioned = template_url.split("/")
+            template_name = template_url_partitioned[len(template_url_partitioned) - 1]
+
+        requestInstanceTemplate = self.service.instanceTemplates().get(
+            project=self.project, instanceTemplate=template_name, fields="properties"
+        )
         responseInstanceTemplateInfo = requestInstanceTemplate.execute()
-    
+
         if self.debug > 1:
-            print('Template information')
-            pprint(responseInstanceTemplateInfo['properties'])
-    
-        machine_type = responseInstanceTemplateInfo['properties']['machineType']
-        is_preemtible = responseInstanceTemplateInfo['properties']['scheduling']['preemptible']
+            print("Template information")
+            pprint(responseInstanceTemplateInfo["properties"])
+
+        machine_type = responseInstanceTemplateInfo["properties"]["machineType"]
+        is_preemtible = responseInstanceTemplateInfo["properties"]["scheduling"][
+            "preemptible"
+        ]
         if self.debug > 0:
-            print('Machine Type: ' + machine_type)
-            print('Is preemtible: ' + str(is_preemtible))
-        request = self.service.machineTypes().get(project=self.project, zone=self.zone,
-                machineType=machine_type)
+            print("Machine Type: " + machine_type)
+            print("Is preemtible: " + str(is_preemtible))
+        request = self.service.machineTypes().get(
+            project=self.project, zone=self.zone, machineType=machine_type
+        )
         response = request.execute()
-        guest_cpus = response['guestCpus']
+        guest_cpus = response["guestCpus"]
         if self.debug > 1:
-            print('Machine information')
-            pprint(responseInstanceTemplateInfo['properties'])
+            print("Machine information")
+            pprint(responseInstanceTemplateInfo["properties"])
         if self.debug > 0:
-            print('Guest CPUs: ' + str(guest_cpus))
-    
-        instanceTemlateInfo = {'machine_type': machine_type,
-                            'is_preemtible': is_preemtible,
-                            'guest_cpus': guest_cpus}
+            print("Guest CPUs: " + str(guest_cpus))
+
+        instanceTemlateInfo = {
+            "machine_type": machine_type,
+            "is_preemtible": is_preemtible,
+            "guest_cpus": guest_cpus,
+        }
         return instanceTemlateInfo
-    
-    
 
     def scale(self):
         # diagnosis
         if self.debug > 1:
-            print('Launching autoscaler.py with the following arguments:')
-            print('project_id: ' + self.project)
-            print('zone: ' + self.zone)
-            print('region: ' + self.region)
-            print(f'multizone: {self.multizone}')
-            print('group_manager: ' + self.instance_group_manager)
-            print('computeinstancelimit: ' + str(self.compute_instance_limit))
-            print('debuglevel: ' + str(self.debug))
+            print("Launching autoscaler.py with the following arguments:")
+            print("project_id: " + self.project)
+            print("zone: " + self.zone)
+            print("region: " + self.region)
+            print(f"multizone: {self.multizone}")
+            print("group_manager: " + self.instance_group_manager)
+            print("computeinstancelimit: " + str(self.compute_instance_limit))
+            print("debuglevel: " + str(self.debug))
 
         if self.multizone:
-            self.zoneargs = {'region': self.region}
+            self.zoneargs = {"region": self.region}
         else:
-            self.zoneargs = {'zone': self.zone}
+            self.zoneargs = {"zone": self.zone}
 
         # Get total number of jobs in the queue that includes number of jos waiting as well as number of jobs already assigned to nodes
-        queue_length_req = 'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
+        queue_length_req = (
+            'condor_q -totals -format "%d " Jobs -format "%d " Idle -format "%d " Held'
+        )
         queue_length_resp = os.popen(queue_length_req).read().split()
-        
+
         if len(queue_length_resp) > 1:
             queue = int(queue_length_resp[0])
             idle_jobs = int(queue_length_resp[1])
@@ -158,70 +197,85 @@ def scale(self):
             queue = 0
             idle_jobs = 0
             on_hold_jobs = 0
-        
-        print('Total queue length: ' + str(queue))
-        print('Idle jobs: ' + str(idle_jobs))
-        print('Jobs on hold: ' + str(on_hold_jobs))
-        
+
+        print("Total queue length: " + str(queue))
+        print("Idle jobs: " + str(idle_jobs))
+        print("Jobs on hold: " + str(on_hold_jobs))
+
         instanceTemlateInfo = self.getInstanceTemplateInfo()
         if self.debug > 1:
-            print('Information about the compute instance template')
+            print("Information about the compute instance template")
             pprint(instanceTemlateInfo)
-        
-        self.cores_per_node = instanceTemlateInfo['guest_cpus']
-        print('Number of CPU per compute node: ' + str(self.cores_per_node))
-        
+
+        self.cores_per_node = instanceTemlateInfo["guest_cpus"]
+        print("Number of CPU per compute node: " + str(self.cores_per_node))
+
         # Get state for for all jobs in Condor
-        name_req = 'condor_status  -af name state'
+        name_req = "condor_status  -af name state"
         slot_names = os.popen(name_req).read().splitlines()
         if self.debug > 1:
-            print('Currently running jobs in Condor')
+            print("Currently running jobs in Condor")
             print(slot_names)
-        
+
         # Adjust current queue length by the number of jos that are on-hold
-        queue -=on_hold_jobs
-        if on_hold_jobs>0:
+        queue -= on_hold_jobs
+        if on_hold_jobs > 0:
             print("Adjusted queue length: " + str(queue))
-        
+
         # Calculate number instances to satisfy current job queue length
         if queue > 0:
             self.size = int(math.ceil(float(queue) / float(self.cores_per_node)))
-            if self.debug>0:
-                print("Calucalting size of MIG: ⌈" + str(queue) + "/" + str(self.cores_per_node) + "⌉ = " + str(self.size))
+            if self.debug > 0:
+                print(
+                    "Calucalting size of MIG: ⌈"
+                    + str(queue)
+                    + "/"
+                    + str(self.cores_per_node)
+                    + "⌉ = "
+                    + str(self.size)
+                )
         else:
             self.size = 0
-        
+
         # If compute instance limit is specified, can not start more instances then specified in the limit
         if self.compute_instance_limit > 0 and self.size > self.compute_instance_limit:
             self.size = self.compute_instance_limit
-            print("MIG target size will be limited by " + str(self.compute_instance_limit))
-        
-        print('New MIG target size: ' + str(self.size))
-        
+            print(
+                "MIG target size will be limited by " + str(self.compute_instance_limit)
+            )
+
+        print("New MIG target size: " + str(self.size))
+
         # Get current number of instances in the MIG
-        requestGroupInfo = self.instanceGroupManagers.get(project=self.project,
-                **self.zoneargs, instanceGroupManager=self.instance_group_manager)
+        requestGroupInfo = self.instanceGroupManagers.get(
+            project=self.project,
+            **self.zoneargs,
+            instanceGroupManager=self.instance_group_manager,
+        )
         responseGroupInfo = requestGroupInfo.execute()
-        currentTarget = int(responseGroupInfo['targetSize'])
-        print('Current MIG target size: ' + str(currentTarget))
-        
+        currentTarget = int(responseGroupInfo["targetSize"])
+        print("Current MIG target size: " + str(currentTarget))
+
         if self.debug > 1:
-            print('MIG Information:')
+            print("MIG Information:")
             print(responseGroupInfo)
-        
+
         if self.size == 0 and currentTarget == 0:
-            print('No jobs in the queue and no compute instances running. Nothing to do')
+            print(
+                "No jobs in the queue and no compute instances running. Nothing to do"
+            )
             exit()
-        
+
         if self.size == currentTarget:
-            print('Running correct number of compute nodes to handle number of jobs in the queue')
+            print(
+                "Running correct number of compute nodes to handle number of jobs in the queue"
+            )
             exit()
-        
-        
+
         if self.size < currentTarget:
-            print('Scaling down. Looking for nodes that can be shut down' )
+            print("Scaling down. Looking for nodes that can be shut down")
             # Find nodes that are not busy (all slots showing status as "Unclaimed")
-        
+
             node_busy = {}
             for slot_name in slot_names:
                 name_status = slot_name.split()
@@ -229,91 +283,96 @@ def scale(self):
                     name = name_status[0]
                     status = name_status[1]
                     slot = "NO-SLOT"
-                    slot_server = name.split('@')
+                    slot_server = name.split("@")
                     if len(slot_server) > 1:
                         slot = slot_server[0]
-                        server = slot_server[1].split('.')[0]
+                        server = slot_server[1].split(".")[0]
                     else:
-                        server = slot_server[0].split('.')[0]
-        
+                        server = slot_server[0].split(".")[0]
+
                     if self.debug > 0:
-                        print(slot + ', ' + server + ', ' + status + '\n')
-        
+                        print(slot + ", " + server + ", " + status + "\n")
+
                     if server not in node_busy:
-                        if status == 'Unclaimed':
+                        if status == "Unclaimed":
                             node_busy[server] = False
                         else:
                             node_busy[server] = True
                     else:
-                        if status != 'Unclaimed':
+                        if status != "Unclaimed":
                             node_busy[server] = True
-                            
+
             if self.debug > 1:
-                print('Compuute node busy status:')
+                print("Compuute node busy status:")
                 print(node_busy)
-        
+
             # Shut down nodes that are not busy
             for node in node_busy:
                 if not node_busy[node]:
-                    print('Will shut down: ' + node + ' ...')
+                    print("Will shut down: " + node + " ...")
                     respDel = self.deleteFromMig(node)
                     if self.debug > 1:
                         print("Shut down request for compute node " + node)
                         pprint(respDel)
-                        
+
             if self.debug > 1:
                 print("Scaling down complete")
-        
+
         if self.size > currentTarget:
-            print("Scaling up. Need to increase number of instances to " + str(self.size))
-            #Request to resize
-            request = self.instanceGroupManagers.resize(project=self.project,
-                    **self.zoneargs,
-                    instanceGroupManager=self.instance_group_manager,
-                    size=self.size)
+            print(
+                "Scaling up. Need to increase number of instances to " + str(self.size)
+            )
+            # Request to resize
+            request = self.instanceGroupManagers.resize(
+                project=self.project,
+                **self.zoneargs,
+                instanceGroupManager=self.instance_group_manager,
+                size=self.size,
+            )
             response = request.execute()
             if self.debug > 1:
-                print('Requesting to increase MIG size')
+                print("Requesting to increase MIG size")
                 pprint(response)
                 print("Scaling up complete")
+
+
 def main():
 
     scaler = AutoScaler(args.mz)
 
     # Project ID
     scaler.project = args.p  # Ex:'slurm-var-demo'
-    
+
     # Name of the zone where the managed instance group is located
-    scaler.zone = args.z # Ex: 'us-central1-f'
-    
+    scaler.zone = args.z  # Ex: 'us-central1-f'
+
     # Name of the region where the managed instance group is located
-    scaler.region = args.r # Ex: 'us-central1'
+    scaler.region = args.r  # Ex: 'us-central1'
 
     # The name of the managed instance group.
     scaler.instance_group_manager = args.g  # Ex: 'condor-compute-igm'
-    
+
     # Default number of cores per intance, will be replaced with actual value
     scaler.cores_per_node = 4
-    
+
     # Default number of running instances that the managed instance group should maintain at any given time. This number will go up and down based on the load (number of jobs in the queue)
     scaler.size = 0
 
     # Dry run: : 0, run scaling; 1, only provide info.
     scaler.dryrun = args.d > 0
-    
+
     # Debug level: 1-print debug information, 2 - print detail debug information
     scaler.debug = 0
-    if (args.v):
+    if args.v:
         scaler.debug = args.v
-    
-    # Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script 
+
+    # Limit for the maximum number of compute instance. If zero (default setting), no limit will be enforced by the  script
     scaler.compute_instance_limit = 0
-    if (args.c):
+    if args.c:
         scaler.compute_instance_limit = abs(args.c)
-    
-    
+
     scaler.scale()
 
 
 if __name__ == "__main__":
-    main()
\ No newline at end of file
+    main()
diff --git a/docs/tutorials/multinode/terraform/htcondor/noise.py b/docs/tutorials/multinode/terraform/htcondor/noise.py
index df87cc55..b5542959 100644
--- a/docs/tutorials/multinode/terraform/htcondor/noise.py
+++ b/docs/tutorials/multinode/terraform/htcondor/noise.py
@@ -4,11 +4,7 @@
 
 # Create a Bell state, |00) + |11)
 q0, q1 = cirq.LineQubit.range(2)
-circuit = cirq.Circuit(
-    cirq.H(q0),
-    cirq.CNOT(q0, q1),
-    cirq.measure(q0, q1, key='m')
-)
+circuit = cirq.Circuit(cirq.H(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1, key="m"))
 
 # Constructs a noise model that adds depolarizing noise after each gate.
 noise = cirq.NoiseModel.from_noise_model_like(cirq.depolarize(p=0.05))
@@ -21,4 +17,4 @@
 # Outputs a histogram dict of result:count pairs.
 # Expected result is a bunch of 0s and 3s, with fewer 1s and 2s.
 # (For comparison, the noiseless circuit will only have 0s and 3s)
-print(result.histogram(key='m'))
\ No newline at end of file
+print(result.histogram(key="m"))

From f607fbcf068978154d41e8ebafcd789bee9db5bd Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Fri, 24 Sep 2021 17:54:03 +0200
Subject: [PATCH 096/246] Add a quantum trajectory app.

---
 apps/make.sh                  |   1 +
 apps/qsim_qtrajectory_cuda.cu | 313 ++++++++++++++++++++++++++++++++++
 lib/channels_qsim.h           | 103 +++++++++++
 lib/gates_qsim.h              |  43 +++++
 4 files changed, 460 insertions(+)
 create mode 100644 apps/qsim_qtrajectory_cuda.cu
 create mode 100644 lib/channels_qsim.h

diff --git a/apps/make.sh b/apps/make.sh
index 679694f8..e21f410c 100755
--- a/apps/make.sh
+++ b/apps/make.sh
@@ -24,3 +24,4 @@ g++ -O3 -march=native -fopenmp -o qsimh_base.x qsimh_base.cc
 g++ -O3 -march=native -fopenmp -o qsimh_amplitudes.x qsimh_amplitudes.cc
 
 nvcc -O3 -o qsim_base_cuda.x qsim_base_cuda.cu
+nvcc -O3 -o qsim_qtrajectory_cuda.x qsim_qtrajectory_cuda.cu
diff --git a/apps/qsim_qtrajectory_cuda.cu b/apps/qsim_qtrajectory_cuda.cu
new file mode 100644
index 00000000..f5636c0f
--- /dev/null
+++ b/apps/qsim_qtrajectory_cuda.cu
@@ -0,0 +1,313 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include <unistd.h>
+
+#include <cmath>
+#include <complex>
+#include <cstdint>
+#include <cstdlib>
+#include <complex>
+#include <limits>
+#include <utility>
+#include <vector>
+
+#include "../lib/channels_qsim.h"
+#include "../lib/circuit_qsim_parser.h"
+#include "../lib/expect.h"
+#include "../lib/fuser_mqubit.h"
+#include "../lib/gates_qsim.h"
+#include "../lib/io_file.h"
+#include "../lib/qtrajectory.h"
+#include "../lib/simulator_cuda.h"
+
+struct Options {
+  std::string circuit_file;
+  std::vector<unsigned> times = {std::numeric_limits<unsigned>::max()};
+  double amplitude_damp_const = 0;
+  double phase_damp_const = 0;
+  unsigned traj0 = 0;
+  unsigned num_trajectories = 10;
+  unsigned max_fused_size = 2;
+  unsigned verbosity = 0;
+};
+
+constexpr char usage[] = "usage:\n  ./qsim_qtrajectory_cuda.x "
+                         "-c circuit_file -d times_to_calculate_observables "
+                         "-a amplitude_damping_const -p phase_damping_const "
+                         "-t traj0 -n num_trajectories -f max_fused_size "
+                         "-v verbosity\n";
+
+Options GetOptions(int argc, char* argv[]) {
+  Options opt;
+
+  int k;
+
+  auto to_int = [](const std::string& word) -> unsigned {
+    return std::atoi(word.c_str());
+  };
+
+  while ((k = getopt(argc, argv, "c:d:a:p:t:n:f:v:")) != -1) {
+    switch (k) {
+      case 'c':
+        opt.circuit_file = optarg;
+        break;
+      case 'd':
+        qsim::SplitString(optarg, ',', to_int, opt.times);
+        break;
+      case 'a':
+        opt.amplitude_damp_const = std::atof(optarg);
+        break;
+      case 'p':
+        opt.phase_damp_const = std::atof(optarg);
+        break;
+      case 't':
+        opt.traj0 = std::atoi(optarg);
+        break;
+      case 'n':
+        opt.num_trajectories = std::atoi(optarg);
+        break;
+      case 'f':
+        opt.max_fused_size = std::atoi(optarg);
+        break;
+      case 'v':
+        opt.verbosity = std::atoi(optarg);
+        break;
+        break;
+      default:
+        qsim::IO::errorf(usage);
+        exit(1);
+    }
+  }
+
+  return opt;
+}
+
+bool ValidateOptions(const Options& opt) {
+  if (opt.circuit_file.empty()) {
+    qsim::IO::errorf("circuit file is not provided.\n");
+    qsim::IO::errorf(usage);
+    return false;
+  }
+
+  if (opt.times.size() == 0) {
+    qsim::IO::errorf("times to calculate observables are not provided.\n");
+    return false;
+  }
+
+  for (std::size_t i = 1; i < opt.times.size(); i++) {
+    if (opt.times[i - 1] == opt.times[i]) {
+      qsim::IO::errorf("duplicate times to calculate observables.\n");
+      return false;
+    } else if (opt.times[i - 1] > opt.times[i]) {
+      qsim::IO::errorf("times to calculate observables are not sorted.\n");
+      return false;
+    }
+  }
+
+  return true;
+}
+
+template <typename Gate, typename Channel1, typename Channel2>
+std::vector<qsim::NoisyCircuit<Gate>> AddNoise(
+    const qsim::Circuit<Gate>& circuit, const std::vector<unsigned>& times,
+    const Channel1& channel1, const Channel2& channel2) {
+  std::vector<qsim::NoisyCircuit<Gate>> ncircuits;
+  ncircuits.reserve(times.size());
+
+  qsim::NoisyCircuit<Gate> ncircuit;
+
+  ncircuit.num_qubits = circuit.num_qubits;
+  ncircuit.channels.reserve(5 * circuit.gates.size());
+
+  unsigned cur_time_index = 0;
+
+  for (std::size_t i = 0; i < circuit.gates.size(); ++i) {
+    const auto& gate = circuit.gates[i];
+
+    ncircuit.channels.push_back(qsim::MakeChannelFromGate(3 * gate.time, gate));
+
+    for (auto q : gate.qubits) {
+      ncircuit.channels.push_back(channel1.Create(3 * gate.time + 1, q));
+    }
+
+    for (auto q : gate.qubits) {
+      ncircuit.channels.push_back(channel2.Create(3 * gate.time + 2, q));
+    }
+
+    unsigned t = times[cur_time_index];
+
+    if (i == circuit.gates.size() - 1 || t < circuit.gates[i + 1].time) {
+      ncircuits.push_back(std::move(ncircuit));
+
+      ncircuit = {};
+
+      if (i < circuit.gates.size() - 1) {
+        if (circuit.gates[i + 1].time > times.back()) {
+          break;
+        }
+
+        ncircuit.num_qubits = circuit.num_qubits;
+        ncircuit.channels.reserve(5 * circuit.gates.size());
+      }
+
+      ++cur_time_index;
+    }
+  }
+
+  return ncircuits;
+}
+
+template <typename Gate>
+std::vector<std::vector<qsim::OpString<Gate>>> GetObservables(
+    unsigned num_qubits) {
+  std::vector<std::vector<qsim::OpString<Gate>>> observables;
+  observables.reserve(num_qubits);
+
+  using X = qsim::GateX<typename Gate::fp_type>;
+
+  for (unsigned q = 0; q < num_qubits; ++q) {
+    observables.push_back({{{1.0, 0.0}, {X::Create(0, q)}}});
+  }
+
+  return observables;
+}
+
+int main(int argc, char* argv[]) {
+  using namespace qsim;
+
+  using fp_type = float;
+
+  struct Factory {
+    using Simulator = qsim::SimulatorCUDA<fp_type>;
+    using StateSpace = Simulator::StateSpace;
+
+    Factory(const StateSpace::Parameter& param1,
+            const Simulator::Parameter& param2)
+        : param1(param1), param2(param2) {}
+
+    StateSpace CreateStateSpace() const {
+      return StateSpace(param1);
+    }
+
+    Simulator CreateSimulator() const {
+      return Simulator(param2);
+    }
+
+    const StateSpace::Parameter& param1;
+    const Simulator::Parameter& param2;
+  };
+
+  using Simulator = Factory::Simulator;
+  using StateSpace = Simulator::StateSpace;
+  using State = StateSpace::State;
+  using Fuser = MultiQubitGateFuser<IO, GateQSim<fp_type>>;
+  using QTSimulator = QuantumTrajectorySimulator<IO, GateQSim<fp_type>,
+                                                 MultiQubitGateFuser,
+                                                 Simulator>;
+
+  auto opt = GetOptions(argc, argv);
+  if (!ValidateOptions(opt)) {
+    return 1;
+  }
+
+  Circuit<GateQSim<fp_type>> circuit;
+  unsigned maxtime = opt.times.back();
+  if (!CircuitQsimParser<IOFile>::FromFile(maxtime, opt.circuit_file,
+                                           circuit)) {
+    return 1;
+  }
+
+  StateSpace::Parameter param1;
+  Simulator::Parameter param2;
+  Factory factory(param1, param2);
+
+  Simulator simulator = factory.CreateSimulator();
+  StateSpace state_space = factory.CreateStateSpace();
+
+  State state = state_space.Create(circuit.num_qubits);
+  State scratch = state_space.Null();
+
+  if (state_space.IsNull(state)) {
+    IO::errorf("not enough memory: is the number of qubits too large?\n");
+    return 1;
+  }
+
+  typename QTSimulator::Parameter param3;
+  param3.max_fused_size = opt.max_fused_size;
+  param3.verbosity = opt.verbosity;
+
+  auto channel1 = AmplitudeDampingChannel<fp_type>(opt.amplitude_damp_const);
+  auto channel2 = PhaseDampingChannel<fp_type>(opt.phase_damp_const);
+
+  auto noisy_circuits = AddNoise(circuit, opt.times, channel1, channel2);
+
+  auto observables = GetObservables<GateQSim<fp_type>>(circuit.num_qubits);
+
+  std::vector<std::vector<std::vector<std::complex<double>>>> results;
+  results.reserve(noisy_circuits.size());
+
+  for (unsigned i = 0; i < opt.num_trajectories; ++i) {
+    results.push_back({});
+    results[i].reserve(noisy_circuits.size());
+
+    state_space.SetStateZero(state);
+
+    auto seed = noisy_circuits.size() * (i + opt.traj0);
+
+    for (unsigned s = 0; s < noisy_circuits.size(); ++s) {
+      std::vector<uint64_t> stat;
+      if (!QTSimulator::RunOnce(param3, noisy_circuits[s], seed++,
+                                state_space, simulator, scratch, state,
+                                stat)) {
+        return 1;
+      }
+
+      results[i].push_back({});
+      results[i][s].reserve(observables.size());
+
+      for (const auto& obs : observables) {
+        results[i][s].push_back(
+            ExpectationValue<IO, Fuser>(obs, simulator, state));
+      }
+    }
+  }
+
+  for (unsigned i = 1; i < opt.num_trajectories; ++i) {
+    for (unsigned s = 0; s < noisy_circuits.size(); ++s) {
+      for (unsigned k = 0; k < observables.size(); ++k) {
+        results[0][s][k] += results[i][s][k];
+      }
+    }
+  }
+
+  double f = 1.0 / opt.num_trajectories;
+
+  for (unsigned s = 0; s < noisy_circuits.size(); ++s) {
+    for (unsigned k = 0; k < observables.size(); ++k) {
+      results[0][s][k] *= f;
+    }
+  }
+
+  for (unsigned s = 0; s < noisy_circuits.size(); ++s) {
+    IO::messagef("#time=%u\n", opt.times[s]);
+
+    for (unsigned k = 0; k < observables.size(); ++k) {
+      IO::messagef("%4u %4u %17.9g %17.9g\n", s, k,
+                   std::real(results[0][s][k]), std::imag(results[0][s][k]));
+    }
+  }
+
+  return 0;
+}
diff --git a/lib/channels_qsim.h b/lib/channels_qsim.h
new file mode 100644
index 00000000..9630de07
--- /dev/null
+++ b/lib/channels_qsim.h
@@ -0,0 +1,103 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef CHANNELS_QSIM_H_
+#define CHANNELS_QSIM_H_
+
+#include <cmath>
+#include <cstdint>
+#include <vector>
+
+#include "channel.h"
+#include "gates_qsim.h"
+
+namespace qsim {
+
+/**
+ * Amplitude damping channel factory.
+ */
+template <typename fp_type>
+struct AmplitudeDampingChannel {
+  AmplitudeDampingChannel(double gamma) : gamma(gamma) {}
+
+  static Channel<GateQSim<fp_type>> Create(
+      unsigned time, unsigned q, double gamma) {
+    double p1 = 1 - gamma;
+    double p2 = 0;
+
+    fp_type r = std::sqrt(p1);
+    fp_type s = std::sqrt(gamma);
+
+    using M = GateMatrix1<fp_type>;
+    auto normal = KrausOperator<GateQSim<fp_type>>::kNormal;
+
+    return {{normal, 0, p1, {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})}},
+            {normal, 0, p2, {M::Create(time, q, {0, 0, s, 0, 0, 0, 0, 0})}}};
+  }
+
+  Channel<GateQSim<fp_type>> Create(unsigned time, unsigned q) const {
+    return Create(time, q, gamma);
+  }
+
+  double gamma = 0;
+};
+
+/**
+ * Returns an amplitude damping channel factory object.
+ */
+template <typename fp_type>
+inline AmplitudeDampingChannel<fp_type> amplitude_damp(double gamma) {
+  return AmplitudeDampingChannel<fp_type>(gamma);
+}
+
+/**
+ *  Phase damping channel factory.
+ */
+template <typename fp_type>
+struct PhaseDampingChannel {
+  PhaseDampingChannel(double gamma) : gamma(gamma) {}
+
+  static Channel<GateQSim<fp_type>> Create(
+      unsigned time, unsigned q, double gamma) {
+    double p1 = 1 - gamma;
+    double p2 = 0;
+
+    fp_type r = std::sqrt(p1);
+    fp_type s = std::sqrt(gamma);
+
+    using M = GateMatrix1<fp_type>;
+    auto normal = KrausOperator<GateQSim<fp_type>>::kNormal;
+
+    return {{normal, 0, p1, {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})}},
+            {normal, 0, p2, {M::Create(time, q, {0, 0, 0, 0, 0, 0, s, 0})}}};
+  }
+
+  Channel<GateQSim<fp_type>> Create(unsigned time, unsigned q) const {
+    return Create(time, q, gamma);
+  }
+
+  double gamma = 0;
+};
+
+/**
+ * Returns a phase damping channel factory object.
+ */
+template <typename fp_type>
+inline PhaseDampingChannel<fp_type> phase_damp(double gamma) {
+  return PhaseDampingChannel<fp_type>(gamma);
+}
+
+}  // namespace qsim
+
+#endif  // CHANNELS_QSIM_H_
diff --git a/lib/gates_qsim.h b/lib/gates_qsim.h
index 7690c2b6..9b64cf98 100644
--- a/lib/gates_qsim.h
+++ b/lib/gates_qsim.h
@@ -46,6 +46,8 @@ enum GateKind {
   kGateIS,      // iSwap
   kGateFS,      // fSim
   kGateCP,      // control phase
+  kGateMatrix1, // One-qubit matrix gate.
+  kGateMatrix2, // Two-qubit matrix gate.
   kDecomp = gate::kDecomp,
   kMeasurement = gate::kMeasurement,
 };
@@ -317,6 +319,24 @@ struct GateS {
   }
 };
 
+/**
+ * A one-qubit gate defined entirely by its matrix.
+ */
+template <typename fp_type>
+struct GateMatrix1 {
+  static constexpr GateKind kind = kGateMatrix1;
+  static constexpr char name[] = "mat1";
+  static constexpr unsigned num_qubits = 1;
+  static constexpr bool symmetric = true;
+
+  static GateQSim<fp_type> Create(unsigned time, unsigned q0,
+                                  const Matrix<fp_type>& m) {
+    auto m2 = m;
+    return
+        CreateGate<GateQSim<fp_type>, GateMatrix1>(time, {q0}, std::move(m2));
+  }
+};
+
 // Two-qubit gates:
 
 /**
@@ -566,6 +586,29 @@ struct GateCP {
   }
 };
 
+/**
+ * A two-qubit gate defined entirely by its matrix.
+ */
+template <typename fp_type>
+struct GateMatrix2 {
+  static constexpr GateKind kind = kGateMatrix2;
+  static constexpr char name[] = "mat2";
+  static constexpr unsigned num_qubits = 2;
+  static constexpr bool symmetric = false;
+
+  template <typename M = Matrix<fp_type>>
+  static GateQSim<fp_type> Create(
+      unsigned time, unsigned q0, unsigned q1, M&& m) {
+    return CreateGate<GateQSim<fp_type>, GateMatrix2>(time, {q1, q0},
+                                                      std::forward<M>(m));
+  }
+
+  static schmidt_decomp_type<fp_type> SchmidtDecomp(fp_type phi) {
+    // Not implemented.
+    return schmidt_decomp_type<fp_type>{};
+  }
+};
+
 template <typename fp_type>
 inline schmidt_decomp_type<fp_type> GetSchmidtDecomp(
     GateKind kind, const std::vector<fp_type>& params) {

From 5c4d98d8475e5c23c1a3d209176210bed384672a Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 24 Sep 2021 10:58:40 -0700
Subject: [PATCH 097/246] Add GPU warning for `simulate_sweep`

---
 qsimcirq/qsim_simulator.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index a7b52335..b99a110a 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -454,6 +454,11 @@ def simulate_sweep(
         This method returns a result which allows access to the entire
         wave function. In contrast to simulate, this allows for sweeping
         over different parameter values.
+        
+        Avoid using this method with `use_gpu=True` in the simulator options;
+        when used with GPU this method must copy state from device to host memory
+        multiple times, which can be very slow. This issue is not present in
+        `simulate_expectation_values_sweep`.
 
         Args:
             program: The circuit to simulate.

From 2f1261211c585961cc0079a06657d50f6345b6a2 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 24 Sep 2021 11:10:03 -0700
Subject: [PATCH 098/246] Remove leading whitespace

---
 qsimcirq/qsim_simulator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index b99a110a..aa923a93 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -454,7 +454,7 @@ def simulate_sweep(
         This method returns a result which allows access to the entire
         wave function. In contrast to simulate, this allows for sweeping
         over different parameter values.
-        
+
         Avoid using this method with `use_gpu=True` in the simulator options;
         when used with GPU this method must copy state from device to host memory
         multiple times, which can be very slow. This issue is not present in

From 2d24994baaf92a0d4dc5eaaf2ecb751f80273a11 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Thu, 30 Sep 2021 15:14:22 +0000
Subject: [PATCH 099/246] Fix an error in _book.yaml; split GCP tutorial into
 multiple parts to clarify CPU and GPU workflows; added noise simulation
 tutorial to nav. #424

---
 docs/_book.yaml                        |  97 +++++-----
 docs/images/colab_connect.png          | Bin 0 -> 75964 bytes
 docs/images/colab_connected.png        | Bin 0 -> 32211 bytes
 docs/images/colab_remote.png           | Bin 0 -> 238053 bytes
 docs/tutorials/gcp_before_you_begin.md |  33 ++++
 docs/tutorials/gcp_cpu.md              | 247 +++++++++++++++++++++++++
 docs/tutorials/gcp_gpu.md              | 195 +++++++++++++++++++
 7 files changed, 529 insertions(+), 43 deletions(-)
 create mode 100644 docs/images/colab_connect.png
 create mode 100644 docs/images/colab_connected.png
 create mode 100644 docs/images/colab_remote.png
 create mode 100644 docs/tutorials/gcp_before_you_begin.md
 create mode 100644 docs/tutorials/gcp_cpu.md
 create mode 100644 docs/tutorials/gcp_gpu.md

diff --git a/docs/_book.yaml b/docs/_book.yaml
index ba841ebe..411999d6 100644
--- a/docs/_book.yaml
+++ b/docs/_book.yaml
@@ -6,49 +6,60 @@ upper_tabs:
   menu:
   - include: /_book/menu_software.yaml
   lower_tabs:
-    # Subsite tabs
-    other:
-    - name: "Tutorials"
-      - title: "Get started with qsimcirq"
-        path: /qsim/tutorials/qsimcirq
-      - title: "Quantum simulation on GCP with Cirq and qsim"
-        path: /qsim/tutorials/qsimcirq_gcp
-      - title: "Simulate a large quantum circuit"
-        path: /qsim/tutorials/q32d14
-    - name: "Guide"
-      contents:
-      - title: "qsim and qsimh"
-        path: /qsim/overview
-      - title: "Usage"
-        path: /qsim/usage
-      - title: "Installing qsimcirq"
-        path: /qsim/install_qsimcirq
-      - title: "Cirq interface"
-        path: /qsim/cirq_interface
-      - title: "Input circuit file format"
-        path: /qsim/input_format
-      - title: "Template naming"
-        path: /qsim/type_reference
-      - title: "Build with Bazel"
-        path: /qsim/bazel
-      - title: "Testing qsim"
-        path: /qsim/testing
-      - title: "Docker"
-        path: /qsim/docker
-      - title: "Release process"
-        path: /qsim/release
-    - name: "Python Reference"
-      skip_translation: true
-      contents:
-      - title: "All Symbols"
-        path: /reference/python/qsimcirq/all_symbols
-      - include: /reference/python/qsimcirq/_toc.yaml
+   # Subsite tabs
+   other:
+   - name: "Tutorials"
+     contents:
+       - title: "Get started with qsimcirq"
+         path: /qsim/tutorials/qsimcirq
+       - heading: "qsim on Google Cloud"
+       - title: "Before you begin"
+         path: /qsim/tutorials/gcp_before_you_begin
+       - title: "CPU-based simulation"
+         path: /qsim/tutorials/gcp_cpu
+       - title: "GPU-based simulation"
+         path: /qsim/tutorials/gcp_gpu
+       - heading: "Other tutorials"
+       - title: "Simulate a large circuit"
+         path: /qsim/tutorials/q32d14
+       - title: "Noise simulation"
+         path: /qsim/tutorials/noisy_qsimcirq
 
-    - name: "C++ Reference"
-      skip_translation: true
-      contents:
-      - title: "All Symbols"
-        path: /reference/cc/qsim
-      - include: /reference/cc/qsim/_doxygen.yaml
+   - name: "Guide"
+     contents:
+       - title: "qsim and qsimh"
+         path: /qsim/overview
+       - title: "Usage"
+         path: /qsim/usage
+       - title: "Installing qsimcirq"
+         path: /qsim/install_qsimcirq
+       - title: "Cirq interface"
+         path: /qsim/cirq_interface
+       - title: "Input circuit file format"
+         path: /qsim/input_format
+       - title: "Template naming"
+         path: /qsim/type_reference
+       - title: "Build with Bazel"
+         path: /qsim/bazel
+       - title: "Testing qsim"
+         path: /qsim/testing
+       - title: "Docker"
+         path: /qsim/docker
+       - title: "Release process"
+         path: /qsim/release
+
+   - name: "Python Reference"
+     skip_translation: true
+     contents:
+       - title: "All Symbols"
+         path: /reference/python/qsimcirq/all_symbols
+       - include: /reference/python/qsimcirq/_toc.yaml
+
+   - name: "C++ Reference"
+     skip_translation: true
+     contents:
+     - title: "All Symbols"
+       path: /reference/cc/qsim
+     - include: /reference/cc/qsim/_doxygen.yaml
 
 - include: /_book/upper_tabs_right.yaml
diff --git a/docs/images/colab_connect.png b/docs/images/colab_connect.png
new file mode 100644
index 0000000000000000000000000000000000000000..9c74edf91dfa433c6ccb1bd49ceb1c20dfc70b9f
GIT binary patch
literal 75964
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
DT$Ryu

literal 0
HcmV?d00001

diff --git a/docs/images/colab_connected.png b/docs/images/colab_connected.png
new file mode 100644
index 0000000000000000000000000000000000000000..d924bb393f9b9148a09267f82d7f8bdeb4e5d6bc
GIT binary patch
literal 32211
zcmdqHgL~b}7BC#M4H{bw8rx=LW5?P%Y;3l%ZKJX6w6T*NJ85j2{nB&Kx%a%^`yaf&
z=b1gT*UYS$HCVG0s-z(G9tj@_0s`W_^k;Du2neV&2na|&1h_Ydu#rgu1jIWl3o$Vz
zX)!TUB?nuOg*6ZY;&W)CCcKvF5O$VMTuclY3O(k72gY~JPh|B7P%5y>h|;9Fy(wsF
z$HRGkRyfM#`=ud%Wpt$BVIiv$HFte}VYQ5hc{H@PqEM};bnATUT&}MfJXhIqsh(yK
z;NvZsk1fU65bm2^7P@ZCj-oQO@iT~n!UUXp!W);SA2h73F~73T{MK7rg$T*}aajE8
zaqr$2i>On$9~wg1pWB~lYe!_|9Ykj+b?h#*u-ZOD;hrp}n_zFN3NC4{6&AN_=pBt+
z&<C#fOCNh{$U5JB#ZMeb1VQH5qaLQhw$l&hUmzNru^4=W6L!Sxh2$qoMy(;gRd#n*
z#cC!r)-h-LhT9L_&epjx`bgm0&n%Rj&JmI5{yt1Q<TKUK&iJ#C?9~rSCQZTZ9(>MH
zC4BUvL6W(1jq#b!u!W*44C5hD$}{+zg6IYSR|usrCF0oPdZ|b^R?cz~L*e7my&!Q>
zYZ&_!ZZ2M#f{8)QKzq`lGT2PA;k}Q-<){}QzR|Pm1MB2@ITUt~D@GD(0kkiGN+)nt
z_dK+_0=aD8Z%LY8#rG_cqDG>uy_g{k$l}tIXja0<A4fu?)fOW@Vb<mcTYtagmUvD=
z8$j&c=#ud%CsoDAE~;f3ihsWo{skk9dy>|R*&qciw;XkDcnhT;)v=2axwpKRjQE?i
z=!_Dhm&oU0R@dVe;SAiW&4c)D_<>J*o0!rz<-^2WINL#V*SlzKBS@R-ju+p(nz<97
z-3mVnaf;wk>!*wn5tK#18zAOE5ClL_#q=aW7W!F}S{_xN1^q~%F#3x8ofH}2YrYH{
zJB7QQ_`B?j9JFW1Sct)(Jy_HzBw@%IU*b91>?l%4yLv-ANfb9Ed*Tq7mh&bryCk;-
zoeyqM9C^NOd)@v17rWhsxWDfn$xbxiBU|RF;XlMk74F7RvLxV&Mvw-fpV*1<L)`V`
z|6)Vn)LbFB!yDcz6WI8an|U5$mkAbW7Lce{delqU5{BPKRh=c@TGswG7c&iw+W$hv
zXWEa~OlH@+noELBj3D4C%%FqSlt(*y*8DrEi|cpLaMZD!<PgQ6i0Sf~ndO3&+q*g%
z%a<?S2{oX1^XUTommR*hT(f&Uf|s7M)`%_$eEyj~$BpE*1PqM_YT%B^UDUn>YtF}a
z&2nrr*f3`i4pKY@3snvm<;Ah?S?)3JDGt|obwzmf^_wUrjwXcF20X}NKl37_5VA~I
zU{232&cZ_UHAy}^dW_&c2a!fx890ZJLY!ywFf)U%)o~ElTY{syPki^v#tShzsm7u0
zTm%#u8I%s~`uri*Kcv|e;Xz;+LRuRMR{q4e|3-?2)bEEI1EKQMR0~L^yQjiTGzy0-
z%t8Z8*Tq|nZVk)#len6M5auQaF$1Eg3)T)#7v6Q_@BoHM1l0}x5gmq%j6EO<m$Wbh
zYx8R}`PyfQ4`JeD_MegBqD;w*#iK?gvB?SsElnwEiAqF$B%?^FV;n#8IS{yqIFZ@L
zMAHPRDC^DOHb_e4uhAe!ierGK&9QmkGl++Scg%UTLr=wyz!>|m*St&LI>kL%zLuE0
z8-3^4+s?v??O$M=nu3`go@fZvqSWx`=>GjcJNM1mgv5?qVIZ}cLbnUujeNYPXv6UW
zcrWRNsvq36sd*9XhWZ*POo59|h|mdxVgyAN&YY<vM?-N;PDqvE=UEbe9`*SnYY3+}
zQ!|cg$YL*`7uY-2t8L6ylX;)AAWI(m?la0qUzK;EvcuF^@tiTYu~G4rF}%{=mWP&w
zmX(%9mL-<P4S|+GOV8P;5<O+l!a2n`a-CT3Ar@0XcPe*Scj}f{uh13g(;{<KYns;t
z7#U6=WI=|C7>`7YlzUlarA_5&zM#I|cR_;=-IuSAfSce$l44#pPulb}$wbv;Rae#Y
zlBN<{3-&Y)hL9wgks^j7^+|;(V(=sTKE47z;rq^h{z#-q-bgz9D)yl?jWqhPp|rp>
zU|KLclZA^_Y(sg&g0^l&i#C?FRK1PmjpcNMUcE{EReiF>*{opEi*E3DlM0N|p7~Ex
zi@A;}dn`oxI^aboVsCVB>KDuo)#PHU{E^AAIfmKQs^!Av{G$B5%H;1{VpXDN#rp8j
zCR%LV5xV_I{UZJE`v=hbDYPhHD3YRz@$7-Uo-eVFB9BlnA6~Ryjvh(gr@-aH@xYb6
zJA8jiuo-k4wDrD-z=nk%xFDe7`hETL+F)EPywn<tXykF^W&{ZDgt^sx#>(25(1xC6
z&CqMAc{#x7gK6BC+PUo%>EutV>_62^Tj#Eu50DFq<NHQ|No+c)0w75cI>@2!1oQ>;
zvdg&}x{Ew!HFl<>MBmQ9$}p#0uXU}JrX5w6@dfb3eIU$w=L==MwyksjVMjxxbM1}s
zk;l;<=OZU!x@fv(x@RN%vhcD+V`Ag{afr*B3y(|s3FC79E%B}B6Vj6`O0j>D|DaKw
z*b_}RO}6r;a$>#>uL=<$3N~ss3N;f~L0JJg^Dt9CvXL;8*JE~{E&m6%C-)xjnN#Oc
z-WKZ|FjqEzgh10%Gs`OQh=VIlCuNzx39f1W6y+4^j^VV4f1h}ZAKSCu&Fl91GQnfc
z&BYzyQQ-OIvh|?ii0G(e^r;-Ri+aH<OEG=|-av8PYu&%o_mSsu=l<lzQ?MTtVK_R@
z68$pv((=0e!UvTCc>uW##S1kC)$%RzTeKg&-@QniUslbr)?&GLxn|dR*VM0`uCv9?
zW1iz(H2RPH-#>n5P@`sNaWdKWXTGW~uRg5KvWq?kY>c4?gbaqLqjT}}6A~ANO|#8e
z9cR>3#Lf)f4@SmD=N;#NSB~5Q+nWqj;JGp_(P|Uwkw6=Bvsf9Q4lMO5gugiR+j||~
zhg~Rc>287sGDC|76hqeuelwDB8%cDpiZ6@18_ULlRJ2vpr=GTBwr7WkFeDXI*fvDN
zjKXLN$PyFM5?bjRT#fg8oiX^P`KQ9BZRBcG*-fTehJxZ9sYx>Pcmnx$lz7Pmc)V>N
zscqgh#Vx0I4J{;0_LyAFUFl!?-&;NCLHTxBcGb!K9-U2{sC%xPGj&FU4g_}FpzG8t
zU-R;jds^K-Wu#=R@<6u?wKTX}x*xbp_3~~K+8?RKm#`H!$`XF;i;J@8oSu_Eij|ac
z9YS0D2oURJ<exD}SRVF`5u!(+DW=&^&tiW8zdOO(#KSRLn$YFF0vKs+DAt_=+5rr8
zV<4uK7dsTI@!OWcm53IGEBalmv7-zULEj0eVZRL69}G_V%^n*D;c++|*myW&Odii-
z_o%ad_<d8G>ESQfwt9X{=nNJ*hmB4>Q%sc4aaRT71;B#rq>H4?-;+B7mn85>W{kEv
z8!g5oGMh3N!vtkenkRsYj#j&yEsm|ZnF?Sf1K?@C_0!RKVoUNDJw*VM!MZZB`dW3D
zL(lO0Y)&LD{VIgY;#Jdni-W?u^oR5+Ys4j$x>+}?gSqHs@nxGYsO$Qg7J7h2|K@zd
zf$2<XzKQ4U7u8wD9=(D#!87c$(*=yCqK4tJQp>8zHLO|lhW1t~gQd=qC$U?u8SXjj
zD&R~KF$DZJy#8~>>s6$GEW8eiJ4xw7-(j+R@IkQbVN7ePv%pRFV^mN=&@F{YbUphc
z2l4Cd!ThQ`NFGb-CaRKKl1IbI`j^|r#TrQ3@h-F+BU-1heno(1W4mGQqT)*txniaO
zk;~&Y-dyUI*~<iH=9Pf!cKhAKBXSnbA)|*b|8x3)ZSXSx@*$(Uo@Mi~V@r*<+*1wR
zH%$fI_bnce_<Ku%N0al*wjbA;o!L%60}QVfdrgkEKRQ+IihiFydj@z?-Zh*i3ov^q
zJ+!T!H4tSHNs$Ecx8KvePOc8L4=`m9W_cabd&qcd-;Q1bW*z7E<n@g7k`3g%CLdHT
zYk#!eqn-$HcGP;`jAV=W>K~_qrysN*J${YVHo@7t{@!`jl(n@!^LKSWdt6Vx#=Aaw
z`1P_eI<Or*@mS<b?oIpK`mW_dc01V<+8rADLuCS=8|F_#F*Y_xw>km{Z6pXMx1bz3
zwKZ6HSmiYXc=UTkEq4P#OhpJw!y@kfx^zfxi1Zt;!S|kh=z?SjIW{&u@|3l5T$+?P
zSZe_Y-q6stk&vVuQ0D+%X7CSp!(UelxW`{0(uzKv<sgxD^Yt{M!M1jQro7HGY0iq)
zx9`1CG0~g-&z^iC1@mG>5PiIt-n5S}pq4a9ULJz>t&9Kx1Bnj-`&NQ{OM;LD|1C>G
z(m+7}1&4xw2)2NL`MZt6TmI*Zc}su#{3nNw3xa@u`}g53x#d9p(;6x*2l}5fq~BW|
zgovt`wDeo9YT^I{+BllqI;B|RIKBZ8?LGtEa%{>!2~t|+<M|u@ISVx{CoOq7UK86d
zj7Fxm#z025FLr<MK=8Zqz7@X!os3A`zF6Bh^12C-|J8!`t^5bfL{9ow6DKPHaxHl!
zQZZWxASov!Gb1y(AQCAlDZhg$h*w2i^6&0%{{+a*ot*4=nV4K%T^U{37;PQQm{@pt
zc$k=3nOIpF-dZp?y4yGzxiQ!{Qv3(WKX}A}jwTKkc1{+yHl%;>8X4O<I|-1J{~74N
z-+$%_bhG&1NH&gtll4X*)1Mk97Di^K|Kfh@%Krz-t7PE@v<8S<e0f{5w=o3SxH<X%
zYX5)L{BOj6_0;-bPfpJNqvyYB{{KDI9f1yFwqM?cbQ1jEcKto<zbpUl$j|hL@_((w
zf0p?#=-WCABJnf*ch3Zo(Cn1--nNm@LR?YpEq^;?e|=qVzcg>@PyUun@g!8B-p-3K
zgtWMbnj7SCCcIaM^UHux%ZT2sLOhk;fz82J(M3-ra#^4vBxK)(D>J4N45oxIEc`FH
z6(kyzq}n_BGB9@Qa{b~KtIf{u2mbq+;H^0QeoFbrmz&uYkKLyh&#Z~7OgsU?Y9pA4
zujtHBl0Ok}At?-Df>MNo5XZ=<EW_FU3wvu|hmZoUXY%`3!w6yRH<%o<hEDOnp<fZ@
zpHTk7^bgwafnO2F>J1wL@&Dle2l|HY?BC=5KY`9L0HIu`4vy)^In<ioEu2QB7ZKgM
zJ5D;+Y;H>f9*dKq$e3yGCd<8-AiY*ITER|YaTYU{BlfYM^z>eCbGv0gBY(qe8dxqe
zULN@0mBRf-Mt0t7620+I^csp)B@onLwI<xx%+EL<jYWsAWI!Ov9f$aX1i|z!r?3@b
zbrn58bTx&w1PK5T5$|5b)zlBm&=tJHG2U%ot)38(GCEagLmj$(zauJVjzTG~lk~6M
zi$gQFwd$+#eN|n#SYE!kys9$J4wP7M*8eo@Cs^;~OinQpt*LL@y>x@_G{8E!75+0h
z^&1Zd?Ec|C+@_#h7IUa58#2)bTJ4ns+M%UXIbYDY5{_RN{b=S7id%u_{DqUBTQQmO
z*`{<szZo#ndL~xp%>PTLH8sqVwvOGA{QTB<whu{}rC10YD;hFzBS+7%#?1wV^#v~k
z1OW(ybvxfkTu{T21c4Y^+jwJ=<0I27wzwlnVwK=!xaD0mAoMmE6C&tDJd23{ucY|+
z+JtF4KnWTqrp;%c<J#W?)n~yI;tKj*A#t3!JbCwDcK$j05kIvk&x4n3dt5tT-m}|U
z3v1-SH$*De-}Dk4Z3o}d{v^H%Ll5trTuc3Sdn(F*LB7SNW9)Sz_7OW!h%L&`kWjTq
zjckCVFX7NZuAHX7|NW7&u2P7W;=9~aW^El_CAF03Za;oZOj8PMWD4v^@}BHS=%_Y`
zU?R`C5VE(q81H}S``27Po<EjVZ6=-R2Mv(;!pK(;4PFA7vsf_*4n4q`vEQ<YNp7{&
zA`Xp7vOJyH92_jcGgJNz&SfH~+_bcG${d{^&f42BZ*KGu?zaXD2)w&8Wau;4V2L7~
zaW!>e#7!1v)`I$jG`9D4^VG1%YM~f~!YapY>Kht+a7MeH^=^CY&3q8IsO3pqR;bv6
ziCQYa|KSjCHyF1J#^)tGdy{Q1D;l;=2G<I)p0klGUPD^2Z}*XVm|Bf&DgN8BAzT`l
zl=8Z^Y;I~GS|FL1u#XX%fZV%bCK@SCSIkw+IDrcqjIXUqX(T^$pU$GZd|?*xRuM>L
z?3a2c@&@z4<vDx;$%vwvL?`t@kCR;s<H8EWtLNzVY|r=mJjuVlQYaE?T)#~XtEpo2
z-&5;+n3c7gM*R^yev7+1!6*UG5S1B8gs^){DwphTqDLlEhFnwV!qHtr+)FW=lO^uC
zOr^~rLbn6cy5I<&T#P8(g>wq_OqqcmT{fcDX3(hy&B|oBbh8YiIvG!w&MUL!Vjfu$
zphp9lWmlu6F$O4vgpj{{85<lMl5ljSGsa8x8r#k_<b?VrN9fbdbAK+4gR)G<oXcZf
z{6*ql+e>Np3Mks_^!)w#$S9&F{^zv?2Ch_UU{awxg4Bz-b-0PDBefT#Hj@~cDe$p+
z-lpxcgR}i*F1<LF9~K#h(NMR5B%1#c0V#YKyfCx<5mr8f8$F&%UZgl5I=-~*S9m=+
zu7!w3I|llaOkJ^L{suPYcCWIEk~p#%#Dy?~5%U8LrbKf%;24huGZFJA$zUH!+i@hD
zpyzBgA=2C3^jp+0{_ow4P=_ia{LR9DAKhjVdCg`Wmo)4~h*2t=N=YmZw;3Yot##Qi
z>BNjWn4R8pFO8%SHhDE62;KDif;eDFCsRCY*nUe%Ma2(C-wUq}G$9^<C@{Fc@vN*(
zbEVYPJjSn0J6{EW^!*rM=ZV~(7-^ylf~}i0Ilp7i&#V7g69$4i5RDE*I||E>M3j`E
z3@o2ml*jQ-sPrOnS$tB;cnP$c_W3MlUPx3^@%JnCpEEkn`{ML`G0vx~ALsx1qp0%d
zT)apVV|B=WO-ynwK8z#Ih7AsE6I2Yp?4(gSA%7O0+x0WjmEXUh2a!PJDXG#IcoNde
zxfGn?VPW8<r7(yQJPt0d{K&b{PpXAEb!Fk9qFWa~p`*WrLt#v_#NKe+t$3re=A|>2
zkQ4CG=VFEiOs=6Dm*mr1SALO79VTOOaiq{YdHsrtL8WQZ<Q>&Fv}bT^E!+C~_Ke~H
zbSnSLh?xr!y-uc>Hu?!{gP4eOfi*FV7bx27pDw%6M>A9uxLgrO-btMA9!i#%o`Dw0
zki@7iua!bnNQ_0t=-Iz$MUf{`4g=p&25t#@o`nvFIk-R{f{anwhGb=xblO5~u0aE}
z2X|(h56Q`fFNJWeV{9z8YhFmp5cr3dEET+{Y*c3X{L#z8WfuJ7P?>T_rK_Jc`C!XN
zi_<xqatbP7uUuEY+2=}dZ>PlD?bn!nKjBUV%MobnRR50v4aAj;k?hUQ32*$!TwEw8
zTO1r##yHWb<XDL^6NGqb4Q9#sxxsPb_8MyeiQMdhpxRW38HtZ+!3<O{kftgj3b@Js
zsneF#N1K_|)LWeDc6vl#`zI6i)wDj-ZBv=DHr6#1z{)0fhH|ZIe=|#>m-wQJfTc=B
z%2kDcQA%ZU5=NQA@rk5>$LPLg<!dwt2b+m`xtX54jR;(L&ot?<icDk*Z+=kfJ}eC*
zT^E^Dc2M6FaaNKTP?U{9>r3vxFKP94q^A9^Q@)<PD-%^67!ky=m3RG;wNgB7kM(tG
z%3m2Mdp1yJ0{5}+l)v?_(b;37nmP(9EU$*XxMYM$AiEky01<bYsT^tbw(#h?^_7%_
zl?P3;>~I(5u7`|WNl5r0oP)F{m#P=hvlKhpG4F(K-z9xn`Pv<)BA3mQ?w3dzn>J^7
zyUlM}cdhKtIt6XtA5iN;-BeT8=6?jj=VK^>?Sl<*f>%=JK(S9!c-*Gs%5&JPClfM#
zV~m6)4FBTUBQOfQkIc_|xxs|Fi)gnLgZm@HP}=l~_ZSo6X6zUYPI_el%F)rKQ9~jk
z*p|spt#xz}o5%0y)AS>wN$e4J$1}&ov*^{-)R?L2U;_gs5WttIsflA+!=#%TOhx7y
z6#9;=CFuDl3!~%0w(WKJ6P=fwS)L{w`rcNEe%6}qzdGS5a81gFt*LNeEqcDEyst?F
zvVX8^MJS0^itwJP(`sVN&J0NL59qGd-8O?)*5^Ur^WNDd6SDq4N%^@zX}9V;&jPCE
zJV1#uiyQ94DdKARcn}tRF=nvt!B*LPJwjhNt|beKY682YjBFlYj5vac4#j2p)<=g$
z#EOw$4IvgUn3uY*<IPN`wHLpYmcKh@X@Y8_*A0>8s8d!4_{q3HsSu6IX|vQ_T>?-_
z;N1iJoRZ<u4IN^HiqQ1DCP<DXHOh(fD&(~~J&1g+_I~7+bRcvd)4V#I>80>^3u2F#
zcinH=L@?dt`dq=`tE4t4<l-H^%Z<?(MbmrvkTDxyI=O@?^_4@=F*Raltn+|`=j3W(
zD`zVxq3})m?z2GtNBU-VL8J%N!WcYn;ykT%5!kk)^PM)EWKT!Tq3YmLxSwyPnp<0o
zLc>x{TcHi!=F$k^_)sme*B~oJxQyA%jae5gryHg2hYn5Q<pWt!9mCtIg;tjWu@Z|@
z+t2_H5~Hk4K>odt+k3#tj<KD|v`;m7qYQ@RieDL>lIZg21iE*oIm5CP8owWh{#s46
z-5OtC55<|Ymh@4ee9ErsYokjty1nK}>Ea&C1hH6oPfHfHp&fNn_;)ZQe#HdYUO)SN
zs1G6!d4f`C$`uV;<ODV1U?u;$T5r#k*t`lpMoR?~vL-Z={-YR}r2l-mTSo=3KjGJ!
z`|OL699qRGKP~Pg>jep|xMX%SG$D-9tZptY3fl`Zq>W;tI<w}lOynI~BjcH{Nt?oG
zt;cl?d=k7%O$vXpLQ2Vr_m{5Qoh;?XO2rc#$SZm0NK%pJgVZgofYPT=>_zXMaIojt
z+G2v4nd(K9f3!M~lt92$HQ<f<f{gm3_8q}o6F1`LHwhkoCy;W%D%m1MH9j&avSBbM
z<$AhXTTOo)MdYNu8)V1VA}|^i{p1(HP;ev^UQ-Z3F!nv&cSE0~KbG3Zaxg0PZBNB4
zkXirMsF)iOpC9Lc^q(}Xuk9&h+4tjdUyZUoWq{ayiX+Yt)zxvc2lV+d(;~^V*)6^u
z8;f1ZfgF<)Va@H2MF{vVdfEJ<VvwC#m(we#)j8umFyTjO`qxy$(apM*Ze{=}Ds0d@
z^;EQ-te=hWa!5z>2Csp&U_P^9LoblNJ~1m`TVVVyBV~*^(3(A>f7he^dRVsk>>&Ak
z$*Sz)G)-NO_)uI^2PcZ(P|zh+Gm87joRh1eZjU$qn-=z`(WI2E;bFpy#s1elJ$C0(
z7**;bx=)M_oVA@b=<D}GLPWWIm;*xryGly+z<<=h1r!9Y6DxzBctyd*y{yxYyS3)S
z(z3@t^xk(IRSopv=mnH)rD$Cl<l=qDs;(;w#_qyJx_VLgad~>m-AW<oB)QO&k<|09
zbkh7g{OC=;(bWjEl`gT~W_dJ^4{PC^TpxF1;3$wE1iTU7o=POvkfY>-EXj|F3-IeJ
zINt85{anupQljtwguOLsQ_s$2{BYTHJ}tE3KNm&+{8Tewj>jO@(=X5c_=~9KDQXMd
z#!8G%N7wJFsooXbdT0XqKo~aP{o6(dyR;vxF4{vN5X55gd28V({q5HHJ^7nv6F|lz
z_r|4Q@)>&nmPCK<Q<Kg&KiZu&%<C%|N4wGp)>Vm<x@vQg(Xc3}B8n>t+$3yKCE*f%
zF}dg_x;Q+l$}7ycVLkA%$qVOC*^nyc^UqCLr7?`X)&<1}TTs5M+c7N<PTiA37-pmw
z#^_r^QEyo=d*t4(J64u(evc$er>tPF8IwH1JwezyiB~ivxWfX%eW0OzsW;zczT($V
z=^7WQcayQ6!Xr67b<o{g&BeCX{Q;-xeKt^Ri~Q>XM_*LmhqF~j`yzDfZom&fxzOH;
zU4yW!2j>W07-kfqk4=y|GDoTSPNZjTJ5(vsM~_`)l9iq*G4BpHS78u*_^Hlrvgr&r
zPRvx)@iX(1=--+?C3t3LySJ1Q3G2@BEZ_JciOC>J421`#Y1JkDj>1!L6h@<5>)X|Y
zkne~#C7iR@M_fwgCeY9d>y~e}xlf;!OpeS?kG&r^b2=<0{Sm!@#>II>p$l9TzI!F4
zLFPiR1aVP#dnlY}BK=_m9QylUngy@ts=UM1uu)S{MY7dphW)%>$A&?V=*VR(u3p4X
zkpnDdU5xYz`k^$ksM4mxH<h<>5)pj~gQM!KC=v!i(FJi1T4HSD0Tf|iIZ%yj4JWlu
zDMdV@h#qF5Q0JD*ipRhYCD~*i)=ir2;JxfyGEmo3%CBijD<FfH(~zqaD|m8JT4d;}
z%91Ry%m^;(@E-dFT+0e+c<)ooX@k`q@98U(?@@9JtI1kUbSUDO2t_^Ye=f?;X+@z(
zlGpQKx2;I7jMq`}yh<v*lX?tn25p$WlTV9e_HTmXM^=ZbM0rMKZbGq5^~HmHpsxKz
z^7#wNbBr;=u@*a)>jBbOR5J-)4Kos;x`SINy7CaMK?fB{CM-jLD-!cNQN$L%QIm9v
zepY1U*eXp~hH$RtxA9%LnFbf7XV~iLXPy*RBYv3$#Nu{ie%@5Mnc<|QbU;prk0W&5
z^oW*{H!It$W2|OOIMnRo_wbh?%86g2$W^dJ+vhdGKv)z03BgxkOpt5!dtgH9F$-h(
z^2kknld^ejP@%C9vg|Ng;SGB*d0h@^ww@o2(1XWx;aEs--u?N--sX9<uLC%EFkm+a
zeF^HX!}CJ@CUy^NILJO_*q^Sn(68z4%T2EzJn5dJ`QVyd?M`^@vPJckR`rdibD;|T
zewfJ2n^`-MGxxBFSaAdpVEOW7h}mc4_XT#&D_or)rjJ-mMu78%Mr{$t&_;k$9jkIU
zPCij2i>dV=rnGTE(F1neLG5{7{c2Dn^EKPbl2qdhjvr`0Novlys?cLo{AebWCzv<v
zD+IC6HX1tszcz4~ZT*5q`FZMj8u*yx(%$i`*M2c<qV>4My1kcd*tNN;#No|L+pjt4
zG5nFdki@w^{UUTiKa#SHb8=Lgj;?91&Wt!JY?Hg9jHuYQ-0awlr44FwTqfC<O#o$B
zpNXCUc&W_DwtH|{#Mcp=dR%MM*wjQJ)5T*nEcd*wE<|vx+5NBOD#38O8soB`mgm~|
z22Z?jDEH&##I|OD*pqu&;O%|k-bqkx<ee}ICJLJHK6PApD>U++D9N2i+Im3`i_dYN
z|AZ!*KPm^*5gzTdIv-`cJYPin9_zMK$))@<rB}@4bsi~|H@6XCF;@IYzs-79f#BK7
zDVK}okh`~ssyEi}WPQ}yU{!6d@ZLPc31%t5SV#g8fj!1u%X*Ndk;G#{5{|ryJ8&v2
z?~Lx$>t(1Ztu2InF?Z-v{$2BFlL9-ptRvRDpMt)2O|)#=RNPN*!Dw>reqt+nqeL^w
z#FYwK&;25F;bcKImLOzv(TuoD>_;a&&#b!JX{NeXwK)q&AvNqm0yc#`P-4x|dk_`#
zSO5A8EZ6h?9lLbD-OQ_}(cVz%`3}ofW@gYKVA+w7p;$JlbBv(FzWfNUr?ugz+B~^$
zG^$7#1nJ(gsb1X?UwMOz5j68!8?tzA@H%&5tq$O%DW_tG51asT{&~v3EBt~Nx`(_L
znq@)DJz#vg%KpuNEtF|;b2uB-Jj46O$!K=sWC^Q&yz&Y@PDb;l*25Dyq50g_{RT+O
znNv;Szs{E=(96tgL<XsR_U$;DxbOW$tz<qmCf9VeO-_R0&^oyyedoq#!n)js4&=$t
z^GZU=16zLwAA@vvn^{TNX2PrO0nkbHQudRR;jyVi16zteq7dWD4l1)k{A%e(Q`>On
z$_)YuY+9h}Xmo8K*EFlo&!h9o>@o1u=S=!!ZNHXvxAJ1EF?||%w^sZ`_Xqx!`3pS_
zgZS45=HIvAt>#~4^IKt#3KAm9#I;`OGy!7gQskqb&%WEeGsX+FB*Tcmbf}vg$~)Vl
zElb5Ckzm1y^P~SUv%1#*k@{A`Orx##aG=KaF*N%bsqn1&C<o=o8^7DAOO5<v`7J?j
zempF@7%_OggvRh(-3leqx9`K!p^vW(u*4gZw6(cW^xDJ#vrciGc0Sp79mpCuVEYab
zxn3W@b%X$oUN4h>aEo3C;^+%YBaR6Wb|8)sx1Mg&^A|UIy%3@6>q0}`SRedWqWRie
z`+?PiphRwZxqW%*sTP#waaa=7*CMoBh$~CP$F(6lr$qUD&DF0uH@g13%e7puesx%7
z5S4D*j4e-Z^8JYhQJy5b{@nR1A|H|7@uzWO5s3%ogt}g3M`*U5ht{~o168_k<vR_A
zw8fXbfR3U%Oce}`%F+QhY{iL)9TWVDIEnaOlLLZ@tus`?uoCyw=Et`AJg3RiK_e(7
z%_q1paHLk7<@?O-R2nlVMaVXo#3USwrjOC;;eO`Dwm;LWIs%(G8@74_!>dhKt=t|e
zs4Xf?Ek4rrH%4)KjIu4#b&N<)O>@Gh8fA@*iwR)nEG|lzTP#JiLsaBowh|oSYjF#H
zJuH<WblR3)*gLQARC#<nO#vT=M|p$(Sa@)upd8{2?7Coel0M?pmPeBOz8`36=fYHc
zeclt|!=Ao5nzse4Ff^?|wM<X5Y~MbQyLN8TKic{}5$sN6uOC^~e-U~ZQp}hDK4b`Z
zHeT^7o69&o9~t~MhCG}%cRmPMIUXQ%jM!Q_k#~}bc|CRg(SxDLzcJcm)B~5m`YHz)
z%YNRbwm<KJ_cd&rkx`mskDPeBBnq2x<zpYZN{#MU949&ypPihXxc&AOeIGG2DztYH
z0D%a{jmtLUHF8P&*WVIt{B1v*XSuGq%Rv}<86b)E^)R)ci%OYNrSm6_i>y7&Z0XFx
zH3IJ*0QI2Pttwwhim@=r#}rETt#-0l@aPy4I1euuJi1~$X>DOjB<})^ubCzt4kAN3
zY6GX}_~|WvsI9aS*!;%7%~ICh?#1fBiYGN>nj7RiQq$=|L6yAoYX+H7a?A(58iCp~
zU5b-TLus7+_;|l(n>0yJ3I!wTnLZZN1og(8dow}A<0)~T<^wWICgNwsju(V1?-!mV
z`BLEwy?`Y#`HXNb>+-I}Vb1v0Kw1VS;I7x#Az{q1WB%)f9#o?VJy(zb7$VE}K>gM*
zySFg~gW0pohWp^T$`cjvBRd^@%*C4C^+yN=3qd`dG?8Fd6_X(sipQpJPye9&;%y1w
zQWSjHW(bwUpjLSEDhM>*;K4KZZAA-p7C?_Knq^0hF#Tv>m$eTpj1wJRs1f($Sd7tn
zK6qRAZ_#Qp2gnBZqS;Sw-H6n`me*fzpLV~P-o^KY<M5qHpRc>Fd!N-Ec3ckA=|m}~
z2$TVDJTLli)|=kl^*K?QedeFY;F<QeQWKD|F4XR%NxY3K36pPno@}INbtXk!wMA`z
zyhJwNH-slmf`|hjZ;V9-fE1YHv3n5mq9jx+ujJV02DGLI2k7mS=xOPG)(Z>bdpcD2
z%!rC>6U6ALgoX`=;&NFaiORoU81&gDN}tP*`kks26+hngj_r00mB=|$j?uW#t&sQj
zn!6@Zp#J+VPTiS%0A&8?*SjHOJWB~FRSM&DUga7)e4F2^&RQKd(6uje+<AS?H8vC@
z<TVvQ=E3qSm#}RFnOUNcg2<&*ZcI~ACFuD~dGrc`P~KbnXw@kV&FBI4Bre{o@Ojk3
zCu>nhrF(18AN^K%9p*#4+sDU`uTwnRpx=X1g0(;_-``K`P0hcW+Ie6UP3>nqG%9ru
z=;i0cD9I0u6A$eI3k#D+9v4iao$0GNI5-r@V^>bB=F07{UH39wc>{YpMqU>N1cQ<d
zd=>$FEqhr<T1-F|pZ(n6^QZOSYY%eMbdVz>y>#q1?woajZ@c5V_alq$f_4zOPWOJP
z$oF}RBx>Zc%;1IgcHP%^Y%^rp*5@kym}Ja&MXs~;Zp|~(+fI-$(6<r0Y%x1dT!$`^
z9p9L3RjheBqlBKR9@06YF5$*Y2GP@>%}R$QtuqU^HD4g)8b&z<$2kBbriXbl`7Y_x
zVOQ@IKc<}s&qHDgXA1(}O}dgcN8}#FS^{P@0v|*E$*R28>#z={=NT&;8;+Uxsf^m#
zBDz2X;#h?8HLUExriQfJtE5&KP4D;2;Y(JhdiF_$MSom|b7zA2oE*IU4CQZSKYXyC
zGL!3`m3cf;5Dg48M_l4s28|iUn0@Ou>~N66!_Wtr#2xueIAmq_^K5e)>SFt@>C6GE
z5kdVL^egs)tk8h_OV<=r_7EdcN3?TmjXyi~a}L1`<1325wG#CR=OTaDj}`5f{N4vs
zq7w!<RgE#TZ11^L%FIxa(scJJX=<KKiTc{SJaR(&UUcrm;(Wp;2isE{SA%v@wndlW
z59KiAEp-#TN9A{kzm&h(bI}WDG$@?KAbYQS-#Pc@&26=waztvHTN3!*lo?P)vN%U)
z7b?qH8oPZx3?5!8v40cowgxGpowB0mgoNIt3A=ecSIX6Awer-{2yXyKA}-b4lR2KF
zWxr|whoP!f0=B%N<tJNV8t!!SjZu)U370IMM9Oo#R4!l~R~Auzc8;F*uq$E8OU`t~
z#K#AAxD<J^!RNgn<rYh)2k#|y5?MOl8o|0d!ALTAYf?2B?`ro~2*!9<MCPrj{f$d+
z_t?G#Dn(Po;^uMS8dhk{U>mvcmgS+CtR-%RGehxm^#|23>YVVoaoHbU<W!1Ap9-F7
z*`@dZ;~^tCfm0LBvf0u06JCi1pC<`Md*G;WBbn&LrF7V~<lTEDj&^s0sEUf80}y9v
zcAc_cZqMMHi{HGJNZDi7e;%y;^snhK`6Y3PpImLKn4Q*_m-6ZD9D1k;Dut)a4iu1<
zn(ZkV+m2cJF9#{kmN8qpQH7rEGJGBnl=w|*H<0A9oRe=@7s0Ga3_80A3by^N#>&8s
z*_fOJN>=;NFf#9khd*il;A<CEO<Jh(+Mzp@(jiW~&c~H&*;C}d5ZCoQY0we866ATk
z-y&*ygoG#j`o}uA7A?7Y)mffKTg_Moq7{=CskNjc$RA28IjJ%dRis}E)OLP8hy{O_
zh#vw)<{}VWRDUwf_(J`O-qF#72G~MI3GJ-nmX!3k&&wokp@>6^8=a~b7i#E;VcZ3E
z%T<Jy!2{{zas{{;XXSqYs~oouz|b#zVWM9;GmOY?MH8U6-M*R(YqeomE2-!S05}3Z
zgf=jllpg1d-lA!noCwoIfwbAF6;gv-lPmifn)LislEj9uuyW{d^Er~p<C3I-8LDLY
z6f=^@)EJ>!I&}?f5u4UwJL6~-b@tnPSl|==@Wxw(er`oGelxgEm*tls6qDhzH^V<(
zqWoVz+<l>MCnDypYWf}rlv4D=W93@Pu7i}70mOaM!$c=UmEhwt*n)skq%bC}Y6#z#
zBZH1Q+nW}c>fUCVX7i_&4Xm^<2K5MwO(oHo@&^3cAWNP2NUO@0e)N>-LU~8s+o3`{
zhPUyaf5oP0#7f+`z)9e#Q(@Rqsc+|#4oH=8V>qRZt<GQ>@qgSRs9U6B6$+VaM5(U(
zK7CTuN{jkXZm6WH<~J1w6{I~y`)1C7q`JnOl$UP_#>w(TA6W-Pr#e#Q)wX_UJ98$b
zlF#h=m<wv%(Mc7rhqpZ9%x`ETV%wc4xJd}yTx?_=ZA|jf7C$<i1E*;#kO2Zb&ss1h
z1RRBsu4YT)Dqn=jv~m5@<CA-8C9QoICFXfN3vg-<#b&bmq9g=pjEZH=bOgwCJ3UI9
z>e9iNiAU8(HhdJpfD;@&-#hr+>n$RTw3n~I_`kv>9%X-80ggwYKFzmSWy(4eg&`AK
z%)8fqIRQm>1(WzJgaV!?d|$T`)Fz$Yj%9MZ(eW5qLBf0(sxZQ#r6QgZd8mRBvh>)e
zW#mQ((|8#h1weV@ODd|0t+7gDPOsY>!-46Tu@~xVI;l=*p`nrF_>Qt%>WF#%0X}+V
zMOwn#8abb*cS`e^Nq=ng+{<O!!pzGgAaF6AhOmz2{?c4Yv+C*=jSt%S!dZc;l!pC?
zKzm=5slPjQS}Pzk(@Q%ocA`=+6)-A@y8Grj<*KRS6t^GXj87C9)#1ls+a2vW^&}b9
zNKmIoA`zFhV$(Yyk~_TMTkp};CibK;R39!YC_ot-BXWCvz&YPG`Q00Eu~=`&YLn10
z=D$d3ZVj}*e})Q^1mP?1yC}I~U-p-^uyxB_6DHLB@bH|bq9SnS5v{ABh;Y@g{kcN4
zYu8DrYd<X{git_o_9p+r)2Gk;B`6s{g$@ZH$c$dt%-c~yyU#B!JI-pVbw`wE;7gHs
zvv>Y}IkQdmsuooR#<cIa&uA+aL}JpFYNyaHPmjhidQ^NTbNy~Sd7WhIu=mD_=5n1Q
z`|aOEFWZC51nZ|@R=oXDwuu!LecHv=#)3PSY$4dPxteuuy*)@@)PAf-qFlTpWF2e~
zU_QLNZLF+`w}pL718aVWq!+#S$6RSLX)dP(#zQ?bg|6~p`-r>pp5BXDCs}x~bS{2W
zli}>}PCHMS@!|FX_cl1cy3$1eh5H`C1A_MJhuyDr7|K*^6Z!R$x7Dcba16zQt!ETo
zz9)~)&D&FSZfxx7(+#<F^{Ii|{u#;A?wwvq29_qQA3Rg*+R-IQR<|>0j0DEv8k<L%
zNP;2sb}QaDVAk7@znQ=r5$2}Ug)CG!h8H^yF3)Zz!eiWy-!$3}HS>RbXWz)Ea_&W%
z8Vkx}4)5c~FC~XlTq^QIYeL1^tv)d*q_!4iy5N6orR-Lt8e|9&#LfMLPM7SZM-)$^
z#dZ}Z%V^KqP06{+f;-=$dzxk-X1vJ2ddA4Nm_N+?zFy0#cIW+or^Z^b?XVPaGo6)e
zXV9Ytl04OD!p_q^??lcGQ*c3Kp4^ASLWG2BQ)C&J$AiPD+Dj!k2dyKA=X=5#<>o#%
z52dl{*vuk%aZR&uRbRGfo0I25>A`d0W=j!qzZ%v0aiblHHtSv2QqT=eNmfLjJ==pj
ze7s*PnlZ@jQ@ponY=pAYW9qjoX{)`sf{_aeP6h5?KLyYR_YILpZ;FX0cvD&W^(Flg
zY79Ned|e^6SNIkvKf^9xS!}G#fFt-Dldq>`mZ!AByH_A&iGca3ejbjhWz&@ox9yqd
zsa3zrZH09nW&(CKAQlJyTF|Z!pXnDWFC}H(saRy?5<1)rtDnss&(uz<SL-3N)_%04
znSP`P1>A9%GPJ!(-<i^CaOP|6?&DWo2=Z8u8Y@KsJF1ETeNYQKBnts=Fx!Yiq@lAn
zfssV()!bK%yzYnh_|vf98Qn5JUfCr0?Afm_YGC#5naG(z&#-|s0q34(m^CFgbHJ@1
zmy`X%yU{uUTux(lZ2A!ipZJX%J4;BQh+?L_5<bpah^$z3$+gxmqva)fOOCx$o09NZ
z_g(urJg+}6v&lbNOy4~^<fz2vZFar=prqZCUij1PmL%F3+DdP3G|lf2QJr2Hvk(|h
zmT!&oFcF;HEA)DUs;ww%QS&ahtzroM`)b7GyXjhO;cOq`r=$UMF})GAXyevlN3GLh
zI{c!7x|ERvaUE5nuq$;dw(yQgKJbUb-Ns~-Gymw`i#;EP#a!730gSXy`L&3DnIWL5
zb8tsZ8EAkT$78J}AF;eE$&d@;6yn}ft~F!Jo$Vcra%y@@hxS!gG8WyM+Af}*-qH{(
zulm^D|1=EPEfRXMC<3>(!oR!;+%B3ool?N~-y5jDxJnU)^BtAr3LmsgzI=Y;$EW@E
zg{{60`DOTDd7sQ_#6={|o|gSoI5dG9>q+5_zIW-GzxoMm#Pu9;0(A)!`vk*kA+BoJ
zi00kD$l|_gp_;HiEH?8e@r6xUN^`N#76lYW`&G3KL^JE{mky=wn7pH2T`V2Y7BFG7
zX}fp|;ecoP;eq0kDHI<#HBt@8Yb=K1;2V|X&d(I(z&I;6=z__@by)$%V%%lO=E~lL
zj8t|8u_VLRe}}%o%<t6V8eSkX7yBYmi#JlDoh{*%Xl4qx4_N#)^UG8a-9#L3Bvn3{
zmu-Phn;<rOYmc?|lX*H|P#|dd0*iZh`>OhP?3pvz0p%LvEwq6Uf<3+O51VC1gIep&
zQQMt|b&D3bwWE@cxLH|x_D)n;T52!xISu2Mukw~HH#uOGLPVy8ygn?es)doOq>x;B
zO!G%iqs?}l5V+$mQ(l&7swimFPvqd;%Wx!Qp=YVG5js5&8(ga$=cp)eq<yWlcCQf2
z<Fuzi|Gc<#_;mVabjYyL@m|#|bZ>2PXHVc&c^YyQvZqQ@s}{iT54fa98Y3Nnsd05n
z0IXY!JY<1k`q?Nt!WVz(5ed+L!yLGm0eQH(R9Cs7iylUf4<{p2fx~c7jJooOYNp3M
ze{~A|PC7kDxo`7da2|MJHd*p&t*(nPP>I@9>34`St5x=C+;TAJVU^r6w|M95(sPDP
zF7wTE&(=4}j$M?_jLXW}#bNc!sN00G=Mc98@@0+1i6o{2z(}ENu1vzKs*Nw=1GYDl
zvG+Ll9`bZ1$@M@cZ`u(jCodVKI!6Ci29p;?o$HE~k^wYEnt!($8^NC-%SS2UB&pC^
zcoHwWGBy-(^HQ32*2(Er@6QBPxI<e}eB(8sPmIb*EG=Ma`Lyj`L)v8>Y{prG1S=h}
zz*fq^6&BpwgUDR94p{)v?3_|&7_s-Ya&R51GY2L{sdk2qwRx$iYE1(zQWfK88P>S6
z*Pqa+rpAHm7J!nMIHiiJD%VY=s@6kV*LlgY{PMK5fYObn^GWcYF8y4Uj(_If1e~mX
zZIc@gl`4M{CJbP$I1sSsLj^7In~t6B)ok)RcogL^qx|ZWn~s!Oqn0BrRQ?G6B36%z
zd_gStGuO>bC<j6ldtTCd_VcESTzUruQdobTZ3_tol}7ce71r~^@jJ|D?t=I<{3Aju
z5V37WvxZZ3{gk53BbA@i*b%5Wa_xOX0sWgwg7$K^2-~u7&lm{8>-$us-p=mNHTg5|
zSmGFgy)y2G)3Gk4d}dfYF9f5l#YN1Yf}Og0{(*A-chKAvYS8!VJw9X6I-z=N?Z1>o
zH1z$k)f2t;`HHOJ>&lzywg@L7O;=*X_CI>}NGT>;NiSX~PpG^rO_FK_X~&K)90hxW
z_3T1I!#vT4ucy4~QJ(`h^;|2(bB&=mRIt+0H0*<A*d46=OPRgY)v+|H^k3Ej)2Gda
zoS<X1sMW5bgK~Kb44#&L8DBiMWq;UdWx;)KvM%6aN;Eg0k+qcwY@xRv=avJdOOXQ>
zR)%ZEp4Wi2M+z1IG!{@M+mE1W)7*0Y^wiDr5(UT<kqfQ$q|l3<2Q79E96Y^<S?jah
zK$iV_uCWOQ5orLdFJIzd{!v@?cicqvt%E5>@vnY0`E&vFE;pg9g>hX8AvGLIq$$w@
zSsr-NLXVEv;Z^;Q4M)lfcitjKupNi*BZf!&hk-|_1qv*9$Vw}<sC*;Df#yI40vz$#
zd!E6ICLa57Jt93hR^t__Ht4=o>jX{hq1*T&0@3TelvMCBDnt6*e>|&#!otq<K)r;R
z_~Q72X`&B4d}r-!f>)^%+^e1|cdG+$uN#9H_Q)SUnnITo<!5vA%(mlN<j$K4Tcd}|
zo%@+0!JT&Bp7&hb*jgR?(cqcur6OCeEdqrNHvk03$6{wTQskmr#Ur9I6RVe@V2AZb
zRay(0c|I`E`{gp+e#^D0h^0DMG`4T<$`dyZ9W;d+Z?=DXTVvOjjmSqyDbkvkUvCHk
ztKfd$A2DjlVcZ5st_{gu&l0r7jxCJ!+!l*)!kW+z6YoBwD5k6U^IW-@&Us*kjSR5K
zW&)1r53>@J!^!(=b`!93U8W_a%q7V)_j7c-x)boUZpO8Hk!kJb&wK*xuC&=JZ2g76
zfr#;iEaSC^AFAl)D|Q-htDC(9D{}PS49AX^o#QF`ei^^GZCv@5mY3Y)F@+gz$1!~?
zUI1QTDf?@S-&{(jI=gJSEwF(CEPur&e9I*z<*F_B#=^pqvo0pahNP+~bEYkks7a&E
z%BsvQe+>$P8%<@St~ipOzrAbJ1r#NIJ4FEysN)$uULQ1{wjL42p7<mU=kIDlCE5s@
zVkOPa5S1#I#;N54`LAX$?!jG8HG+i!AVwJ^Z-rx9GqbM(6Yl;!9w|OlhnQHvskD;r
zQ~L7p%|oCZ9MXsm(Wzlv3`v7LUPS&oqq`QM7QgEU<c4_)3Q;=pco*zZoq#lpI%eP@
zeONDJzfzP*$B0VMmugM-pA)rW@|Xo={h==T?X~zVfjgLyWC>&IcvX|757X%rl4P`6
zDFWiLI$ue*a<?WSH0COW%c;|`$Gw~+d6k-4A}><#QrPlg5)0xNMT%1!KsriVF$2vL
z?`(>6_XD|KkhzQ>S0wxe#oxR^kznk9!rBe3(PD5DZZyaz-?Q1>$@#shG7nK0@kgD>
z$I3OyNE|V<Q+)Nh3<e`a42+Ivw`ZLrUi5mGaI&~Nwc=n;(K?E4DY`_{h`C{55USps
zptb;39iAbaYsTpTp?F?BmE?j1O;%t(icss)lHImGpCPN>{Hk2<qT2GHcB;?JjNHKJ
z;uZ6kUELyI4<F?kRR*#mnvmUAI8d`I%T)&oThWBD2=-Ib6LL(fY|~?}MM$IRW*N>2
z{G64PduX&X3xTq-M%bwm>YR<Pf~z}~;|TKP5O&)8_hd<C!`;`PEWb*ZS#WO29dXr#
z^%7dIsfA;mRrasJ6NWMA^SL#(+^2%CeZr4h{u>4eri1LW_h5)0qDlxMjFeU$y6t;f
z8(aTDoNVC4vbxL@QI>F&vAFXg4KohCwXkl1nC1s5G>Zn{e9{kr>Nz2LM3UM{Ww#o_
z4CDf-VPh@QP8T&TR7--y24MX3(@mkZM6*hNfHhsOJevnP+(lo`3Piaq1!5bIzhP=A
zc2h+t)zjgzVh!ZwyM>WKM}k-C2S?6vuO4?=^Iu(eaGzzw+wbh)Y(#2i70`8{5JhI1
zo6ToO7?M3T?B&Et3#}e6>+5TT48{8m7V_yia}wZl@=1%hABT2&obYD2Y^X1sg{XG4
z3H{o8I|LEqAojnbd#b(BKNnz5nbQE+WAf*gmi%})Fn$t}VD9$eX1|%>C_}Zias)<O
zQ+dk8hR~$Mwblmb<0ZNlC2(9(`gEzhE^Lx$XnSjC-y34Rh5xupFfKr`X4hn<g<_8_
zwR(U&UF$w7Lx!b%t8|Hh9c5%P<jJ=OJfyIBqR<w~=UMTS9BJD0_b!H`fy}ZEU1E+R
zcqCS;nlJf}nXBO3eMq#q=m%t6-j^D5Bz+QZp`S<)={m^w^d;O1_iRQba!S@Tba19j
z!#~VCIWulI=WF^stn=!BOgMKy==WwAMIc=w|2wP$!5S4t<=}Z*b1!Fdd_P@N|C_<O
z3q^RHtZ9F0W~ThSJ7y-m{dZQ8F4DS5J_;usGu3D3Jim_da6CFZ!vNEd6hV=ZCp2SB
zUFdCRp_*A9FvvLaML8xV<QhumAoRO;Nr+`>%&{zqzb-FXGVROVVMhf?3_=~khM$jh
z8|}PdTV_?Or@u+%MdEGSQ^5n_9ngWvIn>#{XtwPy5ck-9AZiaSO~<R&8@HzuXRW%{
z(0htwi!8A+Yji3#SPQ53tg3?9LqhhQ6Kf}#WQ0yD4-01$W~hs~thqd<G+#vi2?6cr
zgzU4R<?E=*Z7m7CNcEN%N)uGg9QMC6lqv^P-Le%~e6VI2YE2}{WoB#iAH7fF%N!&2
zGzA`m-1BsAQS)FEGQGR;jM(c?A5qx$Hh#f|Uu>G7<^~Lj!nPDBFkNbdwZmbntw+k^
ztM$|t7YC5D2VYH{j7>@R$>D~TTm4)=^F=7q^}&1IvI5VZis{FAPi*;wtubeLZn)C}
zZgm3MkWvKJz8OjeR5~CjJg#$9*>+9M8%VCE@yeB!{){Mr-8YrnYrc@c93U&=;=3BN
zpS*hwEGMf49WJDSF<}Y*Av8i*2If%)!2#o&iZ+-gb04Q^EuxI+_nR@mOl3u4vP(tM
z{`Ng;^@=)*4tGEK>M_d9*r{NS)+nrO-LyT?&(^X3ubuCVYI5t=RYV09lrFvZE+ADv
zdI#wdLJbh<y%#}>Akw54F@TZYdq+V!gx-=MAk6?ls`T@^_qX@`&N$=VG48m3?l@=v
zOU6pxHP?LCoNKN*pJ(zyH(!67u%nF#I(kBLAAQBJmzSjje%|$K*tAxVQQ4+}e5?Mx
z?Y6*ZbpF=PPexH8ilso?S1!o#+n0OSj--AXZ~5=yYn*Q?6!N@eC`+0HQO-67^U?)u
z<w70((|*FXdDs?*!&#<M4)r{VA3Ioo-B`og-xmZG-Yk1NWOd)m%ATkNuj)b2OVy|J
z(icoy!3b4(e+ZB@=F~Dt|Jx-AOyg&J4l(*JZ7PGtIY<bcP_^@8^{TMcw5;KEo)~lw
z*LJ%`VPnU<g7f_3Eqc_l^mNDhLDQ#ih4Hzu%Jjjcu#^g`<ycT(jE|*9(B0`$P*n6s
zaj}iv`~)NE2rKehwOcwA&*Rgu0pv~uE-S6MsJF4Dy54*Jt^*7=13^4A^q=qYpWnu|
z?lXZ;c}X)ZYpW)WyuAq<KEC6-;Q7RDn7!i#udN9{1mp<~ZI`;t_VJu>kn<vMd<wbz
z$|&RcpP{fo?RF3s?Y}QV6NK0)Eunm>ZWkLg98?;SvDr8}mBBTM9?mRxi_u_sv#q^w
zLf5ud>uCFJzJ#wAMlVUOZsv=xeYq++`wn#aBX?>J9kX`&oLt-G>$%@u0lO}((%gRZ
zX4Z_w{=hA%vkfP)i^u>0zn$_8+uOO1rx$q+4;e<vWl9V?B0uG}QIrj1bP`7S<c2(b
z2DrwO=jO%+!WlD-ns#<Z_#}FTvOjNKXJb%&XijBgdE#q=2b4}&!51R(!Lz^%64y2P
z@b53^{4y?gC59jT+Ls}U&+~{VUJ(j{B<VCpU4>RY^5^*Ry@9Y2qm}LKy0-9*U8bF~
zf-i`+H|RUw`A@qB3!mnGA<%uH`6(5c@hFdX^HNY}t?CMq?Z?6C6wL0L-m%3Fr+JU^
zh;$SxIA*NN3wL8@q=3w8e@%kNZ`-oe^n_<-s^3^WM(@aG)MCx=wjx`^d+Xs?g#Fx9
zm$O1G^cDpC@!HOkhs*+quIGC$EyYe&s=V!g!Hu)KZl|PuOEqcNhN-&s6U(DYKXJlT
zE9&*aQN5RIPYz0YjXi1-oVS#ktFRX{ZH=3fGv5wK;_c*N_iCLA6&3jc(mmi`ryt~L
z4E0-|^@|NMAJ#fTsHco7vFz;;vi+pC(LR=o%=bT?Wo14>hnJ58N?jmxE1gkUwWiK_
zHX`r(Ri4D&AGQ?yMd*xcVs>jkJyC0r^{V#;zJa&DFdy}gfbHkUsBL+%4aCH_H&9%G
z6O{4J{uyEah6G@6`C7jTpC9fl3fVq-SMHfR0k3{zrA4lQk9asS^5(_i7F;B8{J!Yb
zmSO4hJ*gv<lU-|*v(TDGnS!0ijpnTR2iqHRVv{3RjNQ!(m9{+#Vmsp{4@%O*Md^a?
zxTW%*eqSGzH%Y*k<>|acR)?&V8PR={kW5tNh9;NqK79A?(JXh{8@H^c(us_&*aPP~
z;HCqcp5)oBxbPe&liG>kU$a%YS{TMhunfc2de`6guiuaoC5uv$U&x40%elvwJw;_j
z!5fyB*tIJ$)H>0&RLkv~C!M5>fk)%q0(DIEPiT2}$uv6$MCp3*KY?HNUS5jE?njIn
zx5R}Bh7WIViya~Pt&k(V%PDr3;dP_ZU12+&pfvDX;*e_&^3*?<Cqk61FC;w?HTwy<
z+q|G%lrnb_@k^W`mVtqO@6&wchw4=LdQf{4u{_c&k2L^$${uvmCOZCWCft^4X+H0d
z+|wVqz3o?>X&tV&F1<&wv~HBPS-pHsV=tDrY{_*fBEW8`NiKou&8|kK?qhzlmFJqV
zxwUw29a1aJY>A4EDfWAA@5p_4!TGrU@zTbdimq@Jp<=ApbZ*F=^km0AA;#K!WvIgR
zp83;j{K$Q7o`u?^k8hKo(&b~aSyPNhRNOM2#187ie9YO-iu4dayt04h6KSROvwX<$
zo}=%jxhS#}7XUoY&6={mV6A^_jdq_etBos1^pbPPoT1$vh>}Fx<PgUv8zD7%iMxf`
z8D?SX?e0W9meTGu#beW;H_b+AAN-FTzmrp}6t(Ph{iFz?l-#Plk6Iw|th{~7t$lTS
zRC@2)-W_$<0r7R~P05PoZJT%mZ+pf><*vUSyE<<XR1&ouyTZfG?SX!G7hESqmdjZJ
z|Jr^=_x1}RWv2965sfxUW|2<yi@%~1Am5aL6B=;k&0c<X)I;jegB&@)-XnK#aei&#
z0lpm&2f%mCZfQN)R-g&oAeyZ#C;F(USP1^fH|=5^oiXw01LPccE8tfY<wC|At>>~A
zPlBZm5kbaBr!^dWgI&lRpU#DnwDIP-ZdT>aN)2TT`w6+&Z61F9e1mu3(1*R8Zk*hO
z)?*MHgkW!We2*l3_GhzuC>B7MaUXg6|28uL9OJq@UZgih#CNl&H^)D9o7b(>xIVhA
zd*wCaN1uS2spnWky08t?d7@OUPp$RJ!YI@De4I63GjWZBw=BcVsMsJ5k9qU0QE6{_
z$<tCLqgui~cuMk%^~-y~BZY%vs}5`}#C1Y&p(tMN0Ao@!RT<)}YImjPFX@6o*W<*_
z@97(AQ6A-6%X!QuF5LOIJsAq%@UO^y&QEVmPEQLxenhV=T{YQ%C%!uPqr}HtuW4mL
zk9o%f0XO#AE!sPSf!TpQQyhI<w$y`!ljV!y1SN)++nE$&$m-<O!N&^zQ08GyS-wG5
zFYj7$a0sM-XmHS@dicwdv$C%mbgfF}^yyg$O~6)g_v@wqN`qua%+1BMVA~1qBd?Sl
zjTgfy-h)Tn6^0(zB_;4=_2&9<z_qfX;~FGfx8^7;mRmERHa*92(;QSY6<=aj?>~d`
z*%<oW4h*)9yX~H6t`n9zP5!;I4if8@O`I7sxMdsfWjI^#?ZC3)iF9nxu{0G3)WjS!
z8@~2>xgq6`Y}y}tYT?Fp{E;ZSbD>NB8T#FC7xC3o5K+_u&xiLZp(`@=?Bt_nu`8n;
z;cdhFmF0DJ9nj!VFYfo9#Xj^l1R63{wUFXANF=}3SbvyO@S)(RyE&|hlX_sLnqvDq
z<RgpJEqv19a~sUu0w`;Hxd~Rw_`l;az~XM<xU^p4(D{F(=Q+5vYdu=yN+$QVTyOK~
z%mW{P$=*D((sTkskwE;P8_%b|I@;YG41|oA(b>tx$7f)g<{V$(lfV9St*pHGb2doQ
zdM!3bN62PJz%l5`&{D1@q}9>>Z~xhecaJjk5HoEtmsMdYzpvJMHciYv#{Md#MgHv&
zM?CY!s63&G?$-@se%=yUvKCx2@>I*^?#*<m7i=+i2BREJ#;X`eGB-ci5B_x<`olB-
zCWR9NCi$0}2B4Gwb4cO;kBc42z-zm9jd|{OFM$8i<of>`JwkX)>Py*q)$9Lr(*egB
zTn(u6Ow^(``rmx;CbLEP{y|k8>;JNLC5sj|3ptM#>GS&if3rjt`s={%wsuhe1OEHx
zhVJy%><nM?4*KP^{<r@G4j*Y8HsOih>C`^}D}T0E2;I&EIw5SI?k<e{+e{2WfK2fC
zGTym=6KO#Nm}uc}sUb)7Us(mfbYxF|H(a1MF{%DLTDHKgcK{}8z<hC$boraD`!Mu?
zNC1{0U0)CRH<SC{E?!P3$kD0)k67f{QwtzRI^sQ&E$*T3Sm9Ja^iUP&C}5L52*4z)
z*y#Ns_g9+hEv|7*^7fL+N`DNR{`VUUwPZ(3O+~D&*~Ze#1kcX2@m2_szp=bHJxrJK
z+pBNQ$hTUkU%zXotb9B8=Nt2HAJfb}!=mV70E&~JK8?^qUm|nmlPj}Za;We%*}^#~
zC5v>t(&u$|7Jq#et@QnAW$L>W@uhZptSWOoH-ygo>U8F31b<)`5njG^NyBg%(u_Zw
zI0Ha<(E>Njn$^xNfHNfq)Vu0i>)DkU5<8Dh1602!{BQt*o+PTgO@DuX#Oy2{$olJB
z>ZsV*SjOkoytXDxyFL8DMCz$LU4)WbFSA_Q{baN1{q}7GPbYGf^z=wZq|Y3)0W9>5
z=Of1Ho2LK~tK;&JpOk`Pg+Js3$m9^;CeElnG7COg{Y?$%{ahZ`C+!$dF#=(lh>*$b
zUVC+48t-D}*K|XB#L$q2k7#zU4o5f=iM(#^ARJ<5hCWMeYU`M#3*mnyz6PYo<oSF2
zSov~;jzCDS8L;o+lo3(1LbiBKb+v%ovI0%;uO+dybn9=&XL_c2n)PKQ4@(irE$214
z7d+^oV{qU>K7CNG$UXp0z8!orXfA;Vd7JUrX}&(r8nKY30kwy58<uw3N$*pxGo7|!
zgYJ8*4N)F6*Z1E1EpqPF`MU33KYPFvq&(~6jx!WCucoGE=8z@0@@%JNMV|gtXL+Hm
zeMcR7xh`|n1#l4Ki;KAeFZXk?4YTKSqrs6jgQ=E)>|JBZ^eD_@M;Cg>_>QzL8f%hF
z{DaHtQ#u;KC4uj@Yixm!D$`IX)ChPDz&MYs<G{6YVz|p2arEFCn;sHpt{B|;`T5;R
zJ#BH4oyL_oX5s}gW0>E9Qv*;m{`Jb5sBIITh4u+eP{j7iTvpYDG$7sY+Kyy5d2!?i
z#-PLD-Wbu2leZ++pNuuZ54R)Bu5Jeew7L%Do#bExZ#&GCZ<EdHbUOwEbh}s1G<vib
zWL`n|nmzB^0shqPNg%?zuX>X(dQlYZ`^B#)YifL4_n3KIkS<;l#@QTcU}Us%b&0(~
zAD<kZTLqlA-COg`LL4AkZ01IHf32|#vbsFtGk5L(&;#emaNlk_ns*p^&f*Wr$$S#<
z_|DzCISP@0Ht!!JJ>pl?W+HSyKTXx5zQNAG4P4VtRPC-auj<mqBJ{)Fn68dNNdXy{
z588ebl4N3=M!;;#p1(1ajJIN}r(A}VuJ9cBDYT;1@rC>ngmsCsh#g*0mLp1wid6e`
zLHhdPdwYAyMssP1$tDF+)FTMT$b#f!XC$8Abzv>>Rno262`zMd&iZfW1v+qF^EXf&
zakStY-+8nbKv}%vB)8we0#4iv%P|qovf9@@UVTXi>=2n1K+b3(tg`eTQ7>8MLz(>h
zUU|Qc8alQ$e2{Lv;^ngI5f_vXLdW=oE1K4*q|SH0%mQ1vA&|e7K?B-u4vl&1jJQ1b
zBm?{Kp|c8iVL0=cy5?|w;Y-8>^}9{4H^;1x+a{cHtoArfVd5@mscgTsjDB{i?v^0@
z;db(@7{r#t<@QO<_R{gA<ldQZHXx`PG7TZ*GxsgBo}=N|auth>58ARGp{-fAcJ8?F
z?hP7S*fYJG&X)|77?00PKlZOZ%eG^9pmOwV0NYQTtnmw8eQlVVVpTRN<5mq?|0v*t
zoF4vjcR>P3u5iVS4Tf&?lI=$ScF6h9UP-ssfkL!P$Az@3*f^uG-qL9(!3mbyy{g|I
zi@HL?H3Ma)uyW?*9=v*UC(iI)qxL;A8uvcN=#uK0pa%~z6j~L1o`SxLkVjRU7swnt
zhIn~iVUkgig-is^hM%xo$F0x)jcb&e9TYu`+<~8;$PiL6WBuy`U>SsooShPl5?#=~
zAig)Y=3g8xws?26obN^7V<qLBFr;i0vK?~eF?Xj>V__wniqu19Muv^ELICR_?4`|{
zWoddry5e(rvM#wphCR<b`i&n#O8^Nr0iPXHJG7CRUythN1eKH)^EreB=ka3}x!=`n
zWm#@Nd8WYe0@ZX8hg6R!en#|yP9Opxk!f>u%Py4oadUCi4{@g@NPcHCQtDVs+(jU&
z$>1Mgu^NK=ggu<70BoC<(tacXHBD844WDTvVy=E`%Mtq>8&Gat+MWGTJxxNC)SY*`
zdXP^HQ(EJ?`7w=<19M&xa=}gdj<ddbY4@vs6F2=GSdleT$tHlL7j4}iku-6BeE?2S
z!C-vtC8?;WvcEs3HL~ed&(=;C=yL1mx6j8KxX9Z?Cl`ERxnUFcrpl@laP0!UA2YVr
z>>T9uFuIYK3oadR72l9Qomf!G>4Y}B!rP6oni(39=E2<<)r#4JcC3~pq8IicGwZR_
z=Z>ojmr}E~dGX`4loauGG;^F74gj+-tpKgxe{zuEQ9k4M9bjL0c`q4toRU2^G0DjS
z@fykh%-CsC3hN$zbahw}@-{V<e4PsB)g-?@oD1y!kwNBosqs1TGWB)hW2xf(gQvG?
zaY60@)OB@rBf*<e9~?5}Zh1QC0KD&K>+)~!@-<%TvZ!q6xp#J!zj~bKkeq}Tj@*+(
znSWcTLujP+O+M9e%u#q9iTjG%J6kmAeC+-uKyP!Eo&x|OwAVLtG$;;AD%$6(X#5s^
za({zM)4<*tdXM^pwBs|e#U<tL=%kOzsw@(2EQBECy5Z{1CV81akd27vp5Ing@3+fN
z<O^i4cF+&KU%z@~cG?3M^D)zbi&<AeFp_yifSDY0j5@wSKd1{28jlv9OSq}I;I$mh
zE<w*d()YxTEz7K51U<_R`q_TI$}f*2J(uu0)j$yBIG*E!#?Pr_oh6RK!PGh8uUtMC
z_KL0T0IJnB9@Ytsj%{?nyH8S&A=q)^_@d8#4B>-DYuNa!Td+}A4`7yygLVl)Jf7oc
zEA&_C$yso+mfsa^dSe$ZxrtS#v68H)>}(qBk8MACT;$@Ru{sY%9nvh;N@1bNe-}pm
zWm8Kiy|?R*CMZAnY+;d2lOsuNQZv)}n+WkBHD|VhsQ1aqiOD_s8MA;gl2PP>^ky~&
z&B0ZmE{csIIZidw>t~)ip3<2jU1j8;0~Vdgnqj9@mHYePr1>Jd9N5e^lq<7XG@Uo<
zNr1t?W!x@3JLm{HC;%Ve=i7nV3Hb7}5p`$SGe(0}41{CuyL5BCcj?YZD4h;SfWQ5h
zm2zueF~^%k;+P*le(e5QiI>k)4pa6Ct2XoJl{14C9S;5|AbF(*<xo;K<i%Hsmbj=4
z*?mRtIHys8n9Mr;8S?83ePnp0!uz!;uwy_#%YH^Z^D~_matZLcw%8J`9g3BeHIDO2
zS>`m6`74Vp#AXWI?8BjRfepE8vF4S$IGCUnd=3I_B1IfzQUr@uxjgh!6>>IMY*}_q
z9jd#Njtu0_cA9;9)T<JJ7CWzNwllS^W2qzrx$6zt^+2(#$#rx-P`c<~0;l-y^0=t*
zv^XG9IZsGH%a8v_Kg!C}i=Dru@JM{l^=67RX81J6QTq4^zOzl8L!bMHyP@rp)i@Zq
z$|5BJNPwlgO@6LsKzb_LFicnUVKd$)6N7p~z4D?uD6WnWD>x-M5uqq=_yA?vHxI)$
z@a-%YGbWbk@}LuA5XrJ>Ix{M%3ajAvPeNou$6S{JugG0447ivkz-kiwod9Y|;x^_S
zz8@WX{j^OhR~jY0IOt!v-!Ve5qoN4?q4aEU0;^B1PLOj0Id0KR>C<Ligr_-NvDh(^
z+gvr>DnZeDzBi}^Vh>`wAMYSIbx=%DI_@}62(I`(jL?i586+N_=l7dLS^^1+#ChvS
ziJK!CBiQDaxbEI<T`1fHa;LibJsCGgNxI3t08ubkh1a8mL3t}JP-ru?rYEBcN3%~_
zbgCloN)^p<1_FN0JoYWCsCHMCh5AOoaWl0fq7Av4JUrbe5RVImqa;1^5@l0gr<hFC
z#Wm+*aQ(hg+KI6zE4VQlHJM&e^;_*g1ob1UwCagpHK6@VT8yL4rmIKDgi79(YQ+$@
zx~~L8X(gMVj;Cce=zITod4tgPJw}1Ul9M7;0lt>vdPE3<dl667UJzxvi#ILn8k(UV
zuuuak)RwuZ)l*VmV7ps+#Ol^KtrhJ6>TGlL9Gke@T$3#qiuS=K%o;t6G<A?bOYBgc
z5^@NcQiy{mNwt#1YOz)yu;zJnB4n^8_tgR3ou^K(oE;-QI5c_!+-Ulm>#)%sRiQke
zI`(5lU~}||o7LkkPbrpQbma*B;qQ>tC)iWc`jzJ-hwb+KG602l<ZXGddh{yxyZ^K}
zxI^@<emGo+@v0!{UUCd#Qe1zFxNJ${szo$aVstQJi7@AjzRC0ThY>caQUOu*nrEx2
z5szS-A199Y+ZEuF>#lExx3!>zQGJtL$yra?LlwAT0Uz{&k_WrrRwWd=VI@e`(*(vM
zwD^c~vP}nbjG#XXU>a-POJv2TZY`fba|^Q)oBmwOF}HeVC`JIfnbNmRm}7DHaR%Se
z*|x#}k)!lcUjO#9&x)z$K2)H4HcR8tMqyur7IU=YtHWO89%NV%pd{DISZ{3dJzpq#
zfCGYppKgNd-wzhEH8k%`vhIpNwkJ_dO6DIuA&2iIi)7^VdbN9>$uqTxb^-V_&ZVp6
zH~bP5LSWparmtR!sdy>Sd4SHgJM0oXF~@e1=sS5VSKjlR>1={NmUdHwm9{#!X@l|V
zLa0uIi?|J!6AVliNeF`2TiZ}58-K|g;w1i;eK_0XDLW2lQZ@HZ^iZuEY_<&Y6f2$(
z)=$;E)~ZlK1qgiqGv>~)e%!0L4(f?Q<9+Um*72&-!<4FWY8k&&VI?`}4>r^Fv2NJP
zhwYi&=20@ciUgLND6c1aoDGmKS>GXYLX@!k?P<V)%&4$4{94jTqGNwY0@=H*1|>}E
zBSpf1tYm~<b+pwC@|(l)H$QsT0aKrHK5t?lDl-^oNp5LKw7k`Tmw}qTiYZ_yws{{X
zTkbVI@f=UMshY|{U_*lW&NOIkWk-!|J+<6WD24elH9#u|wGH{265kQv-)&GTO7a2V
zW$shW<aG+%r9MxHRf)aaxm$4hxc68#+NOcx<c)rbV>)h7mkojT<JJWP{Y+Eo4P{!d
zWNYviCLNk{2bSQQc4#7)LUo5g?Bx5qoOMy8tNeI#z^RU?vHO=n)>Pw`(Tt`v8MO!Q
zie<>H=6+XYE;+pk`zy~-J>oE{VI`}33XX9FeWdwSOu`K!iJbN2h{>BWV_5~GZSw0H
zIT#TL>gw{i11mM-r{ngkKhh}SZ8&1mg%1?lR&OA>x@Wu9adoNH7>nM2uInZJY|pHk
z(Iumq>IIM=QQEk`9<n_`g`4^1E2%j;i^_S3DZ&Xm!ZWJv8`vH!UKyNx;|8HgW6N6Z
zU(EVb$2hntzBl6W2iVX6s4=eGYe3QkfH%6y6Q|A_f<#1;lbK7>BatO&7Mk_ptIM&7
zuC~5@o05n06)F1DUm-q&Xd4#k#Y{y#@@p3x!VoVEZ=dOBHFm`aE{=V0s$P!?SKPBy
z*|wR5hp!R(QpF~+pyl$0H{-Gqa4RG57&=YF@a%h8*oSVaXx|>qCh|L=ZDQ0~Ta`+n
zIiJWOFNH}&WM4IpQTrt(pg>Rub`q@}__-f~ExYw%xxN7771F(?@<v0@HRM(F&Zy^4
z)n4}o#l)fu&j?#{!+wYq<eF>QioJ3PH5y`VLY{diAc;th@doi2RWo|y7zV=>97m4(
z?RSLy?wN3K(aN8=NyU>qC!=fSp^vW_-E;3!GGzMp%D}0_y)V3v>UhgBqCoFx^M%Y`
z84kQsN3+&BVc6*0mI|`7wXX$!irp&snl@_olBYtZ7%P|0qEj|bno$3Dmbzd#bqg1a
zwd<pXc9VYq^$ns-;__-zd+6MA<!WG2n{}qghWQiV+?i$$^=9YvR!bV<o^tiCId%^5
z?md{#%y-)&!&{PiA!LSyQOgOeQX)t%3I1Q~25;cb^_~-Tb<{#WO`CxlijK~Ane^@{
zwIGm&itt%NeW;pL<7!ZA#<%BipV-H+qI5mKSHch{%y#5_IQ*F7_)>}tIJBMs%bmp2
ztT09b?Jkph;6Bn_bTL+2J5Mo~XKpFY0uBZ4&!!c9`;%Bl4%}T@e!g(-r^DBp!QIhF
z-tBc5(}!1@>^l~OuK_(1>btZ0H5alLdRwTgZ3p%^)n{IO%2^9Mn5qaS1JJmYKGkKw
zUO^l@CtQ`&9!l1(4+AdIgKjqmQ&{hsn^%Qp0^FPlYHseCI#FMAi{=f$OkcFHs-3Dm
z9&c{NxGGkZCJ+ZwMSsl87CrmLToO55gl#O%Ck~I<*43zzY+d&LK(3k6TwGBRlIw*6
zU#dtQu|94fOXTFs2SJ?&ne-fQa|s`sJS(k^9N7fA_c;Pe*{p+drM5Lt+mmGW#~qz5
zV&eNe*J<#p#JR$4!9GvgPse8vL;?IYTAjc(oSF4eU69$aBiBVe+5PoYa@{UxQ3j+Y
zIzh){#jEzb8^)il1*Jk4<R%hl5|g|84U)|pW!o$VZ`4`&vm}dDR8xW}0;^xVYikez
z5XNI$+|vSc)os%{_!ZrEuI)$x8v_ktpjGb?VWl=Bn$3Nv*#!5}AdT&)vtIuCY2Zg8
z3va|74mv}MTLhv*jB`h<0ooChsC%BEh<81n1Q7_&FJh#39wpa3c(<)rjAbRsT1e`f
z430H~HI=>5sG==I=oh{TwxcSRT4sA8;o^Jwd--q2^f}`1-RlRs-a_;*kI}Ng*?0_`
zjn5c`Z`yf53CjHr7dYPxCz58&o83hHuqyYrL~oe{r8=s_79Ygg8*tr13{x4wn~?X4
zVQ`6*wjK#CJX0ABe0qE$Q9;{+aQM-)xp1x<1tie{pEc^S{pbmN754ddt8M)eB@JPg
zm&j@j6Ov5y>;$@c^PST>^!^?Ho}mH7EXR8aP=DSg^lnu5>V18vy*L+ZUXo6b%|3?h
zshkSA4r+JftFnC6XJ>=!1`H2cAo9^K?(pkarBO@65I2q`5hmwF?H#9d4)?nAIA>b8
z`PxKH`s>{q7x!a^oirgaJy6oj{HKtZZNL#7X)h@>Kh>WTYsd>r-K5RegmQ5{gGtWw
zPeHs(QhkqAM>PR%&&eXD>$Qdt=NHb$%5M>*+4?=dUC*&>bI-uxa|+*vS8van&Ng_3
zbBtL`mgVsY2hfHBby>XIBPGf~mY%)bp$wum$l;xbs<2H>j>HA?ovUsbF&#0P#GEgf
z1ML@3GvDOA)h&^UE}+2Iu~B3rocbF0qv#XO^@_t5&?$Pe+l<LPZ0@b{q#J@D+zQ{I
zS;Y`~4DZY_;^W`0fNyL2F%M(O9gQBt7aom(%g@9B3_F=e%$csY_ww%77&U>C#%4)V
zXW~TSljzk%NJQ$Yu9aa<9_d!al2=PflH78S;*K*dx8RIUm5+;4o4%DWYbp{_+r`2y
zPMr`5)J>_F4L%oEfT^71JZfKS2+|iKCR<P6_TON>5!PxFZ7F@HNjEI-9u?I^zr>9A
zP?<sLE?dL=>zWV1nL)5HEpg*8#p^u}rOF#a;|zPU!Iya#YNhDJM)Op!ohMvaN-1P@
z)TzP@JJ<u+oqMc}IxB%#3DF)xlv5C-<z>;sPKpqF6R)w9&SV2^d7lE}H`Q!KePuij
zTpH!{IckS0P);Faosxvm&v;_yV1QIE$$yxidhMBG)(&1uSBZujuR1<8u{8QbSr<BR
zv;1y{LR5D;ZWeB2cl2yu4i{08A!OcryQLAj;h|Z9^GyO@RjTAH-n5DMQw-RBC5;$W
zaEct(H{w-`X3qK0qrUIJ!EJ_PHo=9~o!gcev%hG59bNLM(+fwtw11;56tTyekQ`d(
z=r>iEd@a>WGrvPlZ&g;mL=WYyuOc(I3*1Yk{0HYf*QbuVc)9p*Ewiq1$rLymHf4Ez
zPE!XvyEhGcZ5_1p;h<r&CbSf&Ne+2Xs;^N2=JQ8vF3<jQp*1E(F$W=>J6%DQ>0jPx
z1QPAm=(x_iKpUMCq)U|PZ2W4P*Alaxu*x?>_m1SDrksaxw8ofs1U#5OTGY5dE>htm
zH^-_0!cV1x`XbWn2A3dgF}Ixiw9Vf{=13X18qM-vhdb$=*N>2)_aV*U@R5$ww+>*5
zs{u(}J-wA|AAKrbw+;<x@NU-fbCKIzk5H`sJwP9D__WZEaQNe9(JIh;gUFWYOM`b}
z){Vp=$V1kE<Zn8v*FmF57=I*gyjJ>-P8#J!deT%=@<Ux7Sm`sWOrtz~rao{aAG*0l
z)3YqT05MtrqkvJcfWIbE;blEIPvPt%jO3HVCJXsb!?or$uK@cuS@5xbqdXNF7IG9W
zg`MTqMZV;V2IXelsLMC;M#=qc+}BrP<nS$c&DouEu8EMU7rv_sPnTo~Gw1~KS^02$
zf7&az-ygyMCYKNQf-KXywERf(Gbcz1ZUk+{U@?M%i5iCTZeBeRv-$=G;?oM-S&?$&
zo;Th>%cks_#gimaPlB7T{lNLSs`lYW6JL4s@b%yxt1Yxf5U&Y^hL4JA3%;8~a1@RE
z>$7KSpmk@d8fTS*pz1`4>&GpXWoe>RPE2~ron)CsbObp<o@O3VBYJ8Uo};P~6q`-K
zB@(&CTZs-szajd2Qv&kqAc70JLvy;@qLd<FAl0R}myc^xeKCHby)Nx1A*=zFcqqNA
zY^B%R(UCgTeRK1aN87>$W)VGce0*3)nmOMOv6^VvUkK~-Y*3bAiN3)q$q}sMleCji
znb@O2Yvixa<Mzqm=W{QQ#MRylH#L?*r8!XS3k|~=*MbN*pnV;7;q8tAffpMJOzP>6
zO31Kj8xn48%k)h;q@RkD9{QIvYW?6~#K^kvqFDUPA>+~2KT(Mfk3SuIG3jl6Aa*ky
z<AYas7b!O*ze{AW6aGwtCJA_=3^TRQ^0(}J7zg&|%we2kC1NUq>T6ch-uDcl_LR*k
z{fBwh%kPH{+ZC!yyXIZ+&(M*4j@4#Am{#v-4VPTZfUArUErSn)qV>yWY~Z5@Z3aA_
zto*z*M8H;f{nI>|%O4jL=>qQJyEc5GlTon{#v2~vc%<kLa9Ia+;Pna_XC_l8dP+Ah
z%#!baLw6n;K?iut1xU!Ee4;+vM9M>(&sd4J%_t7u<HAi(h-I9+jsQxwZOM$X&so%p
zoA9|=<SY4N%)>f4J;~XuS!Ak$?Q$sMrkSC14u@yxcA2s7av*xfU6hMRX@7uNB*Dfv
zO*DISb$Lcr)5p?zPpcS{MyAis5-nR1QPpt5YFx`#rk9N@mv7VLS1+Ots}vc-f+H2m
z<ml};P7`Nowi4>}c~@Jb#a@AJ&G#L0z4n;~3wSUWbGJbPA{9LE=0k!i8XkL^dh#5a
z`z&8v(6N}bJK#?fsJoPjyc@Q|wkcZ(n~J5#GL@(o%TH6H4q`vT_G3pvxx9q+*MlzT
z>NI#w*85<;o*bn$wU|F@Z4_;ciBAiCie{ocb9xaQxj0zg?Vx{GGgN~#YoWRinM&B|
zG+3`L8#bePO%HqGgvt>gXKBNKZvS!K#Cu1@Wxc-j63EKvo4OQR^TZ749|zTHu&bAH
zbCEQFmW}90DDRMVVA)PswM2C*l)qqY3T9bMu!R(v^PEPGKTcNf^7kaSet(j8*hIiA
zK!sO0)AUG-jOoMdxIRxrzGcUF)myIHY)aAiHk-yX#^5z*qbr<CSQFxWwy5j(>>vx=
z>Ra{BGu<~>PYxD5L)Gl2@Av8NRcPR8UQd~w6iD2(sFcaierZKuFrX%w5Yu5WRPgpb
zvCbw%%ApQT8F4a_=lH(X3+#d7Z`J7$WwJdwlNeYSu~R$MV<n3~as(>X!O3d)DVm>8
z7K?{RO6#3_=RKg^d_qakk(Oxt9ekAz#B@2;>q-_p4|G1X+v{?r3RZ<r7|(We?Ytt!
z=s#CeWg5s!>#GzLz{y|w+#~{f!Q^4l8(graTOLN7h%Ba$UVtg6vEDpP<;WDfaBT<D
zjA={XtLnTm5J)P<GbCOt!}T5xRRvB#6|0G_S9pcGFOzVSR~JnVL$5TQMo*apsQ9vh
z8W>4N5G~5-SO~>ZJW_39rmUK-=9y$CC+A^8o4<5i&07WVV0dW>7RZ?s!e1gcVqT2n
z&jOF*SOG`tq2qL~&L-a<Ms)&8K4Jrue6+5zP%Hn`;<pJ{$wb*x0?@9Q0^Z)=HGBaz
z{MiVPWIC~hEh0vXj<iclQP`Y}+2guD5Q;-Ym3P<EB@621U$Fch>;f`B|33|0*^Lrv
zT?-Foh_Sk&1$r)6+L5=0`{dFDK0UXH;ue<Vcfi5LGiCqw#SfL@|AGEyEC27_4y~p5
z4;Wl?Ufy5#GWro3OuF0d*(g`DU(F`_^4fLa4-fEehTG!VDE;dj0|Fm!cw{j1&oKsB
z2GR$ajLDRL{E|WTr7Szczb1MBe7hE^BMXhxu?3#;``dM#oR|Na@Xv?KU58Q1Wf1*2
zhKuKk^M9ULYCXF_(n|9$Nn|a^A7s`f-u!FsPPxvC{hOK0f6rF)5|RCu=dZbO$#LX7
zLf7#A{y7hWupRT=-%I>M)QFb|(+}cue?48`F5d85U)W#kv|wZqrhvx%YaO_FLpb!;
zu3fvjTE0xhyLRnP&~K2>_H-4&HHLe*g4I`um+7IH?CZM5=E$vp!M|7d;1`d8+<r}=
z&)+g?%R;Ge{t`)+i9wjeP#bt5f9fY3PVm=9JQf@|A<M($zvPjH&j0oC<v)M>L!JMq
z1oxj^@{i&C%c1?_6#j7ve;UI-PT?P?@Q+jYZyY?`=EZMpjl85k1|rgHs)||)<#HBb
F{{a!jH8}tP

literal 0
HcmV?d00001

diff --git a/docs/images/colab_remote.png b/docs/images/colab_remote.png
new file mode 100644
index 0000000000000000000000000000000000000000..c1614895c837727673cbd7a2e4f4f0fe545647fe
GIT binary patch
literal 238053
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

literal 0
HcmV?d00001

diff --git a/docs/tutorials/gcp_before_you_begin.md b/docs/tutorials/gcp_before_you_begin.md
new file mode 100644
index 00000000..7dbe05c5
--- /dev/null
+++ b/docs/tutorials/gcp_before_you_begin.md
@@ -0,0 +1,33 @@
+# Before you begin
+
+The following tutorials demonstrate how to configure the Google Cloud Platform
+to run quantum simulations with qsim.
+
+You can use Google Cloud to run high-performance CPU-based simulations or
+GPU-based simulations, depending on your requirements. For more information
+about making a choice between CPU- and GPU-based simulations, see
+[Choosing hardware for your qsim simulation]().
+
+This tutorial depends on resources provided by the Google Cloud Platform.
+
+*   **Ensure that you have a Google Cloud Platform project.** You can reuse an
+    existing project, or create a new one, from your
+    [project dashboard](https://console.cloud.google.com/projectselector2/home/dashboard).
+    *   For more information about Google Cloud projects, see
+        [Creating and managing projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects)
+        in the Google Cloud documentation.
+*   **Ensure that billing is enabled for your project.**
+    *   For more information about billing, see
+        [Enable, disable, or change billing for a project](https://cloud.google.com/billing/docs/how-to/modify-project#enable-billing)
+        in the Google Cloud documentation.
+*   **Estimate costs for your project** Use the
+    [Google Cloud Pricing Calculator](https://cloud.google.com/products/calculator)
+    to estimate the scale of the costs you might incur, based on your projected
+    usage. The resources that you use to simulate a quantum circuit on the
+    Google Cloud platform are billable.
+*   **Enable the Compute Engine API for your project.** You can enable APIs from
+    the [API Library Console](https://console.cloud.google.com/apis/library). On
+    the console, in the search box, enter "compute engine api" to find the API
+    and click through to Enable it.
+    *   For more information about enabling the Compute Engine API, see
+        [Getting Started](https://cloud.google.com/apis/docs/getting-started) in
diff --git a/docs/tutorials/gcp_cpu.md b/docs/tutorials/gcp_cpu.md
new file mode 100644
index 00000000..59b52ef0
--- /dev/null
+++ b/docs/tutorials/gcp_cpu.md
@@ -0,0 +1,247 @@
+# CPU-based quantum simulation on Google Cloud
+
+In this tutorial, you configure and test a virtual machine (VM) to run CPU-based
+quantum simulations. The configuration in this tutorial uses the qsim Docker
+container, running on a Google Compute Engine VM.
+
+## 1. Create a virtual machine
+
+Follow the instructions in the
+[Quickstart using a Linux VM](https://cloud.google.com/compute/docs/quickstart-linux)
+guide to create a VM. In addition to the guidance under the Create a Linux VM
+instance heading, ensure that your VM has the following properties:
+
+*   In the Machine Configuration section, in the Machine family options,
+    click on the **Compute Optimized** filter.
+*   In the Machine Configuration section, in the Machine family options, in
+    the Series option, choose **C2**.
+*   In the Machine Configuration section, in the Machine family options, in
+    the Machine type option, choose **c2-standard-16**. This option gives
+    you 16 virtual CPUS and 64MB of RAM.
+    *   This choice is for demonstration purposes only. For a live
+        experiment, see [Choosing hardware for your qsim simulation]().
+*   In the Boot disk section, click the Change button, and choose
+    Container-Optimized OS. This overrides step 3 in the quickstart guide.
+*   In the Firewall section, ensure that both the **Allow HTTP traffic**
+    checkbox and **Allow HTTPS traffic** checkbox have marks.
+
+When Google Cloud finishes creating the VM, you can see your VM listed in the
+[Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
+for your project.
+
+### Find out more
+* [Choosing the right machine family and
+  type](https://cloud.google.com/blog/products/compute/choose-the-right-google-compute-engine-machine-type-for-you)
+* [Container-Optimized OS
+  Overview](https://cloud.google.com/container-optimized-os/docs/concepts/features-and-benefits)
+
+## 2. Prepare your computer
+
+Use SSH to create an encrypted tunnel from your computer to your VM and redirect
+a local port to your VM over the tunnel.
+
+1.  Follow the instructions in the
+    [Installing Cloud SDK](https://cloud.google.com/sdk/docs/install)
+    documentation to install the `gcloud` command line tool.
+1.  After installation, initialize the Google Cloud environment by using the
+    `gcloud init` command. You need to provide details about your VM, such as
+    the project name and the region where your VM is located.
+    1.  You can verify your environment by using the `gcloud config list`
+        command.
+1.  Create an SSH tunnel and redirect a local port to use the tunnel by typing
+    the following command in a terminal window on your computer. Replace
+    `[YOUR_INSTANCE_NAME]` with the name of your VM.
+
+```
+gcloud compute ssh [YOUR_INSTANCE_NAME] -- -L 8888:localhost:8888
+```
+
+When the command completes successfully, your prompt changes from your local
+machine to your virtual machine.
+
+## 3. Start the qsim Docker container on your virtual machine
+
+On your VM, start the qsim container by typing the following command at the
+command prompt on your VM from the previous step.
+
+```
+docker run -v `pwd`:/homedir -p 8888:8888 gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest &
+```
+
+If you see a `permission denied` error message, you might need to add `sudo`
+before your Docker command. For more information about running Docker, see the
+[`docker run` command reference](https://docs.docker.com/engine/reference/run/#general-form).
+
+As Docker downloads and starts the container, it prints many lines of output.
+The last few lines should be similar to the following output:
+
+```
+To access the notebook, open this file in a browser:
+    file:///root/.local/share/jupyter/runtime/nbserver-1-open.html
+Or copy and paste one of these URLs:
+    http://e1f7a7cca9fa:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
+    or http://127.0.0.1:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
+```
+
+Copy the URL in the last line of output from your console, and save it for the
+next step.
+
+## 4. Connect to your virtual machine
+
+The easiest way to use your VM is through a notebook environment like
+[Google Colaboratory](https://colab.sandbox.google.com/notebooks/intro.ipynb?utm_source=scs-index#recent=true)
+(Colab). Google Colab is a free, hosted notebook environment that enables you to
+write, execute, and share Python code from your browser.
+
+However, the qsim Docker image also includes a Jupyter kernel and other
+command-line tools. These tools enable you to connect directly to your container
+and run your code.
+
+*   {Colab}
+
+      You can write code in a Colab notebook, and use your VM to run your code. In
+      this step, we use the
+      [Get Started with qsimcirq Colab notebook](https://quantumai.google/qsim/tutorials/qsimcirq).
+
+      1.  Open the
+          [Get Started with qsimcirq notebook](https://quantumai.google/qsim/tutorials/qsimcirq).
+      2.  Near the top-right corner of your notebook, click the small triangle beside
+          the Connect button to open the menu.
+      3.  Choose the **Connect to a local runtime** option to open the Local
+          connection settings window.
+          <img src="../images/colab_connect.png" alt="Google Colab Connect to Local Runtime button" style="width: 62%" class="screenshot">
+      1.  In the Backend URL text field, paste the URL that you saved in step 5.
+      2.  Change the part of your URL that read `127.0.0.1` to `localhost`.
+          <img src="../images/colab_remote.png" alt="Google Colab Local Runtime connection window" style="width: 62%" class="screenshot">
+      1.  Click the **Connect** button in the Local connection settings window.
+
+      When your connection is ready, Colab displays a green checkmark beside the
+      Connected (Local) button near the top-right corner of your notebook.
+
+      <img src="../images/colab_connected.png" alt="Google Colab Local Runtime connection windo" style="width: 62%" class="screenshot">
+
+      The code cells in your notebook now execute on your VM instead of your local
+      computer.
+
+*   {Jupyter}
+
+      You can run your simulation directly in your Docker container, in Jupyter.
+      Jupyter runs in the qsim Docker container.
+
+      1.  Open a browser window.
+      2.  In the navigation bar, paste the URL that you copied in step 4.
+      3.  In the browser you should now see the Jupyter UI, running on your VM.
+
+      The code that you execute here executes on your VM. You can navigate to qsim >
+      docs > tutorials to try other tutorials.
+
+*   {Command line}
+
+      You can run a quantum simulation using qsim from the command line.
+      Your code runs in the qsim Docker container.
+
+      **Before you begin**
+
+      For this scenario, you can connect to your machine directly over SSH rather than
+      create a tunnel. In step 3.3 above, remove the second half of the command.
+      Instead of the following command:
+
+      ```
+      gcloud compute ssh [YOUR_INSTANCE_NAME] -- -L 8888:localhost:8888
+      ```
+
+      Run:
+
+      ```
+      gcloud compute ssh [YOUR_INSTANCE_NAME]
+      ```
+
+      Either command works for the purpose of this tutorial. Continue to step 4 then
+      complete the steps below, regardless of which command you use.
+
+      **1. Copy the container ID for your qsim Docker container**
+
+      Use the `docker ps` command to display the container ID. The output should look
+      like the following text:
+
+      ```
+      CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES i
+      8ab217d640a3 gcr.io/quantum-291919/jupyter_qsim:latest "jupyter-notebook --…" 2 hours ago Up 2 hours 0.0.0.0:8888->8888/tcp dazzling_lovelace.
+      ```
+
+      In this case, the container ID is `8ab217d640a3`.
+
+      **2. Connect to your qsim Docker container**
+
+      Use the docker exec command line tool to login to your container. Replace
+      `[CONTAINER_ID]` with the ID that you copied in step 1.
+
+      ```
+      docker exec -it [CONTAINER_ID] /bin/bash
+      ```
+
+      Your command prompt now executes commands in the container.
+
+      **3. Verify your installation**
+
+      You can use the code below to verify that qsim uses your qsim installation.
+      You can paste the code directly into the REPL, or paste the code in a
+      file.
+      ```
+      # Import Cirq and qsim
+      import cirq
+      import qsimcirq
+
+      # Instantiate qubits and create a circuit
+      q0, q1 = cirq.LineQubit.range(2)
+      circuit = cirq.Circuit(cirq.H(q0), cirq.CX(q0, q1))
+
+      # Instantiate a simulator that uses the GPU
+      qsim_simulator = qsimcirq.QSimSimulator()
+
+      # Run the simulation
+      print("Running simulation for the following circuit:")
+      print(circuit)
+
+      qsim_results = qsim_simulator.compute_amplitudes(
+          circuit, bitstrings=[0b00, 0b01])
+
+      print("qsim results:")
+      print(qsim_results)
+      ```
+
+      After a moment, you should see a result that looks similar to the following.
+
+      ```
+      [(0.7071067690849304+0j), 0j]
+      ```
+
+## Clean up
+
+After you finish either tutorial, you can avoid continued billing by stopping or
+deleting the VM instance that you create; visit the
+[Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
+to manage your VM.
+
+For more information about managing your VM, see the following documentation
+from Google Cloud:
+
+*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
+*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
+*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
+
+## Next steps
+
+After you finish, don't forget to stop or delete your VM on the Compute
+Instances dashboard. For more information, see the
+[Clean Up section in the Overview](https://quantumai.google/qsim/tutorials/gcp_overview#clean_up).
+
+You are now ready to run your own large simulations on Google Cloud. If you want
+to try a large circuit on Google Cloud, you can connect the
+[Simulate a large quantum circuit](https://colab.sandbox.google.com/github/quantumlib/qsim/blob/master/docs/tutorials/q32d14.ipynb)
+Colab notebook to your VM
+([documentation](https://quantumai.google/qsim/tutorials/q32d14)).
+
+As an alternative to Google Cloud, you can download the Docker container or the
+qsim source code to run quantum simulations on your own high-performance
+computing platform.
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
new file mode 100644
index 00000000..6ce85650
--- /dev/null
+++ b/docs/tutorials/gcp_gpu.md
@@ -0,0 +1,195 @@
+# GPU-based quantum simulation on Google Cloud
+
+In this tutorial, you configure and test a virtual machine (VM) to run GPU-based
+quantum simulations on Google Cloud.
+
+The later steps in this tutorial require you to enter several commands at the
+command line. Some commands might require you to add `sudo` before the command.
+For example, if a step asks you to type `icecream -fancy`, you might need to
+type `sudo icecream -fancy`.
+
+## 1. Create a virtual machine
+
+Follow the instructions in the
+[Quickstart using a Linux VM](https://cloud.google.com/compute/docs/quickstart-linux)
+guide to create a VM. In addition to the guidance under the Create a Linux VM
+instance heading, ensure that your VM has the following properties:
+
+*   In the Machine Configuration section, in the Machine Family options, click
+    on the **GPU** filter.
+*   In the Machine Configuration section, in the Machine family options, in the
+    GPU type option, choose **NVIDIA Tesla A100**
+    *   In the Number of GPUs option, choose **1**.
+*   In the Boot disk section, click the **Change** button.
+    *   In the Operating System option, choose **Ubuntu**.
+    *   In the Version option, choose **20.04 LTS**.
+    *   In the Size field, enter **30** (minimum).
+    *   This overrides step 3 through 5 in the Quickstart guide.
+*   In the Firewall section, ensure that both the **Allow HTTP traffic**
+    checkbox and **Allow HTTPS traffic** checkbox have marks.
+
+When Google Cloud finishes creating the VM, you can see your VM listed in the
+[Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
+for your project.
+
+### Find out more
+
+*   [Choosing the right machine family and type](https://cloud.google.com/blog/products/compute/choose-the-right-google-compute-engine-machine-type-for-you)
+*   [Creating a VM with attached GPUs](https://cloud.google.com/compute/docs/gpus/create-vm-with-gpus#create-new-gpu-vm)
+
+## 2. Prepare your computer
+
+Use SSH to create an encrypted tunnel from your computer to your VM and redirect
+a local port to your VM over the tunnel.
+
+1.  Follow the instructions in the
+    [Installing Cloud SDK](https://cloud.google.com/sdk/docs/install)
+    documentation to install the `gcloud` command line tool.
+2.  After installation, initialize the Google Cloud environment by using the
+    `gcloud init` command. You need to provide details about your VM, such as
+    the project name and the region where your VM is located.
+    1.  You can verify your environment by using the `gcloud config list`
+        command.
+3.  Create an SSH tunnel and redirect a local port to use the tunnel by typing
+    the following command in a terminal window on your computer. Replace
+    `[YOUR_INSTANCE_NAME]` with the name of your VM.
+
+```shell
+gcloud compute ssh [YOUR_INSTANCE_NAME]
+```
+
+When the command completes successfully, your prompt changes from your local
+machine to your virtual machine.
+
+## 3. Enable your virutal machine to use the GPu
+
+1.  Install the GPU driver. In the Google Cloud documentation, in the Installing
+    GPU drivers guide, follow the steps provided:
+    *   In
+        [the Examples section](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#examples),
+        under the Ubuntu tab. Only follow the steps for Ubuntu 20.04 (steps 3a
+        through 3f).
+    *   In the
+        [Verifying the GPU driver install](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#verify-driver-install)
+        section.
+2.  Run `sudo apt install -y nvidia-cuda-toolkit` to install the CUDA toolkit.
+3.  Add your CUDA toolkit to the environment search path.
+    1.  Run `ls /usr/local` to discover the directory of the CUDA toolkit that
+        you installed. The toolkit will be the highest number that looks like
+        the pattern `cuda-XX.Y`.  The output of the command should resemble the
+        following:
+
+        ```shell
+        bin cuda cuda-11 cuda-11.4 etc games include lib man sbin share src
+        ```
+
+        In this case, the directory is `cuda-11.4`.
+    2.  Add the CUDA toolkit path to your environment by appending the following
+        line to your `~/.bashrc` file.  Replace `[DIR]` with the CUDA directory that
+        you discovered in the previous step.
+
+        ```shell
+        echo "export PATH=/usr/local/[DIR]/bin${PATH:+:${PATH}}" >> ~/.bashrc
+        ```
+
+    3.  Run `source ~/.bashrc` to activate the new environment search path
+
+## 4. Install build tools
+
+Run the following command to install the Cmake tool and the pip tool. This step
+might take a few minutes to complete.
+
+```shell
+sudo apt install cmake && sudo apt install pip
+```
+
+
+## 5. Create a GPU-enabled version of qsim
+
+1.  Run the following command to clone the qsim repository.
+
+    ```shell
+    git clone https://github.com/quantumlib/qsim.git
+    ```
+
+2.  Run `cd qsim`to change your working directory to qsim.
+3.  Run `make`to compile qsim. When CUDA toolkit is installed during a qsim
+    compilation, make builds the GPU version automatically.
+4.  Run `pip install .` to install your local version of qsimcirq.
+5.  Run `python3 -c "import qsimcirq; print(qsimcirq.qsim_gpu)"`to verify your
+    installation. If the installation completed successfully, the output from
+    the command should resemble the following:
+
+    ```shell
+    <module 'qsimcirq.qsim_cuda' from '/home/user_org_com/qsim/qsimcirq/qsim_cuda.cpython-38-x86_64-linux-gnu.so'>
+    ```
+
+
+## 6. Verify your installation
+
+You can use the code below to verify that qsim uses your GPU. You can paste the
+code directly into the REPL, or paste the code in a file and ask the Python
+interpreter to run it. If you paste the code into a file, use the following
+command in the interpreter to run it. Replace `[FILE]` with the name of the file
+that you create.
+
+```
+>>> exec(open("[FILE]").read())
+```
+
+In the `qsim` directory, run `python3` to start the Python REPL. Run the
+following code.
+
+```
+# Import Cirq and qsim
+import cirq
+import qsimcirq
+
+# Instantiate qubits and create a circuit
+q0, q1 = cirq.LineQubit.range(2)
+circuit = cirq.Circuit(cirq.H(q0), cirq.CX(q0, q1))
+
+# Instantiate a simulator that uses the GPU
+gpu_options = qsimcirq.QSimOptions(use_gpu=True)
+qsim_simulator = qsimcirq.QSimSimulator(qsim_options=gpu_options)
+
+# Run the simulation
+print("Running simulation for the following circuit:")
+print(circuit)
+
+qsim_results = qsim_simulator.compute_amplitudes(
+    circuit, bitstrings=[0b00, 0b01])
+
+print("qsim results:")
+print(qsim_results)
+```
+
+After a moment, you should see a result that looks similar to the following.
+
+```
+[(0.7071067690849304+0j), 0j]
+```
+
+## Clean up
+
+After you finish either tutorial, you can avoid continued billing by stopping or
+deleting the VM instance that you create; visit the
+[Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
+to manage your VM.
+
+For more information about managing your VM, see the following documentation
+from Google Cloud:
+
+*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
+*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
+*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
+
+## Next steps
+
+After you finish, don't forget to stop or delete your VM on the Compute
+Instances dashboard. For more information, see the
+[Clean Up section in the Overview](https://quantumai.google/qsim/tutorials/gcp_overview#clean_up).
+
+You are now ready to run your own large simulations on Google Cloud. For sample
+code of a large circuit, see the [Simulate a large
+circuit](https://quantumai.google/qsim/tutorials/q32d14) example.

From 43170e12934d01969cf51910a932b504f91bcd07 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 30 Sep 2021 18:58:54 +0200
Subject: [PATCH 100/246] Add qsim_qtrajectory_cuda usage description.

---
 apps/qsim_qtrajectory_cuda.cu |  7 ++++++-
 docs/usage.md                 | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/apps/qsim_qtrajectory_cuda.cu b/apps/qsim_qtrajectory_cuda.cu
index f5636c0f..ab9f122a 100644
--- a/apps/qsim_qtrajectory_cuda.cu
+++ b/apps/qsim_qtrajectory_cuda.cu
@@ -229,6 +229,11 @@ int main(int argc, char* argv[]) {
     return 1;
   }
 
+  if (opt.times.size() == 1
+      && opt.times[0] == std::numeric_limits<unsigned>::max()) {
+    opt.times[0] = circuit.gates.back().time;
+  }
+
   StateSpace::Parameter param1;
   Simulator::Parameter param2;
   Factory factory(param1, param2);
@@ -256,7 +261,7 @@ int main(int argc, char* argv[]) {
   auto observables = GetObservables<GateQSim<fp_type>>(circuit.num_qubits);
 
   std::vector<std::vector<std::vector<std::complex<double>>>> results;
-  results.reserve(noisy_circuits.size());
+  results.reserve(opt.num_trajectories);
 
   for (unsigned i = 0; i < opt.num_trajectories; ++i) {
     results.push_back({});
diff --git a/docs/usage.md b/docs/usage.md
index 06b8712e..a0992fe2 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -91,6 +91,39 @@ Example:
 ./qsim_amplitudes.x -c ../circuits/circuit_q24 -t 4 -d 16,24 -i ../circuits/bitstrings_q24_s1,../circuits/bitstrings_q24_s2 -o ampl_q24_s1,ampl_q24_s2 -v 1
 ```
 
+## qsim_qtrajectory_cuda usage
+
+```
+./qsim_qtrajectory_cuda.x -c circuit_file \
+                          -d times_to_calculate_observables \
+                          -a amplitude_damping_const \
+                          -p phase_damping_const \
+                          -t traj0 -n num_trajectories \
+                          -f max_fused_size \
+                          -v verbosity
+```
+
+| Flag | Description |
+|-------|------------|
+|`-c circuit_file` | circuit file to run|
+|`-d times_to_calculate_observables` | comma-separated list of circuit times to calculate observables at|
+|`-a amplitude_damping_const` | amplitude damping constant |
+|`-p phase_damping_const` | phase damping constant |
+|`-t traj0` | starting trajectory |
+|`-n num_trajectories ` | number of trajectories to run starting with `traj0` |
+|`-f max_fused_size` | maximum fused gate size|
+|`-v verbosity` | verbosity level (0,1)|
+
+qsim_qtrajectory_cuda runs on GPUs. qsim_qtrajectory_cuda performs quantum
+trajactory simulations with amplitude damping and phase damping noise channels.
+qsim_qtrajectory_cuda calculates observables (operator X at each qubit) at
+specified times.
+
+Example:
+```
+./qsim_qtrajectory_cuda.x -c ../circuits/circuit_q24 -d 8,16,32 -a 0.005 -p 0.005 -t 0 -n 100 -f 4 -v 0
+```
+
 ## qsimh_base usage
 
 ```

From 2c7e8cf9be5a462b3381faa23f19bf2715aa6c80 Mon Sep 17 00:00:00 2001
From: Jae Yoo <jaeyoo@google.com>
Date: Thu, 30 Sep 2021 18:12:41 +0000
Subject: [PATCH 101/246] Add fp_type and ApplyFusedGate test for MPSSimulator

---
 .vscode/settings.json       | 70 +++++++++++++++++++++++++++++++++++++
 lib/mps_simulator.h         |  5 +--
 lib/mps_statespace.h        |  3 +-
 tests/mps_simulator_test.cc | 48 +++++++++++++++++++++++++
 4 files changed, 123 insertions(+), 3 deletions(-)
 create mode 100644 .vscode/settings.json

diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 00000000..dc06896c
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,70 @@
+{
+    "files.associations": {
+        "array": "cpp",
+        "atomic": "cpp",
+        "bit": "cpp",
+        "*.tcc": "cpp",
+        "cctype": "cpp",
+        "chrono": "cpp",
+        "clocale": "cpp",
+        "cmath": "cpp",
+        "compare": "cpp",
+        "complex": "cpp",
+        "concepts": "cpp",
+        "condition_variable": "cpp",
+        "cstdarg": "cpp",
+        "cstddef": "cpp",
+        "cstdint": "cpp",
+        "cstdio": "cpp",
+        "cstdlib": "cpp",
+        "cstring": "cpp",
+        "ctime": "cpp",
+        "cwchar": "cpp",
+        "cwctype": "cpp",
+        "deque": "cpp",
+        "forward_list": "cpp",
+        "list": "cpp",
+        "map": "cpp",
+        "set": "cpp",
+        "unordered_map": "cpp",
+        "unordered_set": "cpp",
+        "vector": "cpp",
+        "exception": "cpp",
+        "algorithm": "cpp",
+        "functional": "cpp",
+        "iterator": "cpp",
+        "memory": "cpp",
+        "memory_resource": "cpp",
+        "numeric": "cpp",
+        "optional": "cpp",
+        "random": "cpp",
+        "ratio": "cpp",
+        "string": "cpp",
+        "string_view": "cpp",
+        "system_error": "cpp",
+        "tuple": "cpp",
+        "type_traits": "cpp",
+        "utility": "cpp",
+        "hash_map": "cpp",
+        "fstream": "cpp",
+        "future": "cpp",
+        "initializer_list": "cpp",
+        "iomanip": "cpp",
+        "iosfwd": "cpp",
+        "iostream": "cpp",
+        "istream": "cpp",
+        "limits": "cpp",
+        "mutex": "cpp",
+        "new": "cpp",
+        "ostream": "cpp",
+        "ranges": "cpp",
+        "sstream": "cpp",
+        "stdexcept": "cpp",
+        "stop_token": "cpp",
+        "streambuf": "cpp",
+        "thread": "cpp",
+        "cinttypes": "cpp",
+        "typeinfo": "cpp",
+        "valarray": "cpp"
+    }
+}
\ No newline at end of file
diff --git a/lib/mps_simulator.h b/lib/mps_simulator.h
index ae053690..98d00310 100644
--- a/lib/mps_simulator.h
+++ b/lib/mps_simulator.h
@@ -35,11 +35,12 @@ namespace mps {
 /**
  *  Truncated Matrix Product State (MPS) circuit simulator w/ vectorization.
  */
-template <typename For, typename fp_type = float>
+template <typename For, typename FP = float>
 class MPSSimulator final {
  public:
-  using MPSStateSpace_ = MPSStateSpace<For, fp_type>;
+  using MPSStateSpace_ = MPSStateSpace<For, FP>;
   using State = typename MPSStateSpace_::MPS;
+  using fp_type = typename MPSStateSpace_::fp_type;
 
   using Complex = std::complex<fp_type>;
   using Matrix =
diff --git a/lib/mps_statespace.h b/lib/mps_statespace.h
index 0520ef9f..26cfe190 100644
--- a/lib/mps_statespace.h
+++ b/lib/mps_statespace.h
@@ -51,10 +51,11 @@ inline void free(void* ptr) {
  * Class containing context and routines for fixed bond dimension
  * truncated Matrix Product State (MPS) simulation.
  */
-template <typename For, typename fp_type = float>
+template <typename For, typename FP = float>
 class MPSStateSpace {
  private:
  public:
+  using fp_type = FP;
   using Pointer = std::unique_ptr<fp_type, decltype(&detail::free)>;
 
   using Complex = std::complex<fp_type>;
diff --git a/tests/mps_simulator_test.cc b/tests/mps_simulator_test.cc
index 98092fd3..f70e63de 100644
--- a/tests/mps_simulator_test.cc
+++ b/tests/mps_simulator_test.cc
@@ -17,6 +17,7 @@
 #include "../lib/formux.h"
 #include "../lib/gate_appl.h"
 #include "../lib/gates_cirq.h"
+#include "../lib/gates_qsim.h"
 #include "gtest/gtest.h"
 
 namespace qsim {
@@ -265,6 +266,53 @@ TEST(MPSSimulator, Apply1InteriorArbitrary) {
   ASSERT_NEAR(state.get()[l_offset + 63], 153.6, 1e-5);
 }
 
+TEST(MPSSimulator, ApplyLeftFusedGate) {
+  // Apply a fused gate matrix to the first two qubits.
+  // Compute the state vector of:
+  //   |     |     |
+  // +-+-----+-+   |
+  // |FusedGate|   |
+  // +-+-----+-+   |
+  //   |     |     |
+  // +-+-+ +-+-+ +-+-+
+  // | 0 +-+ 1 +-+ 2 |
+  // +---+ +---+ +---+
+  auto sim = MPSSimulator<For, float>(1);
+  using MPSStateSpace = MPSSimulator<For, float>::MPSStateSpace_;
+  auto ss = MPSStateSpace(1);
+
+  auto gate1 = GateCZ<float>::Create(2, 0, 1);
+  auto gate2 = GateHd<float>::Create(0, 0);
+  auto gate3 = GateHd<float>::Create(0, 1);
+
+  GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {0, 1},  &gate1, {&gate2, &gate3}};
+  auto mps = ss.CreateMPS(3, 2);
+  ss.SetMPSZero(mps);
+  ApplyFusedGate(sim, fgate1, mps);
+
+  // float wf[32];
+  // ss.ToWaveFunction(mps, wf);
+  // for (int i = 0; i < 16; i++) {
+  //   std::cerr << wf[i] << std::endl;
+  // }
+  // EXPECT_NEAR(wf[0], 100, 1e-4);
+  // EXPECT_NEAR(wf[1], 0.2143698948599676, 1e-4);
+  // EXPECT_NEAR(wf[2], -0.11738977370009586, 1e-4);
+  // EXPECT_NEAR(wf[3], 0.12454935773362025, 1e-4);
+  // EXPECT_NEAR(wf[4], -0.47150921436100324, 1e-4);
+  // EXPECT_NEAR(wf[5], 0.2765580906536361, 1e-4);
+  // EXPECT_NEAR(wf[6], -0.00488996377601076, 1e-4);
+  // EXPECT_NEAR(wf[7], -0.052702222730185794, 1e-4);
+  // EXPECT_NEAR(wf[8], -0.15375504635790666, 1e-4);
+  // EXPECT_NEAR(wf[9], -0.006893208509005258, 1e-4);
+  // EXPECT_NEAR(wf[10], 0.3625325032891465, 1e-4);
+  // EXPECT_NEAR(wf[11], -0.12932957404571366, 1e-4);
+  // EXPECT_NEAR(wf[12], -0.3459372670125525, 1e-4);
+  // EXPECT_NEAR(wf[13], 0.4020253863039828, 1e-4);
+  // EXPECT_NEAR(wf[14], -0.21864624250067458, 1e-4);
+  // EXPECT_NEAR(wf[15], -0.16468189647310463, 1e-4);
+}
+
 TEST(MPSSimulator, Apply2Left01) {
   // Compute the state vector of:
   //   |     |     |

From 089101cbdb372c61fc7d557b278a355e4e2d5c2c Mon Sep 17 00:00:00 2001
From: Jae Yoo <jaeyoo@google.com>
Date: Thu, 30 Sep 2021 19:09:02 +0000
Subject: [PATCH 102/246] Add MPSSimulator ApplyFusedGate{L,R,M} tests

---
 tests/mps_simulator_test.cc | 151 +++++++++++++++++++++++++-----------
 1 file changed, 104 insertions(+), 47 deletions(-)

diff --git a/tests/mps_simulator_test.cc b/tests/mps_simulator_test.cc
index 589a627f..605a29c0 100644
--- a/tests/mps_simulator_test.cc
+++ b/tests/mps_simulator_test.cc
@@ -266,53 +266,6 @@ TEST(MPSSimulator, Apply1InteriorArbitrary) {
   ASSERT_NEAR(state.get()[l_offset + 63], 153.6, 1e-5);
 }
 
-TEST(MPSSimulator, ApplyLeftFusedGate) {
-  // Apply a fused gate matrix to the first two qubits.
-  // Compute the state vector of:
-  //   |     |     |
-  // +-+-----+-+   |
-  // |FusedGate|   |
-  // +-+-----+-+   |
-  //   |     |     |
-  // +-+-+ +-+-+ +-+-+
-  // | 0 +-+ 1 +-+ 2 |
-  // +---+ +---+ +---+
-  auto sim = MPSSimulator<For, float>(1);
-  using MPSStateSpace = MPSSimulator<For, float>::MPSStateSpace_;
-  auto ss = MPSStateSpace(1);
-
-  auto gate1 = GateCZ<float>::Create(2, 0, 1);
-  auto gate2 = GateHd<float>::Create(0, 0);
-  auto gate3 = GateHd<float>::Create(0, 1);
-
-  GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {0, 1},  &gate1, {&gate2, &gate3}};
-  auto mps = ss.CreateMPS(3, 2);
-  ss.SetMPSZero(mps);
-  ApplyFusedGate(sim, fgate1, mps);
-
-  // float wf[32];
-  // ss.ToWaveFunction(mps, wf);
-  // for (int i = 0; i < 16; i++) {
-  //   std::cerr << wf[i] << std::endl;
-  // }
-  // EXPECT_NEAR(wf[0], 100, 1e-4);
-  // EXPECT_NEAR(wf[1], 0.2143698948599676, 1e-4);
-  // EXPECT_NEAR(wf[2], -0.11738977370009586, 1e-4);
-  // EXPECT_NEAR(wf[3], 0.12454935773362025, 1e-4);
-  // EXPECT_NEAR(wf[4], -0.47150921436100324, 1e-4);
-  // EXPECT_NEAR(wf[5], 0.2765580906536361, 1e-4);
-  // EXPECT_NEAR(wf[6], -0.00488996377601076, 1e-4);
-  // EXPECT_NEAR(wf[7], -0.052702222730185794, 1e-4);
-  // EXPECT_NEAR(wf[8], -0.15375504635790666, 1e-4);
-  // EXPECT_NEAR(wf[9], -0.006893208509005258, 1e-4);
-  // EXPECT_NEAR(wf[10], 0.3625325032891465, 1e-4);
-  // EXPECT_NEAR(wf[11], -0.12932957404571366, 1e-4);
-  // EXPECT_NEAR(wf[12], -0.3459372670125525, 1e-4);
-  // EXPECT_NEAR(wf[13], 0.4020253863039828, 1e-4);
-  // EXPECT_NEAR(wf[14], -0.21864624250067458, 1e-4);
-  // EXPECT_NEAR(wf[15], -0.16468189647310463, 1e-4);
-}
-
 TEST(MPSSimulator, Apply2Left01) {
   // Compute the state vector of:
   //   |     |     |
@@ -850,6 +803,110 @@ TEST(MPSSimulator, OneTwoQubitFuzz) {
   */
 }
 
+TEST(MPSSimulator, ApplyFusedGateLeft) {
+  // Apply a fused gate matrix to the first two qubits.
+  // Compute the state vector of:
+  //   |     |     |
+  // +-+-----+-+   |
+  // |FusedGate|   |
+  // +-+-----+-+   |
+  //   |     |     |
+  // +-+-+ +-+-+ +-+-+
+  // | 0 +-+ 1 +-+ 2 |
+  // +---+ +---+ +---+
+  auto sim = MPSSimulator<For, float>(1);
+  using MPSStateSpace = MPSSimulator<For, float>::MPSStateSpace_;
+  auto ss = MPSStateSpace(1);
+
+  auto gate1 = GateCZ<float>::Create(2, 0, 1);
+  auto gate2 = GateHd<float>::Create(0, 0);
+  auto gate3 = GateHd<float>::Create(0, 1);
+
+  GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {0, 1}, &gate1,
+                                    {&gate2, &gate3}};
+  auto mps = ss.Create(3, 4);
+  ss.SetStateZero(mps);
+  ApplyFusedGate(sim, fgate1, mps);
+
+  float wf[32];
+  float ground_truth[] = {0.5, 0., 0., 0., 0.5, 0., 0., 0.,
+                          0.5, 0., 0., 0., 0.5, 0., 0., 0.};
+  ss.ToWaveFunction(mps, wf);
+  for (int i = 0; i < 16; i++) {
+    EXPECT_NEAR(wf[i], ground_truth[i], 1e-4);
+  }
+}
+
+TEST(MPSSimulator, ApplyFusedGateRight) {
+  // Apply a fused gate matrix to the last two qubits.
+  // Compute the state vector of:
+  //   |     |     |
+  //   |   +-+-----+-+
+  //   |   |FusedGate|
+  //   |   +-+-----+-+ 
+  //   |     |     |
+  // +-+-+ +-+-+ +-+-+
+  // | 0 +-+ 1 +-+ 2 |
+  // +---+ +---+ +---+
+  auto sim = MPSSimulator<For, float>(1);
+  using MPSStateSpace = MPSSimulator<For, float>::MPSStateSpace_;
+  auto ss = MPSStateSpace(1);
+
+  auto gate1 = GateCZ<float>::Create(2, 1, 2);
+  auto gate2 = GateHd<float>::Create(0, 1);
+  auto gate3 = GateHd<float>::Create(0, 2);
+
+  GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {1, 2}, &gate1,
+                                    {&gate2, &gate3}};
+  auto mps = ss.Create(3, 4);
+  ss.SetStateZero(mps);
+  ApplyFusedGate(sim, fgate1, mps);
+
+  float wf[32];
+  float ground_truth[] = {0.5, 0., 0.5, 0., 0.5, 0., 0.5, 0.,
+                          0., 0., 0., 0., 0., 0., 0., 0.};
+  ss.ToWaveFunction(mps, wf);
+  for (int i = 0; i < 16; i++) {
+    EXPECT_NEAR(wf[i], ground_truth[i], 1e-4);
+  }
+}
+
+TEST(MPSSimulator, ApplyFusedGateMiddle) {
+  // Apply a fused gate matrix to the middle two qubits.
+  // Compute the state vector of:
+  //   |     |     |     |
+  //   |   +-+-----+-+   |
+  //   |   |FusedGate|   |
+  //   |   +-+-----+-+   |
+  //   |     |     |     |
+  // +-+-+ +-+-+ +-+-+ +-+-+
+  // | 0 +-+ 1 +-+ 2 |-| 3 |
+  // +---+ +---+ +---+ +-+-+
+  auto sim = MPSSimulator<For, float>(1);
+  using MPSStateSpace = MPSSimulator<For, float>::MPSStateSpace_;
+  auto ss = MPSStateSpace(1);
+
+  auto gate1 = GateCZ<float>::Create(2, 1, 2);
+  auto gate2 = GateHd<float>::Create(0, 1);
+  auto gate3 = GateHd<float>::Create(0, 2);
+
+  GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {1, 2}, &gate1,
+                                    {&gate2, &gate3}};
+  auto mps = ss.Create(4, 4);
+  ss.SetStateZero(mps);
+  ApplyFusedGate(sim, fgate1, mps);
+
+  float wf[64];
+  float ground_truth[] = {0.5, 0., 0., 0., 0.5, 0., 0., 0.,
+                          0.5, 0., 0., 0., 0.5, 0., 0., 0.,
+                          0., 0., 0., 0., 0., 0., 0., 0.,
+                          0., 0., 0., 0., 0., 0., 0., 0.};
+  ss.ToWaveFunction(mps, wf);
+  for (int i = 0; i < 32; i++) {
+    EXPECT_NEAR(wf[i], ground_truth[i], 1e-4);
+  }
+}
+
 }  // namespace
 }  // namespace mps
 }  // namespace qsim

From 016af85eeef472f4dc8f69a4e410584e2d429e68 Mon Sep 17 00:00:00 2001
From: Jae Yoo <jaeyoo@google.com>
Date: Thu, 30 Sep 2021 19:17:45 +0000
Subject: [PATCH 103/246] Fix BUILD and remove .vscode/settings.json

---
 .vscode/settings.json | 70 -------------------------------------------
 tests/BUILD           |  1 +
 2 files changed, 1 insertion(+), 70 deletions(-)
 delete mode 100644 .vscode/settings.json

diff --git a/.vscode/settings.json b/.vscode/settings.json
deleted file mode 100644
index dc06896c..00000000
--- a/.vscode/settings.json
+++ /dev/null
@@ -1,70 +0,0 @@
-{
-    "files.associations": {
-        "array": "cpp",
-        "atomic": "cpp",
-        "bit": "cpp",
-        "*.tcc": "cpp",
-        "cctype": "cpp",
-        "chrono": "cpp",
-        "clocale": "cpp",
-        "cmath": "cpp",
-        "compare": "cpp",
-        "complex": "cpp",
-        "concepts": "cpp",
-        "condition_variable": "cpp",
-        "cstdarg": "cpp",
-        "cstddef": "cpp",
-        "cstdint": "cpp",
-        "cstdio": "cpp",
-        "cstdlib": "cpp",
-        "cstring": "cpp",
-        "ctime": "cpp",
-        "cwchar": "cpp",
-        "cwctype": "cpp",
-        "deque": "cpp",
-        "forward_list": "cpp",
-        "list": "cpp",
-        "map": "cpp",
-        "set": "cpp",
-        "unordered_map": "cpp",
-        "unordered_set": "cpp",
-        "vector": "cpp",
-        "exception": "cpp",
-        "algorithm": "cpp",
-        "functional": "cpp",
-        "iterator": "cpp",
-        "memory": "cpp",
-        "memory_resource": "cpp",
-        "numeric": "cpp",
-        "optional": "cpp",
-        "random": "cpp",
-        "ratio": "cpp",
-        "string": "cpp",
-        "string_view": "cpp",
-        "system_error": "cpp",
-        "tuple": "cpp",
-        "type_traits": "cpp",
-        "utility": "cpp",
-        "hash_map": "cpp",
-        "fstream": "cpp",
-        "future": "cpp",
-        "initializer_list": "cpp",
-        "iomanip": "cpp",
-        "iosfwd": "cpp",
-        "iostream": "cpp",
-        "istream": "cpp",
-        "limits": "cpp",
-        "mutex": "cpp",
-        "new": "cpp",
-        "ostream": "cpp",
-        "ranges": "cpp",
-        "sstream": "cpp",
-        "stdexcept": "cpp",
-        "stop_token": "cpp",
-        "streambuf": "cpp",
-        "thread": "cpp",
-        "cinttypes": "cpp",
-        "typeinfo": "cpp",
-        "valarray": "cpp"
-    }
-}
\ No newline at end of file
diff --git a/tests/BUILD b/tests/BUILD
index 53f72ab4..47f90535 100644
--- a/tests/BUILD
+++ b/tests/BUILD
@@ -613,6 +613,7 @@ cc_test(
         "@com_google_googletest//:gtest_main",
         "//lib:gate_appl",
         "//lib:gates_cirq",
+        "//lib:gates_qsim",
         "//lib:mps_simulator",
         "//lib:formux",
     ],

From 9e4d79044546caec471cefe4b7182533d8265f9e Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 30 Sep 2021 22:42:34 +0200
Subject: [PATCH 104/246] Fix memory leak.

---
 lib/simulator_cuda.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/simulator_cuda.h b/lib/simulator_cuda.h
index 36b1e869..b507a224 100644
--- a/lib/simulator_cuda.h
+++ b/lib/simulator_cuda.h
@@ -60,6 +60,10 @@ class SimulatorCUDA final {
     ErrorCheck(cudaFree(d_idx));
     ErrorCheck(cudaFree(d_ms));
     ErrorCheck(cudaFree(d_xss));
+
+    if (scratch_ != nullptr) {
+      ErrorCheck(cudaFree(scratch_));
+    }
   }
 
   /**

From 42f5688ed82687d549e7fd0735616512cfcb6290 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 1 Oct 2021 07:57:49 -0700
Subject: [PATCH 105/246] Valid GPU, broken CPU

---
 CMakeLists.txt                         |  3 ++-
 pybind_interface/cuda/CMakeLists.txt   | 15 +++++++++++++--
 pybind_interface/decide/CMakeLists.txt | 15 +++++++++++++--
 setup.py                               |  2 ++
 4 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d631366c..8aa448e3 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,8 +1,9 @@
 cmake_minimum_required(VERSION 3.11)
-project(qsim)
+project(qsim LANGUAGES CXX CUDA)
 
 ADD_SUBDIRECTORY(pybind_interface/sse)
 ADD_SUBDIRECTORY(pybind_interface/avx512)
 ADD_SUBDIRECTORY(pybind_interface/avx2)
 ADD_SUBDIRECTORY(pybind_interface/basic)
+ADD_SUBDIRECTORY(pybind_interface/cuda)
 ADD_SUBDIRECTORY(pybind_interface/decide)
diff --git a/pybind_interface/cuda/CMakeLists.txt b/pybind_interface/cuda/CMakeLists.txt
index 75e23fbb..d7f5b836 100644
--- a/pybind_interface/cuda/CMakeLists.txt
+++ b/pybind_interface/cuda/CMakeLists.txt
@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.11)
-project(qsim)
+project(qsim LANGUAGES CXX CUDA)
 
 IF (WIN32)
     set(CMAKE_CXX_FLAGS "/O2 /openmp")
@@ -26,4 +26,15 @@ if(NOT pybind11_POPULATED)
   FetchContent_Populate(pybind11)
   add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
 endif()
-pybind11_add_module(qsim_cuda pybind_main_cuda.cpp)
+
+find_package(PythonLibs 3.6 REQUIRED)
+find_package(CUDA REQUIRED)
+
+include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
+
+cuda_add_library(qsim_cuda MODULE pybind_main_cuda.cpp)
+set_target_properties(qsim_cuda PROPERTIES
+       PREFIX "${PYTHON_MODULE_PREFIX}"
+       SUFFIX "${PYTHON_MODULE_EXTENSION}"
+)
+set_source_files_properties(pybind_main_cuda.cpp PROPERTIES LANGUAGE CUDA)
diff --git a/pybind_interface/decide/CMakeLists.txt b/pybind_interface/decide/CMakeLists.txt
index b7d28714..2c54f1cb 100644
--- a/pybind_interface/decide/CMakeLists.txt
+++ b/pybind_interface/decide/CMakeLists.txt
@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.11)
-project(qsim)
+project(qsim LANGUAGES CXX CUDA)
 
 IF (WIN32)
     set(CMAKE_CXX_FLAGS "/O2 /openmp")
@@ -25,4 +25,15 @@ if(NOT pybind11_POPULATED)
   FetchContent_Populate(pybind11)
   add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
 endif()
-pybind11_add_module(qsim_decide decide.cpp)
+
+find_package(PythonLibs 3.6 REQUIRED)
+find_package(CUDA REQUIRED)
+
+include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
+
+cuda_add_library(qsim_decide MODULE decide.cpp)
+set_target_properties(qsim_decide PROPERTIES
+      PREFIX "${PYTHON_MODULE_PREFIX}"
+      SUFFIX "${PYTHON_MODULE_EXTENSION}"
+)
+set_source_files_properties(decide.cpp PROPERTIES LANGUAGE CUDA)
diff --git a/setup.py b/setup.py
index 9fea30da..a6d76835 100644
--- a/setup.py
+++ b/setup.py
@@ -38,6 +38,7 @@ def run(self):
     def build_extension(self, ext):
         extdir = os.path.abspath(os.path.dirname(self.get_ext_fullpath(ext.name)))
         cmake_args = [
+            "-DCMAKE_CUDA_COMPILER=nvcc",
             "-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=" + extdir,
             "-DPYTHON_EXECUTABLE=" + sys.executable,
         ]
@@ -102,6 +103,7 @@ def build_extension(self, ext):
         CMakeExtension("qsimcirq/qsim_avx2"),
         CMakeExtension("qsimcirq/qsim_sse"),
         CMakeExtension("qsimcirq/qsim_basic"),
+        CMakeExtension("qsimcirq/qsim_cuda"),
         CMakeExtension("qsimcirq/qsim_decide"),
     ],
     cmdclass=dict(build_ext=CMakeBuild),

From 3b540b61b12317273bd05ec76b92c0d9c554757c Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 1 Oct 2021 08:27:05 -0700
Subject: [PATCH 106/246] Valid CPU+GPU, Linux

---
 CMakeLists.txt                         | 10 +++++++--
 pybind_interface/decide/CMakeLists.txt | 30 +++++++++++++++++---------
 2 files changed, 28 insertions(+), 12 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 8aa448e3..d1a6c0ea 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,9 +1,15 @@
 cmake_minimum_required(VERSION 3.11)
-project(qsim LANGUAGES CXX CUDA)
+
+execute_process(COMMAND which nvcc OUTPUT_VARIABLE has_nvcc)
+if(has_nvcc STREQUAL "")
+    project(qsim)
+else()
+    project(qsim LANGUAGES CXX CUDA)
+    ADD_SUBDIRECTORY(pybind_interface/cuda)
+endif()
 
 ADD_SUBDIRECTORY(pybind_interface/sse)
 ADD_SUBDIRECTORY(pybind_interface/avx512)
 ADD_SUBDIRECTORY(pybind_interface/avx2)
 ADD_SUBDIRECTORY(pybind_interface/basic)
-ADD_SUBDIRECTORY(pybind_interface/cuda)
 ADD_SUBDIRECTORY(pybind_interface/decide)
diff --git a/pybind_interface/decide/CMakeLists.txt b/pybind_interface/decide/CMakeLists.txt
index 2c54f1cb..3e9fcbb2 100644
--- a/pybind_interface/decide/CMakeLists.txt
+++ b/pybind_interface/decide/CMakeLists.txt
@@ -1,5 +1,11 @@
 cmake_minimum_required(VERSION 3.11)
-project(qsim LANGUAGES CXX CUDA)
+
+execute_process(COMMAND which nvcc OUTPUT_VARIABLE has_nvcc)
+if(has_nvcc STREQUAL "")
+  project(qsim)
+else()
+  project(qsim LANGUAGES CXX CUDA)
+endif()
 
 IF (WIN32)
     set(CMAKE_CXX_FLAGS "/O2 /openmp")
@@ -26,14 +32,18 @@ if(NOT pybind11_POPULATED)
   add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
 endif()
 
-find_package(PythonLibs 3.6 REQUIRED)
-find_package(CUDA REQUIRED)
+if(has_nvcc STREQUAL "")
+  pybind11_add_module(qsim_decide decide.cpp)
+else()
+  find_package(PythonLibs 3.6 REQUIRED)
+  find_package(CUDA REQUIRED)
 
-include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
+  include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
 
-cuda_add_library(qsim_decide MODULE decide.cpp)
-set_target_properties(qsim_decide PROPERTIES
-      PREFIX "${PYTHON_MODULE_PREFIX}"
-      SUFFIX "${PYTHON_MODULE_EXTENSION}"
-)
-set_source_files_properties(decide.cpp PROPERTIES LANGUAGE CUDA)
+  cuda_add_library(qsim_decide MODULE decide.cpp)
+  set_target_properties(qsim_decide PROPERTIES
+        PREFIX "${PYTHON_MODULE_PREFIX}"
+        SUFFIX "${PYTHON_MODULE_EXTENSION}"
+  )
+  set_source_files_properties(decide.cpp PROPERTIES LANGUAGE CUDA)
+endif()

From b543110dbce04f89ef1521fba465f438a86492d0 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Mon, 4 Oct 2021 16:32:46 +0200
Subject: [PATCH 107/246] Fix ASAN error.

---
 tests/simulator_testfixture.h | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/tests/simulator_testfixture.h b/tests/simulator_testfixture.h
index 17b571ec..717ff47d 100644
--- a/tests/simulator_testfixture.h
+++ b/tests/simulator_testfixture.h
@@ -1224,13 +1224,10 @@ void TestControlledGates(const Factory& factory, bool high_precision) {
   std::vector<fp_type> matrix;
   matrix.reserve(1 << (2 * max_target_qubits + 1));
 
-  std::vector<fp_type> vec;
-  vec.reserve(state_space.MinSize(max_qubits));
+  std::vector<fp_type> vec(state_space.MinSize(max_qubits));
 
   // Iterate over circuit size.
   for (unsigned num_qubits = 2; num_qubits <= max_qubits; ++num_qubits) {
-    vec.resize(state_space.MinSize(num_qubits));
-
     unsigned size = 1 << num_qubits;
     unsigned nmask = size - 1;
 

From e566ec807506afc10465689cb097aa5d22808216 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 4 Oct 2021 10:32:22 -0700
Subject: [PATCH 108/246] max_fused_gate_size recommendations

---
 qsimcirq/qsim_simulator.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index a7b52335..91d93849 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -126,8 +126,9 @@ class QSimOptions:
 
     Args:
         max_fused_gate_size: maximum number of qubits allowed per fused gate.
-            Depending on the capabilities of the device qsim runs on, this
-            usually has best performance when set to 3 or 4.
+            For circuits of less than 22 qubits, set this to 2 or 3 for peak
+            performance. Larger circuits (with >= 22 qubits) perform best
+            with this set to 3 or 4.
         cpu_threads: number of threads to use when running on CPU. For best
             performance, this should equal the number of cores on the device.
         ev_noisy_repetitions: number of repetitions used for estimating

From 9161bf3c287cd7ab93e40739bb125bbde91aa1d4 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 5 Oct 2021 07:24:49 -0700
Subject: [PATCH 109/246] account for complexity

---
 qsimcirq/qsim_simulator.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 91d93849..8f278a2f 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -126,9 +126,9 @@ class QSimOptions:
 
     Args:
         max_fused_gate_size: maximum number of qubits allowed per fused gate.
-            For circuits of less than 22 qubits, set this to 2 or 3 for peak
-            performance. Larger circuits (with >= 22 qubits) perform best
-            with this set to 3 or 4.
+            Circuits of less than 22 qubits usually perform best with this set
+            to 2 or 3, while larger circuits (with >= 22 qubits) typically
+            perform better with it set to 3 or 4.
         cpu_threads: number of threads to use when running on CPU. For best
             performance, this should equal the number of cores on the device.
         ev_noisy_repetitions: number of repetitions used for estimating

From 4c1a99c7a6979e6e0758a0a6d863813a218fb0a8 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Tue, 5 Oct 2021 17:47:02 +0000
Subject: [PATCH 110/246] Update to address comments from 95-martin-orion.

---
 docs/images/colab_connect.png          | Bin 75964 -> 69144 bytes
 docs/images/colab_connected.png        | Bin 32211 -> 30086 bytes
 docs/tutorials/gcp_before_you_begin.md |   1 +
 docs/tutorials/gcp_cpu.md              |  58 ++++++------
 docs/tutorials/gcp_gpu.md              | 119 +++++++++++--------------
 5 files changed, 80 insertions(+), 98 deletions(-)

diff --git a/docs/images/colab_connect.png b/docs/images/colab_connect.png
index 9c74edf91dfa433c6ccb1bd49ceb1c20dfc70b9f..1a52c18f4a0ced28b6b1bccc5c1b33dbf71c9cce 100644
GIT binary patch
literal 69144
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%0Djo&mU&+U}-WUQn%%fs5t+FmLjCTI9WtQ@3nUa
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
ao4bF!pCXN(e*5)b;P0ZEjw((C9q>QZ>~^mJ

literal 75964
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
DT$Ryu

diff --git a/docs/images/colab_connected.png b/docs/images/colab_connected.png
index d924bb393f9b9148a09267f82d7f8bdeb4e5d6bc..779a85ab45d199ed839e0feaa54ffb45d4cf3c7b 100644
GIT binary patch
literal 30086
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
XDy)2-W$hvH4}sKGw3G`JA3pyd{D1p5

literal 32211
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
F{{a!jH8}tP

diff --git a/docs/tutorials/gcp_before_you_begin.md b/docs/tutorials/gcp_before_you_begin.md
index 7dbe05c5..13296dfe 100644
--- a/docs/tutorials/gcp_before_you_begin.md
+++ b/docs/tutorials/gcp_before_you_begin.md
@@ -31,3 +31,4 @@ This tutorial depends on resources provided by the Google Cloud Platform.
     and click through to Enable it.
     *   For more information about enabling the Compute Engine API, see
         [Getting Started](https://cloud.google.com/apis/docs/getting-started) in
+        the Google Cloud documentation.
diff --git a/docs/tutorials/gcp_cpu.md b/docs/tutorials/gcp_cpu.md
index 59b52ef0..03571ccc 100644
--- a/docs/tutorials/gcp_cpu.md
+++ b/docs/tutorials/gcp_cpu.md
@@ -40,21 +40,22 @@ for your project.
 Use SSH to create an encrypted tunnel from your computer to your VM and redirect
 a local port to your VM over the tunnel.
 
-1.  Follow the instructions in the
+1.  Install the `gcloud` command line tool. Follow the instructions in the
     [Installing Cloud SDK](https://cloud.google.com/sdk/docs/install)
-    documentation to install the `gcloud` command line tool.
-1.  After installation, initialize the Google Cloud environment by using the
-    `gcloud init` command. You need to provide details about your VM, such as
-    the project name and the region where your VM is located.
+    documentation.
+2.  After installation, run the `gcloud init` command to initialize the Google
+    Cloud environment. You need to provide the `gcloud` tool with details
+    about your VM, such as the project name and the region where your VM is
+    located.
     1.  You can verify your environment by using the `gcloud config list`
         command.
-1.  Create an SSH tunnel and redirect a local port to use the tunnel by typing
+3.  Create an SSH tunnel and redirect a local port to use the tunnel by typing
     the following command in a terminal window on your computer. Replace
     `[YOUR_INSTANCE_NAME]` with the name of your VM.
 
-```
-gcloud compute ssh [YOUR_INSTANCE_NAME] -- -L 8888:localhost:8888
-```
+    ```
+    gcloud compute ssh [YOUR_INSTANCE_NAME] -- -L 8888:localhost:8888
+    ```
 
 When the command completes successfully, your prompt changes from your local
 machine to your virtual machine.
@@ -62,7 +63,7 @@ machine to your virtual machine.
 ## 3. Start the qsim Docker container on your virtual machine
 
 On your VM, start the qsim container by typing the following command at the
-command prompt on your VM from the previous step.
+command prompt, on your VM from the previous step.
 
 ```
 docker run -v `pwd`:/homedir -p 8888:8888 gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest &
@@ -100,7 +101,7 @@ and run your code.
 *   {Colab}
 
       You can write code in a Colab notebook, and use your VM to run your code. In
-      this step, we use the
+      this scenario, we use the
       [Get Started with qsimcirq Colab notebook](https://quantumai.google/qsim/tutorials/qsimcirq).
 
       1.  Open the
@@ -143,7 +144,7 @@ and run your code.
       **Before you begin**
 
       For this scenario, you can connect to your machine directly over SSH rather than
-      create a tunnel. In step 3.3 above, remove the second half of the command.
+      create a tunnel. In step 2.3 above, remove the second half of the command.
       Instead of the following command:
 
       ```
@@ -161,8 +162,8 @@ and run your code.
 
       **1. Copy the container ID for your qsim Docker container**
 
-      Use the `docker ps` command to display the container ID. The output should look
-      like the following text:
+      Run `docker ps` to display the container ID. The output should look like
+      the following text:
 
       ```
       CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES i
@@ -173,8 +174,8 @@ and run your code.
 
       **2. Connect to your qsim Docker container**
 
-      Use the docker exec command line tool to login to your container. Replace
-      `[CONTAINER_ID]` with the ID that you copied in step 1.
+      Run `docker exec` to login to your container. Replace `[CONTAINER_ID]`
+      with the ID that you copied in step 1.
 
       ```
       docker exec -it [CONTAINER_ID] /bin/bash
@@ -187,6 +188,7 @@ and run your code.
       You can use the code below to verify that qsim uses your qsim installation.
       You can paste the code directly into the REPL, or paste the code in a
       file.
+
       ```
       # Import Cirq and qsim
       import cirq
@@ -216,25 +218,10 @@ and run your code.
       [(0.7071067690849304+0j), 0j]
       ```
 
-## Clean up
-
-After you finish either tutorial, you can avoid continued billing by stopping or
-deleting the VM instance that you create; visit the
-[Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
-to manage your VM.
-
-For more information about managing your VM, see the following documentation
-from Google Cloud:
-
-*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
-*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
-*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
-
 ## Next steps
 
 After you finish, don't forget to stop or delete your VM on the Compute
-Instances dashboard. For more information, see the
-[Clean Up section in the Overview](https://quantumai.google/qsim/tutorials/gcp_overview#clean_up).
+Instances dashboard.
 
 You are now ready to run your own large simulations on Google Cloud. If you want
 to try a large circuit on Google Cloud, you can connect the
@@ -242,6 +229,13 @@ to try a large circuit on Google Cloud, you can connect the
 Colab notebook to your VM
 ([documentation](https://quantumai.google/qsim/tutorials/q32d14)).
 
+For more information about managing your VM, see the following documentation
+from Google Cloud:
+
+*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
+*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
+*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
+
 As an alternative to Google Cloud, you can download the Docker container or the
 qsim source code to run quantum simulations on your own high-performance
 computing platform.
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 6ce85650..8307aaac 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -18,7 +18,7 @@ instance heading, ensure that your VM has the following properties:
 *   In the Machine Configuration section, in the Machine Family options, click
     on the **GPU** filter.
 *   In the Machine Configuration section, in the Machine family options, in the
-    GPU type option, choose **NVIDIA Tesla A100**
+    GPU type option, choose **NVIDIA Tesla A100**.
     *   In the Number of GPUs option, choose **1**.
 *   In the Boot disk section, click the **Change** button.
     *   In the Operating System option, choose **Ubuntu**.
@@ -34,49 +34,56 @@ for your project.
 
 ### Find out more
 
+*   [Choosing hardware for your qsim simulation]()
 *   [Choosing the right machine family and type](https://cloud.google.com/blog/products/compute/choose-the-right-google-compute-engine-machine-type-for-you)
 *   [Creating a VM with attached GPUs](https://cloud.google.com/compute/docs/gpus/create-vm-with-gpus#create-new-gpu-vm)
 
 ## 2. Prepare your computer
 
-Use SSH to create an encrypted tunnel from your computer to your VM and redirect
-a local port to your VM over the tunnel.
+Use SSH in the `glcoud` tool to communicate with your VM.
 
-1.  Follow the instructions in the
+1.  Install the `gcloud` command line tool. Follow the instructions in the
     [Installing Cloud SDK](https://cloud.google.com/sdk/docs/install)
-    documentation to install the `gcloud` command line tool.
-2.  After installation, initialize the Google Cloud environment by using the
-    `gcloud init` command. You need to provide details about your VM, such as
-    the project name and the region where your VM is located.
+    documentation.
+2.  After installation, run the `gcloud init` command to initialize the Google
+    Cloud environment. You need to provide the `gcloud` tool with details
+    about your VM, such as the project name and the region where your VM is
+    located.
     1.  You can verify your environment by using the `gcloud config list`
         command.
-3.  Create an SSH tunnel and redirect a local port to use the tunnel by typing
-    the following command in a terminal window on your computer. Replace
-    `[YOUR_INSTANCE_NAME]` with the name of your VM.
+3.  Connect to your VM by using SSH.  Replace `[YOUR_INSTANCE_NAME]` with the
+    name of your VM.
 
-```shell
-gcloud compute ssh [YOUR_INSTANCE_NAME]
-```
+    ```shell
+    gcloud compute ssh [YOUR_INSTANCE_NAME]
+    ```
 
 When the command completes successfully, your prompt changes from your local
 machine to your virtual machine.
 
-## 3. Enable your virutal machine to use the GPu
+## 3. Enable your virutal machine to use the GPU
 
 1.  Install the GPU driver. In the Google Cloud documentation, in the Installing
-    GPU drivers guide, follow the steps provided:
-    *   In
-        [the Examples section](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#examples),
+    GPU drivers guide, follow the steps provided in the following sections:
+    *   [Examples](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#examples),
         under the Ubuntu tab. Only follow the steps for Ubuntu 20.04 (steps 3a
         through 3f).
-    *   In the
-        [Verifying the GPU driver install](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#verify-driver-install)
-        section.
-2.  Run `sudo apt install -y nvidia-cuda-toolkit` to install the CUDA toolkit.
+    *   [Verifying the GPU driver install](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#verify-driver-install)
+2.  Install the CUDA toolkit.
+
+    ```shell
+    sudo apt install -y nvidia-cuda-toolkit`
+    ```
+
 3.  Add your CUDA toolkit to the environment search path.
-    1.  Run `ls /usr/local` to discover the directory of the CUDA toolkit that
-        you installed. The toolkit will be the highest number that looks like
-        the pattern `cuda-XX.Y`.  The output of the command should resemble the
+    1.  Discover the directory of the CUDA toolkit that you installed.
+
+        ```shell
+        ls /usr/local
+        ```
+
+        The toolkit is the highest number that looks like the pattern
+        `cuda-XX.Y`.  The output of the command should resemble the
         following:
 
         ```shell
@@ -84,9 +91,9 @@ machine to your virtual machine.
         ```
 
         In this case, the directory is `cuda-11.4`.
-    2.  Add the CUDA toolkit path to your environment by appending the following
-        line to your `~/.bashrc` file.  Replace `[DIR]` with the CUDA directory that
-        you discovered in the previous step.
+    2.  Add the CUDA toolkit path to your environment. You can run the following
+        command to append the path to your `~/.bashrc` file.  Replace `[DIR]`
+        with the CUDA directory that you discovered in the previous step.
 
         ```shell
         echo "export PATH=/usr/local/[DIR]/bin${PATH:+:${PATH}}" >> ~/.bashrc
@@ -96,29 +103,34 @@ machine to your virtual machine.
 
 ## 4. Install build tools
 
-Run the following command to install the Cmake tool and the pip tool. This step
-might take a few minutes to complete.
+Install the tools required to build qsim. This step might take a few minutes to
+complete.
 
 ```shell
-sudo apt install cmake && sudo apt install pip
+sudo apt install cmake && sudo apt install pip && pip install pybind11
 ```
 
 
 ## 5. Create a GPU-enabled version of qsim
 
-1.  Run the following command to clone the qsim repository.
+1.  Clone the qsim repository.
 
     ```shell
     git clone https://github.com/quantumlib/qsim.git
     ```
 
-2.  Run `cd qsim`to change your working directory to qsim.
-3.  Run `make`to compile qsim. When CUDA toolkit is installed during a qsim
-    compilation, make builds the GPU version automatically.
+2.  Run `cd qsim` to change your working directory to qsim.
+3.  Run `make` to compile qsim. When make detects the CUDA toolkit during
+    compilation, make builds the GPU version of qsim automatically.
 4.  Run `pip install .` to install your local version of qsimcirq.
-5.  Run `python3 -c "import qsimcirq; print(qsimcirq.qsim_gpu)"`to verify your
-    installation. If the installation completed successfully, the output from
-    the command should resemble the following:
+5.  Verify your installation.
+
+    ```shell
+    python3 -c "import qsimcirq; print(qsimcirq.qsim_gpu)"
+    ```
+
+    If the installation completed successfully, the output from the command
+    should resemble the following:
 
     ```shell
     <module 'qsimcirq.qsim_cuda' from '/home/user_org_com/qsim/qsimcirq/qsim_cuda.cpython-38-x86_64-linux-gnu.so'>
@@ -128,17 +140,7 @@ sudo apt install cmake && sudo apt install pip
 ## 6. Verify your installation
 
 You can use the code below to verify that qsim uses your GPU. You can paste the
-code directly into the REPL, or paste the code in a file and ask the Python
-interpreter to run it. If you paste the code into a file, use the following
-command in the interpreter to run it. Replace `[FILE]` with the name of the file
-that you create.
-
-```
->>> exec(open("[FILE]").read())
-```
-
-In the `qsim` directory, run `python3` to start the Python REPL. Run the
-following code.
+code directly into the REPL, or paste the code in a file.
 
 ```
 # Import Cirq and qsim
@@ -170,26 +172,11 @@ After a moment, you should see a result that looks similar to the following.
 [(0.7071067690849304+0j), 0j]
 ```
 
-## Clean up
-
-After you finish either tutorial, you can avoid continued billing by stopping or
-deleting the VM instance that you create; visit the
-[Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
-to manage your VM.
-
-For more information about managing your VM, see the following documentation
-from Google Cloud:
-
-*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
-*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
-*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
-
 ## Next steps
 
 After you finish, don't forget to stop or delete your VM on the Compute
-Instances dashboard. For more information, see the
-[Clean Up section in the Overview](https://quantumai.google/qsim/tutorials/gcp_overview#clean_up).
+Instances dashboard.
 
 You are now ready to run your own large simulations on Google Cloud. For sample
 code of a large circuit, see the [Simulate a large
-circuit](https://quantumai.google/qsim/tutorials/q32d14) example.
+circuit](https://quantumai.google/qsim/tutorials/q32d14) tutorial.

From 4848a4c01f4ad21e4d3e6fa4e19dfe8d2514a0b5 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Tue, 5 Oct 2021 19:36:36 +0000
Subject: [PATCH 111/246] Remove refernce to choosing hardware doc (not
 published yet).

---
 docs/tutorials/gcp_cpu.md | 5 +++--
 docs/tutorials/gcp_gpu.md | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/tutorials/gcp_cpu.md b/docs/tutorials/gcp_cpu.md
index 03571ccc..a986ddbb 100644
--- a/docs/tutorials/gcp_cpu.md
+++ b/docs/tutorials/gcp_cpu.md
@@ -18,8 +18,9 @@ instance heading, ensure that your VM has the following properties:
 *   In the Machine Configuration section, in the Machine family options, in
     the Machine type option, choose **c2-standard-16**. This option gives
     you 16 virtual CPUS and 64MB of RAM.
-    *   This choice is for demonstration purposes only. For a live
-        experiment, see [Choosing hardware for your qsim simulation]().
+    *   This choice is for demonstration purposes only.
+<!-- TODO(cognigami): Add the following sentence to the sub-bullet when the doc
+is published: "For a live experiment, see [Choosing hardware for your qsim simulation]().-->
 *   In the Boot disk section, click the Change button, and choose
     Container-Optimized OS. This overrides step 3 in the quickstart guide.
 *   In the Firewall section, ensure that both the **Allow HTTP traffic**
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 8307aaac..cae908bf 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -34,7 +34,7 @@ for your project.
 
 ### Find out more
 
-*   [Choosing hardware for your qsim simulation]()
+<!-- TODO(cognigami): Add this line when the doc is published: "*   [Choosing hardware for your qsim simulation]()" -->
 *   [Choosing the right machine family and type](https://cloud.google.com/blog/products/compute/choose-the-right-google-compute-engine-machine-type-for-you)
 *   [Creating a VM with attached GPUs](https://cloud.google.com/compute/docs/gpus/create-vm-with-gpus#create-new-gpu-vm)
 

From 8b6b275b3b02eadacdd56d4d3c45d0b9f9d87bdb Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Tue, 5 Oct 2021 22:04:59 +0000
Subject: [PATCH 112/246] Added a few words to connect machine runtime to
 billing.

---
 docs/tutorials/gcp_cpu.md | 2 +-
 docs/tutorials/gcp_gpu.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/tutorials/gcp_cpu.md b/docs/tutorials/gcp_cpu.md
index a986ddbb..d75362b4 100644
--- a/docs/tutorials/gcp_cpu.md
+++ b/docs/tutorials/gcp_cpu.md
@@ -222,7 +222,7 @@ and run your code.
 ## Next steps
 
 After you finish, don't forget to stop or delete your VM on the Compute
-Instances dashboard.
+Instances dashboard to prevent further billing.
 
 You are now ready to run your own large simulations on Google Cloud. If you want
 to try a large circuit on Google Cloud, you can connect the
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index cae908bf..34725ce8 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -175,7 +175,7 @@ After a moment, you should see a result that looks similar to the following.
 ## Next steps
 
 After you finish, don't forget to stop or delete your VM on the Compute
-Instances dashboard.
+Instances dashboard to prevent further billing.
 
 You are now ready to run your own large simulations on Google Cloud. For sample
 code of a large circuit, see the [Simulate a large

From f45b6c64d4b1b134d315e561358b67ed093ad517 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 6 Oct 2021 08:11:18 -0700
Subject: [PATCH 113/246] retrigger checks


From 9ee08d4a909d41580fc9f48d7c6618d1c4453c87 Mon Sep 17 00:00:00 2001
From: jlow2397 <54644848+jlow2397@users.noreply.github.com>
Date: Wed, 6 Oct 2021 09:07:18 -0700
Subject: [PATCH 114/246] Removing qsimh content from marketing page

---
 docs/_index.yaml | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/docs/_index.yaml b/docs/_index.yaml
index 0b93d76c..1d657862 100644
--- a/docs/_index.yaml
+++ b/docs/_index.yaml
@@ -15,7 +15,7 @@
 book_path: /qsim/_book.yaml
 project_path: /qsim/_project.yaml
 description: >
-  Quantum circuit simulators qsim and qsimh.
+  Quantum circuit simulators qsim.
 landing_page:
   custom_css_path: /site-assets/css/style.css
   rows:
@@ -24,7 +24,7 @@ landing_page:
     - hero
     - description-50
     - padding-large
-    heading: qsim and qsimh
+    heading: qsim
     icon:
       path: /site-assets/images/icons/icon_qsim.png
     description: >
@@ -39,12 +39,6 @@ landing_page:
         qsim is integrated with Cirq and can be used to run simulations of up
         to 40 qubits on a 90 core Intel Xeon workstation.
         </p>
-        <h4>qsimh</h4>
-        <p>
-        qsimh is a hybrid Schrödinger-Feynman simulator built for parallel
-        execution on a cluster of machines. It produces amplitudes for user-
-        specified output bitstrings.
-        </p>
       buttons:
       - label: Get started with qsim on Cirq
         path: /qsim/tutorials/qsimcirq

From b98f06352bda589b41e9ed922d4b83580d2172ab Mon Sep 17 00:00:00 2001
From: jlow2397 <54644848+jlow2397@users.noreply.github.com>
Date: Wed, 6 Oct 2021 09:34:02 -0700
Subject: [PATCH 115/246] updating copy with feedback

---
 docs/_index.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/_index.yaml b/docs/_index.yaml
index 1d657862..064e2b70 100644
--- a/docs/_index.yaml
+++ b/docs/_index.yaml
@@ -15,7 +15,7 @@
 book_path: /qsim/_book.yaml
 project_path: /qsim/_project.yaml
 description: >
-  Quantum circuit simulators qsim.
+  Quantum circuit simulator qsim.
 landing_page:
   custom_css_path: /site-assets/css/style.css
   rows:

From 5f24cf95e9293da1fdc556a14bd06b134f3af001 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Wed, 6 Oct 2021 19:50:07 +0000
Subject: [PATCH 116/246] Restructure Guides book.

---
 docs/_book.yaml | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/docs/_book.yaml b/docs/_book.yaml
index 411999d6..77184a50 100644
--- a/docs/_book.yaml
+++ b/docs/_book.yaml
@@ -22,29 +22,28 @@ upper_tabs:
        - heading: "Other tutorials"
        - title: "Simulate a large circuit"
          path: /qsim/tutorials/q32d14
-       - title: "Noise simulation"
+       - title: "Simulate noise"
          path: /qsim/tutorials/noisy_qsimcirq
 
-   - name: "Guide"
+   - name: "Guides"
      contents:
-       - title: "qsim and qsimh"
+       - title: "Introduction"
          path: /qsim/overview
-       - title: "Usage"
+         #       TODO(cognigami): Uncomment this when you post the choose_hw doc.
+         #       - title: "Choosing hardware"
+         #      path: /qsim/choose_hw
+       - title: "Command line reference"
          path: /qsim/usage
-       - title: "Installing qsimcirq"
-         path: /qsim/install_qsimcirq
-       - title: "Cirq interface"
+       - title: "Python interface"
          path: /qsim/cirq_interface
-       - title: "Input circuit file format"
-         path: /qsim/input_format
-       - title: "Template naming"
+       - title: "C++ templates"
          path: /qsim/type_reference
-       - title: "Build with Bazel"
+       - title: "C++ builds with Bazel"
          path: /qsim/bazel
+       - title: "Docker builds"
+         path: /qsim/docker
        - title: "Testing qsim"
          path: /qsim/testing
-       - title: "Docker"
-         path: /qsim/docker
        - title: "Release process"
          path: /qsim/release
 

From b25715ed214efb5744cadc7819a9bb5b2abb7646 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Wed, 6 Oct 2021 19:57:04 +0000
Subject: [PATCH 117/246] Restructure Guides book.

---
 docs/_book.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/_book.yaml b/docs/_book.yaml
index 77184a50..21d2c2d0 100644
--- a/docs/_book.yaml
+++ b/docs/_book.yaml
@@ -62,3 +62,5 @@ upper_tabs:
      - include: /reference/cc/qsim/_doxygen.yaml
 
 - include: /_book/upper_tabs_right.yaml
+
+

From a4609d6dc089da0c70a85a4a8369f73b8f23a8ac Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Thu, 7 Oct 2021 14:22:47 +0000
Subject: [PATCH 118/246] Add Choosing Hardware guide. Integrate guide into
 nav, and resolve TODOs in other files.

---
 docs/_book.yaml                         |   5 +-
 docs/choose_hw.md                       | 933 ++++++++++++++++++++++++
 docs/images/choose_hw.png               | Bin 0 -> 47955 bytes
 docs/images/qsim_runtime_comparison.png | Bin 0 -> 201441 bytes
 docs/tutorials/gcp_cpu.md               |   5 +-
 docs/tutorials/gcp_gpu.md               |   2 +-
 6 files changed, 938 insertions(+), 7 deletions(-)
 create mode 100644 docs/choose_hw.md
 create mode 100644 docs/images/choose_hw.png
 create mode 100644 docs/images/qsim_runtime_comparison.png

diff --git a/docs/_book.yaml b/docs/_book.yaml
index 21d2c2d0..9fe4dae8 100644
--- a/docs/_book.yaml
+++ b/docs/_book.yaml
@@ -29,9 +29,8 @@ upper_tabs:
      contents:
        - title: "Introduction"
          path: /qsim/overview
-         #       TODO(cognigami): Uncomment this when you post the choose_hw doc.
-         #       - title: "Choosing hardware"
-         #      path: /qsim/choose_hw
+       - title: "Choosing hardware"
+         path: /qsim/choose_hw
        - title: "Command line reference"
          path: /qsim/usage
        - title: "Python interface"
diff --git a/docs/choose_hw.md b/docs/choose_hw.md
new file mode 100644
index 00000000..db65950d
--- /dev/null
+++ b/docs/choose_hw.md
@@ -0,0 +1,933 @@
+<devsite-mathjax config="TeX-AMS-MML_SVG"></devsite-mathjax>
+
+# Choosing hardware for your qsim simulation
+
+As you increase the size and complexity of your quantum simulation, you rapidly
+require a large increase in computational power. This guide describes
+considerations that can help you choose hardware for your simulation.
+
+Your simulation setup depends on the following:
+
+*   Noise; noisy (realistic) simulations require more compute power than
+    noiseless (idealised) simulations.
+*   Number of qubits.
+*   Circuit depth; the number of time steps required to perform the circuit.
+
+## Quick start
+
+The following graph provides loose guidelines to help you get started with
+choosing hardware for your simulation. The qubit upper bounds in this chart are
+not technical limits.
+
+![Decision tree for hardware to run a qsim simulation.](images/choose_hw.png)
+
+## Choose hardware for your simulation
+
+### 1. Evaluate whether your simulation can be run locally.
+
+If you have a modern laptop with at least 8GB of memory, you can run your
+simulation locally in the following cases:
+
+*   Noiseless simulations that use fewer than 29 qubits.
+*   Noisy simulations that use fewer than 18 qubits.
+
+If you intend to simulate a circuit many times, consider multinode simulation.
+For more information about multinode simulation
+[see step 5, below](#5_consider_multiple_compute_nodes).
+
+### 2. Estimate your memory requirements
+
+You can estimate your memory requirements with the following rule of thumb:
+
+*   Noiseless simulation: $ memory\ required = 8 \cdot 2^N bytes $ for an N-qubit
+    circuit
+*   Noisy simulation: $ memory\ required = 16 \cdot 2^N bytes $ for an N-qubit circuit
+
+In addition to memory size, consider the bandwidth of your memory. qsim performs
+best when it can use the maximum number of threads. Multi-threaded simulation
+benefits from high-bandwidth memory (above 100GB/s).
+
+### 3. Decide between CPUs and GPUs
+
+*   GPU hardware starts to outperform CPU hardware significantly (up to 15x
+    faster) for circuits with more than 20 qubits.
+*   The maximum number of qubits that you can simulate with a GPU is limited by
+    the memory of the GPU. Currently, for a noiseless simulation on an NVIDIA
+    A100 GPU, the maximum number of qubits is 32.
+*   For noiseless simulations with 32-40 qubits, you can use CPUs. However, the
+    runtime time increases exponentially with the number of qubits, and runtimes
+    are long for simulations above 32 qubits.
+
+The following chart shows the runtime for a circuit run on
+[Google Compute Engine](https://cloud.google.com/compute), using an NVidia A100
+processor, and a compute-optimized processor (c2-standard-4). Each circuit was
+run with three different phase damping channel (p) settings: 0, 0.1, and 0.001.
+The graph is log scale.
+
+![qsim runtime comparison on multipe processors and configurations](images/qsim_runtime_comparison.png)
+
+### 4. Select a specific machine
+
+After you decide whether you want to use CPUs or GPUs for your simulation,
+choose a specific machine:
+
+1.  Restrict your options to machines that meet your memory requirements. For
+    more information about memory requirements, see step 2.
+2.  Decide if performance (speed) or cost is more important to you:
+    *   For a table of performance benchmarks, see
+        [Sample benchmarks](#sample_benchmarks) below.
+    *   For more information about GCP pricing, see the
+        [Google Cloud pricing calculator](https://cloud.google.com/products/calculator).
+    *   Prioritizing performance is particularly important in the following
+        scenarios:
+        *   Simulating with an **higher f value** (f is the maximum number of
+            qubits allowed per fused gate).
+            *   For small to medium size circuits (up to 22 qubits), keep f low
+                (2 or 3)
+            *   For medium to large size qubits (22+ qubits), use a higher f (3
+                or 4)
+        *   Simulating a **deep circuit** (depth 30+).
+
+### 5. Consider multiple compute nodes
+
+Simulating in multinode mode is useful when your simulation can be parallelized.
+In a noisy simulation, the trajectories (also known as repetitions, iterations)
+are “embarrassingly parallelizable”, there is an automated workflow for
+distributing these trajectories over multiple nodes. A simulation of many
+noiseless circuits can also be distributed over multiple compute nodes.
+
+## Runtime estimates
+
+Runtime grows exponentially with the number of qubits, and linearly with circuit
+depth beyond 20 qubits.
+
+*   For noiseless simulations, runtime grows at a rate of $ 2^N $ for an N-qubit
+    circuit. For more information about runtimes for small circuits, see
+    [Additional notes for advanced users](#additional_notes_for_advanced_users)
+    below),
+*   For noisy simulations, runtime grows at a rate of $ 2^N $ multiplied by the
+    number of iterations for an N-qubit circuit.
+
+## Additional notes for advanced users
+
+*   The impact of noise on simulation depends on:
+    *   What type of errors are included in your noise channel (decoherence,
+        depolarizing channels, coherent errors, readout errors).
+    *   How you can represent your noise model using Kraus operator formalism
+        *   Performance is best in the case where all Kraus operators are
+            proportional to unitary matrices, such as when using only a
+            depolarizing channel. In this case, memory requirements are equal to
+            noiseless memory requirements (8\*2^n bytes)
+        *   Using noise which cannot be represented with Kraus operators
+            proportional to unitary matrices, can slow down simulations by a
+            factor of up to 6** **compared to using a depolarizing channel only
+        *   Noisy simulations are faster with lower noise (when one Kraus
+            operator dominates)
+*   Experimenting with the 'f' parameter (maximum number of qubits allowed per
+    fused gate):
+    *   The advanced user is advised to try out multiple f values to optimize
+        their simulation setup.
+        *   Note that f=2 or f=3 can be optimal for large circuits simulated on
+            CPUs with a smaller number of threads (say, up to four or eight
+            threads). However, this depends on the circuit structure.
+        *   Note that f=6 is very rarely optimal
+*   Using the optimal number of threads:
+    *   Use the maximum number of threads on CPUs for the best performance.
+    *   If the maximum number of threads is not used on multi-socket machines
+        then it is advisable to distribute threads evenly to all sockets or to
+        run all threads within a single socket. Separate simulations on each
+        socket can be run simultaneously in the latter case.
+    *   Note that currently the number of CPU threads does not affect the
+        performance for small circuits (smaller than 17 qubits). Only one thread
+        is used because of OpenMP overhead.
+*   Runtime estimates for small circuits:
+    *   For circuits that contain fewer than 20 qubits, the qsimcirq translation
+        layer performance overhead tends to dominate the runtime estimate. In
+        addition to this, qsim is not optimized for small circuits
+    *   ​​The total small circuits runtime overhead for an N qubit circuit
+        depends on the circuit depth and on N, and can be up to orders of
+        magnitude larger than $ 2^N $.
+
+## Sample benchmarks
+
+**Noiseless simulation benchmarks data sheet**
+
+For a random circuit, depth=20, f=3, max threads.
+
+<table>
+  <tr>
+   <td style="background-color: null"><strong>processor type</strong>
+   </td>
+   <td style="background-color: null"><strong>machine</strong>
+   </td>
+   <td style="background-color: null"><strong># of qubits</strong>
+   </td>
+   <td style="background-color: null"><strong>runtime</strong>
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">34
+   </td>
+   <td style="background-color: #f3f3f3">291.987
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">32
+   </td>
+   <td style="background-color: #f3f3f3">54.558
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">30
+   </td>
+   <td style="background-color: #f3f3f3">13.455
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">28
+   </td>
+   <td style="background-color: #f3f3f3">2.837
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">24
+   </td>
+   <td style="background-color: #f3f3f3">0.123
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">20
+   </td>
+   <td style="background-color: #f3f3f3">0.013
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">16
+   </td>
+   <td style="background-color: #f3f3f3">0.009
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #ffffff">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">30
+   </td>
+   <td style="background-color: null">52.880
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #ffffff">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">28
+   </td>
+   <td style="background-color: null">12.814
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #ffffff">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">24
+   </td>
+   <td style="background-color: null">0.658
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #ffffff">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">20
+   </td>
+   <td style="background-color: null">0.031
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #ffffff">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">16
+   </td>
+   <td style="background-color: null">0.008
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">32
+   </td>
+   <td style="background-color: #f3f3f3">7.415
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">30
+   </td>
+   <td style="background-color: #f3f3f3">1.561
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">28
+   </td>
+   <td style="background-color: #f3f3f3">0.384
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">24
+   </td>
+   <td style="background-color: #f3f3f3">0.030
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">20
+   </td>
+   <td style="background-color: #f3f3f3">0.010
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">16
+   </td>
+   <td style="background-color: #f3f3f3">0.007
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">t4
+   </td>
+   <td style="background-color: #f3f3f3">30
+   </td>
+   <td style="background-color: #f3f3f3">10.163
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">28
+   </td>
+   <td style="background-color: null">2.394
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">24
+   </td>
+   <td style="background-color: null">0.118
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">20
+   </td>
+   <td style="background-color: null">0.014
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">16
+   </td>
+   <td style="background-color: null">0.007
+   </td>
+  </tr>
+</table>
+
+**Noisy simulation benchmarks data sheet**
+
+For one trajectory of a random circuit, depth=20, f=3, max threads.
+
+<table>
+  <tr>
+   <td style="background-color: null"><strong>processor type</strong>
+   </td>
+   <td style="background-color: null"><strong>machine</strong>
+   </td>
+   <td style="background-color: null"><strong>noise type</strong>
+   </td>
+   <td style="background-color: null"><strong># of qubits</strong>
+   </td>
+   <td style="background-color: null"><strong>runtime</strong>
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">30
+   </td>
+   <td style="background-color: #f3f3f3">13.021
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">28
+   </td>
+   <td style="background-color: #f3f3f3">2.840
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">26
+   </td>
+   <td style="background-color: #f3f3f3">0.604
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">24
+   </td>
+   <td style="background-color: #f3f3f3">0.110
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">20
+   </td>
+   <td style="background-color: #f3f3f3">0.009
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">16
+   </td>
+   <td style="background-color: #f3f3f3">0.006
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">30
+   </td>
+   <td style="background-color: #f3f3f3">122.788
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">28
+   </td>
+   <td style="background-color: #f3f3f3">29.966
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">26
+   </td>
+   <td style="background-color: #f3f3f3">6.378
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">24
+   </td>
+   <td style="background-color: #f3f3f3">1.181
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">20
+   </td>
+   <td style="background-color: #f3f3f3">0.045
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">CPU
+   </td>
+   <td style="background-color: #f3f3f3">c2-standard-60
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">16
+   </td>
+   <td style="background-color: #f3f3f3">0.023
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #ffffff">CPU
+   </td>
+   <td style="background-color: #ffffff">c2-standard-4-4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: #ffffff">26
+   </td>
+   <td style="background-color: #ffffff">2.807
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">24
+   </td>
+   <td style="background-color: null">0.631
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">20
+   </td>
+   <td style="background-color: null">0.027
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">16
+   </td>
+   <td style="background-color: null">0.005
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">26
+   </td>
+   <td style="background-color: null">33.038
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">24
+   </td>
+   <td style="background-color: null">7.432
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">20
+   </td>
+   <td style="background-color: null">0.230
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">CPU
+   </td>
+   <td style="background-color: null">c2-standard-4-4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">16
+   </td>
+   <td style="background-color: null">0.014
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">30
+   </td>
+   <td style="background-color: #f3f3f3">1.568
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">28
+   </td>
+   <td style="background-color: #f3f3f3">0.391
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">26
+   </td>
+   <td style="background-color: #f3f3f3">0.094
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">24
+   </td>
+   <td style="background-color: #f3f3f3">0.026
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">20
+   </td>
+   <td style="background-color: #f3f3f3">0.006
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">depolarizing
+   </td>
+   <td style="background-color: #f3f3f3">16
+   </td>
+   <td style="background-color: #f3f3f3">0.004
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">30
+   </td>
+   <td style="background-color: #f3f3f3">17.032
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">28
+   </td>
+   <td style="background-color: #f3f3f3">3.959
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">26
+   </td>
+   <td style="background-color: #f3f3f3">0.896
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">24
+   </td>
+   <td style="background-color: #f3f3f3">0.236
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">20
+   </td>
+   <td style="background-color: #f3f3f3">0.029
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: #f3f3f3">GPU
+   </td>
+   <td style="background-color: #f3f3f3">a100
+   </td>
+   <td style="background-color: #f3f3f3">dephasing
+   </td>
+   <td style="background-color: #f3f3f3">16
+   </td>
+   <td style="background-color: #f3f3f3">0.021
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">30
+   </td>
+   <td style="background-color: null">10.229
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">28
+   </td>
+   <td style="background-color: null">2.444
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">26
+   </td>
+   <td style="background-color: null">0.519
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">24
+   </td>
+   <td style="background-color: null">0.115
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">20
+   </td>
+   <td style="background-color: null">0.009
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">depolarizing
+   </td>
+   <td style="background-color: null">16
+   </td>
+   <td style="background-color: null">0.004
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">28
+   </td>
+   <td style="background-color: null">21.800
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">26
+   </td>
+   <td style="background-color: null">5.056
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">24
+   </td>
+   <td style="background-color: null">1.164
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">20
+   </td>
+   <td style="background-color: null">0.077
+   </td>
+  </tr>
+  <tr>
+   <td style="background-color: null">GPU
+   </td>
+   <td style="background-color: null">t4
+   </td>
+   <td style="background-color: null">dephasing
+   </td>
+   <td style="background-color: null">16
+   </td>
+   <td style="background-color: null">0.017
+   </td>
+  </tr>
+</table>
diff --git a/docs/images/choose_hw.png b/docs/images/choose_hw.png
new file mode 100644
index 0000000000000000000000000000000000000000..76a894b4805f0510867aca882dcf767c994120c5
GIT binary patch
literal 47955
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

literal 0
HcmV?d00001

diff --git a/docs/images/qsim_runtime_comparison.png b/docs/images/qsim_runtime_comparison.png
new file mode 100644
index 0000000000000000000000000000000000000000..ac6030742964fdbc92c091b3a28f40e07975d49e
GIT binary patch
literal 201441
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%0Dty20Meb-#R9b^S<W{`u?bg`li3E3<(}YZ
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

literal 0
HcmV?d00001

diff --git a/docs/tutorials/gcp_cpu.md b/docs/tutorials/gcp_cpu.md
index d75362b4..f68e61e5 100644
--- a/docs/tutorials/gcp_cpu.md
+++ b/docs/tutorials/gcp_cpu.md
@@ -18,9 +18,8 @@ instance heading, ensure that your VM has the following properties:
 *   In the Machine Configuration section, in the Machine family options, in
     the Machine type option, choose **c2-standard-16**. This option gives
     you 16 virtual CPUS and 64MB of RAM.
-    *   This choice is for demonstration purposes only.
-<!-- TODO(cognigami): Add the following sentence to the sub-bullet when the doc
-is published: "For a live experiment, see [Choosing hardware for your qsim simulation]().-->
+    *   This choice is for demonstration purposes only. For a live experiment,
+        see [Choosing hardware for your qsim simulation](/qsim/choose_hw)
 *   In the Boot disk section, click the Change button, and choose
     Container-Optimized OS. This overrides step 3 in the quickstart guide.
 *   In the Firewall section, ensure that both the **Allow HTTP traffic**
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 34725ce8..e575bb2a 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -34,7 +34,7 @@ for your project.
 
 ### Find out more
 
-<!-- TODO(cognigami): Add this line when the doc is published: "*   [Choosing hardware for your qsim simulation]()" -->
+*   For a live experiment, see [Choosing hardware for your qsim simulation](/qsim/choose_hw)
 *   [Choosing the right machine family and type](https://cloud.google.com/blog/products/compute/choose-the-right-google-compute-engine-machine-type-for-you)
 *   [Creating a VM with attached GPUs](https://cloud.google.com/compute/docs/gpus/create-vm-with-gpus#create-new-gpu-vm)
 

From 74b1a67cf921f8744a0c3aa3d3fcbc067ba19002 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Thu, 7 Oct 2021 17:22:11 +0000
Subject: [PATCH 119/246] Revisions based on internal review.

---
 docs/choose_hw.md         | 18 +++++++++---------
 docs/tutorials/gcp_gpu.md |  2 +-
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/choose_hw.md b/docs/choose_hw.md
index db65950d..7ddfc76d 100644
--- a/docs/choose_hw.md
+++ b/docs/choose_hw.md
@@ -23,7 +23,7 @@ not technical limits.
 
 ## Choose hardware for your simulation
 
-### 1. Evaluate whether your simulation can be run locally.
+### 1. Evaluate whether your simulation can be run locally
 
 If you have a modern laptop with at least 8GB of memory, you can run your
 simulation locally in the following cases:
@@ -60,7 +60,7 @@ benefits from high-bandwidth memory (above 100GB/s).
 
 The following chart shows the runtime for a circuit run on
 [Google Compute Engine](https://cloud.google.com/compute), using an NVidia A100
-processor, and a compute-optimized processor (c2-standard-4). Each circuit was
+GPU, and a compute-optimized CPU (c2-standard-4). Each circuit was
 run with three different phase damping channel (p) settings: 0, 0.1, and 0.001.
 The graph is log scale.
 
@@ -80,12 +80,12 @@ choose a specific machine:
         [Google Cloud pricing calculator](https://cloud.google.com/products/calculator).
     *   Prioritizing performance is particularly important in the following
         scenarios:
-        *   Simulating with an **higher f value** (f is the maximum number of
+        *   Simulating with a **higher f value** (f is the maximum number of
             qubits allowed per fused gate).
             *   For small to medium size circuits (up to 22 qubits), keep f low
-                (2 or 3)
-            *   For medium to large size qubits (22+ qubits), use a higher f (3
-                or 4)
+                (2 or 3).
+            *   For medium to large size qubits (22+ qubits), use a higher f
+                typically, f=4 is the best option).
         *   Simulating a **deep circuit** (depth 30+).
 
 ### 5. Consider multiple compute nodes
@@ -144,9 +144,9 @@ depth beyond 20 qubits.
     *   For circuits that contain fewer than 20 qubits, the qsimcirq translation
         layer performance overhead tends to dominate the runtime estimate. In
         addition to this, qsim is not optimized for small circuits
-    *   ​​The total small circuits runtime overhead for an N qubit circuit
-        depends on the circuit depth and on N, and can be up to orders of
-        magnitude larger than $ 2^N $.
+    *   The total small circuits runtime overhead for an N qubit circuit
+        depends on the circuit depth and on N. The overhead can be large enough to
+        conceal the  $ 2^N $ growth in runtime.
 
 ## Sample benchmarks
 
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index e575bb2a..61e686fe 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -34,7 +34,7 @@ for your project.
 
 ### Find out more
 
-*   For a live experiment, see [Choosing hardware for your qsim simulation](/qsim/choose_hw)
+*   [Choosing hardware for your qsim simulation](/qsim/choose_hw)
 *   [Choosing the right machine family and type](https://cloud.google.com/blog/products/compute/choose-the-right-google-compute-engine-machine-type-for-you)
 *   [Creating a VM with attached GPUs](https://cloud.google.com/compute/docs/gpus/create-vm-with-gpus#create-new-gpu-vm)
 

From 0e4e8c6ff66777c04b6c6024c34eac4f6c5592fa Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 7 Oct 2021 10:27:03 -0700
Subject: [PATCH 120/246] Address review comments.

---
 docs/tutorials/multinode/README.md         | 235 +++++++++------------
 docs/tutorials/multinode/terraform/init.sh |  10 +-
 2 files changed, 108 insertions(+), 137 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index f7ab47e8..21e00f0e 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -1,85 +1,64 @@
 # Multinode quantum simulation using HTCondor on GCP
-This tutorial will take you through the process of running multiple simultaneous
-`qsim` simulations on Google Cloud. In some situations, it is required to run
-many instances of the same simulation. This could be used to provide a parameter
-sweep or to evaluate noise characteristics.
 
-## Objectives
+In this tutorial, you will configure HTCondor to run multiple simulations of a
+quantum circuit in parallel across multiple nodes. This method can be used to
+accelerate Monte Carlo simulations of noisy quantum circuits.
+
+Objectives of this tutorial:
 
 * Use `terraform` to deploy a HTCondor cluster
-* Run a multi-node simulation using HTCondor
+* Run a multinode simulation using HTCondor
 * Query cluster information and monitor running jobs in HTCondor
 * Use `terraform` to destroy the cluster
 
-
-## Step 1: Create a project
-If necessary, you can run this tutorial in an existing project, but to avoid collisions or damage to existing work, it is often better to create a new project.
-
-In this [GCP setup tutorial](https://quantumai.google/qsim/tutorials/qsimcirq_gcp#gcp_setup), the method to create Google Cloud project is explained in detail.
-
-When you have a project created, move on to the next step.
-
-> IMPORTANT: For this tutorial, it is best if you have `Owner` privilege on the project. If you do not have owner rights, the following roles will be required:
-```bash
-roles/compute.admin
-roles/iam.serviceAccountUser
-roles/monitoring.admin
-roles/logging.admin
-roles/autoscaling.metricsWrite
-```
-Your Cloud admin will be able to provide these roles.
-
-## Step 2: Configure your environment
+## 1. Configure your environment
 
 Although this tutorial can be run from your local computer, we recommend the use
 of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
 
-Once you have created  a project in the previous step, 
-the Cloud Console with Cloud Shell activeated can be reached through this link: (https://console.cloud.google.com/home/dashboard?cloudshell=true)
+Once you have completed the [Before you begin](./gcp_before_you_begin.md)
+tutorial, open the [Cloud Shell in the Cloud Console](https://console.cloud.google.com/home/dashboard?cloudshell=true).
 
 ### Clone this repo
 
 In your Cloud Shell window, clone this Github repo.
 ``` bash
-git clone https://github.com/jrossthomson/qsim.git
+git clone https://github.com/quantumlib/qsim.git
 ```
 
 ### Change directory
+
 Change directory to the tutorial:
 ``` bash
 cd qsim/docs/tutorials/multinode/terraform
 ```
 This is where you will use `terraform` to create the HTCondor cluster required to run your jobs.
 
-### Edit `init.sh` file to customize your environment
+### Edit `init.sh` file to match your environment
 
-You can now edit `init.sh` to change the name of the project you are using. You
-can also change the zone and region as you see fit. More information is
-available [here](https://cloud.google.com/compute/docs/regions-zones).
+Using your favorite text file editor, open the `init.sh` file. The first few
+lines should look like this:
+```bash
+# ---- Edit below -----#
 
-Use your favorite text file editor, either the integrated [Cloud Shell
-Editor](https://cloud.google.com/shell/docs/editor-overview), `vim`, `emacs` or `nano`.
-For example:
-``` bash
-vim init.sh
-```
-The file has many lines, but only edit the first 4.
-``` bash
-export TF_VAR_project=quantum-htcondor-15
-export TF_VAR_project_id=us-east4-c
+export TF_VAR_project=[USER_PROJECT]
 export TF_VAR_zone=us-east4-c
 export TF_VAR_region=us-east4
 ```
+Replace `[USER_PROJECT]` with the project ID you chose in the `Before you begin`
+tutorial.
 
-The most important is the first line, indicating the name of the project you created above.
-``` bash
-export TF_VAR_project=my-quantum-htcondor-project
-```
-The project id needs to be globally unique and to be the same as the project you just created.
+The other lines can optionally be modified to adjust your environment.
+* The `TF_VAR_zone` and `TF_VAR_region` lines can be modified to select where
+your project will create new jobs.
+
+#### Find out more
+
+* [Choosing a zone and region](https://cloud.google.com/compute/docs/regions-zones)
 
 ### Source the `init.sh` file
-The edited `init.sh` file should be "sourced" in the cloud shell:
 
+The edited `init.sh` file should be "sourced" in the cloud shell:
 ``` bash
 source init.sh
 ```
@@ -95,10 +74,10 @@ The final outcome of this script will include:
 This will take up to 60 seconds. At the end you will see output about
 permissions and the configuration of the account.
 
-##  Step 3: Run terraform
+## 2. Run terraform
 
-After the previous steps are completed, you can initialize `terraform` to begin your cluster creation.
-The first step is to initialize the `terraform` state.
+After the previous steps are completed, you can initialize `terraform` to begin
+your cluster creation. The first step is to initialize the `terraform` state.
 ``` bash
 terraform init
 ```
@@ -106,9 +85,11 @@ A successful result will contain the text:
 ```
 Terraform has been successfully initialized!
 ```
+
 ### Run the `make` command
-For convenience, some terraform commands are prepared in a `Makefile`. This means
-you can now create your cluster, with a simple `make` command.
+
+For convenience, some terraform commands are prepared in a `Makefile`. This
+means you can now create your cluster, with a simple `make` command.
 ```bash
 make apply
 ```
@@ -116,26 +97,27 @@ A successful run will show:
 ```
 Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
 ```
-## Step4: Connect to the _submit_ node for HTCondor
-Although there are ways to run `HTCondor` commands from your local machine, 
-the normal path  is to login to the _submit_ node. From there you can run 
-commands to submit and monitor jobs on HTCondor.
 
-### List VMs that were created by
+## 3. Connect to the submit node for HTCondor
 
-You can list the VMs created. One of them will be the submit node. It will be the VM with
-"submit" in the name.
+Although there are ways to run HTCondor commands from your local machine, 
+the normal path  is to login to the submit node. From there you can run 
+commands to submit and monitor jobs on HTCondor.
 
-```
+### List VMs that were created by HTCondor
+
+To see the VMs created by HTCondor, run:
+```bash
 gcloud compute instances list
 ```
-You will see two instances listed:
-* c-manager: the core controller node
-* c-submit: the submit node where you will run interactive work.
+At this point in the tutorial, you will see two instances listed:
 
-Identify then log in to the `submit` node. If you used the standard install, the
-cluster name is "c". In that case you would connect using the `gcloud ssh`
-command.
+* c-manager: the [central manager node](https://htcondor.readthedocs.io/en/latest/getting-htcondor/admin-quick-start.html#the-central-manager-role),
+which manages resource requests behind the scenes
+* c-submit: the [submit node](https://htcondor.readthedocs.io/en/latest/getting-htcondor/admin-quick-start.html#the-submit-role),
+where you will submit jobs to be run in the cluster
+
+Identify and log into the submit node:
 ```bash
 gcloud compute ssh c-submit
 ```
@@ -145,12 +127,9 @@ something like:
 [mylogin@c-submit ~]$
 ```
 
-### Checking the status 
-You can verify if the HTCondor install is completed:
-```
-condor_q
-```
-You will see output:
+### Checking the status
+
+You can run `condor_q` to verify if the HTCondor install is completed. The output should look something like this:
 ```
 -- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
 OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
@@ -161,65 +140,51 @@ Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held,
 ```
 If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
 
-## Step 5: Get the sample code and run it
-The HTCondor cluster is now ready for your jobs to be run. If you are familiar with HTCondor and you want to run your own jobs, you may do so. 
+## 4. Get the sample code and run it
 
-If you don't have jobs to run, you can get sample jobs from this Github repo. You will clone the repo to 
-the submit node and run a job.
+The HTCondor cluster is now ready for your jobs to be run. For this tutorial,
+sample jobs have been provided in the Github repo.
 
 ###  Clone the repo on your cluster
 
-on the `submit` node you you can install the repo to get access to previously created submission files:
-```
-git clone https://github.com/jrossthomson/qsim.git
+On the submit node, you can install the repo to get access to previously
+created submission files:
+```bash
+git clone https://github.com/quantumlib/qsim.git
 ```
 Then cd to the tutorial directory.
-```
+```bash
 cd qsim/docs/tutorials/multinode
 ```
+
 ### Submit a job
+
 Now it is possible to submit a job:
 ```
 condor_submit noiseless.sub
 ```
-If successful, the output will be:
+This job will run the code in `noiseless3.py`, which executes a simple circuit and prints the results as a histogram. If successful, the output will be:
 ```
 Submitting job(s).
 1 job(s) submitted to cluster 1.
 ```
 You can see the job in queue with the `condor_q` command.
-```
-condor_q
-```
+
 The job will take several minutes to finish. The time includes creating a VM
-compute node, installing the HTCondor system and running the job. When completed
-the files will be in the `out` directory.
-```
-ls out
-```
-will list the files:
-```
-err.1-0  log.1-0  out.1-0  placeholder
-```
-You can also see the progress of the job through the log file:
-```
-tail -f out/log.1-0
-```
-After the job is completed, the output of the job can be seen:
-```
-cat out/out.1-0
-```
-## Step5: Run multi-node noise simulations
+compute node, installing the HTCondor system and running the job. When complete, the following files will be stored in the `out` directory:
+
+* `out/log.1-0` contains a progress log for the job as it executes.
+* `out/out.1-0` contains the final output of the job.
+* `out/err.1-0` contains any error reports. This should be empty.
+
+To view one of these files in the shell, you can run `cat [FILE]`,
+replacing `[FILE]` with the name of the file to be viewed.
+
+## 5. Run multinode noise simulations
+
 Noise simulations make use of a [Monte Carlo
 method](https://en.wikipedia.org/wiki/Monte_Carlo_method) for [quantum
-trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory). 
-
-The primary goal of these simulations is to understand the behavior of the
-quantum circuit taking into account the effects of noise. There are many
-potential sources of noise in a quantum circuit, including thermal noise, 1/f
-noise or shot noise, as well as perturbations from cosmic rays. Understanding
-and calibrating noise in quantum computing is an active field of investigation,
-and it will require well characterized simulations.
+trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory).
 
 To run multiple simulations, you can run the submit file `noise.sub`.  The
 submit file is shown below. It is key to note that this is running  a `docker`
@@ -231,6 +196,13 @@ parameter ranges where circuits are particularly susceptible to noise.
 
 
 ### The noise.sub file
+
+To run multiple simulations, you can define a "submit file". `noise.sub` is
+an example of this file format, and is shown below. Notable features include:
+
+* `universe = docker` means that all jobs will run inside a `docker` container.
+* `queue 50` submits 50 separate copies of the job.
+
 ```
 universe                = docker
 docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
@@ -248,30 +220,24 @@ The job can be submitted with the `condor_submit` command.
 ```
 condor_submit noise.sub
 ```
-The output will look as follows:
+The output should look like this:
 ```
 Submitting job(s)..................................................
 50 job(s) submitted to cluster 2.
 ```
 To monitor the ongoing process of jobs running, you can take advantage of the
-Linux `watch` command and run `condor_q` repeatedly. When complete watch can
-be exited with cntrl-c.
+Linux `watch` command to run `condor_q` repeatedly:
 ```
 watch "condor_q; condor_status"
 ```
 The output of this command will show you the jobs in the queue as well as the
 VMs being created to run the jobs. There is a limit of 20 VMs for this
-configuration of the cluster. This can be modified for future runs.
-
-When the command shows the queue is empty, the command can be stopped with cntrl-c.
+configuration of the cluster.
 
-If this is the second _submit_ you have run, you can see the output of all
-the simulations. The output will be in the `out` directory. 
+When the queue is empty, the command can be stopped with CTRL-C.
 
-```
-cat out/out.2-*
-```
-You can see the results of the simulations.
+The output from all trajectories will be stored in the `out` directory. To see
+the results of the simulations, you can run `cat out/out.${TRAJECTORY_NUM}`, replacing `${TRAJECTORY_NUM}` with the trajectory number (e.g. `2-0`).
 ```
 Counter({3: 462, 0: 452, 2: 50, 1: 36})
 Counter({0: 475, 3: 435, 1: 49, 2: 41})
@@ -288,6 +254,11 @@ Counter({3: 466, 0: 442, 2: 51, 1: 41})
 
 ## Next steps
 
+This tutorial makes use of an experimental
+[autoscaling script](./terraform/htcondor/autoscaler.py) to bring up and turn
+down VMs as needed. After you finish, check the Compute Instances dashboard and
+stop or delete any remaining VM(s) to prevent further billing.
+
 The file being run in the previous example was `noise3.py`. To run your own
 simulations, simply create a new python file with your circuit and change the
 `noise3.py` references in `noise.sub` to point to the new file.
@@ -295,15 +266,13 @@ simulations, simply create a new python file with your circuit and change the
 A detailed discussion of how to construct various types of noise in Cirq can be
 found [here](https://quantumai.google/cirq/noise).
 
-## Final step: Shutting down
-
-> **IMPORTANT**:  To avoid excess billing for this project, it is important to shut down the cluster. This is easily done using the make command built for this purpose.
-```
-make destroy
-```
-
-> The most effective way to prevent further charges is to delete the project.
-[The instructions are here.](https://cloud.google.com/resource-manager/docs/creating-managing-projects#shutting_down_projects)
-
+For more information about managing your VMs, see the following documentation
+from Google Cloud:
 
+*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
+*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
+*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
 
+As an alternative to Google Cloud, you can download the Docker container or the
+qsim source code to run quantum simulations on your own high-performance
+computing platform.
diff --git a/docs/tutorials/multinode/terraform/init.sh b/docs/tutorials/multinode/terraform/init.sh
index c9d5d4bd..775ef679 100644
--- a/docs/tutorials/multinode/terraform/init.sh
+++ b/docs/tutorials/multinode/terraform/init.sh
@@ -1,11 +1,13 @@
 # ---- Edit below -----#
 
-export TF_VAR_project=quantum-htcondor-15
-export TF_VAR_project_id=us-east4-c
+export TF_VAR_project=[USER_PROJECT]
 export TF_VAR_zone=us-east4-c
 export TF_VAR_region=us-east4
-export TF_VAR_multizone=true
-export TF_VAR_numzones=4  # for regional/multizone, set to the number of regions in the zone
+
+export TF_VAR_multizone=false
+# For regional/multizone, set this to the number of regions in the zone.
+export TF_VAR_numzones=4
+
 # ---- Do not edit below -----#
 
 export TF_VAR_project_id=${TF_VAR_project}

From 1881a9f3aff6908adb4501de492f3a16d1c8f778 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 7 Oct 2021 12:41:51 -0700
Subject: [PATCH 121/246] Fix bumps in run-through

---
 docs/tutorials/multinode/README.md | 58 +++++++++++++++++++-----------
 1 file changed, 38 insertions(+), 20 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 21e00f0e..a791c380 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -25,6 +25,8 @@ In your Cloud Shell window, clone this Github repo.
 ``` bash
 git clone https://github.com/quantumlib/qsim.git
 ```
+If you get an error saying something like `qsim already exists`, you may need
+to delete the `qsim` directory with `rm -rf qsim` and rerun the clone command.
 
 ### Change directory
 
@@ -117,10 +119,15 @@ which manages resource requests behind the scenes
 * c-submit: the [submit node](https://htcondor.readthedocs.io/en/latest/getting-htcondor/admin-quick-start.html#the-submit-role),
 where you will submit jobs to be run in the cluster
 
-Identify and log into the submit node:
-```bash
-gcloud compute ssh c-submit
-```
+### Connecting to the submit node
+
+To connect to the submit node, navigate to the
+[Compute Instances](https://console.cloud.google.com/compute/instances) section
+of the Cloud Console and press the `SSH` button next to the `c-submit` instance.
+This will open a new window connected to the Submit node. You may see a prompt
+asking to "disable Identity-Aware Proxy" during this step; simply accept the
+prompt and the connection should complete.
+
 Now you are logged in to your HTCondor cluster. You will see a command prompt
 something like:
 ```bash
@@ -147,7 +154,7 @@ sample jobs have been provided in the Github repo.
 
 ###  Clone the repo on your cluster
 
-On the submit node, you can install the repo to get access to previously
+On the submit node, you can clone the repo to get access to previously
 created submission files:
 ```bash
 git clone https://github.com/quantumlib/qsim.git
@@ -186,18 +193,9 @@ Noise simulations make use of a [Monte Carlo
 method](https://en.wikipedia.org/wiki/Monte_Carlo_method) for [quantum
 trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory).
 
-To run multiple simulations, you can run the submit file `noise.sub`.  The
-submit file is shown below. It is key to note that this is running  a `docker`
-container. Also, the `queue 50` command at the end of the file submits 50
-separate instances of the container. Each simulation will be different due to
-the stochastic nature of noisy simulations. A typical analysis of the output
-would be a statistical study of the means and variations, perhaps looking for
-parameter ranges where circuits are particularly susceptible to noise.
-
-
 ### The noise.sub file
 
-To run multiple simulations, you can define a "submit file". `noise.sub` is
+To run multiple simulations, you can define a "submit" file. `noise.sub` is
 an example of this file format, and is shown below. Notable features include:
 
 * `universe = docker` means that all jobs will run inside a `docker` container.
@@ -237,7 +235,11 @@ configuration of the cluster.
 When the queue is empty, the command can be stopped with CTRL-C.
 
 The output from all trajectories will be stored in the `out` directory. To see
-the results of the simulations, you can run `cat out/out.${TRAJECTORY_NUM}`, replacing `${TRAJECTORY_NUM}` with the trajectory number (e.g. `2-0`).
+the results of all simulations together, you can run:
+```
+cat out/out.2-*
+```
+The output should look something like this:
 ```
 Counter({3: 462, 0: 452, 2: 50, 1: 36})
 Counter({0: 475, 3: 435, 1: 49, 2: 41})
@@ -252,12 +254,28 @@ Counter({3: 466, 0: 442, 2: 51, 1: 41})
 .
 ```
 
-## Next steps
+## 6. Shutting down
 
-This tutorial makes use of an experimental
+> **IMPORTANT**:  To avoid excess billing for this project, it is important to
+shut down the cluster. If your Cloud Shell is still open, simply run:
+```
+make destroy
+```
+If your Cloud Shell closed at any point, you'll need to re-initialize it.
+[Open a new shell](https://console.cloud.google.com/home/dashboard?cloudshell=true)
+and run:
+```
+cd qsim/docs/tutorials/multinode/terraform
+source init.sh
+make destroy
+```
+After these commands complete, check the Compute Instances dashboard to verify
+that all VMs have been shut down. This tutorial makes use of an experimental
 [autoscaling script](./terraform/htcondor/autoscaler.py) to bring up and turn
-down VMs as needed. After you finish, check the Compute Instances dashboard and
-stop or delete any remaining VM(s) to prevent further billing.
+down VMs as needed. If any VMs remain after several minutes, you may need to
+shut them down manually, as described in the next section.
+
+## Next steps
 
 The file being run in the previous example was `noise3.py`. To run your own
 simulations, simply create a new python file with your circuit and change the

From 2812f2005c9ca1e94cbb75d54eab191472ca5a81 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 7 Oct 2021 12:44:26 -0700
Subject: [PATCH 122/246] unquote important section

---
 docs/tutorials/multinode/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index a791c380..a292e6d5 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -256,7 +256,7 @@ Counter({3: 466, 0: 442, 2: 51, 1: 41})
 
 ## 6. Shutting down
 
-> **IMPORTANT**:  To avoid excess billing for this project, it is important to
+**IMPORTANT**:  To avoid excess billing for this project, it is important to
 shut down the cluster. If your Cloud Shell is still open, simply run:
 ```
 make destroy

From a6fdc2a73cfef2e45f595599aae8be4bcf208920 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 8 Oct 2021 08:26:09 -0700
Subject: [PATCH 123/246] Re-review

---
 docs/tutorials/multinode/README.md | 47 ++++++++++++++++++++----------
 1 file changed, 31 insertions(+), 16 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index a292e6d5..94d1eb59 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -47,8 +47,8 @@ export TF_VAR_project=[USER_PROJECT]
 export TF_VAR_zone=us-east4-c
 export TF_VAR_region=us-east4
 ```
-Replace `[USER_PROJECT]` with the project ID you chose in the `Before you begin`
-tutorial.
+Replace `[USER_PROJECT]` with the project name you chose on the
+`Before you begin` page.
 
 The other lines can optionally be modified to adjust your environment.
 * The `TF_VAR_zone` and `TF_VAR_region` lines can be modified to select where
@@ -113,26 +113,39 @@ To see the VMs created by HTCondor, run:
 gcloud compute instances list
 ```
 At this point in the tutorial, you will see two instances listed:
+```
+NAME: c-manager
+ZONE: us-central1-a
+MACHINE_TYPE: n1-standard-1
+PREEMPTIBLE:
+INTERNAL_IP: 10.128.0.3
+EXTERNAL_IP: 104.198.206.37
+STATUS: RUNNING
 
-* c-manager: the [central manager node](https://htcondor.readthedocs.io/en/latest/getting-htcondor/admin-quick-start.html#the-central-manager-role),
-which manages resource requests behind the scenes
-* c-submit: the [submit node](https://htcondor.readthedocs.io/en/latest/getting-htcondor/admin-quick-start.html#the-submit-role),
-where you will submit jobs to be run in the cluster
+NAME: c-submit
+ZONE: us-central1-a
+MACHINE_TYPE: n1-standard-1
+PREEMPTIBLE:
+INTERNAL_IP: 10.128.0.2
+EXTERNAL_IP: 35.238.197.124
+STATUS: RUNNING
+```
 
 ### Connecting to the submit node
 
-To connect to the submit node, navigate to the
-[Compute Instances](https://console.cloud.google.com/compute/instances) section
-of the Cloud Console and press the `SSH` button next to the `c-submit` instance.
-This will open a new window connected to the Submit node. You may see a prompt
-asking to "disable Identity-Aware Proxy" during this step; simply accept the
-prompt and the connection should complete.
+To connect to the submit node, click the `Compute Engine` item on the Cloud
+dashboard. This will open the VM Instances page, where you should see the two
+instances listed above. In the `c-submit` row, click on the `SSH` button to
+open a new window connected to the submit node. You may see a prompt asking to
+disable Identity-Aware Proxy during this step; simply accept the prompt and
+the connection should complete.
 
-Now you are logged in to your HTCondor cluster. You will see a command prompt
-something like:
+This new window is logged into your HTCondor cluster. You will see a command
+prompt that looks something like this:
 ```bash
 [mylogin@c-submit ~]$
 ```
+The following steps should be performed in this window.
 
 ### Checking the status
 
@@ -184,7 +197,7 @@ compute node, installing the HTCondor system and running the job. When complete,
 * `out/out.1-0` contains the final output of the job.
 * `out/err.1-0` contains any error reports. This should be empty.
 
-To view one of these files in the shell, you can run `cat [FILE]`,
+To view one of these files in the shell, you can run `cat out/[FILE]`,
 replacing `[FILE]` with the name of the file to be viewed.
 
 ## 5. Run multinode noise simulations
@@ -257,7 +270,9 @@ Counter({3: 466, 0: 442, 2: 51, 1: 41})
 ## 6. Shutting down
 
 **IMPORTANT**:  To avoid excess billing for this project, it is important to
-shut down the cluster. If your Cloud Shell is still open, simply run:
+shut down the cluster. Return to the Cloud dashboard window for the steps below.
+
+If your Cloud Shell is still open, simply run:
 ```
 make destroy
 ```

From ec94311f095c027403e3c14dea84bf3a689ae9db Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 8 Oct 2021 09:15:11 -0700
Subject: [PATCH 124/246] Minor cleanups

---
 docs/tutorials/multinode/README.md | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
index 94d1eb59..2cf434c7 100644
--- a/docs/tutorials/multinode/README.md
+++ b/docs/tutorials/multinode/README.md
@@ -118,16 +118,16 @@ NAME: c-manager
 ZONE: us-central1-a
 MACHINE_TYPE: n1-standard-1
 PREEMPTIBLE:
-INTERNAL_IP: 10.128.0.3
-EXTERNAL_IP: 104.198.206.37
+INTERNAL_IP: X.X.X.X
+EXTERNAL_IP: X.X.X.X
 STATUS: RUNNING
 
 NAME: c-submit
 ZONE: us-central1-a
 MACHINE_TYPE: n1-standard-1
 PREEMPTIBLE:
-INTERNAL_IP: 10.128.0.2
-EXTERNAL_IP: 35.238.197.124
+INTERNAL_IP: X.X.X.X
+EXTERNAL_IP: X.X.X.X
 STATUS: RUNNING
 ```
 
@@ -136,9 +136,10 @@ STATUS: RUNNING
 To connect to the submit node, click the `Compute Engine` item on the Cloud
 dashboard. This will open the VM Instances page, where you should see the two
 instances listed above. In the `c-submit` row, click on the `SSH` button to
-open a new window connected to the submit node. You may see a prompt asking to
-disable Identity-Aware Proxy during this step; simply accept the prompt and
-the connection should complete.
+open a new window connected to the submit node. During this step, you may see a
+prompt that reads `Connection via Cloud Identity-Aware Proxy Failed`; simply
+click on `Connect without Identity-Aware Proxy` and the connection should
+complete.
 
 This new window is logged into your HTCondor cluster. You will see a command
 prompt that looks something like this:

From b1aa2a08fc75813aebb6de13731ed1b12de42594 Mon Sep 17 00:00:00 2001
From: Antonio Sanchez <cantonios@google.com>
Date: Mon, 11 Oct 2021 11:58:57 -0700
Subject: [PATCH 125/246] Replace Eigen::all with Eigen::indexing::all.

A few placeholder symbols (including `last` and `all`) conflict with a lot of
local variable names across many external projects that currently have
`using namespace Eigen` statements. We (Eigen maintainers) decided to remove
the `Eigen::*` aliases to avoid these collisions.
---
 lib/mps_simulator.h | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/mps_simulator.h b/lib/mps_simulator.h
index 98d00310..8fbcbae1 100644
--- a/lib/mps_simulator.h
+++ b/lib/mps_simulator.h
@@ -220,7 +220,7 @@ class MPSSimulator final {
     block_0.fill(Complex(0, 0));
     const auto keep_cols = (svd_u.cols() > bond_dim) ? bond_dim : svd_u.cols();
     block_0.block(0, 0, svd_u.rows(), keep_cols).noalias() =
-        svd_u(Eigen::all, Eigen::seq(0, keep_cols - 1));
+        svd_u(Eigen::indexing::all, Eigen::seq(0, keep_cols - 1));
 
     // Place row product of S V into scratch to truncate and then B1.
     MatrixMap svd_v((Complex*)(raw_state + end), p, 2 * m_dim);
@@ -233,7 +233,8 @@ class MPSSimulator final {
     for (unsigned i = 0; i < keep_rows; ++i) {
       svd_v.row(i) *= s_vector(i);
     }
-    block_1.block(0, 0, keep_rows, svd_v.cols()).noalias() = svd_v(row_seq, Eigen::all);
+    block_1.block(0, 0, keep_rows, svd_v.cols()).noalias() =
+        svd_v(row_seq, Eigen::indexing::all);
   }
 
   For for_;

From 475cbe4de5551b43f8124d2dcda9f7adefc81b3c Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 12 Oct 2021 07:03:05 -0700
Subject: [PATCH 126/246] Fix broken example code

---
 docs/_index.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/_index.yaml b/docs/_index.yaml
index 064e2b70..093ca58b 100644
--- a/docs/_index.yaml
+++ b/docs/_index.yaml
@@ -58,9 +58,9 @@ landing_page:
 
         # Define a circuit to run
         # (Example is from the 2019 "Quantum Supremacy" experiement)
-        circuit = cirq.experiments.
+        circuit = (cirq.experiments.
             random_rotations_between_grid_interaction_layers_circuit(
-            qubits=qubits, depth=16)
+            qubits=qubits, depth=16))
 
         # Measure qubits at the end of the circuit
         circuit.append(cirq.measure(*qubits, key='all_qubits'))

From 153f7cf18eadb54a77dff52e7840836645bc4f2c Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Tue, 12 Oct 2021 18:08:33 +0000
Subject: [PATCH 127/246] Updates to text and images. Moved multinode tutorial
 to better place.

---
 docs/choose_hw.md                             |  33 +-
 docs/images/qsim_runtime_comparison.png       | Bin 201441 -> 0 bytes
 .../qsim_runtime_comparison_noiseless.png     | Bin 0 -> 134499 bytes
 docs/images/qsim_runtime_comparison_noisy.png | Bin 0 -> 129429 bytes
 docs/tutorials/multinode.md                   | 312 ++++++++++++++++++
 5 files changed, 331 insertions(+), 14 deletions(-)
 delete mode 100644 docs/images/qsim_runtime_comparison.png
 create mode 100644 docs/images/qsim_runtime_comparison_noiseless.png
 create mode 100644 docs/images/qsim_runtime_comparison_noisy.png
 create mode 100644 docs/tutorials/multinode.md

diff --git a/docs/choose_hw.md b/docs/choose_hw.md
index 7ddfc76d..09dd9177 100644
--- a/docs/choose_hw.md
+++ b/docs/choose_hw.md
@@ -32,8 +32,8 @@ simulation locally in the following cases:
 *   Noisy simulations that use fewer than 18 qubits.
 
 If you intend to simulate a circuit many times, consider multinode simulation.
-For more information about multinode simulation
-[see step 5, below](#5_consider_multiple_compute_nodes).
+For more information about multinode simulation [see step 5,
+below](#5_consider_multiple_compute_nodes).
 
 ### 2. Estimate your memory requirements
 
@@ -53,18 +53,20 @@ benefits from high-bandwidth memory (above 100GB/s).
     faster) for circuits with more than 20 qubits.
 *   The maximum number of qubits that you can simulate with a GPU is limited by
     the memory of the GPU. Currently, for a noiseless simulation on an NVIDIA
-    A100 GPU, the maximum number of qubits is 32.
+    A100 GPU (with 40GB of memory), the maximum number of qubits is 32.
 *   For noiseless simulations with 32-40 qubits, you can use CPUs. However, the
     runtime time increases exponentially with the number of qubits, and runtimes
     are long for simulations above 32 qubits.
 
-The following chart shows the runtime for a circuit run on
+The following charts show the runtime for a random circuit run on
 [Google Compute Engine](https://cloud.google.com/compute), using an NVidia A100
-GPU, and a compute-optimized CPU (c2-standard-4). Each circuit was
-run with three different phase damping channel (p) settings: 0, 0.1, and 0.001.
-The graph is log scale.
+GPU, and a compute-optimized CPU (c2-standard-4). The first chart shows the
+runtimes for the noiseless simulation. The second chart shows the runtimes for a
+noisy simulation, using a phase damping channel (p=0.01). The charts use a log
+scale.
 
-![qsim runtime comparison on multipe processors and configurations](images/qsim_runtime_comparison.png)
+![qsim runtime comparison on multipe processors: noiseless](images/qsim_runtime_comparison_noiseless.png)
+![qsim runtime comparison on multipe processors: noisy](images/qsim_runtime_comparison_noisy.png)
 
 ### 4. Select a specific machine
 
@@ -96,6 +98,9 @@ are “embarrassingly parallelizable”, there is an automated workflow for
 distributing these trajectories over multiple nodes. A simulation of many
 noiseless circuits can also be distributed over multiple compute nodes.
 
+For mor information about running a mulitnode simulation, see [Multinode quantum
+simulation using HTCondor on Google Cloud](/qsim/tutorials/multinode).
+
 ## Runtime estimates
 
 Runtime grows exponentially with the number of qubits, and linearly with circuit
@@ -104,7 +109,7 @@ depth beyond 20 qubits.
 *   For noiseless simulations, runtime grows at a rate of $ 2^N $ for an N-qubit
     circuit. For more information about runtimes for small circuits, see
     [Additional notes for advanced users](#additional_notes_for_advanced_users)
-    below),
+    below).
 *   For noisy simulations, runtime grows at a rate of $ 2^N $ multiplied by the
     number of iterations for an N-qubit circuit.
 
@@ -113,16 +118,16 @@ depth beyond 20 qubits.
 *   The impact of noise on simulation depends on:
     *   What type of errors are included in your noise channel (decoherence,
         depolarizing channels, coherent errors, readout errors).
-    *   How you can represent your noise model using Kraus operator formalism
+    *   How you can represent your noise model using Kraus operator formalism:
         *   Performance is best in the case where all Kraus operators are
             proportional to unitary matrices, such as when using only a
             depolarizing channel. In this case, memory requirements are equal to
-            noiseless memory requirements (8\*2^n bytes)
+            noiseless memory requirements (8\*2^n bytes).
         *   Using noise which cannot be represented with Kraus operators
             proportional to unitary matrices, can slow down simulations by a
             factor of up to 6** **compared to using a depolarizing channel only
         *   Noisy simulations are faster with lower noise (when one Kraus
-            operator dominates)
+            operator dominates).
 *   Experimenting with the 'f' parameter (maximum number of qubits allowed per
     fused gate):
     *   The advanced user is advised to try out multiple f values to optimize
@@ -130,7 +135,7 @@ depth beyond 20 qubits.
         *   Note that f=2 or f=3 can be optimal for large circuits simulated on
             CPUs with a smaller number of threads (say, up to four or eight
             threads). However, this depends on the circuit structure.
-        *   Note that f=6 is very rarely optimal
+        *   Note that f=6 is very rarely optimal.
 *   Using the optimal number of threads:
     *   Use the maximum number of threads on CPUs for the best performance.
     *   If the maximum number of threads is not used on multi-socket machines
@@ -143,7 +148,7 @@ depth beyond 20 qubits.
 *   Runtime estimates for small circuits:
     *   For circuits that contain fewer than 20 qubits, the qsimcirq translation
         layer performance overhead tends to dominate the runtime estimate. In
-        addition to this, qsim is not optimized for small circuits
+        addition to this, qsim is not optimized for small circuits.
     *   The total small circuits runtime overhead for an N qubit circuit
         depends on the circuit depth and on N. The overhead can be large enough to
         conceal the  $ 2^N $ growth in runtime.
diff --git a/docs/images/qsim_runtime_comparison.png b/docs/images/qsim_runtime_comparison.png
deleted file mode 100644
index ac6030742964fdbc92c091b3a28f40e07975d49e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 201441
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%0Dty20Meb-#R9b^S<W{`u?bg`li3E3<(}YZ
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

diff --git a/docs/images/qsim_runtime_comparison_noiseless.png b/docs/images/qsim_runtime_comparison_noiseless.png
new file mode 100644
index 0000000000000000000000000000000000000000..5849813c8f4bd4dfb223f0257ccfb39a7b203a32
GIT binary patch
literal 134499
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
I#<{Ei1AGv}1poj5

literal 0
HcmV?d00001

diff --git a/docs/images/qsim_runtime_comparison_noisy.png b/docs/images/qsim_runtime_comparison_noisy.png
new file mode 100644
index 0000000000000000000000000000000000000000..ae73659212bf4fcfe2b22c30a1e4856e712b2082
GIT binary patch
literal 129429
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%0A2Bu)ug!tg4?ci@bnt2=
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

literal 0
HcmV?d00001

diff --git a/docs/tutorials/multinode.md b/docs/tutorials/multinode.md
new file mode 100644
index 00000000..2cf434c7
--- /dev/null
+++ b/docs/tutorials/multinode.md
@@ -0,0 +1,312 @@
+# Multinode quantum simulation using HTCondor on GCP
+
+In this tutorial, you will configure HTCondor to run multiple simulations of a
+quantum circuit in parallel across multiple nodes. This method can be used to
+accelerate Monte Carlo simulations of noisy quantum circuits.
+
+Objectives of this tutorial:
+
+* Use `terraform` to deploy a HTCondor cluster
+* Run a multinode simulation using HTCondor
+* Query cluster information and monitor running jobs in HTCondor
+* Use `terraform` to destroy the cluster
+
+## 1. Configure your environment
+
+Although this tutorial can be run from your local computer, we recommend the use
+of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
+
+Once you have completed the [Before you begin](./gcp_before_you_begin.md)
+tutorial, open the [Cloud Shell in the Cloud Console](https://console.cloud.google.com/home/dashboard?cloudshell=true).
+
+### Clone this repo
+
+In your Cloud Shell window, clone this Github repo.
+``` bash
+git clone https://github.com/quantumlib/qsim.git
+```
+If you get an error saying something like `qsim already exists`, you may need
+to delete the `qsim` directory with `rm -rf qsim` and rerun the clone command.
+
+### Change directory
+
+Change directory to the tutorial:
+``` bash
+cd qsim/docs/tutorials/multinode/terraform
+```
+This is where you will use `terraform` to create the HTCondor cluster required to run your jobs.
+
+### Edit `init.sh` file to match your environment
+
+Using your favorite text file editor, open the `init.sh` file. The first few
+lines should look like this:
+```bash
+# ---- Edit below -----#
+
+export TF_VAR_project=[USER_PROJECT]
+export TF_VAR_zone=us-east4-c
+export TF_VAR_region=us-east4
+```
+Replace `[USER_PROJECT]` with the project name you chose on the
+`Before you begin` page.
+
+The other lines can optionally be modified to adjust your environment.
+* The `TF_VAR_zone` and `TF_VAR_region` lines can be modified to select where
+your project will create new jobs.
+
+#### Find out more
+
+* [Choosing a zone and region](https://cloud.google.com/compute/docs/regions-zones)
+
+### Source the `init.sh` file
+
+The edited `init.sh` file should be "sourced" in the cloud shell:
+``` bash
+source init.sh
+```
+Respond `Agree` to any pop-ups that request permissions on the Google Cloud platform.
+
+The final outcome of this script will include:
+
+* A gcloud config setup correctly
+* A service account created
+* The appropriate permissions assigned to the service account
+* A key file created to enable the use of Google Cloud automation.
+
+This will take up to 60 seconds. At the end you will see output about
+permissions and the configuration of the account.
+
+## 2. Run terraform
+
+After the previous steps are completed, you can initialize `terraform` to begin
+your cluster creation. The first step is to initialize the `terraform` state.
+``` bash
+terraform init
+```
+A successful result will contain the text:
+```
+Terraform has been successfully initialized!
+```
+
+### Run the `make` command
+
+For convenience, some terraform commands are prepared in a `Makefile`. This
+means you can now create your cluster, with a simple `make` command.
+```bash
+make apply
+```
+A successful run will show:
+```
+Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
+```
+
+## 3. Connect to the submit node for HTCondor
+
+Although there are ways to run HTCondor commands from your local machine, 
+the normal path  is to login to the submit node. From there you can run 
+commands to submit and monitor jobs on HTCondor.
+
+### List VMs that were created by HTCondor
+
+To see the VMs created by HTCondor, run:
+```bash
+gcloud compute instances list
+```
+At this point in the tutorial, you will see two instances listed:
+```
+NAME: c-manager
+ZONE: us-central1-a
+MACHINE_TYPE: n1-standard-1
+PREEMPTIBLE:
+INTERNAL_IP: X.X.X.X
+EXTERNAL_IP: X.X.X.X
+STATUS: RUNNING
+
+NAME: c-submit
+ZONE: us-central1-a
+MACHINE_TYPE: n1-standard-1
+PREEMPTIBLE:
+INTERNAL_IP: X.X.X.X
+EXTERNAL_IP: X.X.X.X
+STATUS: RUNNING
+```
+
+### Connecting to the submit node
+
+To connect to the submit node, click the `Compute Engine` item on the Cloud
+dashboard. This will open the VM Instances page, where you should see the two
+instances listed above. In the `c-submit` row, click on the `SSH` button to
+open a new window connected to the submit node. During this step, you may see a
+prompt that reads `Connection via Cloud Identity-Aware Proxy Failed`; simply
+click on `Connect without Identity-Aware Proxy` and the connection should
+complete.
+
+This new window is logged into your HTCondor cluster. You will see a command
+prompt that looks something like this:
+```bash
+[mylogin@c-submit ~]$
+```
+The following steps should be performed in this window.
+
+### Checking the status
+
+You can run `condor_q` to verify if the HTCondor install is completed. The output should look something like this:
+```
+-- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
+OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
+
+Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+Total for drj: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
+```
+If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
+
+## 4. Get the sample code and run it
+
+The HTCondor cluster is now ready for your jobs to be run. For this tutorial,
+sample jobs have been provided in the Github repo.
+
+###  Clone the repo on your cluster
+
+On the submit node, you can clone the repo to get access to previously
+created submission files:
+```bash
+git clone https://github.com/quantumlib/qsim.git
+```
+Then cd to the tutorial directory.
+```bash
+cd qsim/docs/tutorials/multinode
+```
+
+### Submit a job
+
+Now it is possible to submit a job:
+```
+condor_submit noiseless.sub
+```
+This job will run the code in `noiseless3.py`, which executes a simple circuit and prints the results as a histogram. If successful, the output will be:
+```
+Submitting job(s).
+1 job(s) submitted to cluster 1.
+```
+You can see the job in queue with the `condor_q` command.
+
+The job will take several minutes to finish. The time includes creating a VM
+compute node, installing the HTCondor system and running the job. When complete, the following files will be stored in the `out` directory:
+
+* `out/log.1-0` contains a progress log for the job as it executes.
+* `out/out.1-0` contains the final output of the job.
+* `out/err.1-0` contains any error reports. This should be empty.
+
+To view one of these files in the shell, you can run `cat out/[FILE]`,
+replacing `[FILE]` with the name of the file to be viewed.
+
+## 5. Run multinode noise simulations
+
+Noise simulations make use of a [Monte Carlo
+method](https://en.wikipedia.org/wiki/Monte_Carlo_method) for [quantum
+trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory).
+
+### The noise.sub file
+
+To run multiple simulations, you can define a "submit" file. `noise.sub` is
+an example of this file format, and is shown below. Notable features include:
+
+* `universe = docker` means that all jobs will run inside a `docker` container.
+* `queue 50` submits 50 separate copies of the job.
+
+```
+universe                = docker
+docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
+arguments               = python3 noise3.py
+should_transfer_files   = YES
+transfer_input_files    = noise3.py
+when_to_transfer_output = ON_EXIT
+output                  = out/out.$(Cluster)-$(Process)
+error                   = out/err.$(Cluster)-$(Process)
+log                     = out/log.$(Cluster)-$(Process)
+request_memory          = 10GB
+queue 50
+```
+The job can be submitted with the `condor_submit` command.
+```
+condor_submit noise.sub
+```
+The output should look like this:
+```
+Submitting job(s)..................................................
+50 job(s) submitted to cluster 2.
+```
+To monitor the ongoing process of jobs running, you can take advantage of the
+Linux `watch` command to run `condor_q` repeatedly:
+```
+watch "condor_q; condor_status"
+```
+The output of this command will show you the jobs in the queue as well as the
+VMs being created to run the jobs. There is a limit of 20 VMs for this
+configuration of the cluster.
+
+When the queue is empty, the command can be stopped with CTRL-C.
+
+The output from all trajectories will be stored in the `out` directory. To see
+the results of all simulations together, you can run:
+```
+cat out/out.2-*
+```
+The output should look something like this:
+```
+Counter({3: 462, 0: 452, 2: 50, 1: 36})
+Counter({0: 475, 3: 435, 1: 49, 2: 41})
+Counter({0: 450, 3: 440, 1: 59, 2: 51})
+Counter({0: 459, 3: 453, 2: 51, 1: 37})
+Counter({3: 471, 0: 450, 2: 46, 1: 33})
+Counter({3: 467, 0: 441, 1: 54, 2: 38})
+Counter({3: 455, 0: 455, 1: 50, 2: 40})
+Counter({3: 466, 0: 442, 2: 51, 1: 41})
+.
+.
+.
+```
+
+## 6. Shutting down
+
+**IMPORTANT**:  To avoid excess billing for this project, it is important to
+shut down the cluster. Return to the Cloud dashboard window for the steps below.
+
+If your Cloud Shell is still open, simply run:
+```
+make destroy
+```
+If your Cloud Shell closed at any point, you'll need to re-initialize it.
+[Open a new shell](https://console.cloud.google.com/home/dashboard?cloudshell=true)
+and run:
+```
+cd qsim/docs/tutorials/multinode/terraform
+source init.sh
+make destroy
+```
+After these commands complete, check the Compute Instances dashboard to verify
+that all VMs have been shut down. This tutorial makes use of an experimental
+[autoscaling script](./terraform/htcondor/autoscaler.py) to bring up and turn
+down VMs as needed. If any VMs remain after several minutes, you may need to
+shut them down manually, as described in the next section.
+
+## Next steps
+
+The file being run in the previous example was `noise3.py`. To run your own
+simulations, simply create a new python file with your circuit and change the
+`noise3.py` references in `noise.sub` to point to the new file.
+
+A detailed discussion of how to construct various types of noise in Cirq can be
+found [here](https://quantumai.google/cirq/noise).
+
+For more information about managing your VMs, see the following documentation
+from Google Cloud:
+
+*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
+*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
+*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
+
+As an alternative to Google Cloud, you can download the Docker container or the
+qsim source code to run quantum simulations on your own high-performance
+computing platform.

From 086b8790119253c079a6e66ae5f4505646c6ced7 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Tue, 12 Oct 2021 19:29:01 +0000
Subject: [PATCH 128/246] Remove duplicate content from multinode tutorial.

---
 docs/tutorials/multinode/README.md | 312 -----------------------------
 1 file changed, 312 deletions(-)
 delete mode 100644 docs/tutorials/multinode/README.md

diff --git a/docs/tutorials/multinode/README.md b/docs/tutorials/multinode/README.md
deleted file mode 100644
index 2cf434c7..00000000
--- a/docs/tutorials/multinode/README.md
+++ /dev/null
@@ -1,312 +0,0 @@
-# Multinode quantum simulation using HTCondor on GCP
-
-In this tutorial, you will configure HTCondor to run multiple simulations of a
-quantum circuit in parallel across multiple nodes. This method can be used to
-accelerate Monte Carlo simulations of noisy quantum circuits.
-
-Objectives of this tutorial:
-
-* Use `terraform` to deploy a HTCondor cluster
-* Run a multinode simulation using HTCondor
-* Query cluster information and monitor running jobs in HTCondor
-* Use `terraform` to destroy the cluster
-
-## 1. Configure your environment
-
-Although this tutorial can be run from your local computer, we recommend the use
-of [Google Cloud Shell](https://cloud.google.com/shell). Cloud Shell has many useful tools pre-installed.
-
-Once you have completed the [Before you begin](./gcp_before_you_begin.md)
-tutorial, open the [Cloud Shell in the Cloud Console](https://console.cloud.google.com/home/dashboard?cloudshell=true).
-
-### Clone this repo
-
-In your Cloud Shell window, clone this Github repo.
-``` bash
-git clone https://github.com/quantumlib/qsim.git
-```
-If you get an error saying something like `qsim already exists`, you may need
-to delete the `qsim` directory with `rm -rf qsim` and rerun the clone command.
-
-### Change directory
-
-Change directory to the tutorial:
-``` bash
-cd qsim/docs/tutorials/multinode/terraform
-```
-This is where you will use `terraform` to create the HTCondor cluster required to run your jobs.
-
-### Edit `init.sh` file to match your environment
-
-Using your favorite text file editor, open the `init.sh` file. The first few
-lines should look like this:
-```bash
-# ---- Edit below -----#
-
-export TF_VAR_project=[USER_PROJECT]
-export TF_VAR_zone=us-east4-c
-export TF_VAR_region=us-east4
-```
-Replace `[USER_PROJECT]` with the project name you chose on the
-`Before you begin` page.
-
-The other lines can optionally be modified to adjust your environment.
-* The `TF_VAR_zone` and `TF_VAR_region` lines can be modified to select where
-your project will create new jobs.
-
-#### Find out more
-
-* [Choosing a zone and region](https://cloud.google.com/compute/docs/regions-zones)
-
-### Source the `init.sh` file
-
-The edited `init.sh` file should be "sourced" in the cloud shell:
-``` bash
-source init.sh
-```
-Respond `Agree` to any pop-ups that request permissions on the Google Cloud platform.
-
-The final outcome of this script will include:
-
-* A gcloud config setup correctly
-* A service account created
-* The appropriate permissions assigned to the service account
-* A key file created to enable the use of Google Cloud automation.
-
-This will take up to 60 seconds. At the end you will see output about
-permissions and the configuration of the account.
-
-## 2. Run terraform
-
-After the previous steps are completed, you can initialize `terraform` to begin
-your cluster creation. The first step is to initialize the `terraform` state.
-``` bash
-terraform init
-```
-A successful result will contain the text:
-```
-Terraform has been successfully initialized!
-```
-
-### Run the `make` command
-
-For convenience, some terraform commands are prepared in a `Makefile`. This
-means you can now create your cluster, with a simple `make` command.
-```bash
-make apply
-```
-A successful run will show:
-```
-Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
-```
-
-## 3. Connect to the submit node for HTCondor
-
-Although there are ways to run HTCondor commands from your local machine, 
-the normal path  is to login to the submit node. From there you can run 
-commands to submit and monitor jobs on HTCondor.
-
-### List VMs that were created by HTCondor
-
-To see the VMs created by HTCondor, run:
-```bash
-gcloud compute instances list
-```
-At this point in the tutorial, you will see two instances listed:
-```
-NAME: c-manager
-ZONE: us-central1-a
-MACHINE_TYPE: n1-standard-1
-PREEMPTIBLE:
-INTERNAL_IP: X.X.X.X
-EXTERNAL_IP: X.X.X.X
-STATUS: RUNNING
-
-NAME: c-submit
-ZONE: us-central1-a
-MACHINE_TYPE: n1-standard-1
-PREEMPTIBLE:
-INTERNAL_IP: X.X.X.X
-EXTERNAL_IP: X.X.X.X
-STATUS: RUNNING
-```
-
-### Connecting to the submit node
-
-To connect to the submit node, click the `Compute Engine` item on the Cloud
-dashboard. This will open the VM Instances page, where you should see the two
-instances listed above. In the `c-submit` row, click on the `SSH` button to
-open a new window connected to the submit node. During this step, you may see a
-prompt that reads `Connection via Cloud Identity-Aware Proxy Failed`; simply
-click on `Connect without Identity-Aware Proxy` and the connection should
-complete.
-
-This new window is logged into your HTCondor cluster. You will see a command
-prompt that looks something like this:
-```bash
-[mylogin@c-submit ~]$
-```
-The following steps should be performed in this window.
-
-### Checking the status
-
-You can run `condor_q` to verify if the HTCondor install is completed. The output should look something like this:
-```
--- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
-OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
-
-Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
-Total for drj: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
-Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
-```
-If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
-
-## 4. Get the sample code and run it
-
-The HTCondor cluster is now ready for your jobs to be run. For this tutorial,
-sample jobs have been provided in the Github repo.
-
-###  Clone the repo on your cluster
-
-On the submit node, you can clone the repo to get access to previously
-created submission files:
-```bash
-git clone https://github.com/quantumlib/qsim.git
-```
-Then cd to the tutorial directory.
-```bash
-cd qsim/docs/tutorials/multinode
-```
-
-### Submit a job
-
-Now it is possible to submit a job:
-```
-condor_submit noiseless.sub
-```
-This job will run the code in `noiseless3.py`, which executes a simple circuit and prints the results as a histogram. If successful, the output will be:
-```
-Submitting job(s).
-1 job(s) submitted to cluster 1.
-```
-You can see the job in queue with the `condor_q` command.
-
-The job will take several minutes to finish. The time includes creating a VM
-compute node, installing the HTCondor system and running the job. When complete, the following files will be stored in the `out` directory:
-
-* `out/log.1-0` contains a progress log for the job as it executes.
-* `out/out.1-0` contains the final output of the job.
-* `out/err.1-0` contains any error reports. This should be empty.
-
-To view one of these files in the shell, you can run `cat out/[FILE]`,
-replacing `[FILE]` with the name of the file to be viewed.
-
-## 5. Run multinode noise simulations
-
-Noise simulations make use of a [Monte Carlo
-method](https://en.wikipedia.org/wiki/Monte_Carlo_method) for [quantum
-trajectories](https://en.wikipedia.org/wiki/Quantum_Trajectory_Theory).
-
-### The noise.sub file
-
-To run multiple simulations, you can define a "submit" file. `noise.sub` is
-an example of this file format, and is shown below. Notable features include:
-
-* `universe = docker` means that all jobs will run inside a `docker` container.
-* `queue 50` submits 50 separate copies of the job.
-
-```
-universe                = docker
-docker_image            = gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest
-arguments               = python3 noise3.py
-should_transfer_files   = YES
-transfer_input_files    = noise3.py
-when_to_transfer_output = ON_EXIT
-output                  = out/out.$(Cluster)-$(Process)
-error                   = out/err.$(Cluster)-$(Process)
-log                     = out/log.$(Cluster)-$(Process)
-request_memory          = 10GB
-queue 50
-```
-The job can be submitted with the `condor_submit` command.
-```
-condor_submit noise.sub
-```
-The output should look like this:
-```
-Submitting job(s)..................................................
-50 job(s) submitted to cluster 2.
-```
-To monitor the ongoing process of jobs running, you can take advantage of the
-Linux `watch` command to run `condor_q` repeatedly:
-```
-watch "condor_q; condor_status"
-```
-The output of this command will show you the jobs in the queue as well as the
-VMs being created to run the jobs. There is a limit of 20 VMs for this
-configuration of the cluster.
-
-When the queue is empty, the command can be stopped with CTRL-C.
-
-The output from all trajectories will be stored in the `out` directory. To see
-the results of all simulations together, you can run:
-```
-cat out/out.2-*
-```
-The output should look something like this:
-```
-Counter({3: 462, 0: 452, 2: 50, 1: 36})
-Counter({0: 475, 3: 435, 1: 49, 2: 41})
-Counter({0: 450, 3: 440, 1: 59, 2: 51})
-Counter({0: 459, 3: 453, 2: 51, 1: 37})
-Counter({3: 471, 0: 450, 2: 46, 1: 33})
-Counter({3: 467, 0: 441, 1: 54, 2: 38})
-Counter({3: 455, 0: 455, 1: 50, 2: 40})
-Counter({3: 466, 0: 442, 2: 51, 1: 41})
-.
-.
-.
-```
-
-## 6. Shutting down
-
-**IMPORTANT**:  To avoid excess billing for this project, it is important to
-shut down the cluster. Return to the Cloud dashboard window for the steps below.
-
-If your Cloud Shell is still open, simply run:
-```
-make destroy
-```
-If your Cloud Shell closed at any point, you'll need to re-initialize it.
-[Open a new shell](https://console.cloud.google.com/home/dashboard?cloudshell=true)
-and run:
-```
-cd qsim/docs/tutorials/multinode/terraform
-source init.sh
-make destroy
-```
-After these commands complete, check the Compute Instances dashboard to verify
-that all VMs have been shut down. This tutorial makes use of an experimental
-[autoscaling script](./terraform/htcondor/autoscaler.py) to bring up and turn
-down VMs as needed. If any VMs remain after several minutes, you may need to
-shut them down manually, as described in the next section.
-
-## Next steps
-
-The file being run in the previous example was `noise3.py`. To run your own
-simulations, simply create a new python file with your circuit and change the
-`noise3.py` references in `noise.sub` to point to the new file.
-
-A detailed discussion of how to construct various types of noise in Cirq can be
-found [here](https://quantumai.google/cirq/noise).
-
-For more information about managing your VMs, see the following documentation
-from Google Cloud:
-
-*   [Stopping and starting a VM](https://cloud.google.com/compute/docs/instances/stop-start-instance)
-*   [Suspending and resuming an instance](https://cloud.google.com/compute/docs/instances/suspend-resume-instance)
-*   [Deleting a VM instance](https://cloud.google.com/compute/docs/instances/deleting-instance)
-
-As an alternative to Google Cloud, you can download the Docker container or the
-qsim source code to run quantum simulations on your own high-performance
-computing platform.

From 339106842b7a45bab51f42eacb749ae7f4a9e46d Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 13 Oct 2021 13:57:37 -0700
Subject: [PATCH 129/246] Update to match Cirq v0.13

---
 qsimcirq/qsim_circuit.py        |  4 ++--
 qsimcirq_tests/qsimcirq_test.py | 12 ++++++------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index 4d63fcd6..a3089752 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -376,7 +376,7 @@ def to_matrix(op: cirq.ops.GateOperation):
                     ops_by_mix.append(qsim_op)
                     moment_length = max(moment_length, 1)
                     pass
-                elif cirq.has_channel(qsim_op):
+                elif cirq.has_kraus(qsim_op):
                     ops_by_channel.append(qsim_op)
                     moment_length = max(moment_length, 1)
                     pass
@@ -407,7 +407,7 @@ def to_matrix(op: cirq.ops.GateOperation):
                 # Handle channel output.
                 for channel in ops_by_channel:
                     chdata = []
-                    for i, mat in enumerate(cirq.channel(channel)):
+                    for i, mat in enumerate(cirq.kraus(channel)):
                         square_mat = np.reshape(mat, (int(np.sqrt(mat.size)), -1))
                         unitary = cirq.is_unitary(square_mat)
                         singular_vals = np.linalg.svd(square_mat)[1]
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index b6acd09a..aa63846e 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -29,7 +29,7 @@ class NoiseTrigger(cirq.SingleQubitGate):
     # def _mixture_(self):
     #   return ((1.0, np.asarray([1, 0, 0, 1])),)
 
-    def _channel_(self):
+    def _kraus_(self):
         return (np.asarray([1, 0, 0, 1]),)
 
 
@@ -781,8 +781,8 @@ def test_mixture_simulation():
     possible_circuits = [
         cirq.Circuit(cirq.X(q0) ** 0.5, cirq.X(q1) ** 0.5, pf, bf)
         # Extract the operators from the mixtures to construct trajectories.
-        for pf in [NoiseStep(m).on(q0) for m in cirq.channel(pflip)]
-        for bf in [NoiseStep(m).on(q1) for m in cirq.channel(bflip)]
+        for pf in [NoiseStep(m).on(q0) for m in cirq.kraus(pflip)]
+        for bf in [NoiseStep(m).on(q1) for m in cirq.kraus(bflip)]
     ]
     possible_states = [
         cirq.Simulator().simulate(pc).state_vector() for pc in possible_circuits
@@ -823,8 +823,8 @@ def test_channel_simulation():
     possible_circuits = [
         cirq.Circuit(cirq.X(q0) ** 0.5, cirq.X(q1) ** 0.5, ad, gad)
         # Extract the operators from the channels to construct trajectories.
-        for ad in [NoiseStep(m).on(q0) for m in cirq.channel(amp_damp)]
-        for gad in [NoiseStep(m).on(q1) for m in cirq.channel(gen_amp_damp)]
+        for ad in [NoiseStep(m).on(q0) for m in cirq.kraus(amp_damp)]
+        for gad in [NoiseStep(m).on(q1) for m in cirq.kraus(gen_amp_damp)]
     ]
     possible_states = [
         cirq.Simulator().simulate(pc).state_vector() for pc in possible_circuits
@@ -860,7 +860,7 @@ def __init__(self, *prob_mat_pairs, num_qubits=1):
     def _num_qubits_(self):
         return self._num_qubits
 
-    def _channel_(self):
+    def _kraus_(self):
         return [cirq.unitary(op) for _, op, in self._prob_op_pairs]
 
     def steps(self):

From af6e198b286d4046ca0e09ef6169ab0ace65e860 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 18 Oct 2021 07:49:29 -0700
Subject: [PATCH 130/246] Remove floating backtick

---
 docs/tutorials/gcp_gpu.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 61e686fe..2f28f791 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -72,7 +72,7 @@ machine to your virtual machine.
 2.  Install the CUDA toolkit.
 
     ```shell
-    sudo apt install -y nvidia-cuda-toolkit`
+    sudo apt install -y nvidia-cuda-toolkit
     ```
 
 3.  Add your CUDA toolkit to the environment search path.

From b96fc9ed83fbf7af578f59e9889560a93455a3f3 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 18 Oct 2021 07:54:37 -0700
Subject: [PATCH 131/246] virutal -> virtual

---
 docs/tutorials/gcp_gpu.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 2f28f791..5cf736be 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -61,7 +61,7 @@ Use SSH in the `glcoud` tool to communicate with your VM.
 When the command completes successfully, your prompt changes from your local
 machine to your virtual machine.
 
-## 3. Enable your virutal machine to use the GPU
+## 3. Enable your virtual machine to use the GPU
 
 1.  Install the GPU driver. In the Google Cloud documentation, in the Installing
     GPU drivers guide, follow the steps provided in the following sections:

From 7dbf6cd7c8e5b65e887a6d1d6f50a6d28bb1a08e Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 21 Oct 2021 17:48:25 +0200
Subject: [PATCH 132/246] Split gate fusion and simulation.

---
 docs/usage.md                          | 12 ++--
 lib/expect.h                           |  4 +-
 lib/fuser.h                            | 38 ++++++++---
 lib/fuser_basic.h                      | 60 +++++++++++-------
 lib/fuser_mqubit.h                     | 67 ++++++++++++--------
 lib/gate_appl.h                        | 11 ++--
 lib/hybrid.h                           |  9 ++-
 lib/run_qsim.h                         | 49 +++++++++++---
 tests/fuser_mqubit_test.cc             | 88 +++++++++++++-------------
 tests/mps_simulator_test.cc            |  9 ++-
 tests/simulator_testfixture.h          | 16 +++--
 tests/statespace_testfixture.h         | 28 ++++----
 tests/unitary_calculator_testfixture.h |  4 +-
 13 files changed, 247 insertions(+), 148 deletions(-)

diff --git a/docs/usage.md b/docs/usage.md
index a0992fe2..14dbcda8 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -22,7 +22,7 @@ Sample circuits are provided in
 |`-d maxtime` | maximum time |
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
-|`-v verbosity` | verbosity level (0,1,>1)|
+|`-v verbosity` | verbosity level (0,1,2,3,4,5)|
 |`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_base computes all the amplitudes and just prints the first eight of them
@@ -46,7 +46,7 @@ Example:
 |`-d maxtime` | maximum time |
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
-|`-v verbosity` | verbosity level (0,1,>1)|
+|`-v verbosity` | verbosity level (0,1,2,3,4,5)|
 |`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_von_neumann computes all the amplitudes and calculates the von Neumann
@@ -77,7 +77,7 @@ Example:
 |`-o output_files` | comma-separated list of amplitude output files|
 |`-t num_threads` | number of threads to use|
 |`-f max_fused_size` | maximum fused gate size|
-|`-v verbosity` | verbosity level (0,1,>1)|
+|`-v verbosity` | verbosity level (0,1,2,3,4,5)|
 |`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsim_amplitudes reads input files of bitstrings, computes the corresponding
@@ -112,7 +112,7 @@ Example:
 |`-t traj0` | starting trajectory |
 |`-n num_trajectories ` | number of trajectories to run starting with `traj0` |
 |`-f max_fused_size` | maximum fused gate size|
-|`-v verbosity` | verbosity level (0,1)|
+|`-v verbosity` | verbosity level (0,1,2,3,4,5)|
 
 qsim_qtrajectory_cuda runs on GPUs. qsim_qtrajectory_cuda performs quantum
 trajactory simulations with amplitude damping and phase damping noise channels.
@@ -145,7 +145,7 @@ Example:
 |`-p num_prefix_gates` | number of prefix gates|
 |`-r num_root_gates` | number of root gates|
 |`-t num_threads` | number of threads to use|
-|`-v verbosity` | verbosity level (0,>0)|
+|`-v verbosity` | verbosity level (0,1,4,5)|
 |`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsimh_base just computes and just prints the first eight amplitudes. The hybrid
@@ -226,7 +226,7 @@ maximum "time".
 |`-i input_file` | bitstring input file|
 |`-o output_file` | amplitude output file|
 |`-t num_threads` | number of threads to use|
-|`-v verbosity` | verbosity level (0,>0)|
+|`-v verbosity` | verbosity level (0,1,4,5)|
 |`-z` | set flush-to-zero and denormals-are-zeros MXCSR control flags|
 
 qsimh_amplitudes reads the input file of bitstrings, computes the corresponding
diff --git a/lib/expect.h b/lib/expect.h
index 2943c713..66ff817d 100644
--- a/lib/expect.h
+++ b/lib/expect.h
@@ -123,8 +123,8 @@ std::complex<double> ExpectationValue(
         break;
       }
 
-      auto matrix = CalculateFusedMatrix<typename Simulator::fp_type>(fgate);
-      auto r = simulator.ExpectationValue(fgate.qubits, matrix.data(), state);
+      auto r = simulator.ExpectationValue(
+          fgate.qubits, fgate.matrix.data(), state);
       eval += str.weight * r;
     }
   }
diff --git a/lib/fuser.h b/lib/fuser.h
index 927349f1..93933975 100644
--- a/lib/fuser.h
+++ b/lib/fuser.h
@@ -50,6 +50,10 @@ struct GateFused {
    * Ordered list of component gates.
    */
   std::vector<const Gate*> gates;
+  /**
+   * Fused gate matrix.
+   */
+  Matrix<typename Gate::fp_type> matrix;
 };
 
 /**
@@ -134,16 +138,14 @@ class Fuser {
 /**
  * Multiplies component gate matrices of a fused gate.
  * @param gate Fused gate.
- * @return Matrix product of component matrices.
  */
-template <typename fp_type, typename FusedGate>
-inline Matrix<fp_type> CalculateFusedMatrix(const FusedGate& gate) {
-  Matrix<fp_type> matrix;
-  MatrixIdentity(unsigned{1} << gate.qubits.size(), matrix);
+template <typename FusedGate>
+inline void CalculateFusedMatrix(FusedGate& gate) {
+  MatrixIdentity(unsigned{1} << gate.qubits.size(), gate.matrix);
 
   for (auto pgate : gate.gates) {
     if (gate.qubits.size() == pgate->qubits.size()) {
-      MatrixMultiply(gate.qubits.size(), pgate->matrix, matrix);
+      MatrixMultiply(gate.qubits.size(), pgate->matrix, gate.matrix);
     } else {
       unsigned mask = 0;
 
@@ -157,11 +159,31 @@ inline Matrix<fp_type> CalculateFusedMatrix(const FusedGate& gate) {
       }
 
       MatrixMultiply(mask, pgate->qubits.size(), pgate->matrix,
-                     gate.qubits.size(), matrix);
+                     gate.qubits.size(), gate.matrix);
     }
   }
+}
 
-  return matrix;
+/**
+ * Multiplies component gate matrices for a range of fused gates.
+ * @param gbeg, gend The iterator range [gbeg, gend) of fused gates.
+ */
+template <typename Iterator>
+inline void CalculateFusedMatrices(Iterator gbeg, Iterator gend) {
+  for (auto g = gbeg; g != gend; ++g) {
+    if (g->kind != gate::kMeasurement) {
+      CalculateFusedMatrix(*g);
+    }
+  }
+}
+
+/**
+ * Multiplies component gate matrices for a vector of fused gates.
+ * @param gates The vector of fused gates.
+ */
+template <typename FusedGate>
+inline void CalculateFusedMatrices(std::vector<FusedGate>& gates) {
+  CalculateFusedMatrices(gates.begin(), gates.end());
 }
 
 }  // namespace qsim
diff --git a/lib/fuser_basic.h b/lib/fuser_basic.h
index 345db25a..abc006e8 100644
--- a/lib/fuser_basic.h
+++ b/lib/fuser_basic.h
@@ -53,29 +53,29 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
 
   /**
    * Stores sets of gates that can be applied together. Only one- and
-   * two-qubit gates will get fused. Gates fused with this method are not
-   * multiplied together until ApplyFusedGate is called on the output.
-   * To respect specific time boundaries while fusing gates, use the other
-   * version of this method below.
+   * two-qubit gates will get fused. To respect specific time boundaries while
+   * fusing gates, use the other version of this method below.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
    *   Gate times of the gates that act on the same qubits should be ordered.
    *   Gates that are out of time order should not cross the time boundaries
    *   set by measurement gates.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(const Parameter& param,
                                           unsigned num_qubits,
-                                          const std::vector<Gate>& gates) {
-    return FuseGates(param, num_qubits, gates.cbegin(), gates.cend(), {});
+                                          const std::vector<Gate>& gates,
+                                          bool fuse_matrix = true) {
+    return FuseGates(
+        param, num_qubits, gates.cbegin(), gates.cend(), {}, fuse_matrix);
   }
 
   /**
    * Stores sets of gates that can be applied together. Only one- and
-   * two-qubit gates will get fused. Gates fused with this method are not
-   * multiplied together until ApplyFusedGate is called on the output.
+   * two-qubit gates will get fused.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
@@ -85,43 +85,44 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    * @param times_to_split_at Ordered list of time steps (boundaries) at which
    *   to separate fused gates. Each element of the output will contain gates
    *   from a single 'window' in this list.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
       const Parameter& param,
       unsigned num_qubits, const std::vector<Gate>& gates,
-      const std::vector<unsigned>& times_to_split_at) {
+      const std::vector<unsigned>& times_to_split_at,
+      bool fuse_matrix = true) {
     return FuseGates(param, num_qubits, gates.cbegin(), gates.cend(),
-                     times_to_split_at);
+                     times_to_split_at, fuse_matrix);
   }
 
   /**
    * Stores sets of gates that can be applied together. Only one- and
-   * two-qubit gates will get fused. Gates fused with this method are not
-   * multiplied together until ApplyFusedGate is called on the output.
-   * To respect specific time boundaries while fusing gates, use the other
-   * version of this method below.
+   * two-qubit gates will get fused. To respect specific time boundaries while
+   * fusing gates, use the other version of this method below.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by gates.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
    *   (or pointers to gates) in. Gate times of the gates that act on the same
    *   qubits should be ordered. Gates that are out of time order should not
    *   cross the time boundaries set by measurement gates.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
       const Parameter& param, unsigned num_qubits,
       typename std::vector<Gate>::const_iterator gfirst,
-      typename std::vector<Gate>::const_iterator glast) {
-    return FuseGates(param, num_qubits, gfirst, glast, {});
+      typename std::vector<Gate>::const_iterator glast,
+      bool fuse_matrix = true) {
+    return FuseGates(param, num_qubits, gfirst, glast, {}, fuse_matrix);
   }
 
   /**
    * Stores sets of gates that can be applied together. Only one- and
-   * two-qubit gates will get fused. Gates fused with this method are not
-   * multiplied together until ApplyFusedGate is called on the output.
+   * two-qubit gates will get fused.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by gates.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
@@ -132,6 +133,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    * @param times_to_split_at Ordered list of time steps (boundaries) at which
    *   to separate fused gates. Each element of the output will contain gates
    *   from a single 'window' in this list.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
@@ -139,7 +141,8 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
       const Parameter& param, unsigned num_qubits,
       typename std::vector<Gate>::const_iterator gfirst,
       typename std::vector<Gate>::const_iterator glast,
-      const std::vector<unsigned>& times_to_split_at) {
+      const std::vector<unsigned>& times_to_split_at,
+      bool fuse_matrix = true) {
     std::vector<GateFused> gates_fused;
 
     if (gfirst >= glast) return gates_fused;
@@ -243,11 +246,11 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
           }
 
           gates_fused.push_back({pgate->kind, pgate->time, pgate->qubits,
-                                 pgate, {pgate}});
+                                 pgate, {pgate}, {}});
         } else if (pgate->qubits.size() == 1) {
           unsigned q0 = pgate->qubits[0];
 
-          GateFused gate_f = {pgate->kind, pgate->time, {q0}, pgate, {}};
+          GateFused gate_f = {pgate->kind, pgate->time, {q0}, pgate, {}, {}};
 
           last[q0] = Advance(last[q0], gates_lat[q0], gate_f.gates);
           gate_f.gates.push_back(gates_lat[q0][last[q0]]);
@@ -260,7 +263,8 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
 
           if (Done(last[q0], pgate->time, gates_lat[q0])) continue;
 
-          GateFused gate_f = {pgate->kind, pgate->time, {q0, q1}, pgate, {}};
+          GateFused gate_f =
+              {pgate->kind, pgate->time, {q0, q1}, pgate, {}, {}};
 
           do {
             last[q0] = Advance(last[q0], gates_lat[q0], gate_f.gates);
@@ -290,7 +294,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
 
         const auto& mea_gates_at_time = measurement_gates[pgate->time];
 
-        GateFused gate_f = {pgate->kind, pgate->time, {}, pgate, {}};
+        GateFused gate_f = {pgate->kind, pgate->time, {}, pgate, {}, {}};
         gate_f.gates.reserve(mea_gates_at_time.size());
 
         // Fuse measurement gates with equal times.
@@ -307,6 +311,14 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
       if (gate_it == glast) break;
     }
 
+    if (fuse_matrix) {
+      for (auto& gate_f : gates_fused) {
+        if (gate_f.kind != gate::kMeasurement && gate_f.kind != gate::kDecomp) {
+          CalculateFusedMatrix(gate_f);
+        }
+      }
+    }
+
     return gates_fused;
   }
 
@@ -338,7 +350,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
                                    std::vector<GateFused>& gates_fused) {
     auto pgate = gates_lat[q][k];
 
-    GateFused gate_f = {pgate->kind, pgate->time, {q}, pgate, {}};
+    GateFused gate_f = {pgate->kind, pgate->time, {q}, pgate, {}, {}};
     gate_f.gates.push_back(pgate);
 
     k = Advance(k + 1, gates_lat[q], gate_f.gates);
diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index 8db3ceae..08a40d11 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -152,29 +152,29 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
   };
 
   /**
-   * Stores sets of gates that can be applied together. Note that
-   * gates fused with this method are not multiplied together until
-   * ApplyFusedGate is called on the output. To respect specific time
-   * boundaries while fusing gates, use the other version of this method below.
+   * Stores sets of gates that can be applied together. To respect specific
+   * time boundaries while fusing gates, use the other version of this method
+   * below.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
    *   Gate times of the gates that act on the same qubits should be ordered.
    *   Gates that are out of time order should not cross the time boundaries
    *   set by measurement gates.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(const Parameter& param,
                                           unsigned num_qubits,
-                                          const std::vector<Gate>& gates) {
-    return FuseGates(param, num_qubits, gates.cbegin(), gates.cend(), {});
+                                          const std::vector<Gate>& gates,
+                                          bool fuse_matrix = true) {
+    return FuseGates(
+        param, num_qubits, gates.cbegin(), gates.cend(), {}, fuse_matrix);
   }
 
   /**
-   * Stores sets of gates that can be applied together. Note that
-   * gates fused with this method are not multiplied together until
-   * ApplyFusedGate is called on the output.
+   * Stores sets of gates that can be applied together.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
@@ -184,42 +184,43 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    * @param times_to_split_at Ordered list of time steps (boundaries) at which
    *   to separate fused gates. Each element of the output will contain gates
    *   from a single 'window' in this list.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
       const Parameter& param,
       unsigned num_qubits, const std::vector<Gate>& gates,
-      const std::vector<unsigned>& times_to_split_at) {
+      const std::vector<unsigned>& times_to_split_at,
+      bool fuse_matrix = true) {
     return FuseGates(param, num_qubits, gates.cbegin(), gates.cend(),
-                     times_to_split_at);
+                     times_to_split_at, fuse_matrix);
   }
 
   /**
-   * Stores sets of gates that can be applied together. Note that
-   * gates fused with this method are not multiplied together until
-   * ApplyFusedGate is called on the output. To respect specific time
-   * boundaries while fusing gates, use the other version of this method below.
+   * Stores sets of gates that can be applied together. To respect specific
+   * time boundaries while fusing gates, use the other version of this method
+   * below.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by gates.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
    *   (or pointers to gates) in. Gate times of the gates that act on the same
    *   qubits should be ordered. Gates that are out of time order should not
    *   cross the time boundaries set by measurement gates.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
       const Parameter& param, unsigned num_qubits,
       typename std::vector<Gate>::const_iterator gfirst,
-      typename std::vector<Gate>::const_iterator glast) {
-    return FuseGates(param, num_qubits, gfirst, glast, {});
+      typename std::vector<Gate>::const_iterator glast,
+      bool fuse_matrix = true) {
+    return FuseGates(param, num_qubits, gfirst, glast, {}, fuse_matrix);
   }
 
   /**
-   * Stores sets of gates that can be applied together. Note that
-   * gates fused with this method are not multiplied together until
-   * ApplyFusedGate is called on the output.
+   * Stores sets of gates that can be applied together.
    * @param param Options for gate fusion.
    * @param num_qubits The number of qubits acted on by gates.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
@@ -230,6 +231,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    * @param times_to_split_at Ordered list of time steps (boundaries) at which
    *   to separate fused gates. Each element of the output will contain gates
    *   from a single 'window' in this list.
+   * @param fuse_matrix If true, multiply gate matrices together.
    * @return A vector of fused gate objects. Each element is a set of gates
    *   acting on a specific pair of qubits which can be applied as a group.
    */
@@ -237,7 +239,8 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
       const Parameter& param, unsigned num_qubits,
       typename std::vector<Gate>::const_iterator gfirst,
       typename std::vector<Gate>::const_iterator glast,
-      const std::vector<unsigned>& times_to_split_at) {
+      const std::vector<unsigned>& times_to_split_at,
+      bool fuse_matrix = true) {
     std::vector<GateFused> fused_gates;
 
     if (gfirst >= glast) return fused_gates;
@@ -420,7 +423,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
           // Assume fgate.qubits (gate.qubits) are sorted.
           fused_gates.push_back({fgate.parent->kind, fgate.parent->time,
                                  std::move(fgate.qubits), fgate.parent,
-                                 std::move(fgate.gates)});
+                                 std::move(fgate.gates), {}});
 
           if (fgate.visited != kMeaCnt) {
             ++stat.num_fused_gates;
@@ -433,6 +436,14 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
       }
     }
 
+    if (fuse_matrix) {
+      for (auto& fgate : fused_gates) {
+        if (fgate.kind != gate::kMeasurement && fgate.kind != gate::kDecomp) {
+          CalculateFusedMatrix(fgate);
+        }
+      }
+    }
+
     PrintStat(param.verbosity, stat, fused_gates);
 
     return fused_gates;
@@ -496,14 +507,14 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
       if (fgate.visited == kMeaCnt || fgate.qubits.size() >= max_fused_size
           || fgate.parent->unfusible) {
         if (fgate.visited != kMeaCnt) {
-           ++stat.num_fused_gates;
+          ++stat.num_fused_gates;
         }
 
         fgate.visited = kFinal;
 
         fused_gates.push_back({fgate.parent->kind, fgate.parent->time,
                                std::move(fgate.qubits), fgate.parent,
-                               std::move(fgate.gates)});
+                               std::move(fgate.gates), {}});
 
         continue;
       }
@@ -528,7 +539,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
           fused_gates.push_back({fgate->parent->kind, fgate->parent->time,
                                  std::move(fgate->qubits), fgate->parent,
-                                 std::move(fgate->gates)});
+                                 std::move(fgate->gates), {}});
 
           ++stat.num_fused_gates;
         }
@@ -589,7 +600,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
       fused_gates.push_back({ogate1->parent->kind, ogate1->parent->time,
                              std::move(ogate1->qubits), ogate1->parent,
-                             std::move(ogate1->gates)});
+                             std::move(ogate1->gates), {}});
 
       ++stat.num_fused_gates;
     }
@@ -988,7 +999,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
   static void PrintStat(unsigned verbosity, const Stat& stat,
                         const std::vector<GateFused>& fused_gates) {
-    if (verbosity == 0) return;
+    if (verbosity < 3) return;
 
     if (stat.num_controlled_gates > 0) {
       IO::messagef("%lu controlled gates\n", stat.num_controlled_gates);
@@ -1017,7 +1028,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
     IO::messagef(" gates are fused into %lu gates\n", stat.num_fused_gates);
 
-    if (verbosity == 1) return;
+    if (verbosity < 5) return;
 
     IO::messagef("fused gate qubits:\n");
     for (const auto g : fused_gates) {
diff --git a/lib/gate_appl.h b/lib/gate_appl.h
index 59b60082..8601e6f2 100644
--- a/lib/gate_appl.h
+++ b/lib/gate_appl.h
@@ -136,13 +136,12 @@ template <typename Simulator, typename Gate>
 inline void ApplyFusedGate(const Simulator& simulator, const Gate& gate,
                            typename Simulator::State& state) {
   if (gate.kind != gate::kMeasurement) {
-    using fp_type = typename Simulator::fp_type;
-    auto matrix = CalculateFusedMatrix<fp_type>(gate);
     if (gate.parent->controlled_by.size() == 0) {
-      simulator.ApplyGate(gate.qubits, matrix.data(), state);
+      simulator.ApplyGate(gate.qubits, gate.matrix.data(), state);
     } else {
       simulator.ApplyControlledGate(gate.qubits, gate.parent->controlled_by,
-                                    gate.parent->cmask, matrix.data(), state);
+                                    gate.parent->cmask, gate.matrix.data(),
+                                    state);
     }
   }
 }
@@ -160,9 +159,9 @@ template <typename Simulator, typename Gate>
 inline void ApplyFusedGateDagger(const Simulator& simulator, const Gate& gate,
                                  typename Simulator::State& state) {
   if (gate.kind != gate::kMeasurement) {
-    using fp_type = typename Simulator::fp_type;
-    auto matrix = CalculateFusedMatrix<fp_type>(gate);
+    auto matrix = gate.matrix;
     MatrixDagger(unsigned{1} << gate.qubits.size(), matrix);
+
     if (gate.parent->controlled_by.size() == 0) {
       simulator.ApplyGate(gate.qubits, matrix.data(), state);
     } else {
diff --git a/lib/hybrid.h b/lib/hybrid.h
index 0ce98b63..d0189efc 100644
--- a/lib/hybrid.h
+++ b/lib/hybrid.h
@@ -40,6 +40,7 @@ struct HybridSimulator final {
   // Note that one can use "struct GateHybrid : public Gate {" in C++17.
   struct GateHybrid {
     using GateKind = HybridSimulator::GateKind;
+    using fp_type = HybridSimulator::fp_type;
 
     GateKind kind;
     unsigned time;
@@ -554,7 +555,13 @@ struct HybridSimulator final {
                          const Simulator& simulator,
                          typename Simulator::State& state) {
     for (std::size_t i = i0; i < i1; ++i) {
-      ApplyFusedGate(simulator, gates[i], state);
+      if (gates[i].matrix.size() > 0) {
+        ApplyFusedGate(simulator, gates[i], state);
+      } else {
+        auto gate = gates[i];
+        CalculateFusedMatrix(gate);
+        ApplyFusedGate(simulator, gate, state);
+      }
     }
   }
 
diff --git a/lib/run_qsim.h b/lib/run_qsim.h
index bbc401b6..b0aad9f3 100644
--- a/lib/run_qsim.h
+++ b/lib/run_qsim.h
@@ -79,7 +79,7 @@ struct QSimRunner final {
     double t0 = 0.0;
     double t1 = 0.0;
 
-    if (param.verbosity > 0) {
+    if (param.verbosity > 1) {
       t0 = GetTime();
     }
 
@@ -96,17 +96,33 @@ struct QSimRunner final {
     state_space.SetStateZero(state);
     Simulator simulator = factory.CreateSimulator();
 
+    if (param.verbosity > 1) {
+      t1 = GetTime();
+      IO::messagef("init time is %g seconds.\n", t1 - t0);
+      t0 = GetTime();
+    }
+
     auto fused_gates = Fuser::FuseGates(param, circuit.num_qubits,
                                         circuit.gates, times_to_measure_at);
+
     if (fused_gates.size() == 0 && circuit.gates.size() > 0) {
       return false;
     }
 
+    if (param.verbosity > 1) {
+      t1 = GetTime();
+      IO::messagef("fuse time is %g seconds.\n", t1 - t0);
+    }
+
+    if (param.verbosity > 0) {
+      t0 = GetTime();
+    }
+
     unsigned cur_time_index = 0;
 
     // Apply fused gates.
     for (std::size_t i = 0; i < fused_gates.size(); ++i) {
-      if (param.verbosity > 1) {
+      if (param.verbosity > 3) {
         t1 = GetTime();
       }
 
@@ -116,7 +132,7 @@ struct QSimRunner final {
         return false;
       }
 
-      if (param.verbosity > 1) {
+      if (param.verbosity > 3) {
         double t2 = GetTime();
         IO::messagef("gate %lu done in %g seconds.\n", i, t2 - t1);
       }
@@ -132,7 +148,7 @@ struct QSimRunner final {
 
     if (param.verbosity > 0) {
       double t2 = GetTime();
-      IO::messagef("time elapsed %g seconds.\n", t2 - t0);
+      IO::messagef("time is %g seconds.\n", t2 - t0);
     }
 
     return true;
@@ -159,7 +175,7 @@ struct QSimRunner final {
     double t0 = 0.0;
     double t1 = 0.0;
 
-    if (param.verbosity > 0) {
+    if (param.verbosity > 1) {
       t0 = GetTime();
     }
 
@@ -168,16 +184,33 @@ struct QSimRunner final {
     StateSpace state_space = factory.CreateStateSpace();
     Simulator simulator = factory.CreateSimulator();
 
+    if (param.verbosity > 1) {
+      t1 = GetTime();
+      IO::messagef("init time is %g seconds.\n", t1 - t0);
+      t0 = GetTime();
+    }
+
     auto fused_gates = Fuser::FuseGates(param, circuit.num_qubits,
                                         circuit.gates);
+
     if (fused_gates.size() == 0 && circuit.gates.size() > 0) {
       return false;
     }
+
     measure_results.reserve(fused_gates.size());
 
+    if (param.verbosity > 1) {
+      t1 = GetTime();
+      IO::messagef("fuse time is %g seconds.\n", t1 - t0);
+    }
+
+    if (param.verbosity > 0) {
+      t0 = GetTime();
+    }
+
     // Apply fused gates.
     for (std::size_t i = 0; i < fused_gates.size(); ++i) {
-      if (param.verbosity > 1) {
+      if (param.verbosity > 3) {
         t1 = GetTime();
       }
 
@@ -187,7 +220,7 @@ struct QSimRunner final {
         return false;
       }
 
-      if (param.verbosity > 1) {
+      if (param.verbosity > 3) {
         double t2 = GetTime();
         IO::messagef("gate %lu done in %g seconds.\n", i, t2 - t1);
       }
@@ -195,7 +228,7 @@ struct QSimRunner final {
 
     if (param.verbosity > 0) {
       double t2 = GetTime();
-      IO::messagef("time elapsed %g seconds.\n", t2 - t0);
+      IO::messagef("simu time is %g seconds.\n", t2 - t0);
     }
 
     return true;
diff --git a/tests/fuser_mqubit_test.cc b/tests/fuser_mqubit_test.cc
index 761b1654..c41c6549 100644
--- a/tests/fuser_mqubit_test.cc
+++ b/tests/fuser_mqubit_test.cc
@@ -44,6 +44,7 @@ enum DummyGateKind {
 
 struct DummyGate {
   using GateKind = DummyGateKind;
+  using fp_type = float;
 
   GateKind kind;
   unsigned time;
@@ -263,7 +264,7 @@ TEST(FuserMultiQubitTest, RandomCircuit1) {
   for (unsigned q = 2; q <= 6; ++q) {
     param.max_fused_size = q;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
   }
@@ -272,7 +273,7 @@ TEST(FuserMultiQubitTest, RandomCircuit1) {
     param.max_fused_size = q;
     auto fused_gates = Fuser::FuseGates(
         param, num_qubits, circuit.begin(), circuit.end(),
-        {5000, 7000, 25000, 37000});
+        {5000, 7000, 25000, 37000}, false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
   }
@@ -301,7 +302,7 @@ TEST(FuserMultiQubitTest, RandomCircuit2) {
   for (unsigned q = 2; q <= 6; ++q) {
     param.max_fused_size = q;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, pcircuit.begin(), pcircuit.end());
+        param, num_qubits, pcircuit.begin(), pcircuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
   }
@@ -309,7 +310,8 @@ TEST(FuserMultiQubitTest, RandomCircuit2) {
   for (unsigned q = 2; q <= 6; ++q) {
     param.max_fused_size = q;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, pcircuit.begin(), pcircuit.end(), {300, 700, 2400});
+        param, num_qubits, pcircuit.begin(), pcircuit.end(),
+        {300, 700, 2400}, false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
   }
@@ -404,7 +406,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 4;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 1);
@@ -424,7 +426,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 4;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 3);
@@ -447,7 +449,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 6;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 1);
@@ -472,7 +474,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 6;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 3);
@@ -488,7 +490,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 2);
@@ -505,7 +507,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 3);
@@ -523,7 +525,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 3);
@@ -542,7 +544,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 4);
@@ -563,7 +565,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 5;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 3);
@@ -579,7 +581,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 1);
@@ -595,7 +597,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 1);
@@ -613,7 +615,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     EXPECT_EQ(fused_gates.size(), 4);
@@ -633,7 +635,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
     {
       param.max_fused_size = 3;
       auto fused_gates = Fuser::FuseGates(
-          param, num_qubits, circuit.begin(), circuit.end());
+          param, num_qubits, circuit.begin(), circuit.end(), false);
 
       EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
       EXPECT_EQ(fused_gates.size(), 4);
@@ -642,7 +644,7 @@ TEST(FuserMultiQubitTest, SmallCircuits) {
     {
       param.max_fused_size = 5;
       auto fused_gates = Fuser::FuseGates(
-          param, num_qubits, circuit.begin(), circuit.end());
+          param, num_qubits, circuit.begin(), circuit.end(), false);
 
       EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
 
@@ -680,7 +682,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 14);
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
@@ -705,7 +707,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
 
     param.max_fused_size = 6;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 3);
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
@@ -724,7 +726,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 4);
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
@@ -745,7 +747,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
 
     param.max_fused_size = 5;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 3);
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
@@ -763,7 +765,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 4);
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
@@ -783,7 +785,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
     {
       param.max_fused_size = 3;
       auto fused_gates = Fuser::FuseGates(
-          param, num_qubits, circuit.begin(), circuit.end());
+          param, num_qubits, circuit.begin(), circuit.end(), false);
 
       EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     }
@@ -791,7 +793,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
     {
       param.max_fused_size = 5;
       auto fused_gates = Fuser::FuseGates(
-          param, num_qubits, circuit.begin(), circuit.end());
+          param, num_qubits, circuit.begin(), circuit.end(), false);
 
       EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
     }
@@ -814,8 +816,8 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
 
     param.max_fused_size = 4;
     std::vector<unsigned> time_boundary = {3};
-    auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end(), time_boundary);
+    auto fused_gates = Fuser::FuseGates(param, num_qubits, circuit.begin(),
+                                        circuit.end(), time_boundary, false);
 
     EXPECT_EQ(fused_gates.size(), 2);
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
@@ -838,7 +840,7 @@ TEST(FuserMultiQubitTest, ValidTimeOrder) {
 
     param.max_fused_size = 4;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 3);
     EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
@@ -860,7 +862,7 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 3;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -876,7 +878,7 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -892,8 +894,8 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 2;
     std::vector<unsigned> time_boundary = {1};
-    auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end(), time_boundary);
+    auto fused_gates = Fuser::FuseGates(param, num_qubits, circuit.begin(),
+                                        circuit.end(), time_boundary, false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -909,8 +911,8 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 2;
     std::vector<unsigned> time_boundary = {2};
-    auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end(), time_boundary);
+    auto fused_gates = Fuser::FuseGates(param, num_qubits, circuit.begin(),
+                                        circuit.end(), time_boundary, false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -926,7 +928,7 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -942,7 +944,7 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -958,7 +960,7 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -974,7 +976,7 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 0);
   }
@@ -999,7 +1001,7 @@ TEST(FuserMultiQubitTest, OrphanedGates) {
     for (unsigned f = 2; f <= num_qubits; ++f) {
       param.max_fused_size = f;
       auto fused_gates = Fuser::FuseGates(
-          param, num_qubits, circuit.begin(), circuit.end());
+          param, num_qubits, circuit.begin(), circuit.end(), false);
 
       EXPECT_TRUE(TestFusedGates(num_qubits, circuit, fused_gates));
       EXPECT_EQ(fused_gates.size(), (num_qubits - 1) / f + 1);
@@ -1018,7 +1020,7 @@ TEST(FuserMultiQubitTest, OrphanedGates) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 2);
   }
@@ -1035,7 +1037,7 @@ TEST(FuserMultiQubitTest, OrphanedGates) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 2);
   }
@@ -1049,7 +1051,7 @@ TEST(FuserMultiQubitTest, OrphanedGates) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 2);
   }
@@ -1063,7 +1065,7 @@ TEST(FuserMultiQubitTest, OrphanedGates) {
 
     param.max_fused_size = 2;
     auto fused_gates = Fuser::FuseGates(
-        param, num_qubits, circuit.begin(), circuit.end());
+        param, num_qubits, circuit.begin(), circuit.end(), false);
 
     EXPECT_EQ(fused_gates.size(), 2);
   }
diff --git a/tests/mps_simulator_test.cc b/tests/mps_simulator_test.cc
index 605a29c0..c607d1aa 100644
--- a/tests/mps_simulator_test.cc
+++ b/tests/mps_simulator_test.cc
@@ -823,7 +823,8 @@ TEST(MPSSimulator, ApplyFusedGateLeft) {
   auto gate3 = GateHd<float>::Create(0, 1);
 
   GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {0, 1}, &gate1,
-                                    {&gate2, &gate3}};
+                                    {&gate2, &gate3}, {}};
+  CalculateFusedMatrix(fgate1);
   auto mps = ss.Create(3, 4);
   ss.SetStateZero(mps);
   ApplyFusedGate(sim, fgate1, mps);
@@ -857,7 +858,8 @@ TEST(MPSSimulator, ApplyFusedGateRight) {
   auto gate3 = GateHd<float>::Create(0, 2);
 
   GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {1, 2}, &gate1,
-                                    {&gate2, &gate3}};
+                                    {&gate2, &gate3}, {}};
+  CalculateFusedMatrix(fgate1);
   auto mps = ss.Create(3, 4);
   ss.SetStateZero(mps);
   ApplyFusedGate(sim, fgate1, mps);
@@ -891,7 +893,8 @@ TEST(MPSSimulator, ApplyFusedGateMiddle) {
   auto gate3 = GateHd<float>::Create(0, 2);
 
   GateFused<GateQSim<float>> fgate1{kGateCZ, 2, {1, 2}, &gate1,
-                                    {&gate2, &gate3}};
+                                    {&gate2, &gate3}, {}};
+  CalculateFusedMatrix(fgate1);
   auto mps = ss.Create(4, 4);
   ss.SetStateZero(mps);
   ApplyFusedGate(sim, fgate1, mps);
diff --git a/tests/simulator_testfixture.h b/tests/simulator_testfixture.h
index 717ff47d..05cad5a6 100644
--- a/tests/simulator_testfixture.h
+++ b/tests/simulator_testfixture.h
@@ -224,7 +224,8 @@ void TestApplyGate5(const Factory& factory) {
   auto gate25 = GateRX<fp_type>::Create(11, 4, 0.3);
 
   GateFused<GateQSim<fp_type>> fgate1{kGateCZ, 2, {0, 1},  &gate11,
-      {&gate1, &gate2, &gate6, &gate7, &gate11, &gate12, &gate13}};
+      {&gate1, &gate2, &gate6, &gate7, &gate11, &gate12, &gate13}, {}};
+  CalculateFusedMatrix(fgate1);
   ApplyFusedGate(simulator, fgate1, state);
 
   EXPECT_NEAR(state_space.Norm(state), 1, 1e-6);
@@ -245,7 +246,8 @@ void TestApplyGate5(const Factory& factory) {
   }
 
   GateFused<GateQSim<fp_type>> fgate2{kGateIS, 4, {1, 2}, &gate14,
-      {&gate3, &gate8, &gate14, &gate15, &gate16}};
+      {&gate3, &gate8, &gate14, &gate15, &gate16}, {}};
+  CalculateFusedMatrix(fgate2);
   ApplyFusedGate(simulator, fgate2, state);
 
   EXPECT_NEAR(state_space.Norm(state), 1, 1e-6);
@@ -266,7 +268,8 @@ void TestApplyGate5(const Factory& factory) {
   }
 
   GateFused<GateQSim<fp_type>> fgate3{kGateCNot, 6, {2, 3}, &gate17,
-      {&gate4, &gate9, &gate17, &gate18, &gate19}};
+      {&gate4, &gate9, &gate17, &gate18, &gate19},{}};
+  CalculateFusedMatrix(fgate3);
   ApplyFusedGate(simulator, fgate3, state);
 
   EXPECT_NEAR(state_space.Norm(state), 1, 1e-6);
@@ -287,7 +290,8 @@ void TestApplyGate5(const Factory& factory) {
   }
 
   GateFused<GateQSim<fp_type>> fgate4{kGateFS, 8, {3, 4}, &gate20,
-      {&gate5, &gate10, &gate20, &gate21, &gate22}};
+      {&gate5, &gate10, &gate20, &gate21, &gate22}, {}};
+  CalculateFusedMatrix(fgate4);
   ApplyFusedGate(simulator, fgate4, state);
 
   EXPECT_NEAR(state_space.Norm(state), 1, 1e-6);
@@ -307,7 +311,9 @@ void TestApplyGate5(const Factory& factory) {
     EXPECT_NEAR(std::imag(ampl3), -0.00987822, 1e-6);
   }
 
-  GateFused<GateQSim<fp_type>> fgate5{kGateCP, 10, {0, 1}, &gate23, {&gate23}};
+  GateFused<GateQSim<fp_type>> fgate5{kGateCP, 10, {0, 1}, &gate23,
+      {&gate23}, {}};
+  CalculateFusedMatrix(fgate5);
   ApplyFusedGate(simulator, fgate5, state);
 
   EXPECT_NEAR(state_space.Norm(state), 1, 1e-6);
diff --git a/tests/statespace_testfixture.h b/tests/statespace_testfixture.h
index 2a41c047..a6df9a29 100644
--- a/tests/statespace_testfixture.h
+++ b/tests/statespace_testfixture.h
@@ -463,17 +463,18 @@ void TestNormAndInnerProductSmall(const Factory& factory) {
 
 template <typename Factory>
 void TestNormAndInnerProduct(const Factory& factory) {
+  using Simulator = typename Factory::Simulator;
+  using StateSpace = typename Simulator::StateSpace;
+  using State = typename StateSpace::State;
+  using fp_type = typename StateSpace::fp_type;
+  using Runner = QSimRunner<IO, BasicGateFuser<IO, GateQSim<fp_type>>, Factory>;
+
   unsigned depth = 8;
 
   std::stringstream ss(circuit_string);
-  Circuit<GateQSim<float>> circuit;
+  Circuit<GateQSim<fp_type>> circuit;
   EXPECT_TRUE(CircuitQsimParser<IO>::FromStream(depth, provider, ss, circuit));
-  circuit.gates.emplace_back(GateT<float>::Create(depth + 1, 0));
-
-  using Simulator = typename Factory::Simulator;
-  using StateSpace = typename Simulator::StateSpace;
-  using State = typename StateSpace::State;
-  using Runner = QSimRunner<IO, BasicGateFuser<IO, GateQSim<float>>, Factory>;
+  circuit.gates.emplace_back(GateT<fp_type>::Create(depth + 1, 0));
 
   StateSpace state_space = factory.CreateStateSpace();
   State state0 = state_space.Create(circuit.num_qubits);
@@ -773,17 +774,18 @@ void TestMeasurementSmall(const Factory& factory, bool cuda = false) {
 
 template <typename Factory>
 void TestMeasurementLarge(const Factory& factory) {
+  using Simulator = typename Factory::Simulator;
+  using StateSpace = typename Simulator::StateSpace;
+  using State = typename StateSpace::State;
+  using fp_type = typename StateSpace::fp_type;
+  using Runner = QSimRunner<IO, BasicGateFuser<IO, GateQSim<fp_type>>, Factory>;
+
   unsigned depth = 20;
 
   std::stringstream ss(circuit_string);
-  Circuit<GateQSim<float>> circuit;
+  Circuit<GateQSim<fp_type>> circuit;
   EXPECT_TRUE(CircuitQsimParser<IO>::FromStream(depth, provider, ss, circuit));
 
-  using Simulator = typename Factory::Simulator;
-  using StateSpace = typename Simulator::StateSpace;
-  using State = typename StateSpace::State;
-  using Runner = QSimRunner<IO, BasicGateFuser<IO, GateQSim<float>>, Factory>;
-
   StateSpace state_space = factory.CreateStateSpace();
   State state = state_space.Create(circuit.num_qubits);
 
diff --git a/tests/unitary_calculator_testfixture.h b/tests/unitary_calculator_testfixture.h
index 3b7707c3..cd77ca43 100644
--- a/tests/unitary_calculator_testfixture.h
+++ b/tests/unitary_calculator_testfixture.h
@@ -425,8 +425,10 @@ void TestApplyFusedGate() {
   std::vector<Gate> gates = {Cirq::H<fp_type>::Create(0, 0),
                              Cirq::H<fp_type>::Create(1, 0)};
 
-  GateFused<Gate> fgate{Cirq::kH, 0, {0}, &gates[0], {&gates[0], &gates[1]}};
+  GateFused<Gate> fgate {Cirq::kH, 0, {0}, &gates[0],
+                         {&gates[0], &gates[1]}, {}};
 
+  CalculateFusedMatrix(fgate);
   ApplyFusedGate(uc, fgate, u);
 
   unsigned size = 1 << num_qubits;

From a058fc99c04cf412ac0084a8bd1d5c20895f24e3 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <mneeley@gmail.com>
Date: Mon, 25 Oct 2021 08:49:58 -0700
Subject: [PATCH 133/246] Remove print in qsim_simulator when sampling from
 final state vector (#461)

This print results in very verbose output when using QSimSimulator. Could also convert it to debug logging if people think it's still helpful to have.

Review: @95-martin-orion
---
 qsimcirq/qsim_simulator.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 34bbde2e..806c910c 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -332,10 +332,6 @@ def _sample_measure_results(
             sampler_fn = self._sim_module.qsim_sample
 
         if not noisy and program.are_all_measurements_terminal() and repetitions > 1:
-            print(
-                "Provided circuit has no intermediate measurements. "
-                + "Sampling repeatedly from final state vector."
-            )
             # Measurements must be replaced with identity gates to sample properly.
             # Simply removing them may omit qubits from the circuit.
             for i in range(len(program.moments)):

From f76aa22221dd5c2812fe5acb8f91daf23207b4e2 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Mon, 25 Oct 2021 16:16:41 +0000
Subject: [PATCH 134/246] Fixes href rendering in docs/tutorials/multinode.md
 (Step 1 -> Clone this repo)

---
 docs/tutorials/multinode.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/tutorials/multinode.md b/docs/tutorials/multinode.md
index 2cf434c7..746ceda8 100644
--- a/docs/tutorials/multinode.md
+++ b/docs/tutorials/multinode.md
@@ -22,9 +22,11 @@ tutorial, open the [Cloud Shell in the Cloud Console](https://console.cloud.goog
 ### Clone this repo
 
 In your Cloud Shell window, clone this Github repo.
+
 ``` bash
 git clone https://github.com/quantumlib/qsim.git
 ```
+
 If you get an error saying something like `qsim already exists`, you may need
 to delete the `qsim` directory with `rm -rf qsim` and rerun the clone command.
 

From 250967901574d17dadb15dccda02b52fc8e937f6 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Mon, 25 Oct 2021 16:47:55 +0000
Subject: [PATCH 135/246] Fixes href rendering in docs/tutorials/multinode.md

---
 docs/tutorials/multinode.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/docs/tutorials/multinode.md b/docs/tutorials/multinode.md
index 746ceda8..8d425cc2 100644
--- a/docs/tutorials/multinode.md
+++ b/docs/tutorials/multinode.md
@@ -33,15 +33,18 @@ to delete the `qsim` directory with `rm -rf qsim` and rerun the clone command.
 ### Change directory
 
 Change directory to the tutorial:
+
 ``` bash
 cd qsim/docs/tutorials/multinode/terraform
 ```
+
 This is where you will use `terraform` to create the HTCondor cluster required to run your jobs.
 
 ### Edit `init.sh` file to match your environment
 
 Using your favorite text file editor, open the `init.sh` file. The first few
 lines should look like this:
+
 ```bash
 # ---- Edit below -----#
 
@@ -49,6 +52,7 @@ export TF_VAR_project=[USER_PROJECT]
 export TF_VAR_zone=us-east4-c
 export TF_VAR_region=us-east4
 ```
+
 Replace `[USER_PROJECT]` with the project name you chose on the
 `Before you begin` page.
 
@@ -63,9 +67,11 @@ your project will create new jobs.
 ### Source the `init.sh` file
 
 The edited `init.sh` file should be "sourced" in the cloud shell:
+
 ``` bash
 source init.sh
 ```
+
 Respond `Agree` to any pop-ups that request permissions on the Google Cloud platform.
 
 The final outcome of this script will include:
@@ -94,10 +100,13 @@ Terraform has been successfully initialized!
 
 For convenience, some terraform commands are prepared in a `Makefile`. This
 means you can now create your cluster, with a simple `make` command.
+
 ```bash
 make apply
 ```
+
 A successful run will show:
+
 ```
 Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
 ```
@@ -111,10 +120,13 @@ commands to submit and monitor jobs on HTCondor.
 ### List VMs that were created by HTCondor
 
 To see the VMs created by HTCondor, run:
+
 ```bash
 gcloud compute instances list
 ```
+
 At this point in the tutorial, you will see two instances listed:
+
 ```
 NAME: c-manager
 ZONE: us-central1-a
@@ -145,14 +157,17 @@ complete.
 
 This new window is logged into your HTCondor cluster. You will see a command
 prompt that looks something like this:
+
 ```bash
 [mylogin@c-submit ~]$
 ```
+
 The following steps should be performed in this window.
 
 ### Checking the status
 
 You can run `condor_q` to verify if the HTCondor install is completed. The output should look something like this:
+
 ```
 -- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
 OWNER BATCH_NAME      SUBMITTED   DONE   RUN    IDLE   HOLD  TOTAL JOB_IDS
@@ -161,6 +176,7 @@ Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 su
 Total for drj: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
 Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
 ```
+
 If you get `command not found`, you will need to wait a few minutes for the HTCondor install to complete.
 
 ## 4. Get the sample code and run it
@@ -172,10 +188,13 @@ sample jobs have been provided in the Github repo.
 
 On the submit node, you can clone the repo to get access to previously
 created submission files:
+
 ```bash
 git clone https://github.com/quantumlib/qsim.git
 ```
+
 Then cd to the tutorial directory.
+
 ```bash
 cd qsim/docs/tutorials/multinode
 ```

From dfd8f6441164578711c7870cad02eb9a12168fa6 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Tue, 26 Oct 2021 18:17:58 +0200
Subject: [PATCH 136/246] Verbosity levels.

---
 docs/usage.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/usage.md b/docs/usage.md
index 14dbcda8..33b7f317 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -28,6 +28,17 @@ Sample circuits are provided in
 qsim_base computes all the amplitudes and just prints the first eight of them
 (or a smaller number for 1- or 2-qubit circuits).
 
+Verbosity levels are described in the following table.
+
+| Verbosity level | Description |
+|-----------------|-------------|
+| 0 | no additional information|
+| 1 | add total simulation runtime|
+| 2 | add initialization runtime and fuser runtime|
+| 3 | add basic fuser statistics|
+| 4 | add simulation runtime for each fused gate|
+| 5 | additional fuser information (qubit indices for each fused gate)|
+
 Example:
 ```
 ./qsim_base.x -c ../circuits/circuit_q24 -d 16 -t 8 -v 1

From c9bc8844ceb87c22eb5b812f53b4df4617532bed Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Tue, 26 Oct 2021 16:59:56 +0000
Subject: [PATCH 137/246] Fine polish on the setup tutorials.

---
 docs/tutorials/gcp_cpu.md | 86 ++++++++++++++++++++-------------------
 docs/tutorials/gcp_gpu.md | 53 ++++++++++++------------
 2 files changed, 72 insertions(+), 67 deletions(-)

diff --git a/docs/tutorials/gcp_cpu.md b/docs/tutorials/gcp_cpu.md
index f68e61e5..0795e622 100644
--- a/docs/tutorials/gcp_cpu.md
+++ b/docs/tutorials/gcp_cpu.md
@@ -11,19 +11,20 @@ Follow the instructions in the
 guide to create a VM. In addition to the guidance under the Create a Linux VM
 instance heading, ensure that your VM has the following properties:
 
-*   In the Machine Configuration section, in the Machine family options,
-    click on the **Compute Optimized** filter.
-*   In the Machine Configuration section, in the Machine family options, in
-    the Series option, choose **C2**.
-*   In the Machine Configuration section, in the Machine family options, in
-    the Machine type option, choose **c2-standard-16**. This option gives
-    you 16 virtual CPUS and 64MB of RAM.
-    *   This choice is for demonstration purposes only. For a live experiment,
-        see [Choosing hardware for your qsim simulation](/qsim/choose_hw)
-*   In the Boot disk section, click the Change button, and choose
-    Container-Optimized OS. This overrides step 3 in the quickstart guide.
-*   In the Firewall section, ensure that both the **Allow HTTP traffic**
-    checkbox and **Allow HTTPS traffic** checkbox have marks.
+*   In the **Machine Configuration** section:
+    1. Select the tab for the **Compute Optimized** machine family.
+    2. In the machine **Series** option, choose **C2**.
+    3. In the **Machine type** option, choose **c2-standard-16**. This option
+       gives you 16 virtual CPUS and 64MB of RAM.
+       Note: This choice is for demonstration purposes only. For a live
+       experiment, see [Choosing hardware for your qsim
+       simulation](/qsim/choose_hw).
+*   In the **Boot disk section**, click the **Change** button, and choose
+    **Container-Optimized** operating system. This overrides the seletion in
+    step 3 in [Create a Linux VM
+    instance](https://cloud.google.com/compute/docs/quickstart-linux#create_a_linux_vm_instance).
+*   In the **Firewall** section, ensure that both the **Allow HTTP traffic**
+    checkbox and the **Allow HTTPS traffic** checkbox are selected.
 
 When Google Cloud finishes creating the VM, you can see your VM listed in the
 [Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
@@ -62,30 +63,29 @@ machine to your virtual machine.
 
 ## 3. Start the qsim Docker container on your virtual machine
 
-On your VM, start the qsim container by typing the following command at the
-command prompt, on your VM from the previous step.
+1.  On the VM that you just created, start the qsim container:
 
-```
-docker run -v `pwd`:/homedir -p 8888:8888 gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest &
-```
+    ```
+    docker run -v `pwd`:/homedir -p 8888:8888 gcr.io/quantum-builds/github.com/quantumlib/jupyter_qsim:latest &
+    ```
 
-If you see a `permission denied` error message, you might need to add `sudo`
-before your Docker command. For more information about running Docker, see the
-[`docker run` command reference](https://docs.docker.com/engine/reference/run/#general-form).
+    If you see a `permission denied` error message, you might need to add `sudo`
+    before your Docker command. For more information about running Docker, see the
+    [`docker run` command reference](https://docs.docker.com/engine/reference/run/#general-form).
 
-As Docker downloads and starts the container, it prints many lines of output.
-The last few lines should be similar to the following output:
+2.  Verify the output from Docker when as it downloads and starts the container.
+    The last few lines should be similar to the following output:
 
-```
-To access the notebook, open this file in a browser:
-    file:///root/.local/share/jupyter/runtime/nbserver-1-open.html
-Or copy and paste one of these URLs:
-    http://e1f7a7cca9fa:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
-    or http://127.0.0.1:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
-```
+    ```
+    To access the notebook, open this file in a browser:
+        file:///root/.local/share/jupyter/runtime/nbserver-1-open.html
+    Or copy and paste one of these URLs:
+        http://e1f7a7cca9fa:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
+        or http://127.0.0.1:8888/?token=aa16e1b6d3f51c58928037d34cc6854dac47347dd4c0eae5
+    ```
 
-Copy the URL in the last line of output from your console, and save it for the
-next step.
+3.  Copy the URL in the last line of output from your console, and save it for
+    the next task.
 
 ## 4. Connect to your virtual machine
 
@@ -106,18 +106,19 @@ and run your code.
 
       1.  Open the
           [Get Started with qsimcirq notebook](https://quantumai.google/qsim/tutorials/qsimcirq).
-      2.  Near the top-right corner of your notebook, click the small triangle beside
+      2.  Click the **Connect** drop-down menu.
           the Connect button to open the menu.
       3.  Choose the **Connect to a local runtime** option to open the Local
           connection settings window.
           <img src="../images/colab_connect.png" alt="Google Colab Connect to Local Runtime button" style="width: 62%" class="screenshot">
-      1.  In the Backend URL text field, paste the URL that you saved in step 5.
-      2.  Change the part of your URL that read `127.0.0.1` to `localhost`.
+      4.  In the **Backend URL** text field, paste the URL that you saved in
+          [task 3](#3_start_the_qsim_docker_container_on_your_virtual_machine).
+      5.  Change the part of your URL that read `127.0.0.1` to `localhost`.
           <img src="../images/colab_remote.png" alt="Google Colab Local Runtime connection window" style="width: 62%" class="screenshot">
-      1.  Click the **Connect** button in the Local connection settings window.
+      6.  Click the **Connect** button in the Local connection settings window.
 
       When your connection is ready, Colab displays a green checkmark beside the
-      Connected (Local) button near the top-right corner of your notebook.
+      Connected (Local) drop-down menu.
 
       <img src="../images/colab_connected.png" alt="Google Colab Local Runtime connection windo" style="width: 62%" class="screenshot">
 
@@ -130,7 +131,8 @@ and run your code.
       Jupyter runs in the qsim Docker container.
 
       1.  Open a browser window.
-      2.  In the navigation bar, paste the URL that you copied in step 4.
+      2.  In the navigation bar, paste the URL that you copied in [task
+          3](#3_start_the_qsim_docker_container_on_your_virtual_machine).
       3.  In the browser you should now see the Jupyter UI, running on your VM.
 
       The code that you execute here executes on your VM. You can navigate to qsim >
@@ -143,9 +145,9 @@ and run your code.
 
       **Before you begin**
 
-      For this scenario, you can connect to your machine directly over SSH rather than
-      create a tunnel. In step 2.3 above, remove the second half of the command.
-      Instead of the following command:
+      For this scenario, you can connect to your machine directly over SSH
+      rather than create a tunnel. In [task 2, step 3](#2_prepare_your_computer)
+      above, remove the second half of the command.  Instead of this command:
 
       ```
       gcloud compute ssh [YOUR_INSTANCE_NAME] -- -L 8888:localhost:8888
@@ -157,7 +159,7 @@ and run your code.
       gcloud compute ssh [YOUR_INSTANCE_NAME]
       ```
 
-      Either command works for the purpose of this tutorial. Continue to step 4 then
+      Either command works for the purpose of this tutorial. Continue to task 4 then
       complete the steps below, regardless of which command you use.
 
       **1. Copy the container ID for your qsim Docker container**
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 61e686fe..119fa2c2 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -3,7 +3,7 @@
 In this tutorial, you configure and test a virtual machine (VM) to run GPU-based
 quantum simulations on Google Cloud.
 
-The later steps in this tutorial require you to enter several commands at the
+Note: The later steps in this tutorial require you to enter several commands at the
 command line. Some commands might require you to add `sudo` before the command.
 For example, if a step asks you to type `icecream -fancy`, you might need to
 type `sudo icecream -fancy`.
@@ -12,21 +12,22 @@ type `sudo icecream -fancy`.
 
 Follow the instructions in the
 [Quickstart using a Linux VM](https://cloud.google.com/compute/docs/quickstart-linux)
-guide to create a VM. In addition to the guidance under the Create a Linux VM
-instance heading, ensure that your VM has the following properties:
-
-*   In the Machine Configuration section, in the Machine Family options, click
-    on the **GPU** filter.
-*   In the Machine Configuration section, in the Machine family options, in the
-    GPU type option, choose **NVIDIA Tesla A100**.
-    *   In the Number of GPUs option, choose **1**.
-*   In the Boot disk section, click the **Change** button.
-    *   In the Operating System option, choose **Ubuntu**.
-    *   In the Version option, choose **20.04 LTS**.
-    *   In the Size field, enter **30** (minimum).
-    *   This overrides step 3 through 5 in the Quickstart guide.
-*   In the Firewall section, ensure that both the **Allow HTTP traffic**
-    checkbox and **Allow HTTPS traffic** checkbox have marks.
+guide to create a VM. In addition to the guidance specified in the Create a Linux VM
+instance section, ensure that your VM has the following properties:
+
+*   In the **Machine Configuration** section:
+    1.  Select the tab for the **GPU** machine family.
+    2.   In the **GPU type** option, choose **NVIDIA Tesla A100**.
+    3.   In the **Number of GPUs** option, choose **1**.
+*   In the **Boot disk** section, click the **Change** button:
+    1.   In the **Operating System** option, choose **Ubuntu**.
+    2.   In the **Version** option, choose **20.04 LTS**.
+    3.   In the **Size** field, enter **30** (minimum).
+    4.   This overrides step 3 through 5 in the [Create a Linux
+         VM instance](https://cloud.google.com/compute/docs/quickstart-linux)
+         Quickstart.
+*   In the **Firewall** section, ensure that both the **Allow HTTP traffic**
+    checkbox and the **Allow HTTPS traffic** checkboxs are selected.
 
 When Google Cloud finishes creating the VM, you can see your VM listed in the
 [Compute Instances dashboard](https://pantheon.corp.google.com/compute/instances)
@@ -63,11 +64,13 @@ machine to your virtual machine.
 
 ## 3. Enable your virutal machine to use the GPU
 
-1.  Install the GPU driver. In the Google Cloud documentation, in the Installing
-    GPU drivers guide, follow the steps provided in the following sections:
+1.  Install the GPU driver. Complete the steps provided in the following
+    sections of the [Installing GPU
+    drivers](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu):
+    guide:
     *   [Examples](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#examples),
-        under the Ubuntu tab. Only follow the steps for Ubuntu 20.04 (steps 3a
-        through 3f).
+        under the **Ubuntu** tab. For step 3, only perform the steps for
+        **Ubuntu 20.04** (steps 3a through 3f).
     *   [Verifying the GPU driver install](https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#verify-driver-install)
 2.  Install the CUDA toolkit.
 
@@ -123,7 +126,7 @@ sudo apt install cmake && sudo apt install pip && pip install pybind11
 3.  Run `make` to compile qsim. When make detects the CUDA toolkit during
     compilation, make builds the GPU version of qsim automatically.
 4.  Run `pip install .` to install your local version of qsimcirq.
-5.  Verify your installation.
+5.  Verify your qsim installation.
 
     ```shell
     python3 -c "import qsimcirq; print(qsimcirq.qsim_gpu)"
@@ -132,15 +135,15 @@ sudo apt install cmake && sudo apt install pip && pip install pybind11
     If the installation completed successfully, the output from the command
     should resemble the following:
 
-    ```shell
+    ```none
     <module 'qsimcirq.qsim_cuda' from '/home/user_org_com/qsim/qsimcirq/qsim_cuda.cpython-38-x86_64-linux-gnu.so'>
     ```
 
 
 ## 6. Verify your installation
 
-You can use the code below to verify that qsim uses your GPU. You can paste the
-code directly into the REPL, or paste the code in a file.
+You can use the following code to verify that qsim uses your GPU. You can paste
+the code directly into the REPL, or paste the code in a file.
 
 ```
 # Import Cirq and qsim
@@ -168,7 +171,7 @@ print(qsim_results)
 
 After a moment, you should see a result that looks similar to the following.
 
-```
+```none
 [(0.7071067690849304+0j), 0j]
 ```
 

From 2e6e05e02ad56e4fbd4672acc00d398c65ba7e37 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 27 Oct 2021 08:33:32 -0700
Subject: [PATCH 138/246] Align with Cirq 0.13.1

---
 qsimcirq/qsim_simulator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 806c910c..39796b92 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -305,7 +305,7 @@ def _sample_measure_results(
         current_index = 0
         for op in measurement_ops:
             gate = op.gate
-            key = protocols.measurement_key(gate)
+            key = protocols.measurement_key_name(gate)
             meas_ops[key] = op
             if key in bounds:
                 raise ValueError(f"Duplicate MeasurementGate with key {key}")

From d7cd507ba1b3809e568bce3625f9a51e5cc051a7 Mon Sep 17 00:00:00 2001
From: Ricardo Olenewa <rolenewa@gmail.com>
Date: Thu, 28 Oct 2021 16:24:37 +0000
Subject: [PATCH 139/246] Addresses comments.

---
 docs/tutorials/gcp_gpu.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index f5933f86..6d442051 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -23,9 +23,9 @@ instance section, ensure that your VM has the following properties:
     1.   In the **Operating System** option, choose **Ubuntu**.
     2.   In the **Version** option, choose **20.04 LTS**.
     3.   In the **Size** field, enter **30** (minimum).
-    4.   This overrides step 3 through 5 in the [Create a Linux
-         VM instance](https://cloud.google.com/compute/docs/quickstart-linux)
-         Quickstart.
+*   The instructions above override steps 3 through 5 in the [Create a Linux VM
+    instance](https://cloud.google.com/compute/docs/quickstart-linux)
+    Quickstart.
 *   In the **Firewall** section, ensure that both the **Allow HTTP traffic**
     checkbox and the **Allow HTTPS traffic** checkboxs are selected.
 

From 25c9a4640ef5ea4032b5d3f2a2913196f387c809 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 1 Nov 2021 12:17:50 -0700
Subject: [PATCH 140/246] Unpin qsimcirq version in noisy_qsimcirq doc

---
 docs/tutorials/noisy_qsimcirq.ipynb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/tutorials/noisy_qsimcirq.ipynb b/docs/tutorials/noisy_qsimcirq.ipynb
index 6f366593..af2e5c89 100644
--- a/docs/tutorials/noisy_qsimcirq.ipynb
+++ b/docs/tutorials/noisy_qsimcirq.ipynb
@@ -98,7 +98,7 @@
     "try:\n",
     "    import qsimcirq\n",
     "except ImportError:\n",
-    "    !pip install qsimcirq==0.9.5 --quiet\n",
+    "    !pip install qsimcirq --quiet\n",
     "    import qsimcirq"
    ]
   },
@@ -284,4 +284,4 @@
    "metadata": {}
   }
  ]
-}
\ No newline at end of file
+}

From f0491cccf78e5d2f5a6054f326e8da50ea74fd1d Mon Sep 17 00:00:00 2001
From: Bernardo Meurer <bernardo@meurer.org>
Date: Sat, 30 Oct 2021 00:52:02 -0700
Subject: [PATCH 141/246] refactor: split dev requirements out of main
 requirements.txt

---
 .github/workflows/python_format.yml  |  6 ++----
 .github/workflows/testing_wheels.yml |  1 +
 MANIFEST.in                          |  1 +
 dev-requirements.txt                 |  3 +++
 docs/install_qsimcirq.md             |  6 ++++++
 requirements.txt                     | 12 ++----------
 setup.py                             |  4 ++++
 7 files changed, 19 insertions(+), 14 deletions(-)
 create mode 100644 dev-requirements.txt

diff --git a/.github/workflows/python_format.yml b/.github/workflows/python_format.yml
index adb5f56f..213abf2e 100644
--- a/.github/workflows/python_format.yml
+++ b/.github/workflows/python_format.yml
@@ -24,9 +24,7 @@ jobs:
         with:
           python-version: '3.7'
           architecture: 'x64'
-      - name: Install flynt
-        run: cat requirements.txt | grep flynt | xargs pip install
-      - name: Install black
-        run: cat requirements.txt | grep black | xargs pip install
+      - name: Install dev requirements
+        run: pip install -r dev-requirements.txt
       - name: Format
         run: check/format-incremental
diff --git a/.github/workflows/testing_wheels.yml b/.github/workflows/testing_wheels.yml
index eeb4d741..55dd237a 100644
--- a/.github/workflows/testing_wheels.yml
+++ b/.github/workflows/testing_wheels.yml
@@ -45,6 +45,7 @@ jobs:
       CIBW_REPAIR_WHEEL_COMMAND_MACOS: ""
       # due to package and module name conflict have to temporarily move it away to run tests
       CIBW_BEFORE_TEST: "mv {package}/qsimcirq /tmp"
+      CIBW_TEST_EXTRAS: "dev"
       CIBW_TEST_COMMAND: "pytest {package}/qsimcirq_tests/qsimcirq_test.py && mv /tmp/qsimcirq {package}"
     steps:
       - uses: actions/checkout@v2
diff --git a/MANIFEST.in b/MANIFEST.in
index 2968589b..4b487267 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,4 +1,5 @@
 include requirements.txt
+include dev-requirements.txt
 include CMakeLists.txt
 
 graft pybind_interface
diff --git a/dev-requirements.txt b/dev-requirements.txt
new file mode 100644
index 00000000..4cb3afc0
--- /dev/null
+++ b/dev-requirements.txt
@@ -0,0 +1,3 @@
+black==20.8b1
+flynt~=0.60
+pytest
diff --git a/docs/install_qsimcirq.md b/docs/install_qsimcirq.md
index 9ae35d21..0a0f3182 100644
--- a/docs/install_qsimcirq.md
+++ b/docs/install_qsimcirq.md
@@ -17,6 +17,12 @@ Prerequisites are included in the
 [`requirements.txt`](https://github.com/quantumlib/qsim/blob/master/requirements.txt)
 file, and will be automatically installed along with qsimcirq.
 
+If you'd like to develop qsimcirq, a separate set of dependencies are includes
+in the
+[`dev-requirements.txt`](https://github.com/quantumlib/qsim/blob/master/dev-requirements.txt)
+file. You can install them with `pip3 install -r dev-requirements.txt` or
+`pip3 install qsimcirq[dev]`.
+
 ## Linux installation
 
 We provide `qsimcirq` Python wheels on 64-bit `x86` architectures with `Python 3.{6,7,8,9}`.
diff --git a/requirements.txt b/requirements.txt
index 01d20cd5..0a95d64c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,13 +1,5 @@
-# Runtime requirements for the python 3 version of cirq.
-
+absl-py
 cirq-core
 numpy~=1.16
-typing_extensions
-absl-py
-
-# Build and test requirements
-
-black==20.8b1
-flynt~=0.60
 pybind11
-pytest
+typing_extensions
diff --git a/setup.py b/setup.py
index a6d76835..30bb72d4 100644
--- a/setup.py
+++ b/setup.py
@@ -78,6 +78,7 @@ def build_extension(self, ext):
 
 
 requirements = open("requirements.txt").readlines()
+dev_requirements = open("dev-requirements.txt").readlines()
 
 description = "Schrödinger and Schrödinger-Feynman simulators for quantum circuits."
 
@@ -94,6 +95,9 @@ def build_extension(self, ext):
     author_email="devabathini92@gmail.com",
     python_requires=">=3.3.0",
     install_requires=requirements,
+    extras_require={
+        "dev": dev_requirements,
+    },
     license="Apache 2",
     description=description,
     long_description=long_description,

From 9cd89369755860c82b7fc0b29f737ce3e1661790 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 5 Nov 2021 08:28:11 -0700
Subject: [PATCH 142/246] Update cirq_compatibility.yml

---
 .github/workflows/cirq_compatibility.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/cirq_compatibility.yml b/.github/workflows/cirq_compatibility.yml
index 04e13559..f4fd7473 100644
--- a/.github/workflows/cirq_compatibility.yml
+++ b/.github/workflows/cirq_compatibility.yml
@@ -18,5 +18,7 @@ jobs:
         run: pip3 install -U cirq --pre
       - name: Install qsim requirements
         run: pip3 install -r requirements.txt
+      - name: Install test requirements
+        run: pip3 install -r dev-requirements.txt
       - name: Run python tests
         run: make run-py-tests

From 99c1f699cf7ba8ad13bd0ec75a7bba3534f4a1d7 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 08:52:33 -0800
Subject: [PATCH 143/246] Add cuQuantum blurb in docs

---
 docs/tutorials/gcp_gpu.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 6d442051..234d6dd6 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -175,6 +175,20 @@ After a moment, you should see a result that looks similar to the following.
 [(0.7071067690849304+0j), 0j]
 ```
 
+### Optional: Use the NVIDIA cuQuantum SDK 
+
+If you have the NVIDIA cuQuantum SDK installed, you can use it here by
+modifying the `gpu_options` line like so:
+
+```python
+gpu_options = qsimcirq.QSimOptions(use_gpu=True, gpu_mode=1)
+```
+
+This instructs qsim to make use of its cuQuantum integration, which provides
+improved performance on NVIDIA GPUs. If you experience issues with this
+option, please file an issue on the qsim repository.
+
+
 ## Next steps
 
 After you finish, don't forget to stop or delete your VM on the Compute

From 3e96eef6b157c1efff08d7b7b8a2dbb67e6ced0f Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Mon, 8 Nov 2021 17:26:42 +0100
Subject: [PATCH 144/246] Add cuQuantum integration.

---
 CMakeLists.txt                                |   3 +
 Makefile                                      |  16 +
 apps/Makefile                                 |  15 +-
 apps/make.sh                                  |   4 +
 apps/qsim_base_custatevec.cu                  | 171 ++++++++
 docs/cirq_interface.md                        |  16 +-
 lib/simulator_custatevec.h                    | 182 +++++++++
 lib/statespace_custatevec.h                   | 378 ++++++++++++++++++
 lib/util_custatevec.h                         |  44 ++
 pybind_interface/Makefile                     |  19 +-
 pybind_interface/cuda/pybind_main_cuda.cpp    |   4 +-
 pybind_interface/custatevec/CMakeLists.txt    |  58 +++
 .../custatevec/pybind_main_custatevec.cpp     |  58 +++
 .../custatevec/pybind_main_custatevec.h       |  17 +
 pybind_interface/decide/CMakeLists.txt        |   7 +
 pybind_interface/decide/decide.cpp            |  34 +-
 pybind_interface/pybind_main.cpp              |  70 ++--
 qsimcirq/__init__.py                          |  23 ++
 qsimcirq/qsim_simulator.py                    |  37 +-
 qsimcirq_tests/qsimcirq_test.py               |  83 ++++
 setup.py                                      |   1 +
 tests/Makefile                                |  19 +-
 tests/hybrid_custatevec_test.cu               |  67 ++++
 tests/make.sh                                 |   8 +
 tests/qtrajectory_custatevec_test.cu          |  83 ++++
 tests/simulator_custatevec_test.cu            | 108 +++++
 tests/statespace_custatevec_test.cu           | 127 ++++++
 27 files changed, 1601 insertions(+), 51 deletions(-)
 create mode 100644 apps/qsim_base_custatevec.cu
 create mode 100644 lib/simulator_custatevec.h
 create mode 100644 lib/statespace_custatevec.h
 create mode 100644 lib/util_custatevec.h
 create mode 100644 pybind_interface/custatevec/CMakeLists.txt
 create mode 100644 pybind_interface/custatevec/pybind_main_custatevec.cpp
 create mode 100644 pybind_interface/custatevec/pybind_main_custatevec.h
 create mode 100644 tests/hybrid_custatevec_test.cu
 create mode 100644 tests/qtrajectory_custatevec_test.cu
 create mode 100644 tests/simulator_custatevec_test.cu
 create mode 100644 tests/statespace_custatevec_test.cu

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d1a6c0ea..615a33db 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -6,6 +6,9 @@ if(has_nvcc STREQUAL "")
 else()
     project(qsim LANGUAGES CXX CUDA)
     ADD_SUBDIRECTORY(pybind_interface/cuda)
+    if(DEFINED ENV{CUQUANTUM_ROOT})
+        ADD_SUBDIRECTORY(pybind_interface/custatevec)
+    endif()
 endif()
 
 ADD_SUBDIRECTORY(pybind_interface/sse)
diff --git a/Makefile b/Makefile
index 49d1370b..900aa3cd 100644
--- a/Makefile
+++ b/Makefile
@@ -11,6 +11,9 @@ CXXFLAGS = -O3 -fopenmp
 ARCHFLAGS = -march=native
 NVCCFLAGS = -O3
 
+# CUQUANTUM_ROOT should be set.
+CUSTATEVECFLAGS = -I$(CUQUANTUM_ROOT)/include -L$(CUQUANTUM_ROOT)/lib64 -lcustatevec -lcublas
+
 PYBIND11 = true
 
 export CXX
@@ -18,6 +21,7 @@ export CXXFLAGS
 export ARCHFLAGS
 export NVCC
 export NVCCFLAGS
+export CUSTATEVECFLAGS
 
 ifeq ($(PYBIND11), true)
   TARGETS += pybind
@@ -35,6 +39,10 @@ qsim:
 qsim-cuda:
 	$(MAKE) -C apps/ qsim-cuda
 
+.PHONY: qsim-custatevec
+qsim-custatevec:
+	$(MAKE) -C apps/ qsim-custatevec
+
 .PHONY: pybind
 pybind:
 	$(MAKE) -C pybind_interface/ pybind
@@ -47,6 +55,10 @@ cxx-tests: eigen
 cuda-tests:
 	$(MAKE) -C tests/ cuda-tests
 
+.PHONY: custatevec-tests
+custatevec-tests:
+	$(MAKE) -C tests/ custatevec-tests
+
 .PHONY: run-cxx-tests
 run-cxx-tests: cxx-tests
 	$(MAKE) -C tests/ run-cxx-tests
@@ -55,6 +67,10 @@ run-cxx-tests: cxx-tests
 run-cuda-tests: cuda-tests
 	$(MAKE) -C tests/ run-cuda-tests
 
+.PHONY: run-custatevec-tests
+run-custatevec-tests: custatevec-tests
+	$(MAKE) -C tests/ run-custatevec-tests
+
 PYTESTS = $(shell find qsimcirq_tests/ -name '*_test.py')
 
 .PHONY: run-py-tests
diff --git a/apps/Makefile b/apps/Makefile
index cb16c1c9..41fb81e5 100644
--- a/apps/Makefile
+++ b/apps/Makefile
@@ -1,8 +1,11 @@
 CXX_TARGETS = $(shell find . -maxdepth 1 -name '*.cc')
 CXX_TARGETS := $(CXX_TARGETS:%.cc=%.x)
 
-CUDA_TARGETS = $(shell find . -maxdepth 1 -name '*.cu')
-CUDA_TARGETS := $(CUDA_TARGETS:%.cu=%.x)
+CUDA_TARGETS = $(shell find . -maxdepth 1 -name '*cuda.cu')
+CUDA_TARGETS := $(CUDA_TARGETS:%cuda.cu=%cuda.x)
+
+CUSTATEVEC_TARGETS = $(shell find . -maxdepth 1 -name "*custatevec.cu")
+CUSTATEVEC_TARGETS := $(CUSTATEVEC_TARGETS:%custatevec.cu=%custatevec.x)
 
 .PHONY: qsim
 qsim: $(CXX_TARGETS)
@@ -10,12 +13,18 @@ qsim: $(CXX_TARGETS)
 .PHONY: qsim-cuda
 qsim-cuda: $(CUDA_TARGETS)
 
+.PHONY: qsim-custatevec
+qsim-custatevec: $(CUSTATEVEC_TARGETS)
+
 %.x: %.cc
 	$(CXX) -o ./$@ $< $(CXXFLAGS) $(ARCHFLAGS)
 
-%.x: %.cu
+%cuda.x: %cuda.cu
 	$(NVCC) -o ./$@ $< $(NVCCFLAGS)
 
+%custatevec.x: %custatevec.cu
+	$(NVCC) -o ./$@ $< $(NVCCFLAGS) $(CUSTATEVECFLAGS)
+
 .PHONY: clean
 clean:
 	-rm -f ./*.x ./*.a ./*.so ./*.mod
diff --git a/apps/make.sh b/apps/make.sh
index e21f410c..51052cc5 100755
--- a/apps/make.sh
+++ b/apps/make.sh
@@ -25,3 +25,7 @@ g++ -O3 -march=native -fopenmp -o qsimh_amplitudes.x qsimh_amplitudes.cc
 
 nvcc -O3 -o qsim_base_cuda.x qsim_base_cuda.cu
 nvcc -O3 -o qsim_qtrajectory_cuda.x qsim_qtrajectory_cuda.cu
+
+# CUQUANTUM_ROOT should be set.
+CUSTATEVECFLAGS="-I${CUQUANTUM_ROOT}/include -L${CUQUANTUM_ROOT}/lib64 -lcustatevec -lcublas"
+nvcc -O3 $CUSTATEVECFLAGS -o qsim_base_custatevec.x qsim_base_custatevec.cu
diff --git a/apps/qsim_base_custatevec.cu b/apps/qsim_base_custatevec.cu
new file mode 100644
index 00000000..a83f3e46
--- /dev/null
+++ b/apps/qsim_base_custatevec.cu
@@ -0,0 +1,171 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include <unistd.h>
+
+#include <algorithm>
+#include <complex>
+#include <limits>
+#include <string>
+
+#include <custatevec.h>
+
+#include "../lib/circuit_qsim_parser.h"
+#include "../lib/formux.h"
+#include "../lib/fuser_mqubit.h"
+#include "../lib/gates_qsim.h"
+#include "../lib/io_file.h"
+#include "../lib/run_qsim.h"
+#include "../lib/simulator_custatevec.h"
+#include "../lib/util_custatevec.h"
+
+struct Options {
+  std::string circuit_file;
+  unsigned maxtime = std::numeric_limits<unsigned>::max();
+  unsigned seed = 1;
+  unsigned max_fused_size = 2;
+  unsigned verbosity = 0;
+};
+
+Options GetOptions(int argc, char* argv[]) {
+  constexpr char usage[] = "usage:\n  ./qsim_base -c circuit -d maxtime "
+                           "-s seed -f max_fused_size -v verbosity\n";
+
+  Options opt;
+
+  int k;
+
+  while ((k = getopt(argc, argv, "c:d:s:f:v:")) != -1) {
+    switch (k) {
+      case 'c':
+        opt.circuit_file = optarg;
+        break;
+      case 'd':
+        opt.maxtime = std::atoi(optarg);
+        break;
+      case 's':
+        opt.seed = std::atoi(optarg);
+        break;
+      case 'f':
+        opt.max_fused_size = std::atoi(optarg);
+        break;
+      case 'v':
+        opt.verbosity = std::atoi(optarg);
+        break;
+      default:
+        qsim::IO::errorf(usage);
+        exit(1);
+    }
+  }
+
+  return opt;
+}
+
+bool ValidateOptions(const Options& opt) {
+  if (opt.circuit_file.empty()) {
+    qsim::IO::errorf("circuit file is not provided.\n");
+    return false;
+  }
+
+  return true;
+}
+
+template <typename StateSpace, typename State>
+void PrintAmplitudes(
+    unsigned num_qubits, const StateSpace& state_space, const State& state) {
+  static constexpr char const* bits[8] = {
+    "000", "001", "010", "011", "100", "101", "110", "111",
+  };
+
+  uint64_t size = std::min(uint64_t{8}, uint64_t{1} << num_qubits);
+  unsigned s = 3 - std::min(unsigned{3}, num_qubits);
+
+  for (uint64_t i = 0; i < size; ++i) {
+    auto a = state_space.GetAmpl(state, i);
+    qsim::IO::messagef("%s:%16.8g%16.8g%16.8g\n",
+                       bits[i] + s, std::real(a), std::imag(a), std::norm(a));
+  }
+}
+
+int main(int argc, char* argv[]) {
+  using namespace qsim;
+
+  auto opt = GetOptions(argc, argv);
+  if (!ValidateOptions(opt)) {
+    return 1;
+  }
+
+  using fp_type = float;
+
+  Circuit<GateQSim<fp_type>> circuit;
+  if (!CircuitQsimParser<IOFile>::FromFile(opt.maxtime, opt.circuit_file,
+                                           circuit)) {
+    return 1;
+  }
+
+  struct Factory {
+    using Simulator = qsim::SimulatorCuStateVec<fp_type>;
+    using StateSpace = Simulator::StateSpace;
+
+    Factory() {
+      ErrorCheck(cublasCreate(&cublas_handle));
+      ErrorCheck(custatevecCreate(&custatevec_handle));
+    }
+
+    ~Factory() {
+      ErrorCheck(cublasDestroy(cublas_handle));
+      ErrorCheck(custatevecDestroy(custatevec_handle));
+    }
+
+    StateSpace CreateStateSpace() const {
+      return StateSpace(cublas_handle, custatevec_handle);
+    }
+
+    Simulator CreateSimulator() const {
+      return Simulator(custatevec_handle);
+    }
+
+    cublasHandle_t cublas_handle;
+    custatevecHandle_t custatevec_handle;
+  };
+
+  using Simulator = Factory::Simulator;
+  using StateSpace = Simulator::StateSpace;
+  using State = StateSpace::State;
+  using Fuser = MultiQubitGateFuser<IO, GateQSim<fp_type>>;
+  using Runner = QSimRunner<IO, Fuser, Factory>;
+
+  Factory factory;
+
+  StateSpace state_space = factory.CreateStateSpace();
+  State state = state_space.Create(circuit.num_qubits);
+
+  if (state_space.IsNull(state)) {
+    IO::errorf("not enough memory: is the number of qubits too large?\n");
+    return 1;
+  }
+
+  state_space.SetStateZero(state);
+
+  Runner::Parameter param;
+  param.max_fused_size = opt.max_fused_size;
+  param.seed = opt.seed;
+  param.verbosity = opt.verbosity;
+
+  if (Runner::Run(param, factory, circuit, state)) {
+    PrintAmplitudes(circuit.num_qubits, state_space, state);
+  }
+
+  return 0;
+}
diff --git a/docs/cirq_interface.md b/docs/cirq_interface.md
index 5184ed3d..8f610450 100644
--- a/docs/cirq_interface.md
+++ b/docs/cirq_interface.md
@@ -50,7 +50,7 @@ which invokes qsim through the qsim-Cirq interface.
 ## Interface design and operations
 
 The purpose of this interface is to provide a performant simulator for quantum
-circuits defined in Cirq. 
+circuits defined in Cirq.
 
 ### Classes
 
@@ -179,14 +179,18 @@ and run on a device with available NVIDIA GPUs.
 
 Compilation for GPU follows the same steps outlined in the
 [Compiling qsimcirq](./cirq_interface.md#compiling-qsimcirq) section.
+To compile with the NVIDIA cuStateVec library, set the environmment variable
+`CUQUANTUM_ROOT` to path to the root of the cuStateVec library.
 
-`QSimOptions` provides four parameters to configure GPU execution. Only
-`use_gpu` is required to enable GPU execution:
+`QSimOptions` provides five parameters to configure GPU execution. `use_gpu`
+is required to enable GPU execution:
 * `use_gpu`: if True, use GPU instead of CPU for simulation.
+* `gpu_mode`: use CUDA if set to 0 (default value) or use the NVIDIA cuStateVec
+library if set to any other value.
 
-The remaining parameters use default values which provide good performance in
-most cases, but can optionally be set to fine-tune perfomance for a specific
-device or circuit.
+If `use_gpu` is set and `gpu_mode` is set to 0, the remaining parameters can
+optionally be set to fine-tune perfomance for a specific device or circuit.
+In most cases, the default values provide good performance.
 * `gpu_sim_threads`: number of threads per CUDA block to use for the GPU
 Simulator. This must be a power of 2 in the range [32, 256].
 * `gpu_state_threads`: number of threads per CUDA block to use for the GPU
diff --git a/lib/simulator_custatevec.h b/lib/simulator_custatevec.h
new file mode 100644
index 00000000..05e91e16
--- /dev/null
+++ b/lib/simulator_custatevec.h
@@ -0,0 +1,182 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef SIMULATOR_CUSTATEVEC_H_
+#define SIMULATOR_CUSTATEVEC_H_
+
+#include <complex>
+#include <cstdint>
+#include <type_traits>
+
+#include <cuComplex.h>
+#include <custatevec.h>
+
+#include "statespace_custatevec.h"
+#include "util_custatevec.h"
+
+namespace qsim {
+
+/**
+ * Quantum circuit simulator using the NVIDIA cuStateVec library.
+ */
+template <typename FP = float>
+class SimulatorCuStateVec final {
+ public:
+  using StateSpace = StateSpaceCuStateVec<FP>;
+  using State = typename StateSpace::State;
+  using fp_type = typename StateSpace::fp_type;
+
+  static constexpr auto kStateType = StateSpace::kStateType;
+  static constexpr auto kMatrixType = StateSpace::kMatrixType;
+  static constexpr auto kExpectType = StateSpace::kExpectType;
+  static constexpr auto kComputeType = StateSpace::kComputeType;
+  static constexpr auto kMatrixLayout = StateSpace::kMatrixLayout;
+
+  explicit SimulatorCuStateVec(const custatevecHandle_t& handle)
+      : handle_(handle), workspace_(nullptr), workspace_size_(0) {}
+
+  ~SimulatorCuStateVec() {
+    ErrorCheck(cudaFree(workspace_));
+  }
+
+  /**
+   * Applies a gate using the NVIDIA cuStateVec library.
+   * @param qs Indices of the qubits affected by this gate.
+   * @param matrix Matrix representation of the gate to be applied.
+   * @param state The state of the system, to be updated by this method.
+   */
+  void ApplyGate(const std::vector<unsigned>& qs,
+                 const fp_type* matrix, State& state) const {
+    auto workspace_size = ApplyGateWorkSpaceSize(
+        state.num_qubits(), qs.size(), 0, matrix);
+    AllocWorkSpace(workspace_size);
+
+    ErrorCheck(custatevecApplyMatrix(
+                   handle_, state.get(), kStateType, state.num_qubits(),
+                   matrix, kMatrixType, kMatrixLayout, 0,
+                   (int32_t*) qs.data(), qs.size(), nullptr, 0, nullptr,
+                   kComputeType, workspace_, workspace_size));
+  }
+
+  /**
+   * Applies a controlled gate using the NVIDIA cuStateVec library.
+   * @param qs Indices of the qubits affected by this gate.
+   * @param cqs Indices of control qubits.
+   * @param cmask Bit mask of control qubit values.
+   * @param matrix Matrix representation of the gate to be applied.
+   * @param state The state of the system, to be updated by this method.
+   */
+  void ApplyControlledGate(const std::vector<unsigned>& qs,
+                           const std::vector<unsigned>& cqs, uint64_t cmask,
+                           const fp_type* matrix, State& state) const {
+    std::vector<int32_t> control_bits;
+    control_bits.reserve(cqs.size());
+
+    for (std::size_t i = 0; i < cqs.size(); ++i) {
+      control_bits.push_back((cmask >> i) & 1);
+    }
+
+    auto workspace_size = ApplyGateWorkSpaceSize(
+        state.num_qubits(), qs.size(), cqs.size(), matrix);
+    AllocWorkSpace(workspace_size);
+
+    ErrorCheck(custatevecApplyMatrix(
+                   handle_, state.get(), kStateType, state.num_qubits(),
+                   matrix, kMatrixType, kMatrixLayout, 0,
+                   (int32_t*) qs.data(), qs.size(),
+                   (int32_t*) cqs.data(), cqs.size(), control_bits.data(),
+                   kComputeType, workspace_, workspace_size));
+  }
+
+  /**
+   * Computes the expectation value of an operator using the NVIDIA cuStateVec
+   * library.
+   * @param qs Indices of the qubits the operator acts on.
+   * @param matrix The operator matrix.
+   * @param state The state of the system.
+   * @return The computed expectation value.
+   */
+  std::complex<double> ExpectationValue(const std::vector<unsigned>& qs,
+                                        const fp_type* matrix,
+                                        const State& state) const {
+    auto workspace_size = ExpectationValueWorkSpaceSize(
+        state.num_qubits(), qs.size(), matrix);
+    AllocWorkSpace(workspace_size);
+
+    cuDoubleComplex eval;
+
+    ErrorCheck(custatevecExpectation(
+                   handle_, state.get(), kStateType, state.num_qubits(),
+                   &eval, kExpectType, nullptr, matrix, kMatrixType,
+                   kMatrixLayout, (int32_t*) qs.data(), qs.size(),
+                   kComputeType, workspace_, workspace_size));
+
+    return {cuCreal(eval), cuCimag(eval)};
+  }
+
+  /**
+   * @return The size of SIMD register if applicable.
+   */
+  static unsigned SIMDRegisterSize() {
+    return 32;
+  }
+
+ private:
+  size_t ApplyGateWorkSpaceSize(
+      unsigned num_qubits, unsigned num_targets, unsigned num_controls,
+      const fp_type* matrix) const {
+    size_t size;
+
+    ErrorCheck(custatevecApplyMatrix_bufferSize(
+                   handle_, kStateType, num_qubits, matrix, kMatrixType,
+                   kMatrixLayout, 0, num_targets, num_controls, kComputeType,
+                   &size));
+
+    return size;
+  }
+
+  size_t ExpectationValueWorkSpaceSize(
+      unsigned num_qubits, unsigned num_targets, const fp_type* matrix) const {
+    size_t size;
+
+    ErrorCheck(custatevecExpectation_bufferSize(
+                   handle_, kStateType, num_qubits, matrix, kMatrixType,
+                   kMatrixLayout, num_targets, kComputeType, &size));
+
+    return size;
+  }
+
+  void* AllocWorkSpace(size_t size) const {
+    if (size > workspace_size_) {
+      if (workspace_ != nullptr) {
+        ErrorCheck(cudaFree(workspace_));
+      }
+
+      ErrorCheck(cudaMalloc(const_cast<void**>(&workspace_), size));
+
+      const_cast<uint64_t&>(workspace_size_) = size;
+    }
+
+    return workspace_;
+  }
+
+  const custatevecHandle_t handle_;
+
+  void* workspace_;
+  size_t workspace_size_;
+};
+
+}  // namespace qsim
+
+#endif  // SIMULATOR_CUSTATEVEC_H_
diff --git a/lib/statespace_custatevec.h b/lib/statespace_custatevec.h
new file mode 100644
index 00000000..dd2b4599
--- /dev/null
+++ b/lib/statespace_custatevec.h
@@ -0,0 +1,378 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef STATESPACE_CUSTATEVEC_H_
+#define STATESPACE_CUSTATEVEC_H_
+
+#include <cmath>
+#include <complex>
+#include <cstdint>
+#include <type_traits>
+#include <vector>
+
+#include <cublas_v2.h>
+#include <cuComplex.h>
+#include <custatevec.h>
+
+#include "statespace.h"
+#include "util_custatevec.h"
+#include "vectorspace_cuda.h"
+
+namespace qsim {
+
+namespace detail {
+
+template <typename FP>
+__global__ void SetStateUniformKernel(FP v, uint64_t size, FP* state) {
+  uint64_t k = uint64_t{blockIdx.x} * blockDim.x + threadIdx.x;
+
+  if (k < size) {
+    state[2 * k] = v;
+    state[2 * k + 1] = 0;
+  }
+}
+
+}  // namespace detail
+
+/**
+ * Object containing context and routines for cuStateVec state-vector
+ * manipulations. It is not recommended to use `GetAmpl` and `SetAmpl`.
+ */
+template <typename FP = float>
+class StateSpaceCuStateVec :
+    public StateSpace<StateSpaceCuStateVec<FP>, VectorSpaceCUDA, FP> {
+ private:
+  using Base = StateSpace<StateSpaceCuStateVec<FP>, qsim::VectorSpaceCUDA, FP>;
+
+ public:
+  using State = typename Base::State;
+  using fp_type = typename Base::fp_type;
+
+ private:
+  static constexpr auto is_float = std::is_same<fp_type, float>::value;
+
+ public:
+  static constexpr auto kStateType = is_float ? CUDA_C_32F : CUDA_C_64F;
+  static constexpr auto kMatrixType = kStateType;
+  static constexpr auto kExpectType = CUDA_C_64F;
+  static constexpr auto kComputeType =
+      is_float ? CUSTATEVEC_COMPUTE_32F : CUSTATEVEC_COMPUTE_64F;
+  static constexpr auto kMatrixLayout = CUSTATEVEC_MATRIX_LAYOUT_ROW;
+
+  explicit StateSpaceCuStateVec(const cublasHandle_t& cublas_handle,
+                                const custatevecHandle_t& custatevec_handle)
+      : cublas_handle_(cublas_handle), custatevec_handle_(custatevec_handle),
+        workspace_(nullptr), workspace_size_(0) {}
+
+  virtual ~StateSpaceCuStateVec() {
+    if (workspace_ != nullptr) {
+      ErrorCheck(cudaFree(workspace_));
+    }
+  }
+
+  static uint64_t MinSize(unsigned num_qubits) {
+    return 2 * (uint64_t{1} << num_qubits);
+  };
+
+  void InternalToNormalOrder(State& state) const {
+  }
+
+  void NormalToInternalOrder(State& state) const {
+  }
+
+  void SetAllZeros(State& state) const {
+    ErrorCheck(cudaMemset(state.get(), 0,
+                          MinSize(state.num_qubits()) * sizeof(fp_type)));
+  }
+
+  // Uniform superposition.
+  void SetStateUniform(State& state) const {
+    uint64_t size = uint64_t{1} << state.num_qubits();
+
+    unsigned threads = size < 256 ? size : 256;
+    unsigned blocks = size / threads;
+
+    fp_type v = double{1} / std::sqrt(size);
+
+    detail::SetStateUniformKernel<<<blocks, threads>>>(v, size, state.get());
+    ErrorCheck(cudaPeekAtLastError());
+  }
+
+  // |0> state.
+  void SetStateZero(State& state) const {
+    SetAllZeros(state);
+    fp_type one[1] = {1};
+    ErrorCheck(
+        cudaMemcpy(state.get(), one, sizeof(fp_type), cudaMemcpyHostToDevice));
+  }
+
+  // It is not recommended to use this function.
+  static std::complex<fp_type> GetAmpl(const State& state, uint64_t i) {
+    fp_type a[2];
+    auto p = state.get() + 2 * i;
+    ErrorCheck(cudaMemcpy(a, p, 2 * sizeof(fp_type), cudaMemcpyDeviceToHost));
+    return std::complex<fp_type>(a[0], a[1]);
+  }
+
+  // It is not recommended to use this function.
+  static void SetAmpl(
+      State& state, uint64_t i, const std::complex<fp_type>& ampl) {
+    fp_type a[2] = {std::real(ampl), std::imag(ampl)};
+    auto p = state.get() + 2 * i;
+    ErrorCheck(cudaMemcpy(p, a, 2 * sizeof(fp_type), cudaMemcpyHostToDevice));
+  }
+
+  // It is not recommended to use this function.
+  static void SetAmpl(State& state, uint64_t i, fp_type re, fp_type im) {
+    fp_type a[2] = {re, im};
+    auto p = state.get() + 2 * i;
+    ErrorCheck(cudaMemcpy(p, a, 2 * sizeof(fp_type), cudaMemcpyHostToDevice));
+  }
+
+  // Sets state[i] = complex(re, im) where (i & mask) == bits.
+  // if `exclude` is true then the criteria becomes (i & mask) != bits.
+  void BulkSetAmpl(State& state, uint64_t mask, uint64_t bits,
+                   const std::complex<fp_type>& val,
+                   bool exclude = false) const {
+    // Not implemented.
+  }
+
+  // Sets state[i] = complex(re, im) where (i & mask) == bits.
+  // if `exclude` is true then the criteria becomes (i & mask) != bits.
+  void BulkSetAmpl(State& state, uint64_t mask, uint64_t bits, fp_type re,
+                   fp_type im, bool exclude = false) const {
+    // Not implemented.
+  }
+
+  // Does the equivalent of dest += src elementwise.
+  bool Add(const State& src, State& dest) const {
+    if (src.num_qubits() != dest.num_qubits()) {
+      return false;
+    }
+
+    uint64_t size = uint64_t{1} << src.num_qubits();
+
+    if (is_float) {
+      cuComplex a = {1.0, 0.0};
+      auto p1 = (const cuComplex*) src.get();
+      auto p2 = (cuComplex*) dest.get();
+      ErrorCheck(cublasCaxpy(cublas_handle_, size, &a, p1, 1, p2, 1));
+    } else {
+      cuDoubleComplex a = {1.0, 0.0};
+      auto p1 = (const cuDoubleComplex*) src.get();
+      auto p2 = (cuDoubleComplex*) dest.get();
+      ErrorCheck(cublasZaxpy(cublas_handle_, size, &a, p1, 1, p2, 1));
+    }
+
+    return true;
+  }
+
+  // Does the equivalent of state *= a elementwise.
+  void Multiply(fp_type a, State& state) const {
+    uint64_t size = uint64_t{1} << state.num_qubits();
+
+    if (is_float) {
+      float a1 = a;
+      auto p = (cuComplex*) state.get();
+      ErrorCheck(cublasCsscal(cublas_handle_, size, &a1, p, 1));
+    } else {
+      double a1 = a;
+      auto p = (cuDoubleComplex*) state.get();
+      ErrorCheck(cublasZdscal(cublas_handle_, size, &a1, p, 1));
+    }
+  }
+
+  std::complex<double> InnerProduct(
+      const State& state1, const State& state2) const {
+    if (state1.num_qubits() != state2.num_qubits()) {
+      return std::nan("");
+    }
+
+    uint64_t size = uint64_t{1} << state1.num_qubits();
+
+    if (is_float) {
+      cuComplex result;
+      auto p1 = (const cuComplex*) state1.get();
+      auto p2 = (const cuComplex*) state2.get();
+      ErrorCheck(cublasCdotc(cublas_handle_, size, p1, 1, p2, 1, &result));
+      return {cuCrealf(result), cuCimagf(result)};
+    } else {
+      cuDoubleComplex result;
+      auto p1 = (const cuDoubleComplex*) state1.get();
+      auto p2 = (const cuDoubleComplex*) state2.get();
+      ErrorCheck(cublasZdotc(cublas_handle_, size, p1, 1, p2, 1, &result));
+      return {cuCreal(result), cuCimag(result)};
+    }
+  }
+
+  double RealInnerProduct(const State& state1, const State& state2) const {
+    return std::real(InnerProduct(state1, state2));
+  }
+
+  double Norm(const State& state) const {
+    uint64_t size = uint64_t{1} << state.num_qubits();
+
+    if (is_float) {
+      float result;
+      auto p = (const cuComplex*) state.get();
+      ErrorCheck(cublasScnrm2(cublas_handle_, size, p, 1, &result));
+      return result * result;
+    } else {
+      double result;
+      auto p = (const cuDoubleComplex*) state.get();
+      ErrorCheck(cublasDznrm2(cublas_handle_, size, p, 1, &result));
+      return result * result;
+    }
+  }
+
+  template <typename DistrRealType = double>
+  std::vector<uint64_t> Sample(
+      const State& state, uint64_t num_samples, unsigned seed) const {
+    std::vector<uint64_t> bitstrings;
+
+    if (num_samples > 0) {
+      auto rs = GenerateRandomValues<double>(num_samples, seed, 1.0);
+
+      size_t workspace_size;
+      custatevecSamplerDescriptor_t sampler;
+
+      ErrorCheck(custatevecSampler_create(
+                     custatevec_handle_, state.get(), kStateType,
+                     state.num_qubits(), &sampler, num_samples,
+                     &workspace_size));
+
+      AllocWorkSpace(workspace_size);
+
+      ErrorCheck(custatevecSampler_preprocess(
+                     custatevec_handle_, &sampler, workspace_, workspace_size));
+
+      std::vector<custatevecIndex_t> bitstrings0(num_samples);
+      std::vector<int32_t> bitordering;
+
+      bitordering.reserve(state.num_qubits());
+      for (unsigned i = 0; i < state.num_qubits(); ++i) {
+        bitordering.push_back(i);
+      }
+
+      ErrorCheck(custatevecSampler_sample(
+                     custatevec_handle_, &sampler, bitstrings0.data(),
+                     bitordering.data(), state.num_qubits(), rs.data(),
+                     num_samples, CUSTATEVEC_SAMPLER_OUTPUT_RANDNUM_ORDER));
+
+      bitstrings.reserve(num_samples);
+      for (unsigned i = 0; i < num_samples; ++i) {
+        bitstrings.push_back(bitstrings0[i]);
+      }
+    }
+
+    return bitstrings;
+  }
+
+  using MeasurementResult = typename Base::MeasurementResult;
+
+  template <typename RGen>
+  MeasurementResult Measure(const std::vector<unsigned>& qubits,
+                            RGen& rgen, State& state,
+                            bool no_collapse = false) const {
+    auto r = RandomValue(rgen, 1.0);
+
+    MeasurementResult result;
+
+    result.valid = true;
+    result.mask = 0;
+    result.bits = 0;
+    result.bitstring.resize(qubits.size(), 0);
+
+    for (auto q : qubits) {
+      if (q >= state.num_qubits()) {
+        result.valid = false;
+        return result;
+      }
+
+      result.mask |= uint64_t{1} << q;
+    }
+
+    auto collapse = no_collapse ?
+        CUSTATEVEC_COLLAPSE_NONE : CUSTATEVEC_COLLAPSE_NORMALIZE_AND_ZERO;
+
+    ErrorCheck(custatevecBatchMeasure(
+                   custatevec_handle_, state.get(), kStateType,
+                   state.num_qubits(), (int*) result.bitstring.data(),
+                   (int*) qubits.data(), qubits.size(), r, collapse));
+
+    for (std::size_t i = 0; i < result.bitstring.size(); ++i) {
+      result.bits |= result.bitstring[i] << qubits[i];
+    }
+
+    return result;
+  }
+
+  template <typename RGen>
+  MeasurementResult VirtualMeasure(const std::vector<unsigned>& qubits,
+                                   RGen& rgen, const State& state) const {
+    return Measure(qubits, rgen, const_cast<State&>(state), true);
+  }
+
+  void Collapse(const MeasurementResult& mr, State& state) const {
+    unsigned count = 0;
+
+    std::vector<int> bitstring;
+    std::vector<int> bitordering;
+
+    bitstring.reserve(state.num_qubits());
+    bitordering.reserve(state.num_qubits());
+
+    for (unsigned i = 0; i < state.num_qubits(); ++i) {
+      if (((mr.mask >> i) & 1) != 0) {
+        bitstring.push_back((mr.bits >> i) & 1);
+        bitordering.push_back(i);
+        ++count;
+      }
+    }
+
+    ErrorCheck(custatevecCollapseByBitString(
+                   custatevec_handle_, state.get(), kStateType,
+                   state.num_qubits(), bitstring.data(), bitordering.data(),
+                   count, 1.0));
+
+    // TODO: do we need the following?
+    double norm = Norm(state);
+    Multiply(1.0 / std::sqrt(norm), state);
+  }
+
+ private:
+  void* AllocWorkSpace(size_t size) const {
+    if (size > workspace_size_) {
+      if (workspace_ != nullptr) {
+        ErrorCheck(cudaFree(workspace_));
+      }
+
+      ErrorCheck(cudaMalloc(const_cast<void**>(&workspace_), size));
+
+      const_cast<uint64_t&>(workspace_size_) = size;
+    }
+
+    return workspace_;
+  }
+
+  const cublasHandle_t cublas_handle_;
+  const custatevecHandle_t custatevec_handle_;
+
+  void* workspace_;
+  size_t workspace_size_;
+};
+
+}  // namespace qsim
+
+#endif  // STATESPACE_CUSTATEVEC_H_
diff --git a/lib/util_custatevec.h b/lib/util_custatevec.h
new file mode 100644
index 00000000..36f29efa
--- /dev/null
+++ b/lib/util_custatevec.h
@@ -0,0 +1,44 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef UTIL_CUSTATEVEC_H_
+#define UTIL_CUSTATEVEC_H_
+
+#include <cublas_v2.h>
+#include <custatevec.h>
+
+#include "io.h"
+#include "util_cuda.h"
+
+namespace qsim {
+
+inline void ErrorAssert(cublasStatus_t code, const char* file, unsigned line) {
+  if (code != CUBLAS_STATUS_SUCCESS) {
+    IO::errorf("cuBLAS error %i: %s %d\n", code, file, line);
+    exit(code);
+  }
+}
+
+inline void ErrorAssert(
+    custatevecStatus_t code, const char* file, unsigned line) {
+  if (code != CUSTATEVEC_STATUS_SUCCESS) {
+    IO::errorf("custatevec error: %s %s %d\n",
+                custatevecGetErrorString(code), file, line);
+    exit(code);
+  }
+}
+
+}  // namespace qsim
+
+#endif  // UTIL_CUSTATEVEC_H_
diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index daebea5e..c8944562 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -4,9 +4,9 @@ QSIMLIB_SSE = ../qsimcirq/qsim_sse`python3-config --extension-suffix`
 QSIMLIB_AVX2 = ../qsimcirq/qsim_avx2`python3-config --extension-suffix`
 QSIMLIB_AVX512 = ../qsimcirq/qsim_avx512`python3-config --extension-suffix`
 QSIMLIB_CUDA = ../qsimcirq/qsim_cuda`python3-config --extension-suffix`
+QSIMLIB_CUSTATEVEC = ../qsimcirq/qsim_custatevec`python3-config --extension-suffix`
 QSIMLIB_DECIDE = ../qsimcirq/qsim_decide`python3-config --extension-suffix`
 
-
 # The flags for the compilation of the simd-specific Pybind11 interfaces
 PYBINDFLAGS_BASIC = -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_SSE = -msse4.1 -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
@@ -16,11 +16,19 @@ PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind
 # The flags for the compilation of GPU-specific Pybind11 interfaces
 PYBINDFLAGS_CUDA = -std=c++14 -x cu -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
 
+# The flags for the compilation of cuStateVec-specific Pybind11 interfaces
+PYBINDFLAGS_CUSTATEVEC = $(CUSTATEVECFLAGS) $(PYBINDFLAGS_CUDA)
+
 # Check for nvcc to decide compilation mode.
 ifeq ($(shell which $(NVCC)),)
 pybind: pybind-cpu decide-cpu
 else
+# Check for the cuStateVec library.
+ifeq ($(CUQUANTUM_ROOT),)
 pybind: pybind-cpu pybind-gpu decide-gpu
+else
+pybind: pybind-cpu pybind-gpu pybind-custatevec decide-custatevec
+endif
 endif
 
 .PHONY: pybind-cpu
@@ -42,6 +50,14 @@ pybind-gpu:
 decide-gpu:
 	$(NVCC) decide/decide.cpp -o $(QSIMLIB_DECIDE) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA)
 
+.PHONY: pybind-custatevec
+pybind-custatevec:
+	$(NVCC) custatevec/pybind_main_custatevec.cpp -o $(QSIMLIB_CUSTATEVEC) $(NVCCFLAGS) $(PYBINDFLAGS_CUSTATEVEC)
+
+.PHONY: decide-custatevec
+decide-custatevec:
+	$(NVCC) decide/decide.cpp -D__CUSTATEVEC__ -o $(QSIMLIB_DECIDE) $(NVCCFLAGS) $(PYBINDFLAGS_CUDA)
+
 .PHONY: clean
 clean:
 	-rm -f ./basic/*.x ./basic/*.a ./basic/*.so ./basic/*.mod $(QSIMLIB_BASIC)
@@ -49,4 +65,5 @@ clean:
 	-rm -f ./avx2/*.x ./avx2/*.a ./avx2/*.so ./avx2/*.mod $(QSIMLIB_AVX2)
 	-rm -f ./avx512/*.x ./avx512/*.a ./avx512/*.so ./avx512/*.mod $(QSIMLIB_AVX512)
 	-rm -f ./cuda/*.x ./cuda/*.a ./cuda/*.so ./cuda/*.mod $(QSIMLIB_CUDA)
+	-rm -f ./custatevec/*.x ./custatevec/*.a ./custatevec/*.so ./custatevec/*.mod $(QSIMLIB_CUSTATEVEC)
 	-rm -f ./decide/*.x ./decide/*.a ./decide/*.so ./decide/*.mod $(QSIMLIB_DECIDE)
diff --git a/pybind_interface/cuda/pybind_main_cuda.cpp b/pybind_interface/cuda/pybind_main_cuda.cpp
index 825082f5..391cb976 100644
--- a/pybind_interface/cuda/pybind_main_cuda.cpp
+++ b/pybind_interface/cuda/pybind_main_cuda.cpp
@@ -38,8 +38,8 @@ namespace qsim {
       return Simulator(sim_params);
     }
 
-    const StateSpace::Parameter ss_params;
-    const Simulator::Parameter sim_params;
+    StateSpace::Parameter ss_params;
+    Simulator::Parameter sim_params;
   };
 }
 
diff --git a/pybind_interface/custatevec/CMakeLists.txt b/pybind_interface/custatevec/CMakeLists.txt
new file mode 100644
index 00000000..4ea57380
--- /dev/null
+++ b/pybind_interface/custatevec/CMakeLists.txt
@@ -0,0 +1,58 @@
+# Copyright 2019 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+cmake_minimum_required(VERSION 3.11)
+project(qsim LANGUAGES CXX CUDA)
+
+IF (WIN32)
+    set(CMAKE_CXX_FLAGS "/O2 /openmp")
+ELSE()
+    set(CMAKE_CXX_FLAGS "-O3 -fopenmp")
+ENDIF()
+
+if(APPLE)
+    set(CMAKE_CXX_STANDARD 14)
+    include_directories("/usr/local/include" "/usr/local/opt/llvm/include")
+    link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
+endif()
+
+include(FetchContent)
+
+FetchContent_Declare(
+  pybind11
+  GIT_REPOSITORY https://github.com/pybind/pybind11
+  GIT_TAG v2.2.4
+)
+FetchContent_GetProperties(pybind11)
+if(NOT pybind11_POPULATED)
+  FetchContent_Populate(pybind11)
+  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
+endif()
+
+find_package(PythonLibs 3.6 REQUIRED)
+find_package(CUDA REQUIRED)
+
+include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
+
+include_directories($ENV{CUQUANTUM_ROOT}/include)
+link_directories($ENV{CUQUANTUM_ROOT}/lib64)
+
+cuda_add_library(qsim_custatevec MODULE pybind_main_custatevec.cpp)
+target_link_libraries(qsim_custatevec -lcustatevec -lcublas)
+
+set_target_properties(qsim_custatevec PROPERTIES
+       PREFIX "${PYTHON_MODULE_PREFIX}"
+       SUFFIX "${PYTHON_MODULE_EXTENSION}"
+)
+set_source_files_properties(pybind_main_custatevec.cpp PROPERTIES LANGUAGE CUDA)
diff --git a/pybind_interface/custatevec/pybind_main_custatevec.cpp b/pybind_interface/custatevec/pybind_main_custatevec.cpp
new file mode 100644
index 00000000..109cedae
--- /dev/null
+++ b/pybind_interface/custatevec/pybind_main_custatevec.cpp
@@ -0,0 +1,58 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include <cublas_v2.h>
+#include <custatevec.h>
+
+#include "pybind_main_custatevec.h"
+
+#include "../../lib/simulator_custatevec.h"
+
+namespace qsim {
+
+using Simulator = SimulatorCuStateVec<float>;
+
+struct Factory {
+  using Simulator = qsim::Simulator;
+  using StateSpace = Simulator::StateSpace;
+
+  // num_sim_threads, num_state_threads and num_dblocks are unused, but kept
+  // for consistency with other factories.
+  Factory(unsigned num_sim_threads,
+          unsigned num_state_threads,
+          unsigned num_dblocks) {
+    ErrorCheck(cublasCreate(&cublas_handle));
+    ErrorCheck(custatevecCreate(&custatevec_handle));
+  }
+
+  ~Factory() {
+    ErrorCheck(cublasDestroy(cublas_handle));
+    ErrorCheck(custatevecDestroy(custatevec_handle));
+  }
+
+  StateSpace CreateStateSpace() const {
+    return StateSpace(cublas_handle, custatevec_handle);
+  }
+
+  Simulator CreateSimulator() const {
+    return Simulator(custatevec_handle);
+  }
+
+  cublasHandle_t cublas_handle;
+  custatevecHandle_t custatevec_handle;
+};
+
+}
+
+#include "../pybind_main.cpp"
diff --git a/pybind_interface/custatevec/pybind_main_custatevec.h b/pybind_interface/custatevec/pybind_main_custatevec.h
new file mode 100644
index 00000000..b6722bf4
--- /dev/null
+++ b/pybind_interface/custatevec/pybind_main_custatevec.h
@@ -0,0 +1,17 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include "../pybind_main.h"
+
+PYBIND11_MODULE(qsim_custatevec, m) { GPU_MODULE_BINDINGS }
diff --git a/pybind_interface/decide/CMakeLists.txt b/pybind_interface/decide/CMakeLists.txt
index 3e9fcbb2..99a75881 100644
--- a/pybind_interface/decide/CMakeLists.txt
+++ b/pybind_interface/decide/CMakeLists.txt
@@ -41,6 +41,13 @@ else()
   include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
 
   cuda_add_library(qsim_decide MODULE decide.cpp)
+
+  if(DEFINED ENV{CUQUANTUM_ROOT})
+      target_compile_options(qsim_decide PRIVATE
+          $<$<COMPILE_LANGUAGE:CUDA>:-D__CUSTATEVEC__>
+      )
+  endif()
+
   set_target_properties(qsim_decide PROPERTIES
         PREFIX "${PYTHON_MODULE_PREFIX}"
         SUFFIX "${PYTHON_MODULE_EXTENSION}"
diff --git a/pybind_interface/decide/decide.cpp b/pybind_interface/decide/decide.cpp
index 890f7a41..6355ad3b 100644
--- a/pybind_interface/decide/decide.cpp
+++ b/pybind_interface/decide/decide.cpp
@@ -1,3 +1,17 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 #include <pybind11/pybind11.h>
 
 namespace py = pybind11;
@@ -45,7 +59,8 @@ int detect_instructions() {
   return static_cast<int>(instr);
 }
 
-enum GPUCapabilities { CUDA = 0, NO_GPU = 10 };
+enum GPUCapabilities {
+    CUDA = 0, CUSTATEVEC = 1, NO_GPU = 10, NO_CUSTATEVEC = 11 };
 
 // For now, GPU detection is performed at compile time, as our wheels are
 // generated on Github Actions runners which do not have GPU support.
@@ -61,6 +76,20 @@ int detect_gpu() {
   return gpu;
 }
 
+// For now, cuStateVec detection is performed at compile time, as our wheels
+// are generated on Github Actions runners which do not have GPU support.
+//
+// Users wishing to use qsim with cuStateVec will need to compile locally on
+// a device which has the necessary CUDA toolkit and cuStateVec library.
+int detect_custatevec() {
+  #if defined(__NVCC__) && defined(__CUSTATEVEC__)
+  GPUCapabilities gpu = CUSTATEVEC;
+  #else
+  GPUCapabilities gpu = NO_CUSTATEVEC;
+  #endif
+  return gpu;
+}
+
 PYBIND11_MODULE(qsim_decide, m) {
   m.doc() = "pybind11 plugin";  // optional module docstring
 
@@ -69,4 +98,7 @@ PYBIND11_MODULE(qsim_decide, m) {
 
   // Detect available GPUs.
   m.def("detect_gpu", &detect_gpu, "Detect GPU");
+
+  // Detect cuStateVec.
+  m.def("detect_custatevec", &detect_custatevec, "Detect cuStateVec");
 }
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 67a74cae..428372d1 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -384,19 +384,21 @@ std::vector<std::complex<float>> qsim_simulate(const py::dict &options) {
 
   bool use_gpu;
   bool denormals_are_zeros;
-  unsigned num_sim_threads;
+  unsigned gpu_mode;
+  unsigned num_sim_threads = 0;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
   Runner::Parameter param;
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    gpu_mode = parseOptions<unsigned>(options, "gmode\0");
     denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
-    if (use_gpu) {
+    if (use_gpu == 0) {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    } else if (gpu_mode == 0) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
       num_dblocks = parseOptions<unsigned>(options, "gdb\0");
-    } else {
-      num_sim_threads = parseOptions<unsigned>(options, "t\0");
     }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
@@ -446,20 +448,22 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
   Runner::Parameter param;
   bool use_gpu;
   bool denormals_are_zeros;
-  unsigned num_sim_threads;
+  unsigned gpu_mode;
+  unsigned num_sim_threads = 0;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
   uint64_t seed;
 
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    gpu_mode = parseOptions<unsigned>(options, "gmode\0");
     denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
-    if (use_gpu) {
+    if (use_gpu == 0) {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    } else if (gpu_mode == 0) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
       num_dblocks = parseOptions<unsigned>(options, "gdb\0");
-    } else {
-      num_sim_threads = parseOptions<unsigned>(options, "t\0");
     }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
@@ -499,7 +503,7 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
 class SimulatorHelper {
  public:
   using Simulator = Factory::Simulator;
-  using StateSpace = Simulator::StateSpace;
+  using StateSpace = Factory::StateSpace;
   using State = StateSpace::State;
 
   using Gate = Cirq::GateCirq<float>;
@@ -558,7 +562,7 @@ class SimulatorHelper {
 
  private:
   SimulatorHelper(const py::dict &options, bool noisy)
-      : state_space(Factory(1, 1, 1).CreateStateSpace()),
+      : factory(Factory(1, 1, 1)),
         state(StateSpace::Null()),
         scratch(StateSpace::Null()) {
     bool denormals_are_zeros;
@@ -575,20 +579,24 @@ class SimulatorHelper {
       }
 
       use_gpu = parseOptions<unsigned>(options, "g\0");
+      gpu_mode = parseOptions<unsigned>(options, "gmode\0");
       denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
-      if (use_gpu) {
+      if (use_gpu == 0) {
+        num_sim_threads = parseOptions<unsigned>(options, "t\0");
+      } else if (gpu_mode == 0) {
         num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
         num_state_threads = parseOptions<unsigned>(options, "gsst\0");
         num_dblocks = parseOptions<unsigned>(options, "gdb\0");
-      } else {
-        num_sim_threads = parseOptions<unsigned>(options, "t\0");
       }
       max_fused_size = parseOptions<unsigned>(options, "f\0");
       verbosity = parseOptions<unsigned>(options, "v\0");
       seed = parseOptions<unsigned>(options, "s\0");
 
-      state_space = Factory(
-        num_sim_threads, num_state_threads, num_dblocks).CreateStateSpace();
+      if (use_gpu == 0 || gpu_mode == 0) {
+        factory = Factory(num_sim_threads, num_state_threads, num_dblocks);
+      }
+
+      StateSpace state_space = factory.CreateStateSpace();
       state = state_space.Create(num_qubits);
       is_valid = true;
 
@@ -604,11 +612,13 @@ class SimulatorHelper {
   }
 
   void init_state(uint64_t input_state) {
+    StateSpace state_space = factory.CreateStateSpace();
     state_space.SetAllZeros(state);
     state_space.SetAmpl(state, input_state, 1, 0);
   }
 
   void init_state(const py::array_t<float> &input_vector) {
+    StateSpace state_space = factory.CreateStateSpace();
     state_space.Copy(input_vector.data(), state);
     state_space.NormalToInternalOrder(state);
   }
@@ -633,8 +643,6 @@ class SimulatorHelper {
     init_state(input_state);
     bool result = false;
 
-    Factory factory(num_sim_threads, num_state_threads, num_dblocks);
-
     if (is_noisy) {
       std::vector<uint64_t> stat;
       auto params = get_noisy_params();
@@ -652,6 +660,7 @@ class SimulatorHelper {
   }
 
   py::array_t<float> release_state_to_python() {
+    StateSpace state_space = factory.CreateStateSpace();
     state_space.InternalToNormalOrder(state);
     uint64_t fsv_size = 2 * (uint64_t{1} << num_qubits);
     if (state.requires_copy_to_host()) {
@@ -672,8 +681,8 @@ class SimulatorHelper {
   std::vector<std::complex<double>> get_expectation_value(
       const std::vector<std::tuple<std::vector<OpString<Gate>>,
                                    unsigned>>& opsums_and_qubit_counts) {
-    Simulator simulator = Factory(
-      num_sim_threads, num_state_threads, num_dblocks).CreateSimulator();
+    Simulator simulator = factory.CreateSimulator();
+    StateSpace state_space = factory.CreateStateSpace();
     using Fuser = MultiQubitGateFuser<IO, Gate>;
 
     std::vector<std::complex<double>> results;
@@ -697,11 +706,12 @@ class SimulatorHelper {
   Circuit<Gate> circuit;
   NoisyCircuit<Gate> ncircuit;
 
-  StateSpace state_space;
+  Factory factory;
   State state;
   State scratch;
 
   bool use_gpu;
+  unsigned gpu_mode;
   unsigned num_qubits;
   unsigned num_sim_threads;
   unsigned num_state_threads;
@@ -799,19 +809,21 @@ std::vector<unsigned> qsim_sample(const py::dict &options) {
 
   bool use_gpu;
   bool denormals_are_zeros;
-  unsigned num_sim_threads;
+  unsigned gpu_mode;
+  unsigned num_sim_threads = 0;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
   Runner::Parameter param;
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    gpu_mode = parseOptions<unsigned>(options, "gmode\0");
     denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
-    if (use_gpu) {
+    if (use_gpu == 0) {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    } else if (gpu_mode == 0) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
       num_dblocks = parseOptions<unsigned>(options, "gdb\0");
-    } else {
-      num_sim_threads = parseOptions<unsigned>(options, "t\0");
     }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
@@ -865,20 +877,22 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
   Runner::Parameter param;
   bool use_gpu;
   bool denormals_are_zeros;
-  unsigned num_sim_threads;
+  unsigned gpu_mode;
+  unsigned num_sim_threads = 0;
   unsigned num_state_threads = 0;
   unsigned num_dblocks = 0;
   uint64_t seed;
 
   try {
     use_gpu = parseOptions<unsigned>(options, "g\0");
+    gpu_mode = parseOptions<unsigned>(options, "gmode\0");
     denormals_are_zeros = parseOptions<unsigned>(options, "z\0");
-    if (use_gpu) {
+    if (use_gpu == 0) {
+      num_sim_threads = parseOptions<unsigned>(options, "t\0");
+    } else if (gpu_mode == 0) {
       num_sim_threads = parseOptions<unsigned>(options, "gsmt\0");
       num_state_threads = parseOptions<unsigned>(options, "gsst\0");
       num_dblocks = parseOptions<unsigned>(options, "gdb\0");
-    } else {
-      num_sim_threads = parseOptions<unsigned>(options, "t\0");
     }
     param.max_fused_size = parseOptions<unsigned>(options, "f\0");
     param.verbosity = parseOptions<unsigned>(options, "v\0");
diff --git a/qsimcirq/__init__.py b/qsimcirq/__init__.py
index f1542018..8b7db6ba 100644
--- a/qsimcirq/__init__.py
+++ b/qsimcirq/__init__.py
@@ -1,3 +1,18 @@
+# Copyright 2019 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
 import importlib
 from qsimcirq import qsim_decide
 
@@ -23,9 +38,17 @@ def _load_qsim_gpu():
         qsim_gpu = None
     return qsim_gpu
 
+def _load_qsim_custatevec():
+    instr = qsim_decide.detect_custatevec()
+    if instr == 1:
+        qsim_custatevec = importlib.import_module("qsimcirq.qsim_custatevec")
+    else:
+        qsim_custatevec = None
+    return qsim_custatevec
 
 qsim = _load_simd_qsim()
 qsim_gpu = _load_qsim_gpu()
+qsim_custatevec = _load_qsim_custatevec()
 
 from .qsim_circuit import add_op_to_opstring, add_op_to_circuit, QSimCircuit
 from .qsim_simulator import (
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 39796b92..d24eda47 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -34,7 +34,7 @@
 
 import numpy as np
 
-from . import qsim, qsim_gpu
+from . import qsim, qsim_gpu, qsim_custatevec
 import qsimcirq.qsim_circuit as qsimc
 
 
@@ -136,6 +136,9 @@ class QSimOptions:
             simulation modes.
         use_gpu: whether to use GPU instead of CPU for simulation. The "gpu_*"
             arguments below are only considered if this is set to True.
+        gpu_mode: use CUDA if set to 0 (default value) or use the NVIDIA
+            cuStateVec library if set to any other value. The "gpu_*"
+            arguments below are only considered if this is set to 0.
         gpu_sim_threads: number of threads per CUDA block to use for the GPU
             Simulator. This must be a power of 2 in the range [32, 256].
         gpu_state_threads: number of threads per CUDA block to use for the GPU
@@ -152,6 +155,7 @@ class QSimOptions:
     cpu_threads: int = 1
     ev_noisy_repetitions: int = 1
     use_gpu: bool = False
+    gpu_mode: int = 0
     gpu_sim_threads: int = 256
     gpu_state_threads: int = 512
     gpu_data_blocks: int = 16
@@ -168,6 +172,7 @@ def as_dict(self):
             "t": self.cpu_threads,
             "r": self.ev_noisy_repetitions,
             "g": self.use_gpu,
+            "gmode": self.gpu_mode,
             "gsmt": self.gpu_sim_threads,
             "gsst": self.gpu_state_threads,
             "gdb": self.gpu_data_blocks,
@@ -220,13 +225,31 @@ def __init__(
         self._prng = value.parse_random_state(seed)
         self.qsim_options = QSimOptions().as_dict()
         self.qsim_options.update(qsim_options)
+
         # module to use for simulation
-        if self.qsim_options["g"] and qsim_gpu is None:
-            raise ValueError(
-                "GPU execution requested, but not supported. If your device "
-                "has GPU support, you may need to compile qsim locally."
-            )
-        self._sim_module = qsim_gpu if self.qsim_options["g"] else qsim
+        if self.qsim_options["g"]:
+            if self.qsim_options["gmode"] == 0:
+                if qsim_gpu is None:
+                    raise ValueError(
+                        "GPU execution requested, but not supported. If your "
+                        "device has GPU support, you may need to compile qsim "
+                        "locally."
+                    )
+                else:
+                    self._sim_module = qsim_gpu
+            else:
+                if qsim_custatevec is None:
+                    raise ValueError(
+                        "cuStateVec GPU execution requested, but not "
+                        "supported. If your device has GPU support and the "
+                        "NVIDIA cuStateVec library is installed, you may need "
+                        "to compile qsim locally."
+                    )
+                else:
+                    self._sim_module = qsim_custatevec
+        else:
+            self._sim_module = qsim
+
         # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
         self._translated_circuits = deque(maxlen=circuit_memoization_size)
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index aa63846e..77e0597f 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -1162,6 +1162,89 @@ def test_cirq_qsim_gpu_input_state():
     )
 
 
+def test_cirq_qsim_custatevec_amplitudes():
+    if qsimcirq.qsim_custatevec is None:
+        pytest.skip("cuStateVec library is not available for testing.")
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.CNOT(a, b), cirq.CNOT(b, a), cirq.X(a))
+
+    # Enable GPU acceleration.
+    custatevec_options = qsimcirq.QSimOptions(gpu_mode=1)
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=custatevec_options)
+    result = qsimGpuSim.compute_amplitudes(
+        cirq_circuit, bitstrings=[0b00, 0b01, 0b10, 0b11]
+    )
+    assert np.allclose(result, [0j, 0j, (1 + 0j), 0j])
+
+
+def test_cirq_qsim_custatevec_simulate():
+    if qsimcirq.qsim_custatevec is None:
+        pytest.skip("cuStateVec library is not available for testing.")
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
+
+    # Enable GPU acceleration.
+    custatevec_options = qsimcirq.QSimOptions(gpu_mode=1)
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=custatevec_options)
+    result = qsimGpuSim.simulate(cirq_circuit)
+    assert result.state_vector().shape == (4,)
+
+    cirqSim = cirq.Simulator()
+    cirq_result = cirqSim.simulate(cirq_circuit)
+    assert cirq.linalg.allclose_up_to_global_phase(
+        result.state_vector(), cirq_result.state_vector(), atol=1.0e-6
+    )
+
+
+def test_cirq_qsim_custatevec_expectation_values():
+    if qsimcirq.qsim_custatevec is None:
+        pytest.skip("cuStateVec library is not available for testing.")
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
+    obs = [cirq.Z(a) * cirq.Z(b)]
+
+    # Enable GPU acceleration.
+    custatevec_options = qsimcirq.QSimOptions(gpu_mode=1)
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=custatevec_options)
+    result = qsimGpuSim.simulate_expectation_values(cirq_circuit, obs)
+
+    cirqSim = cirq.Simulator()
+    cirq_result = cirqSim.simulate_expectation_values(cirq_circuit, obs)
+    assert np.allclose(result, cirq_result)
+
+
+def test_cirq_qsim_custatevec_input_state():
+    if qsimcirq.qsim_custatevec is None:
+        pytest.skip("cuStateVec library is not available for testing.")
+    # Pick qubits.
+    a, b = [cirq.GridQubit(0, 0), cirq.GridQubit(0, 1)]
+
+    # Create a circuit
+    cirq_circuit = cirq.Circuit(cirq.H(a), cirq.CNOT(a, b), cirq.X(b))
+
+    # Enable GPU acceleration.
+    custatevec_options = qsimcirq.QSimOptions(gpu_mode=1)
+    qsimGpuSim = qsimcirq.QSimSimulator(qsim_options=custatevec_options)
+    initial_state = np.asarray([0.5] * 4, dtype=np.complex64)
+    result = qsimGpuSim.simulate(cirq_circuit, initial_state=initial_state)
+    assert result.state_vector().shape == (4,)
+
+    cirqSim = cirq.Simulator()
+    cirq_result = cirqSim.simulate(cirq_circuit, initial_state=initial_state)
+    assert cirq.linalg.allclose_up_to_global_phase(
+        result.state_vector(), cirq_result.state_vector(), atol=1.0e-6
+    )
+
+
 def test_cirq_qsim_old_options():
     old_options = {"f": 3, "t": 4, "r": 100, "v": 1}
     old_sim = qsimcirq.QSimSimulator(qsim_options=old_options)
diff --git a/setup.py b/setup.py
index 30bb72d4..e1e80a70 100644
--- a/setup.py
+++ b/setup.py
@@ -108,6 +108,7 @@ def build_extension(self, ext):
         CMakeExtension("qsimcirq/qsim_sse"),
         CMakeExtension("qsimcirq/qsim_basic"),
         CMakeExtension("qsimcirq/qsim_cuda"),
+        CMakeExtension("qsimcirq/qsim_custatevec"),
         CMakeExtension("qsimcirq/qsim_decide"),
     ],
     cmdclass=dict(build_ext=CMakeBuild),
diff --git a/tests/Makefile b/tests/Makefile
index d10e887b..f4a37278 100644
--- a/tests/Makefile
+++ b/tests/Makefile
@@ -8,8 +8,11 @@ CXX_TARGETS = $(shell\
 )
 CXX_TARGETS := $(CXX_TARGETS:%.cc=%.x)
 
-CUDA_TARGETS = $(shell find . -maxdepth 1 -name "*_test.cu")
-CUDA_TARGETS := $(CUDA_TARGETS:%.cu=%.x)
+CUDA_TARGETS = $(shell find . -maxdepth 1 -name "*cuda_test.cu")
+CUDA_TARGETS := $(CUDA_TARGETS:%cuda_test.cu=%cuda_test.x)
+
+CUSTATEVEC_TARGETS = $(shell find . -maxdepth 1 -name "*custatevec_test.cu")
+CUSTATEVEC_TARGETS := $(CUSTATEVEC_TARGETS:%custatevec_test.cu=%custatevec_test.x)
 
 GTEST_DIR = $(CURDIR)/googletest/googletest
 GMOCK_DIR = $(CURDIR)/googletest/googlemock
@@ -24,6 +27,9 @@ cxx-tests: $(CXX_TARGETS)
 .PHONY: cuda-tests
 cuda-tests: $(CUDA_TARGETS)
 
+.PHONY: custatevec-tests
+custatevec-tests: $(CUSTATEVEC_TARGETS)
+
 .PHONY: run-cxx-tests
 run-cxx-tests: cxx-tests
 	for exe in $(CXX_TARGETS); do if ! ./$$exe; then exit 1; fi; done
@@ -32,6 +38,10 @@ run-cxx-tests: cxx-tests
 run-cuda-tests: cuda-tests
 	for exe in $(CUDA_TARGETS); do if ! ./$$exe; then exit 1; fi; done
 
+.PHONY: run-custatevec-tests
+run-custatevec-tests: custatevec-tests
+	for exe in $(CUSTATEVEC_TARGETS); do if ! ./$$exe; then exit 1; fi; done
+
 $(GTEST_DIR)/make:
 	-git submodule update --init --recursive googletest
 	mkdir -p $(GTEST_DIR)/make
@@ -40,9 +50,12 @@ $(GTEST_DIR)/make:
 %.x: %.cc $(GTEST_DIR)/make
 	$(CXX) -o ./$@ $< $(TESTFLAGS) $(CXXFLAGS) $(ARCHFLAGS)
 
-%.x: %.cu $(GTEST_DIR)/make
+%cuda_test.x: %cuda_test.cu $(GTEST_DIR)/make
 	$(NVCC) -o ./$@ $< $(TESTFLAGS) $(NVCCFLAGS)
 
+%custatevec_test.x: %custatevec_test.cu $(GTEST_DIR)/make
+	$(NVCC) -o ./$@ $< $(TESTFLAGS) $(NVCCFLAGS) $(CUSTATEVECFLAGS)
+
 .PHONY: clean
 clean:
 	-rm -f ./*.x ./*.a ./*.so ./*.mod
diff --git a/tests/hybrid_custatevec_test.cu b/tests/hybrid_custatevec_test.cu
new file mode 100644
index 00000000..82dbeafc
--- /dev/null
+++ b/tests/hybrid_custatevec_test.cu
@@ -0,0 +1,67 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include "hybrid_testfixture.h"
+
+#include <cublas_v2.h>
+#include <custatevec.h>
+
+#include "gtest/gtest.h"
+
+#include "../lib/simulator_custatevec.h"
+
+namespace qsim {
+
+template <typename FP>
+struct Factory {
+  using fp_type = FP;
+  using Simulator = qsim::SimulatorCuStateVec<fp_type>;
+  using StateSpace = typename Simulator::StateSpace;
+
+  Factory() {
+    ErrorCheck(cublasCreate(&cublas_handle));
+    ErrorCheck(custatevecCreate(&custatevec_handle));
+  }
+
+  ~Factory() {
+    ErrorCheck(cublasDestroy(cublas_handle));
+    ErrorCheck(custatevecDestroy(custatevec_handle));
+  }
+
+  StateSpace CreateStateSpace() const {
+    return StateSpace(cublas_handle, custatevec_handle);
+  }
+
+  Simulator CreateSimulator() const {
+    return Simulator(custatevec_handle);
+  }
+
+  cublasHandle_t cublas_handle;
+  custatevecHandle_t custatevec_handle;
+};
+
+TEST(HybridCuStateVecTest, Hybrid2) {
+  TestHybrid2(qsim::Factory<float>());
+}
+
+TEST(HybridCuStateVecTest, Hybrid4) {
+  TestHybrid4(qsim::Factory<float>());
+}
+
+}  // namespace qsim
+
+int main(int argc, char** argv) {
+  ::testing::InitGoogleTest(&argc, argv);
+  return RUN_ALL_TESTS();
+}
diff --git a/tests/make.sh b/tests/make.sh
index 37b91723..10d91b56 100755
--- a/tests/make.sh
+++ b/tests/make.sh
@@ -19,6 +19,7 @@
 
 path_to_include=googletest/googletest/include
 path_to_lib=googletest/lib
+path_to_lib=googletest/googletest/make/lib
 
 g++ -O3 -I$path_to_include -L$path_to_lib -o bitstring_test.x bitstring_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o channels_cirq_test.x channels_cirq_test.cc -lgtest -lpthread
@@ -54,3 +55,10 @@ nvcc -O3 -I$path_to_include -L$path_to_lib -o hybrid_cuda_test.x hybrid_cuda_tes
 nvcc -O3 -I$path_to_include -L$path_to_lib -o qtrajectory_cuda_test.x qtrajectory_cuda_test.cu -lgtest -lpthread
 nvcc -O3 -I$path_to_include -L$path_to_lib -o simulator_cuda_test.x simulator_cuda_test.cu -lgtest -lpthread
 nvcc -O3 -I$path_to_include -L$path_to_lib -o statespace_cuda_test.x statespace_cuda_test.cu -lgtest -lpthread
+
+# CUQUANTUM_ROOT should be set.
+CUSTATEVECFLAGS="-I${CUQUANTUM_ROOT}/include -L${CUQUANTUM_ROOT}/lib64 -lcustatevec -lcublas"
+nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o hybrid_custatevec_test.x hybrid_custatevec_test.cu -lgtest -lpthread
+nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o qtrajectory_custatevec_test.x qtrajectory_custatevec_test.cu -lgtest -lpthread
+nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o simulator_custatevec_test.x simulator_custatevec_test.cu -lgtest -lpthread
+nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o statespace_custatevec_test.x statespace_custatevec_test.cu -lgtest -lpthread
diff --git a/tests/qtrajectory_custatevec_test.cu b/tests/qtrajectory_custatevec_test.cu
new file mode 100644
index 00000000..c8a2958d
--- /dev/null
+++ b/tests/qtrajectory_custatevec_test.cu
@@ -0,0 +1,83 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include "qtrajectory_testfixture.h"
+
+#include <cublas_v2.h>
+#include <custatevec.h>
+
+#include "gtest/gtest.h"
+
+#include "../lib/simulator_custatevec.h"
+
+namespace qsim {
+
+template <typename FP>
+struct Factory {
+  using fp_type = FP;
+  using Simulator = qsim::SimulatorCuStateVec<fp_type>;
+  using StateSpace = typename Simulator::StateSpace;
+
+  Factory() {
+    ErrorCheck(cublasCreate(&cublas_handle));
+    ErrorCheck(custatevecCreate(&custatevec_handle));
+  }
+
+  ~Factory() {
+    ErrorCheck(cublasDestroy(cublas_handle));
+    ErrorCheck(custatevecDestroy(custatevec_handle));
+  }
+
+  StateSpace CreateStateSpace() const {
+    return StateSpace(cublas_handle, custatevec_handle);
+  }
+
+  Simulator CreateSimulator() const {
+    return Simulator(custatevec_handle);
+  }
+
+  cublasHandle_t cublas_handle;
+  custatevecHandle_t custatevec_handle;
+};
+
+TEST(QTrajectoryCuStateVecTest, BitFlip) {
+  TestBitFlip(qsim::Factory<float>());
+}
+
+TEST(QTrajectoryCuStateVecTest, GenDump) {
+  TestGenDump(qsim::Factory<float>());
+}
+
+TEST(QTrajectoryCuStateVecTest, CollectKopStat) {
+  TestCollectKopStat(qsim::Factory<float>());
+}
+
+TEST(QTrajectoryCuStateVecTest, CleanCircuit) {
+  TestCleanCircuit(qsim::Factory<float>());
+}
+
+TEST(QTrajectoryCuStateVecTest, InitialState) {
+  TestInitialState(qsim::Factory<float>());
+}
+
+TEST(QTrajectoryCuStateVecTest, UncomputeFinalState) {
+  TestUncomputeFinalState(qsim::Factory<float>());
+}
+
+}  // namespace qsim
+
+int main(int argc, char** argv) {
+  ::testing::InitGoogleTest(&argc, argv);
+  return RUN_ALL_TESTS();
+}
diff --git a/tests/simulator_custatevec_test.cu b/tests/simulator_custatevec_test.cu
new file mode 100644
index 00000000..646e0c07
--- /dev/null
+++ b/tests/simulator_custatevec_test.cu
@@ -0,0 +1,108 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include "simulator_testfixture.h"
+
+#include <cublas_v2.h>
+#include <custatevec.h>
+
+#include <type_traits>
+
+#include "gtest/gtest.h"
+
+#include "../lib/simulator_custatevec.h"
+
+namespace qsim {
+
+template <class T>
+class SimulatorCuStateVecTest : public testing::Test {};
+
+using fp_impl = ::testing::Types<float, double>;
+
+TYPED_TEST_SUITE(SimulatorCuStateVecTest, fp_impl);
+
+template <typename fp_type>
+struct Factory {
+  using Simulator = qsim::SimulatorCuStateVec<fp_type>;
+  using StateSpace = typename Simulator::StateSpace;
+
+  Factory() {
+    ErrorCheck(cublasCreate(&cublas_handle));
+    ErrorCheck(custatevecCreate(&custatevec_handle));
+  }
+
+  ~Factory() {
+    ErrorCheck(cublasDestroy(cublas_handle));
+    ErrorCheck(custatevecDestroy(custatevec_handle));
+  }
+
+  StateSpace CreateStateSpace() const {
+    return StateSpace(cublas_handle, custatevec_handle);
+  }
+
+  Simulator CreateSimulator() const {
+    return Simulator(custatevec_handle);
+  }
+
+  cublasHandle_t cublas_handle;
+  custatevecHandle_t custatevec_handle;
+};
+
+TYPED_TEST(SimulatorCuStateVecTest, ApplyGate1) {
+  TestApplyGate1(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, ApplyGate2) {
+  TestApplyGate2(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, ApplyGate3) {
+  TestApplyGate3(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, ApplyGate5) {
+  TestApplyGate5(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, CircuitWithControlledGates) {
+  TestCircuitWithControlledGates(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, CircuitWithControlledGatesDagger) {
+  TestCircuitWithControlledGatesDagger(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, MultiQubitGates) {
+  TestMultiQubitGates(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, ControlledGates) {
+  bool high_precision = std::is_same<TypeParam, double>::value;
+  TestControlledGates(qsim::Factory<TypeParam>(), high_precision);
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, ExpectationValue1) {
+  TestExpectationValue1(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(SimulatorCuStateVecTest, ExpectationValue2) {
+  TestExpectationValue2(qsim::Factory<TypeParam>());
+}
+
+}  // namespace qsim
+
+int main(int argc, char** argv) {
+  ::testing::InitGoogleTest(&argc, argv);
+  return RUN_ALL_TESTS();
+}
diff --git a/tests/statespace_custatevec_test.cu b/tests/statespace_custatevec_test.cu
new file mode 100644
index 00000000..833bbee0
--- /dev/null
+++ b/tests/statespace_custatevec_test.cu
@@ -0,0 +1,127 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include "statespace_testfixture.h"
+
+#include <cublas_v2.h>
+#include <custatevec.h>
+
+#include "gtest/gtest.h"
+
+#include "../lib/simulator_custatevec.h"
+#include "../lib/statespace_custatevec.h"
+
+namespace qsim {
+
+template <class T>
+class StateSpaceCuStateVecTest : public testing::Test {};
+
+using fp_impl = ::testing::Types<float, double>;
+
+TYPED_TEST_SUITE(StateSpaceCuStateVecTest, fp_impl);
+
+template <typename fp_type>
+struct Factory {
+  using Simulator = qsim::SimulatorCuStateVec<fp_type>;
+  using StateSpace = typename Simulator::StateSpace;
+
+  Factory() {
+    ErrorCheck(cublasCreate(&cublas_handle));
+    ErrorCheck(custatevecCreate(&custatevec_handle));
+  }
+
+  ~Factory() {
+    ErrorCheck(cublasDestroy(cublas_handle));
+    ErrorCheck(custatevecDestroy(custatevec_handle));
+  }
+
+  StateSpace CreateStateSpace() const {
+    return StateSpace(cublas_handle, custatevec_handle);
+  }
+
+  Simulator CreateSimulator() const {
+    return Simulator(custatevec_handle);
+  }
+
+  cublasHandle_t cublas_handle;
+  custatevecHandle_t custatevec_handle;
+};
+
+TYPED_TEST(StateSpaceCuStateVecTest, Add) {
+  TestAdd(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, NormSmall) {
+  TestNormSmall(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, NormAndInnerProductSmall) {
+  TestNormAndInnerProductSmall(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, NormAndInnerProduct) {
+  TestNormAndInnerProduct(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, SamplingSmall) {
+  TestSamplingSmall(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, SamplingCrossEntropyDifference) {
+  TestSamplingCrossEntropyDifference(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, Ordering) {
+  TestOrdering(qsim::Factory<TypeParam>());
+}
+
+TEST(StateSpaceCuStateVecTest, MeasurementSmall) {
+  TestMeasurementSmall(qsim::Factory<float>(), true);
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, MeasurementLarge) {
+//  This test fails.
+//  TestMeasurementLarge(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, Collapse) {
+//  This test fails.
+  TestCollapse(qsim::Factory<TypeParam>());
+}
+
+TEST(StateSpaceCuStateVecTest, InvalidStateSize) {
+  TestInvalidStateSize(qsim::Factory<float>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, BulkSetAmpl) {
+//  Not implemented.
+//  TestBulkSetAmplitude(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, BulkSetAmplExclusion) {
+//  Not implemented.
+//  TestBulkSetAmplitudeExclusion(qsim::Factory<TypeParam>());
+}
+
+TYPED_TEST(StateSpaceCuStateVecTest, BulkSetAmplDefault) {
+//  Not implemented.
+//  TestBulkSetAmplitudeDefault(factory);
+}
+
+}  // namespace qsim
+
+int main(int argc, char** argv) {
+  ::testing::InitGoogleTest(&argc, argv);
+  return RUN_ALL_TESTS();
+}

From 4c18f7fc0fd7e140ff93ab275d2175d099da12c2 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Mon, 8 Nov 2021 17:33:48 +0100
Subject: [PATCH 145/246] Fix Python format.

---
 qsimcirq/__init__.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/qsimcirq/__init__.py b/qsimcirq/__init__.py
index 8b7db6ba..89c6197e 100644
--- a/qsimcirq/__init__.py
+++ b/qsimcirq/__init__.py
@@ -38,6 +38,7 @@ def _load_qsim_gpu():
         qsim_gpu = None
     return qsim_gpu
 
+
 def _load_qsim_custatevec():
     instr = qsim_decide.detect_custatevec()
     if instr == 1:
@@ -46,6 +47,7 @@ def _load_qsim_custatevec():
         qsim_custatevec = None
     return qsim_custatevec
 
+
 qsim = _load_simd_qsim()
 qsim_gpu = _load_qsim_gpu()
 qsim_custatevec = _load_qsim_custatevec()

From 8a48dc3f4a899a502afa7934cdbd1f87238604bb Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 08:56:19 -0800
Subject: [PATCH 146/246] Link to cuQuantum SDK

---
 docs/tutorials/gcp_gpu.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 234d6dd6..f064ff26 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -177,8 +177,8 @@ After a moment, you should see a result that looks similar to the following.
 
 ### Optional: Use the NVIDIA cuQuantum SDK 
 
-If you have the NVIDIA cuQuantum SDK installed, you can use it here by
-modifying the `gpu_options` line like so:
+If you have the [NVIDIA cuQuantum SDK](https://developer.nvidia.com/cuquantum-sdk)
+installed, you can use it here by modifying the `gpu_options` line like so:
 
 ```python
 gpu_options = qsimcirq.QSimOptions(use_gpu=True, gpu_mode=1)

From a8a4040e7a52d79f4b87b83691b90cc6cadfe0ab Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 08:57:55 -0800
Subject: [PATCH 147/246] Update version to 0.11.0

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index 0d4f6478..28e37090 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.10.3"
+__version__ = "0.11.0"

From 823f7c00301fbd96f5eac6b8de560865919b3409 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 09:30:31 -0800
Subject: [PATCH 148/246] Note about CUQUANTUM_ROOT

---
 docs/tutorials/gcp_gpu.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index f064ff26..5235b418 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -178,7 +178,14 @@ After a moment, you should see a result that looks similar to the following.
 ### Optional: Use the NVIDIA cuQuantum SDK 
 
 If you have the [NVIDIA cuQuantum SDK](https://developer.nvidia.com/cuquantum-sdk)
-installed, you can use it here by modifying the `gpu_options` line like so:
+installed, you can use it with this tutorial. Before building qsim in step 5,
+set the `CUQUANTUM_ROOT` environment variable from the command line:
+
+```bash
+CUQUANTUM_ROOT=[PATH_TO_CUQUANTUM_SDK]
+```
+
+Once you have built qsim, modify the `gpu_options` line like so:
 
 ```python
 gpu_options = qsimcirq.QSimOptions(use_gpu=True, gpu_mode=1)

From 19137761b68507e1310ac402f90ed87054ca7d0a Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 10:05:25 -0800
Subject: [PATCH 149/246] export CUQUANTUM_ROOT

---
 docs/tutorials/gcp_gpu.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index 5235b418..e437f3e2 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -182,7 +182,7 @@ installed, you can use it with this tutorial. Before building qsim in step 5,
 set the `CUQUANTUM_ROOT` environment variable from the command line:
 
 ```bash
-CUQUANTUM_ROOT=[PATH_TO_CUQUANTUM_SDK]
+export CUQUANTUM_ROOT=[PATH_TO_CUQUANTUM_SDK]
 ```
 
 Once you have built qsim, modify the `gpu_options` line like so:

From 05761621217604abb9f050485ee78a1a40b854ef Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 15:32:28 -0800
Subject: [PATCH 150/246] Revert "refactor: split dev requirements out of main
 requirements.txt"

---
 .github/workflows/python_format.yml  |  6 ++++--
 .github/workflows/testing_wheels.yml |  1 -
 MANIFEST.in                          |  1 -
 dev-requirements.txt                 |  3 ---
 docs/install_qsimcirq.md             |  6 ------
 requirements.txt                     | 12 ++++++++++--
 setup.py                             |  4 ----
 7 files changed, 14 insertions(+), 19 deletions(-)
 delete mode 100644 dev-requirements.txt

diff --git a/.github/workflows/python_format.yml b/.github/workflows/python_format.yml
index 213abf2e..adb5f56f 100644
--- a/.github/workflows/python_format.yml
+++ b/.github/workflows/python_format.yml
@@ -24,7 +24,9 @@ jobs:
         with:
           python-version: '3.7'
           architecture: 'x64'
-      - name: Install dev requirements
-        run: pip install -r dev-requirements.txt
+      - name: Install flynt
+        run: cat requirements.txt | grep flynt | xargs pip install
+      - name: Install black
+        run: cat requirements.txt | grep black | xargs pip install
       - name: Format
         run: check/format-incremental
diff --git a/.github/workflows/testing_wheels.yml b/.github/workflows/testing_wheels.yml
index 55dd237a..eeb4d741 100644
--- a/.github/workflows/testing_wheels.yml
+++ b/.github/workflows/testing_wheels.yml
@@ -45,7 +45,6 @@ jobs:
       CIBW_REPAIR_WHEEL_COMMAND_MACOS: ""
       # due to package and module name conflict have to temporarily move it away to run tests
       CIBW_BEFORE_TEST: "mv {package}/qsimcirq /tmp"
-      CIBW_TEST_EXTRAS: "dev"
       CIBW_TEST_COMMAND: "pytest {package}/qsimcirq_tests/qsimcirq_test.py && mv /tmp/qsimcirq {package}"
     steps:
       - uses: actions/checkout@v2
diff --git a/MANIFEST.in b/MANIFEST.in
index 4b487267..2968589b 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,5 +1,4 @@
 include requirements.txt
-include dev-requirements.txt
 include CMakeLists.txt
 
 graft pybind_interface
diff --git a/dev-requirements.txt b/dev-requirements.txt
deleted file mode 100644
index 4cb3afc0..00000000
--- a/dev-requirements.txt
+++ /dev/null
@@ -1,3 +0,0 @@
-black==20.8b1
-flynt~=0.60
-pytest
diff --git a/docs/install_qsimcirq.md b/docs/install_qsimcirq.md
index 0a0f3182..9ae35d21 100644
--- a/docs/install_qsimcirq.md
+++ b/docs/install_qsimcirq.md
@@ -17,12 +17,6 @@ Prerequisites are included in the
 [`requirements.txt`](https://github.com/quantumlib/qsim/blob/master/requirements.txt)
 file, and will be automatically installed along with qsimcirq.
 
-If you'd like to develop qsimcirq, a separate set of dependencies are includes
-in the
-[`dev-requirements.txt`](https://github.com/quantumlib/qsim/blob/master/dev-requirements.txt)
-file. You can install them with `pip3 install -r dev-requirements.txt` or
-`pip3 install qsimcirq[dev]`.
-
 ## Linux installation
 
 We provide `qsimcirq` Python wheels on 64-bit `x86` architectures with `Python 3.{6,7,8,9}`.
diff --git a/requirements.txt b/requirements.txt
index 0a95d64c..01d20cd5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,13 @@
-absl-py
+# Runtime requirements for the python 3 version of cirq.
+
 cirq-core
 numpy~=1.16
-pybind11
 typing_extensions
+absl-py
+
+# Build and test requirements
+
+black==20.8b1
+flynt~=0.60
+pybind11
+pytest
diff --git a/setup.py b/setup.py
index e1e80a70..2fc70507 100644
--- a/setup.py
+++ b/setup.py
@@ -78,7 +78,6 @@ def build_extension(self, ext):
 
 
 requirements = open("requirements.txt").readlines()
-dev_requirements = open("dev-requirements.txt").readlines()
 
 description = "Schrödinger and Schrödinger-Feynman simulators for quantum circuits."
 
@@ -95,9 +94,6 @@ def build_extension(self, ext):
     author_email="devabathini92@gmail.com",
     python_requires=">=3.3.0",
     install_requires=requirements,
-    extras_require={
-        "dev": dev_requirements,
-    },
     license="Apache 2",
     description=description,
     long_description=long_description,

From 51ba016984d63f2594a57bbbc1b368f28e746f8d Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 15:36:00 -0800
Subject: [PATCH 151/246] Revert #469

---
 .github/workflows/cirq_compatibility.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/cirq_compatibility.yml b/.github/workflows/cirq_compatibility.yml
index f4fd7473..04e13559 100644
--- a/.github/workflows/cirq_compatibility.yml
+++ b/.github/workflows/cirq_compatibility.yml
@@ -18,7 +18,5 @@ jobs:
         run: pip3 install -U cirq --pre
       - name: Install qsim requirements
         run: pip3 install -r requirements.txt
-      - name: Install test requirements
-        run: pip3 install -r dev-requirements.txt
       - name: Run python tests
         run: make run-py-tests

From f59589f5f13813041ae0b0c88596a206ddd43413 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 8 Nov 2021 15:41:24 -0800
Subject: [PATCH 152/246] Update version to 0.11.1

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index 28e37090..bf85e4ce 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.11.0"
+__version__ = "0.11.1"

From 11f8b121d0b8c13a6e0839a674150d16006b9b92 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Tue, 9 Nov 2021 16:48:47 +0100
Subject: [PATCH 153/246] Change environment variable name.

---
 CMakeLists.txt                             | 2 +-
 Makefile                                   | 4 ++--
 apps/make.sh                               | 4 ++--
 docs/cirq_interface.md                     | 2 +-
 docs/tutorials/gcp_gpu.md                  | 6 +++---
 pybind_interface/Makefile                  | 2 +-
 pybind_interface/custatevec/CMakeLists.txt | 4 ++--
 pybind_interface/decide/CMakeLists.txt     | 2 +-
 tests/make.sh                              | 4 ++--
 9 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 615a33db..fba9db45 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -6,7 +6,7 @@ if(has_nvcc STREQUAL "")
 else()
     project(qsim LANGUAGES CXX CUDA)
     ADD_SUBDIRECTORY(pybind_interface/cuda)
-    if(DEFINED ENV{CUQUANTUM_ROOT})
+    if(DEFINED ENV{CUQUANTUM_DIR})
         ADD_SUBDIRECTORY(pybind_interface/custatevec)
     endif()
 endif()
diff --git a/Makefile b/Makefile
index 900aa3cd..706ffab6 100644
--- a/Makefile
+++ b/Makefile
@@ -11,8 +11,8 @@ CXXFLAGS = -O3 -fopenmp
 ARCHFLAGS = -march=native
 NVCCFLAGS = -O3
 
-# CUQUANTUM_ROOT should be set.
-CUSTATEVECFLAGS = -I$(CUQUANTUM_ROOT)/include -L$(CUQUANTUM_ROOT)/lib64 -lcustatevec -lcublas
+# CUQUANTUM_DIR should be set.
+CUSTATEVECFLAGS = -I$(CUQUANTUM_DIR)/include -L$(CUQUANTUM_DIR)/lib64 -lcustatevec -lcublas
 
 PYBIND11 = true
 
diff --git a/apps/make.sh b/apps/make.sh
index 51052cc5..7b2db2c8 100755
--- a/apps/make.sh
+++ b/apps/make.sh
@@ -26,6 +26,6 @@ g++ -O3 -march=native -fopenmp -o qsimh_amplitudes.x qsimh_amplitudes.cc
 nvcc -O3 -o qsim_base_cuda.x qsim_base_cuda.cu
 nvcc -O3 -o qsim_qtrajectory_cuda.x qsim_qtrajectory_cuda.cu
 
-# CUQUANTUM_ROOT should be set.
-CUSTATEVECFLAGS="-I${CUQUANTUM_ROOT}/include -L${CUQUANTUM_ROOT}/lib64 -lcustatevec -lcublas"
+# CUQUANTUM_DIR should be set.
+CUSTATEVECFLAGS="-I${CUQUANTUM_DIR}/include -L${CUQUANTUM_DIR}/lib64 -lcustatevec -lcublas"
 nvcc -O3 $CUSTATEVECFLAGS -o qsim_base_custatevec.x qsim_base_custatevec.cu
diff --git a/docs/cirq_interface.md b/docs/cirq_interface.md
index 8f610450..321c985c 100644
--- a/docs/cirq_interface.md
+++ b/docs/cirq_interface.md
@@ -180,7 +180,7 @@ and run on a device with available NVIDIA GPUs.
 Compilation for GPU follows the same steps outlined in the
 [Compiling qsimcirq](./cirq_interface.md#compiling-qsimcirq) section.
 To compile with the NVIDIA cuStateVec library, set the environmment variable
-`CUQUANTUM_ROOT` to path to the root of the cuStateVec library.
+`CUQUANTUM_DIR` to the path to the cuStateVec library.
 
 `QSimOptions` provides five parameters to configure GPU execution. `use_gpu`
 is required to enable GPU execution:
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index e437f3e2..f18ae61f 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -175,14 +175,14 @@ After a moment, you should see a result that looks similar to the following.
 [(0.7071067690849304+0j), 0j]
 ```
 
-### Optional: Use the NVIDIA cuQuantum SDK 
+### Optional: Use the NVIDIA cuQuantum SDK
 
 If you have the [NVIDIA cuQuantum SDK](https://developer.nvidia.com/cuquantum-sdk)
 installed, you can use it with this tutorial. Before building qsim in step 5,
-set the `CUQUANTUM_ROOT` environment variable from the command line:
+set the `CUQUANTUM_DIR` environment variable from the command line:
 
 ```bash
-export CUQUANTUM_ROOT=[PATH_TO_CUQUANTUM_SDK]
+export CUQUANTUM_DIR=[PATH_TO_CUQUANTUM_SDK]
 ```
 
 Once you have built qsim, modify the `gpu_options` line like so:
diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index c8944562..6a7dc7eb 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -24,7 +24,7 @@ ifeq ($(shell which $(NVCC)),)
 pybind: pybind-cpu decide-cpu
 else
 # Check for the cuStateVec library.
-ifeq ($(CUQUANTUM_ROOT),)
+ifeq ($(CUQUANTUM_DIR),)
 pybind: pybind-cpu pybind-gpu decide-gpu
 else
 pybind: pybind-cpu pybind-gpu pybind-custatevec decide-custatevec
diff --git a/pybind_interface/custatevec/CMakeLists.txt b/pybind_interface/custatevec/CMakeLists.txt
index 4ea57380..0d9a05fb 100644
--- a/pybind_interface/custatevec/CMakeLists.txt
+++ b/pybind_interface/custatevec/CMakeLists.txt
@@ -45,8 +45,8 @@ find_package(CUDA REQUIRED)
 
 include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
 
-include_directories($ENV{CUQUANTUM_ROOT}/include)
-link_directories($ENV{CUQUANTUM_ROOT}/lib64)
+include_directories($ENV{CUQUANTUM_DIR}/include)
+link_directories($ENV{CUQUANTUM_DIR}/lib64)
 
 cuda_add_library(qsim_custatevec MODULE pybind_main_custatevec.cpp)
 target_link_libraries(qsim_custatevec -lcustatevec -lcublas)
diff --git a/pybind_interface/decide/CMakeLists.txt b/pybind_interface/decide/CMakeLists.txt
index 99a75881..643ca9ad 100644
--- a/pybind_interface/decide/CMakeLists.txt
+++ b/pybind_interface/decide/CMakeLists.txt
@@ -42,7 +42,7 @@ else()
 
   cuda_add_library(qsim_decide MODULE decide.cpp)
 
-  if(DEFINED ENV{CUQUANTUM_ROOT})
+  if(DEFINED ENV{CUQUANTUM_DIR})
       target_compile_options(qsim_decide PRIVATE
           $<$<COMPILE_LANGUAGE:CUDA>:-D__CUSTATEVEC__>
       )
diff --git a/tests/make.sh b/tests/make.sh
index 10d91b56..5df5a37e 100755
--- a/tests/make.sh
+++ b/tests/make.sh
@@ -56,8 +56,8 @@ nvcc -O3 -I$path_to_include -L$path_to_lib -o qtrajectory_cuda_test.x qtrajector
 nvcc -O3 -I$path_to_include -L$path_to_lib -o simulator_cuda_test.x simulator_cuda_test.cu -lgtest -lpthread
 nvcc -O3 -I$path_to_include -L$path_to_lib -o statespace_cuda_test.x statespace_cuda_test.cu -lgtest -lpthread
 
-# CUQUANTUM_ROOT should be set.
-CUSTATEVECFLAGS="-I${CUQUANTUM_ROOT}/include -L${CUQUANTUM_ROOT}/lib64 -lcustatevec -lcublas"
+# CUQUANTUM_DIR should be set.
+CUSTATEVECFLAGS="-I${CUQUANTUM_DIR}/include -L${CUQUANTUM_DIR}/lib64 -lcustatevec -lcublas"
 nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o hybrid_custatevec_test.x hybrid_custatevec_test.cu -lgtest -lpthread
 nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o qtrajectory_custatevec_test.x qtrajectory_custatevec_test.cu -lgtest -lpthread
 nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o simulator_custatevec_test.x simulator_custatevec_test.cu -lgtest -lpthread

From 60774853ac65fb80c4b360bc02f74609de7d6f26 Mon Sep 17 00:00:00 2001
From: jlow2397 <54644848+jlow2397@users.noreply.github.com>
Date: Wed, 10 Nov 2021 14:07:48 -0800
Subject: [PATCH 154/246] updating cards on qsim documentation landing page

---
 docs/_index.yaml | 41 +++++++++++++++++++++--------------------
 1 file changed, 21 insertions(+), 20 deletions(-)

diff --git a/docs/_index.yaml b/docs/_index.yaml
index 093ca58b..41c71faf 100644
--- a/docs/_index.yaml
+++ b/docs/_index.yaml
@@ -78,28 +78,11 @@ landing_page:
     options:
     - cards
     items:
-    - heading: "Schrödinger simulation via qsim"
-      image_path: /site-assets/images/cards/qsim-card-schrodinger.png
-      description: >
-        qsim is a full wavefunction simulator that has been optimized to support
-        vectorized operations and multi-threading.
-      buttons:
-      - label: "Learn more"
-        path: /qsim/usage
-    - heading: "Schrödinger-Feynman simulation via qsimh"
-      image_path: /site-assets/images/cards/qsim-card-schrodinger-feynman.png
-      description: >
-        qsimh is a hybrid Schrödinger-Feynman simulator. It simulates separate
-        disjoint sets of qubit using a full wave vector simulator, and then uses
-        Feynman paths to sum over gates that span the sets.
-      buttons:
-      - label: "Learn more"
-        path: /qsim/usage#qsimh_base_usage
     - heading: "Cirq integration"
       image_path: /site-assets/images/cards/qsim-card-cirq-integrations.png
       description: >
         Cirq is a python framework for writing, simulating, and executing
-        quantum programs. Cirq’s built in simulator is useful to around 20
+        quantum programs. Cirq's built in simulator is useful to around 20
         qubits. By using the qsim Cirq simulator one can boost the number of
         qubits simulated to be mostly limited by available ram. Up to 40 qubits
         can be simulated on a 90 core Intel Xeon workstation.
@@ -109,9 +92,27 @@ landing_page:
     - heading: "Install qsim on GCP"
       image_path: /site-assets/images/cards/qsim-card-gcp.jpg
       description: >
-        Learn how to simulate up to 38 qubits on Google Cloud’s Compute Engine.
+        Learn how to simulate up to 38 qubits on Google Cloud's Compute Engine.
         qsim has a prepackaged docker image that allows easy deployment of qsim,
         Juypter, and Cirq onto a virtual machine.
       buttons:
       - label: "Learn more"
-        path: /qsim/tutorials/qsimcirq_gcp
+        path: /qsim/tutorials/gcp_before_you_begin
+    - heading: "Upgrades to qsim"
+      image_path: /site-assets/images/cards/qsim-card-schrodinger.png
+      description: >
+        To help researchers and developers develop quantum algorithms today, we
+        have made updates to qsim that make it more performant and intuitive,
+        and more “hardware-like”.
+      buttons:
+      - label: "Learn more"
+        path: https://opensource.googleblog.com/2021/11/Upgrading%20qsim%20Google%20Quantum%20AIs%20Open%20Source%20Quantum%20Simulator%20.html?linkId=138925083
+    - heading: "Integrating qsim with NVIDIA's cuQuantum SDK"
+      image_path: /qsim/images/qsim_nvidia.png
+      description: >
+        The integration between qsim and the NVIDIA cuQuantum SDK will enable
+        qsim users to make the most of GPUs when developing quantum algorithms
+        and applications.
+      buttons:
+      - label: "Learn more"
+        path: https://opensource.googleblog.com/2021/11/qsim%20integrates%20with%20NVIDIA%20cuQuantum%20SDK%20to%20accelerate%20quantum%20circuit%20simulations%20on%20NVIDIA%20GPUs.html

From 8570fe5f5a9ac6fc1f82759c7d3ee8922a1a65c3 Mon Sep 17 00:00:00 2001
From: jlow2397 <54644848+jlow2397@users.noreply.github.com>
Date: Thu, 11 Nov 2021 14:06:03 -0800
Subject: [PATCH 155/246] removing curly quotes from documentation on qsim

---
 docs/_index.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/_index.yaml b/docs/_index.yaml
index 41c71faf..e525f69c 100644
--- a/docs/_index.yaml
+++ b/docs/_index.yaml
@@ -103,7 +103,7 @@ landing_page:
       description: >
         To help researchers and developers develop quantum algorithms today, we
         have made updates to qsim that make it more performant and intuitive,
-        and more “hardware-like”.
+        and more "hardware-like".
       buttons:
       - label: "Learn more"
         path: https://opensource.googleblog.com/2021/11/Upgrading%20qsim%20Google%20Quantum%20AIs%20Open%20Source%20Quantum%20Simulator%20.html?linkId=138925083

From f0175cafa9e2b59ed5796d4b8876be4ba1c5e457 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 16 Nov 2021 08:49:31 -0800
Subject: [PATCH 156/246] Reinstate `noise` parameter

---
 qsimcirq/qsim_simulator.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index b37b646b..cd199213 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -191,6 +191,7 @@ def __init__(
         self,
         qsim_options: Union[None, Dict, QSimOptions] = None,
         seed: value.RANDOM_STATE_OR_SEED_LIKE = None,
+        noise: "devices.NOISE_MODEL_LIKE" = None,
         circuit_memoization_size: int = 0,
     ):
         """Creates a new QSimSimulator using the given options and seed.
@@ -200,6 +201,8 @@ def __init__(
                 to use for all circuits run using this simulator. See the
                 QSimOptions class for details.
             seed: A random state or seed object, as defined in cirq.value.
+            noise: A cirq.NoiseModel to apply to all circuits simulated with
+                this simulator.
             circuit_memoization_size: The number of last translated circuits
                 to be memoized from simulation executions, to eliminate
                 translation overhead. Every simulation will perform a linear

From f91d8bab6d599c39d355f43c0b5b4fe9a695e4ae Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 16 Nov 2021 10:48:30 -0800
Subject: [PATCH 157/246] Skip applying noise if none is provided, part 1

---
 qsimcirq/qsim_simulator.py | 54 ++++++++++++++++++++------------------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index cd199213..b273b398 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -309,13 +309,15 @@ def _sample_measure_results(
         """
 
         # Add noise to the circuit if a noise model was provided.
-        program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, sorted(program.all_qubits())),
-            device=program.device,
-        )
+        all_qubits = program.all_qubits()
+        if self.noise is not devices.NO_NOISE:
+            program = qsimc.QSimCircuit(
+                self.noise.noisy_moments(program, sorted(all_qubits)),
+                device=program.device,
+            )
 
         # Compute indices of measured qubits
-        ordered_qubits = ops.QubitOrder.DEFAULT.order_for(program.all_qubits())
+        ordered_qubits = ops.QubitOrder.DEFAULT.order_for(all_qubits)
         num_qubits = len(ordered_qubits)
 
         qubit_map = {qubit: index for index, qubit in enumerate(ordered_qubits)}
@@ -434,15 +436,15 @@ def compute_amplitudes_sweep(
         """
 
         # Add noise to the circuit if a noise model was provided.
-        program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, sorted(program.all_qubits())),
-            device=program.device,
-        )
+        all_qubits = program.all_qubits()
+        if self.noise is not devices.NO_NOISE:
+            program = qsimc.QSimCircuit(
+                self.noise.noisy_moments(program, sorted(all_qubits)),
+                device=program.device,
+            )
 
         # qsim numbers qubits in reverse order from cirq
-        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(
-            program.all_qubits()
-        )
+        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
         num_qubits = len(cirq_order)
         bitstrings = [
             format(bitstring, "b").zfill(num_qubits)[::-1] for bitstring in bitstrings
@@ -516,19 +518,19 @@ def simulate_sweep(
             raise TypeError("initial_state must be an int or state vector.")
 
         # Add noise to the circuit if a noise model was provided.
-        program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, sorted(program.all_qubits())),
-            device=program.device,
-        )
+        all_qubits = program.all_qubits()
+        if self.noise is not devices.NO_NOISE:
+            program = qsimc.QSimCircuit(
+                self.noise.noisy_moments(program, sorted(all_qubits)),
+                device=program.device,
+            )
 
         options = {}
         options.update(self.qsim_options)
 
         param_resolvers = study.to_resolvers(params)
         # qsim numbers qubits in reverse order from cirq
-        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(
-            program.all_qubits()
-        )
+        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
         qsim_order = list(reversed(cirq_order))
         num_qubits = len(qsim_order)
         if isinstance(initial_state, np.ndarray):
@@ -626,9 +628,8 @@ def simulate_expectation_values_sweep(
             observables = [observables]
         psumlist = [ops.PauliSum.wrap(pslike) for pslike in observables]
 
-        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(
-            program.all_qubits()
-        )
+        all_qubits = program.all_qubits()
+        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
         qsim_order = list(reversed(cirq_order))
         num_qubits = len(qsim_order)
         qubit_map = {qubit: index for index, qubit in enumerate(qsim_order)}
@@ -653,10 +654,11 @@ def simulate_expectation_values_sweep(
             raise TypeError("initial_state must be an int or state vector.")
 
         # Add noise to the circuit if a noise model was provided.
-        program = qsimc.QSimCircuit(
-            self.noise.noisy_moments(program, sorted(program.all_qubits())),
-            device=program.device,
-        )
+        if self.noise is not devices.NO_NOISE:
+            program = qsimc.QSimCircuit(
+                self.noise.noisy_moments(program, sorted(all_qubits)),
+                device=program.device,
+            )
 
         options = {}
         options.update(self.qsim_options)

From 6d15523bb12e07b54a7ff3a5824005c95d0c899f Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 16 Nov 2021 10:53:52 -0800
Subject: [PATCH 158/246] Skip applying noise if none is provided, part 2

---
 qsimcirq/qsim_simulator.py | 40 +++++++++++++++++++-------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index b273b398..364ebae4 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -310,11 +310,11 @@ def _sample_measure_results(
 
         # Add noise to the circuit if a noise model was provided.
         all_qubits = program.all_qubits()
-        if self.noise is not devices.NO_NOISE:
-            program = qsimc.QSimCircuit(
-                self.noise.noisy_moments(program, sorted(all_qubits)),
-                device=program.device,
-            )
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, sorted(all_qubits))
+            if self.noise is not devices.NO_NOISE else program,
+            device=program.device,
+        )
 
         # Compute indices of measured qubits
         ordered_qubits = ops.QubitOrder.DEFAULT.order_for(all_qubits)
@@ -437,11 +437,11 @@ def compute_amplitudes_sweep(
 
         # Add noise to the circuit if a noise model was provided.
         all_qubits = program.all_qubits()
-        if self.noise is not devices.NO_NOISE:
-            program = qsimc.QSimCircuit(
-                self.noise.noisy_moments(program, sorted(all_qubits)),
-                device=program.device,
-            )
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, sorted(all_qubits))
+            if self.noise is not devices.NO_NOISE else program,
+            device=program.device,
+        )
 
         # qsim numbers qubits in reverse order from cirq
         cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
@@ -519,11 +519,11 @@ def simulate_sweep(
 
         # Add noise to the circuit if a noise model was provided.
         all_qubits = program.all_qubits()
-        if self.noise is not devices.NO_NOISE:
-            program = qsimc.QSimCircuit(
-                self.noise.noisy_moments(program, sorted(all_qubits)),
-                device=program.device,
-            )
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, sorted(all_qubits))
+            if self.noise is not devices.NO_NOISE else program,
+            device=program.device,
+        )
 
         options = {}
         options.update(self.qsim_options)
@@ -654,11 +654,11 @@ def simulate_expectation_values_sweep(
             raise TypeError("initial_state must be an int or state vector.")
 
         # Add noise to the circuit if a noise model was provided.
-        if self.noise is not devices.NO_NOISE:
-            program = qsimc.QSimCircuit(
-                self.noise.noisy_moments(program, sorted(all_qubits)),
-                device=program.device,
-            )
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, sorted(all_qubits))
+            if self.noise is not devices.NO_NOISE else program,
+            device=program.device,
+        )
 
         options = {}
         options.update(self.qsim_options)

From 44dc3be3ffb9f6da037de3dc7b910b49b02ef52c Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 16 Nov 2021 11:04:41 -0800
Subject: [PATCH 159/246] Formatting fixes

---
 qsimcirq/qsim_simulator.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 364ebae4..1ed05505 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -312,7 +312,8 @@ def _sample_measure_results(
         all_qubits = program.all_qubits()
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE else program,
+            if self.noise is not devices.NO_NOISE
+            else program,
             device=program.device,
         )
 
@@ -439,7 +440,8 @@ def compute_amplitudes_sweep(
         all_qubits = program.all_qubits()
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE else program,
+            if self.noise is not devices.NO_NOISE
+            else program,
             device=program.device,
         )
 
@@ -521,7 +523,8 @@ def simulate_sweep(
         all_qubits = program.all_qubits()
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE else program,
+            if self.noise is not devices.NO_NOISE
+            else program,
             device=program.device,
         )
 
@@ -656,7 +659,8 @@ def simulate_expectation_values_sweep(
         # Add noise to the circuit if a noise model was provided.
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE else program,
+            if self.noise is not devices.NO_NOISE
+            else program,
             device=program.device,
         )
 

From bf7b347f81639c5ce343c8b9b35bd9cf96620fc9 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 19 Nov 2021 08:33:36 -0800
Subject: [PATCH 160/246] Link to cuQuantum install guide

---
 docs/tutorials/gcp_gpu.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index f18ae61f..e352cfe9 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -178,7 +178,9 @@ After a moment, you should see a result that looks similar to the following.
 ### Optional: Use the NVIDIA cuQuantum SDK
 
 If you have the [NVIDIA cuQuantum SDK](https://developer.nvidia.com/cuquantum-sdk)
-installed, you can use it with this tutorial. Before building qsim in step 5,
+installed (instructions are provided
+[here](https://docs.nvidia.com/cuda/cuquantum/custatevec/html/getting_started.html#installation-and-compilation)),
+you can use it with this tutorial. Before building qsim in step 5,
 set the `CUQUANTUM_DIR` environment variable from the command line:
 
 ```bash

From 50cfc8aeb63457184681737736adb677f2a5fc33 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Fri, 19 Nov 2021 11:54:27 -0800
Subject: [PATCH 161/246] Import and use cirq instead of submodules

---
 qsimcirq/qsim_circuit.py    |   7 +-
 qsimcirq/qsim_simulator.py  | 127 ++++++++++++++++--------------------
 qsimcirq/qsimh_simulator.py |  16 ++---
 3 files changed, 70 insertions(+), 80 deletions(-)

diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index a3089752..a4811e2b 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -12,12 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import numpy as np
 import warnings
+from typing import Dict, Union
 
 import cirq
+import numpy as np
+
 from . import qsim
-from typing import Dict, Union
 
 
 # List of parameter names that appear in valid Cirq protos.
@@ -300,7 +301,7 @@ def has_qsim_kind(op: cirq.ops.GateOperation):
             return _cirq_gate_kind(op.gate) != None
 
         def to_matrix(op: cirq.ops.GateOperation):
-            mat = cirq.protocols.unitary(op.gate, None)
+            mat = cirq.unitary(op.gate, None)
             if mat is None:
                 return NotImplemented
 
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 1ed05505..a24ffd89 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -16,18 +16,7 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List, Optional, Sequence, Tuple, Union
 
-from cirq import (
-    circuits,
-    devices,
-    ops,
-    protocols,
-    sim,
-    study,
-    value,
-    SimulatesAmplitudes,
-    SimulatesFinalState,
-    SimulatesSamples,
-)
+import cirq
 
 # TODO: import from cirq directly when fix is released
 from cirq.sim.simulator import SimulatesExpectationValues
@@ -38,17 +27,17 @@
 import qsimcirq.qsim_circuit as qsimc
 
 
-class QSimSimulatorState(sim.StateVectorSimulatorState):
-    def __init__(self, qsim_data: np.ndarray, qubit_map: Dict[ops.Qid, int]):
+class QSimSimulatorState(cirq.StateVectorSimulatorState):
+    def __init__(self, qsim_data: np.ndarray, qubit_map: Dict[cirq.Qid, int]):
         state_vector = qsim_data.view(np.complex64)
         super().__init__(state_vector=state_vector, qubit_map=qubit_map)
 
 
-@value.value_equality(unhashable=True)
-class QSimSimulatorTrialResult(sim.StateVectorMixin, sim.SimulationTrialResult):
+@cirq.value_equality(unhashable=True)
+class QSimSimulatorTrialResult(cirq.StateVectorMixin, cirq.SimulationTrialResult):
     def __init__(
         self,
-        params: study.ParamResolver,
+        params: cirq.ParamResolver,
         measurements: Dict[str, np.ndarray],
         final_simulator_state: QSimSimulatorState,
     ):
@@ -102,17 +91,17 @@ def __repr__(self) -> str:
 
 # This should probably live in Cirq...
 # TODO: update to support CircuitOperations.
-def _needs_trajectories(circuit: circuits.Circuit) -> bool:
+def _needs_trajectories(circuit: cirq.Circuit) -> bool:
     """Checks if the circuit requires trajectory simulation."""
     for op in circuit.all_operations():
         test_op = (
             op
-            if not protocols.is_parameterized(op)
-            else protocols.resolve_parameters(
-                op, {param: 1 for param in protocols.parameter_names(op)}
+            if not cirq.is_parameterized(op)
+            else cirq.resolve_parameters(
+                op, {param: 1 for param in cirq.parameter_names(op)}
             )
         )
-        if not (protocols.has_unitary(test_op) or protocols.is_measurement(test_op)):
+        if not (cirq.has_unitary(test_op) or cirq.is_measurement(test_op)):
             return True
     return False
 
@@ -182,16 +171,16 @@ def as_dict(self):
 
 
 class QSimSimulator(
-    SimulatesSamples,
-    SimulatesAmplitudes,
-    SimulatesFinalState,
+    cirq.SimulatesSamples,
+    cirq.SimulatesAmplitudes,
+    cirq.SimulatesFinalState,
     SimulatesExpectationValues,
 ):
     def __init__(
         self,
         qsim_options: Union[None, Dict, QSimOptions] = None,
-        seed: value.RANDOM_STATE_OR_SEED_LIKE = None,
-        noise: "devices.NOISE_MODEL_LIKE" = None,
+        seed: cirq.RANDOM_STATE_OR_SEED_LIKE = None,
+        noise: cirq.NOISE_MODEL_LIKE = None,
         circuit_memoization_size: int = 0,
     ):
         """Creates a new QSimSimulator using the given options and seed.
@@ -225,10 +214,10 @@ def __init__(
                 'Keys {"c", "i", "s"} are reserved for internal use and cannot be '
                 "used in QSimCircuit instantiation."
             )
-        self._prng = value.parse_random_state(seed)
+        self._prng = cirq.parse_random_state(seed)
         self.qsim_options = QSimOptions().as_dict()
         self.qsim_options.update(qsim_options)
-        self.noise = devices.NoiseModel.from_noise_model_like(noise)
+        self.noise = cirq.NoiseModel.from_noise_model_like(noise)
 
         # module to use for simulation
         if self.qsim_options["g"]:
@@ -263,8 +252,8 @@ def get_seed(self):
 
     def _run(
         self,
-        circuit: circuits.Circuit,
-        param_resolver: study.ParamResolver,
+        circuit: cirq.Circuit,
+        param_resolver: cirq.ParamResolver,
         repetitions: int,
     ) -> Dict[str, np.ndarray]:
         """Run a simulation, mimicking quantum hardware.
@@ -278,14 +267,14 @@ def _run(
             A dictionary from measurement gate key to measurement
             results.
         """
-        param_resolver = param_resolver or study.ParamResolver({})
-        solved_circuit = protocols.resolve_parameters(circuit, param_resolver)
+        param_resolver = param_resolver or cirq.ParamResolver({})
+        solved_circuit = cirq.resolve_parameters(circuit, param_resolver)
 
         return self._sample_measure_results(solved_circuit, repetitions)
 
     def _sample_measure_results(
         self,
-        program: circuits.Circuit,
+        program: cirq.Circuit,
         repetitions: int = 1,
     ) -> Dict[str, np.ndarray]:
         """Samples from measurement gates in the circuit.
@@ -312,13 +301,13 @@ def _sample_measure_results(
         all_qubits = program.all_qubits()
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE
+            if self.noise is not cirq.NO_NOISE
             else program,
             device=program.device,
         )
 
         # Compute indices of measured qubits
-        ordered_qubits = ops.QubitOrder.DEFAULT.order_for(all_qubits)
+        ordered_qubits = cirq.QubitOrder.DEFAULT.order_for(all_qubits)
         num_qubits = len(ordered_qubits)
 
         qubit_map = {qubit: index for index, qubit in enumerate(ordered_qubits)}
@@ -330,16 +319,16 @@ def _sample_measure_results(
         measurement_ops = [
             op
             for _, op, _ in program.findall_operations_with_gate_type(
-                ops.MeasurementGate
+                cirq.MeasurementGate
             )
         ]
-        measured_qubits = []  # type: List[ops.Qid]
+        measured_qubits = []  # type: List[cirq.Qid]
         bounds = {}  # type: Dict[str, Tuple]
         meas_ops = {}  # type: Dict[str, cirq.GateOperation]
         current_index = 0
         for op in measurement_ops:
             gate = op.gate
-            key = protocols.measurement_key_name(gate)
+            key = cirq.measurement_key_name(gate)
             meas_ops[key] = op
             if key in bounds:
                 raise ValueError(f"Duplicate MeasurementGate with key {key}")
@@ -369,21 +358,21 @@ def _sample_measure_results(
             # Measurements must be replaced with identity gates to sample properly.
             # Simply removing them may omit qubits from the circuit.
             for i in range(len(program.moments)):
-                program.moments[i] = ops.Moment(
+                program.moments[i] = cirq.Moment(
                     op
-                    if not isinstance(op.gate, ops.MeasurementGate)
-                    else [ops.IdentityGate(1).on(q) for q in op.qubits]
+                    if not isinstance(op.gate, cirq.MeasurementGate)
+                    else [cirq.IdentityGate(1).on(q) for q in op.qubits]
                     for op in program.moments[i]
                 )
             translator_fn_name = "translate_cirq_to_qsim"
             options["c"] = self._translate_circuit(
                 program,
                 translator_fn_name,
-                ops.QubitOrder.DEFAULT,
+                cirq.QubitOrder.DEFAULT,
             )
             options["s"] = self.get_seed()
             final_state = self._sim_module.qsim_simulate_fullstate(options, 0)
-            full_results = sim.sample_state_vector(
+            full_results = cirq.sample_state_vector(
                 final_state.view(np.complex64),
                 range(num_qubits),
                 repetitions=repetitions,
@@ -399,7 +388,7 @@ def _sample_measure_results(
             options["c"] = self._translate_circuit(
                 program,
                 translator_fn_name,
-                ops.QubitOrder.DEFAULT,
+                cirq.QubitOrder.DEFAULT,
             )
             for i in range(repetitions):
                 options["s"] = self.get_seed()
@@ -412,10 +401,10 @@ def _sample_measure_results(
 
     def compute_amplitudes_sweep(
         self,
-        program: circuits.Circuit,
+        program: cirq.Circuit,
         bitstrings: Sequence[int],
-        params: study.Sweepable,
-        qubit_order: ops.QubitOrderOrList = ops.QubitOrder.DEFAULT,
+        params: cirq.Sweepable,
+        qubit_order: cirq.QubitOrderOrList = cirq.QubitOrder.DEFAULT,
     ) -> Sequence[Sequence[complex]]:
         """Computes the desired amplitudes using qsim.
 
@@ -440,13 +429,13 @@ def compute_amplitudes_sweep(
         all_qubits = program.all_qubits()
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE
+            if self.noise is not cirq.NO_NOISE
             else program,
             device=program.device,
         )
 
         # qsim numbers qubits in reverse order from cirq
-        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
+        cirq_order = cirq.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
         num_qubits = len(cirq_order)
         bitstrings = [
             format(bitstring, "b").zfill(num_qubits)[::-1] for bitstring in bitstrings
@@ -455,7 +444,7 @@ def compute_amplitudes_sweep(
         options = {"i": "\n".join(bitstrings)}
         options.update(self.qsim_options)
 
-        param_resolvers = study.to_resolvers(params)
+        param_resolvers = cirq.to_resolvers(params)
 
         trials_results = []
         if _needs_trajectories(program):
@@ -466,7 +455,7 @@ def compute_amplitudes_sweep(
             simulator_fn = self._sim_module.qsim_simulate
 
         for prs in param_resolvers:
-            solved_circuit = protocols.resolve_parameters(program, prs)
+            solved_circuit = cirq.resolve_parameters(program, prs)
             options["c"] = self._translate_circuit(
                 solved_circuit,
                 translator_fn_name,
@@ -480,9 +469,9 @@ def compute_amplitudes_sweep(
 
     def simulate_sweep(
         self,
-        program: circuits.Circuit,
-        params: study.Sweepable,
-        qubit_order: ops.QubitOrderOrList = ops.QubitOrder.DEFAULT,
+        program: cirq.Circuit,
+        params: cirq.Sweepable,
+        qubit_order: cirq.QubitOrderOrList = cirq.QubitOrder.DEFAULT,
         initial_state: Optional[Union[int, np.ndarray]] = None,
     ) -> List["SimulationTrialResult"]:
         """Simulates the supplied Circuit.
@@ -523,7 +512,7 @@ def simulate_sweep(
         all_qubits = program.all_qubits()
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE
+            if self.noise is not cirq.NO_NOISE
             else program,
             device=program.device,
         )
@@ -531,9 +520,9 @@ def simulate_sweep(
         options = {}
         options.update(self.qsim_options)
 
-        param_resolvers = study.to_resolvers(params)
+        param_resolvers = cirq.to_resolvers(params)
         # qsim numbers qubits in reverse order from cirq
-        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
+        cirq_order = cirq.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
         qsim_order = list(reversed(cirq_order))
         num_qubits = len(qsim_order)
         if isinstance(initial_state, np.ndarray):
@@ -555,7 +544,7 @@ def simulate_sweep(
             fullstate_simulator_fn = self._sim_module.qsim_simulate_fullstate
 
         for prs in param_resolvers:
-            solved_circuit = protocols.resolve_parameters(program, prs)
+            solved_circuit = cirq.resolve_parameters(program, prs)
 
             options["c"] = self._translate_circuit(
                 solved_circuit,
@@ -583,10 +572,10 @@ def simulate_sweep(
 
     def simulate_expectation_values_sweep(
         self,
-        program: "cirq.Circuit",
-        observables: Union["cirq.PauliSumLike", List["cirq.PauliSumLike"]],
-        params: "study.Sweepable",
-        qubit_order: ops.QubitOrderOrList = ops.QubitOrder.DEFAULT,
+        program: cirq.Circuit,
+        observables: Union[cirq.PauliSumLike, List[cirq.PauliSumLike]],
+        params: cirq.Sweepable,
+        qubit_order: cirq.QubitOrderOrList = cirq.QubitOrder.DEFAULT,
         initial_state: Any = None,
         permit_terminal_measurements: bool = False,
     ) -> List[List[float]]:
@@ -629,10 +618,10 @@ def simulate_expectation_values_sweep(
             )
         if not isinstance(observables, List):
             observables = [observables]
-        psumlist = [ops.PauliSum.wrap(pslike) for pslike in observables]
+        psumlist = [cirq.PauliSum.wrap(pslike) for pslike in observables]
 
         all_qubits = program.all_qubits()
-        cirq_order = ops.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
+        cirq_order = cirq.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
         qsim_order = list(reversed(cirq_order))
         num_qubits = len(qsim_order)
         qubit_map = {qubit: index for index, qubit in enumerate(qsim_order)}
@@ -659,7 +648,7 @@ def simulate_expectation_values_sweep(
         # Add noise to the circuit if a noise model was provided.
         program = qsimc.QSimCircuit(
             self.noise.noisy_moments(program, sorted(all_qubits))
-            if self.noise is not devices.NO_NOISE
+            if self.noise is not cirq.NO_NOISE
             else program,
             device=program.device,
         )
@@ -667,7 +656,7 @@ def simulate_expectation_values_sweep(
         options = {}
         options.update(self.qsim_options)
 
-        param_resolvers = study.to_resolvers(params)
+        param_resolvers = cirq.to_resolvers(params)
         if isinstance(initial_state, np.ndarray):
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
@@ -687,7 +676,7 @@ def simulate_expectation_values_sweep(
             ev_simulator_fn = self._sim_module.qsim_simulate_expectation_values
 
         for prs in param_resolvers:
-            solved_circuit = protocols.resolve_parameters(program, prs)
+            solved_circuit = cirq.resolve_parameters(program, prs)
             options["c"] = self._translate_circuit(
                 solved_circuit,
                 translator_fn_name,
@@ -707,7 +696,7 @@ def _translate_circuit(
         self,
         circuit: Any,
         translator_fn_name: str,
-        qubit_order: ops.QubitOrderOrList,
+        qubit_order: cirq.QubitOrderOrList,
     ):
         # If the circuit is memoized, reuse the corresponding translated
         # circuit.
diff --git a/qsimcirq/qsimh_simulator.py b/qsimcirq/qsimh_simulator.py
index 3d2ec049..ccf1c1a0 100644
--- a/qsimcirq/qsimh_simulator.py
+++ b/qsimcirq/qsimh_simulator.py
@@ -12,15 +12,15 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import Union, Sequence
+from typing import Sequence
 
-from cirq import study, ops, protocols, circuits, value, SimulatesAmplitudes
+import cirq
 
 from . import qsim
 import qsimcirq.qsim_circuit as qsimc
 
 
-class QSimhSimulator(SimulatesAmplitudes):
+class QSimhSimulator(cirq.SimulatesAmplitudes):
     def __init__(self, qsimh_options: dict = {}):
         """Creates a new QSimhSimulator using the given options.
 
@@ -41,10 +41,10 @@ def __init__(self, qsimh_options: dict = {}):
 
     def compute_amplitudes_sweep(
         self,
-        program: circuits.Circuit,
+        program: cirq.Circuit,
         bitstrings: Sequence[int],
-        params: study.Sweepable,
-        qubit_order: ops.QubitOrderOrList = ops.QubitOrder.DEFAULT,
+        params: cirq.Sweepable,
+        qubit_order: cirq.QubitOrderOrList = cirq.QubitOrder.DEFAULT,
     ) -> Sequence[Sequence[complex]]:
 
         if not isinstance(program, qsimc.QSimCircuit):
@@ -58,12 +58,12 @@ def compute_amplitudes_sweep(
 
         options = {"i": "\n".join(bitstrings)}
         options.update(self.qsimh_options)
-        param_resolvers = study.to_resolvers(params)
+        param_resolvers = cirq.to_resolvers(params)
 
         trials_results = []
         for prs in param_resolvers:
 
-            solved_circuit = protocols.resolve_parameters(program, prs)
+            solved_circuit = cirq.resolve_parameters(program, prs)
 
             options["c"] = solved_circuit.translate_cirq_to_qsim(qubit_order)
 

From f02260465d7edaf222ac530cf610ca1227cf228e Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Fri, 19 Nov 2021 13:51:31 -0800
Subject: [PATCH 162/246] Fix reference to parse_random_state

---
 qsimcirq/qsim_simulator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index a24ffd89..e8faeeca 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -214,7 +214,7 @@ def __init__(
                 'Keys {"c", "i", "s"} are reserved for internal use and cannot be '
                 "used in QSimCircuit instantiation."
             )
-        self._prng = cirq.parse_random_state(seed)
+        self._prng = cirq.value.parse_random_state(seed)
         self.qsim_options = QSimOptions().as_dict()
         self.qsim_options.update(qsim_options)
         self.noise = cirq.NoiseModel.from_noise_model_like(noise)

From 3faee5a3a6b10363ddab25490eb465d576889ac9 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Fri, 19 Nov 2021 14:05:28 -0800
Subject: [PATCH 163/246] Fix import of SimulatesExpectationValues

---
 qsimcirq/qsim_simulator.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index e8faeeca..8e17ee8a 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -18,9 +18,6 @@
 
 import cirq
 
-# TODO: import from cirq directly when fix is released
-from cirq.sim.simulator import SimulatesExpectationValues
-
 import numpy as np
 
 from . import qsim, qsim_gpu, qsim_custatevec
@@ -174,7 +171,7 @@ class QSimSimulator(
     cirq.SimulatesSamples,
     cirq.SimulatesAmplitudes,
     cirq.SimulatesFinalState,
-    SimulatesExpectationValues,
+    cirq.SimulatesExpectationValues,
 ):
     def __init__(
         self,

From 867d0ad66649b7804978ff192ed1e6c6b5e6e2c0 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 23 Nov 2021 09:12:36 -0800
Subject: [PATCH 164/246] Support invert_mask in qsimcirq

---
 qsimcirq/qsim_simulator.py      |  8 ++++++--
 qsimcirq_tests/qsimcirq_test.py | 27 +++++++++++++++++++++++++++
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 8e17ee8a..bd47eb33 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -379,8 +379,9 @@ def _sample_measure_results(
             for i in range(repetitions):
                 for key, op in meas_ops.items():
                     meas_indices = [qubit_map[qubit] for qubit in op.qubits]
+                    invert_mask = op.gate.invert_mask
                     for j, q in enumerate(meas_indices):
-                        results[key][i][j] = full_results[i][q]
+                        results[key][i][j] = full_results[i][q] ^ invert_mask[j]
         else:
             options["c"] = self._translate_circuit(
                 program,
@@ -391,8 +392,11 @@ def _sample_measure_results(
                 options["s"] = self.get_seed()
                 measurements = sampler_fn(options)
                 for key, bound in bounds.items():
+                    invert_mask = meas_ops[key].gate.invert_mask
                     for j in range(bound[1] - bound[0]):
-                        results[key][i][j] = int(measurements[bound[0] + j])
+                        results[key][i][j] = int(
+                            measurements[bound[0] + j] ^ invert_mask[j]
+                        )
 
         return results
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 0287d548..048b2ab6 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -361,6 +361,33 @@ def test_cirq_qsim_run(mode: str):
         assert value.shape == (5, 1)
 
 
+def test_qsim_invert_mask():
+    q0, q1 = cirq.LineQubit.range(2)
+    circuit = cirq.Circuit(
+        cirq.measure(q0, q1, key="d", invert_mask=[False, True]),
+    )
+    cirq_sample = cirq.Simulator().sample(circuit, repetitions=5)
+    qsim_sample = qsimcirq.QSimSimulator().sample(circuit, repetitions=5)
+    assert qsim_sample.equals(cirq_sample)
+
+
+def test_qsim_invert_mask_intermediate_measure():
+    q0, q1 = cirq.LineQubit.range(2)
+    # The dataframe generated by this should be all zeroes.
+    circuit = cirq.Circuit(
+        cirq.measure(q0, q1, key="a", invert_mask=[False, False]),
+        cirq.X(q0),
+        cirq.measure(q0, q1, key="b", invert_mask=[True, False]),
+        cirq.X(q1),
+        cirq.measure(q0, q1, key="c", invert_mask=[True, True]),
+        cirq.X(q0),
+        cirq.measure(q0, q1, key="d", invert_mask=[False, True]),
+    )
+    cirq_sample = cirq.Simulator().sample(circuit, repetitions=5)
+    qsim_sample = qsimcirq.QSimSimulator().sample(circuit, repetitions=5)
+    assert qsim_sample.equals(cirq_sample)
+
+
 @pytest.mark.parametrize("mode", ["noiseless", "noisy"])
 def test_qsim_run_vs_cirq_run(mode: str):
     # Simple circuit, want to check mapping of qubit(s) to their measurements

From fee4f3909bd1ea6ff3f7beb1984c75eeef4d4b5f Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 23 Nov 2021 09:21:13 -0800
Subject: [PATCH 165/246] More coverage

---
 qsimcirq_tests/qsimcirq_test.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 048b2ab6..2ccccd7d 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -371,6 +371,19 @@ def test_qsim_invert_mask():
     assert qsim_sample.equals(cirq_sample)
 
 
+def test_qsim_invert_mask_different_qubits():
+    q0, q1 = cirq.LineQubit.range(2)
+    circuit = cirq.Circuit(
+        cirq.measure(q1, key="a", invert_mask=[True]),
+        cirq.measure(q0, key="b", invert_mask=[True]),
+        cirq.measure(q0, q1, key="c", invert_mask=[False, True]),
+        cirq.measure(q1, q0, key="d", invert_mask=[False, True]),
+    )
+    cirq_sample = cirq.Simulator().sample(circuit, repetitions=5)
+    qsim_sample = qsimcirq.QSimSimulator().sample(circuit, repetitions=5)
+    assert qsim_sample.equals(cirq_sample)
+
+
 def test_qsim_invert_mask_intermediate_measure():
     q0, q1 = cirq.LineQubit.range(2)
     # The dataframe generated by this should be all zeroes.

From 25b838c7678dad038f589acf8e1ea4a82ca4367f Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 23 Nov 2021 09:40:26 -0800
Subject: [PATCH 166/246] Rescue tests with full_invert_mask

---
 qsimcirq/qsim_simulator.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index bd47eb33..d4ef424d 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -379,7 +379,7 @@ def _sample_measure_results(
             for i in range(repetitions):
                 for key, op in meas_ops.items():
                     meas_indices = [qubit_map[qubit] for qubit in op.qubits]
-                    invert_mask = op.gate.invert_mask
+                    invert_mask = op.gate.full_invert_mask()
                     for j, q in enumerate(meas_indices):
                         results[key][i][j] = full_results[i][q] ^ invert_mask[j]
         else:
@@ -392,7 +392,7 @@ def _sample_measure_results(
                 options["s"] = self.get_seed()
                 measurements = sampler_fn(options)
                 for key, bound in bounds.items():
-                    invert_mask = meas_ops[key].gate.invert_mask
+                    invert_mask = meas_ops[key].gate.full_invert_mask()
                     for j in range(bound[1] - bound[0]):
                         results[key][i][j] = int(
                             measurements[bound[0] + j] ^ invert_mask[j]

From 4ede564da3611174c8f5e9151fe3916b8bb355d9 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 30 Nov 2021 09:31:18 -0800
Subject: [PATCH 167/246] Optimize triple-loops.

---
 qsimcirq/qsim_simulator.py | 37 ++++++++++++++++++++++++-------------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index d4ef424d..b929e441 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -376,27 +376,38 @@ def _sample_measure_results(
                 seed=self._prng,
             )
 
-            for i in range(repetitions):
-                for key, op in meas_ops.items():
-                    meas_indices = [qubit_map[qubit] for qubit in op.qubits]
-                    invert_mask = op.gate.full_invert_mask()
-                    for j, q in enumerate(meas_indices):
-                        results[key][i][j] = full_results[i][q] ^ invert_mask[j]
+            for key, op in meas_ops.items():
+                meas_indices = [qubit_map[qubit] for qubit in op.qubits]
+                invert_mask = op.gate.full_invert_mask()
+                for j, q in enumerate(meas_indices):
+                    results[key][:, j] = np.logical_xor(
+                        full_results[:, q],
+                        invert_mask[j],
+                    )
+
         else:
             options["c"] = self._translate_circuit(
                 program,
                 translator_fn_name,
                 cirq.QubitOrder.DEFAULT,
             )
+            measurements = np.empty(
+                shape=(
+                    repetitions,
+                    sum(cirq.num_qubits(op) for op in meas_ops.values())
+                )
+            )
             for i in range(repetitions):
                 options["s"] = self.get_seed()
-                measurements = sampler_fn(options)
-                for key, bound in bounds.items():
-                    invert_mask = meas_ops[key].gate.full_invert_mask()
-                    for j in range(bound[1] - bound[0]):
-                        results[key][i][j] = int(
-                            measurements[bound[0] + j] ^ invert_mask[j]
-                        )
+                measurements[i] = sampler_fn(options)
+
+            for key, bound in bounds.items():
+                invert_mask = meas_ops[key].gate.full_invert_mask()
+                for j in range(bound[1] - bound[0]):
+                    results[key][:, j] = np.logical_xor(
+                        measurements[:, bound[0] + j],
+                        invert_mask[j]
+                    )
 
         return results
 

From 3019cf205e5c79609f0281c30e1263dd70d9d503 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 30 Nov 2021 09:54:00 -0800
Subject: [PATCH 168/246] Further optimization for single-pass circuits.

---
 qsimcirq/qsim_simulator.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index b929e441..f68ef227 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -379,11 +379,9 @@ def _sample_measure_results(
             for key, op in meas_ops.items():
                 meas_indices = [qubit_map[qubit] for qubit in op.qubits]
                 invert_mask = op.gate.full_invert_mask()
-                for j, q in enumerate(meas_indices):
-                    results[key][:, j] = np.logical_xor(
-                        full_results[:, q],
-                        invert_mask[j],
-                    )
+                # Match result order to order in ops, then apply invert mask
+                permuted_results = full_results[:, meas_indices]
+                results[key] = np.logical_xor(permuted_results, invert_mask)
 
         else:
             options["c"] = self._translate_circuit(

From 15e661b385ea044fe185cfa0fc0a779f1106a5cb Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 30 Nov 2021 10:23:37 -0800
Subject: [PATCH 169/246] Further optimization for multi-pass circuits.

---
 qsimcirq/qsim_simulator.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index f68ef227..0d0ff1e2 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -401,11 +401,9 @@ def _sample_measure_results(
 
             for key, bound in bounds.items():
                 invert_mask = meas_ops[key].gate.full_invert_mask()
-                for j in range(bound[1] - bound[0]):
-                    results[key][:, j] = np.logical_xor(
-                        measurements[:, bound[0] + j],
-                        invert_mask[j]
-                    )
+                permutation = list(range(bound[0], bound[1]))
+                permuted_measurements = measurements[:, permutation]
+                results[key] = np.logical_xor(permuted_measurements, invert_mask)
 
         return results
 

From cf4e1d4ea9dd2252147abdf754cd5887af4ce82e Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 30 Nov 2021 10:39:09 -0800
Subject: [PATCH 170/246] formatting

---
 qsimcirq/qsim_simulator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 0d0ff1e2..904b06d1 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -392,7 +392,7 @@ def _sample_measure_results(
             measurements = np.empty(
                 shape=(
                     repetitions,
-                    sum(cirq.num_qubits(op) for op in meas_ops.values())
+                    sum(cirq.num_qubits(op) for op in meas_ops.values()),
                 )
             )
             for i in range(repetitions):

From 4cb6217df8298a70b000c7949d44ca99419c7fe8 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Tue, 30 Nov 2021 23:10:21 +0100
Subject: [PATCH 171/246] Update simulators.

---
 lib/BUILD                              |   18 +-
 lib/simulator.h                        |  471 ++
 lib/simulator_avx.h                    | 7887 ++-------------------
 lib/simulator_avx512.h                 | 8724 +-----------------------
 lib/simulator_basic.h                  | 1233 +---
 lib/simulator_sse.h                    | 6071 ++---------------
 pybind_interface/Makefile              |    2 +-
 pybind_interface/avx512/CMakeLists.txt |    2 +-
 tests/make.sh                          |   15 +-
 9 files changed, 2014 insertions(+), 22409 deletions(-)
 create mode 100644 lib/simulator.h

diff --git a/lib/BUILD b/lib/BUILD
index 99c93e96..e40a58d3 100644
--- a/lib/BUILD
+++ b/lib/BUILD
@@ -40,6 +40,7 @@ cc_library(
         "run_qsimh.h",
         "seqfor.h",
         "simmux.h",
+        "simulator.h",
         "simulator_avx.h",
         "simulator_avx512.h",
         "simulator_basic.h",
@@ -97,6 +98,7 @@ cc_library(
         "run_qsimh.h",
         "seqfor.h",
         "simmux.h",
+        "simulator.h",
         "simulator_avx.h",
         "simulator_avx512.h",
         "simulator_basic.h",
@@ -149,6 +151,7 @@ cc_library(
         "run_qsim.h",
         "seqfor.h",
         "simmux.h",
+        "simulator.h",
         "simulator_avx.h",
         "simulator_avx512.h",
         "simulator_basic.h",
@@ -194,6 +197,7 @@ cc_library(
         "run_qsimh.h",
         "seqfor.h",
         "simmux.h",
+        "simulator.h",
         "simulator_avx.h",
         "simulator_avx512.h",
         "simulator_basic.h",
@@ -465,11 +469,17 @@ cc_library(
 
 ### Simulator libraries ###
 
+cc_library(
+    name = "simulator_base",
+    hdrs = ["simulator.h"],
+    deps = [":bits"],
+)
+
 cc_library(
     name = "simulator_avx",
     hdrs = ["simulator_avx.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":statespace_avx",
     ],
 )
@@ -478,7 +488,7 @@ cc_library(
     name = "simulator_avx512",
     hdrs = ["simulator_avx512.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":statespace_avx512",
     ],
 )
@@ -487,7 +497,7 @@ cc_library(
     name = "simulator_basic",
     hdrs = ["simulator_basic.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":statespace_basic",
     ],
 )
@@ -496,7 +506,7 @@ cc_library(
     name = "simulator_sse",
     hdrs = ["simulator_sse.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":statespace_sse",
     ],
 )
diff --git a/lib/simulator.h b/lib/simulator.h
new file mode 100644
index 00000000..a5b799f5
--- /dev/null
+++ b/lib/simulator.h
@@ -0,0 +1,471 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef SIMULATOR_H_
+#define SIMULATOR_H_
+
+#include <cstdint>
+
+#include "bits.h"
+
+namespace qsim {
+
+/**
+ * Base class for simulator classes.
+ */
+class SimulatorBase {
+ protected:
+  template <unsigned H, unsigned L = 0>
+  static void FillIndices(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          uint64_t* ms, uint64_t* xss) {
+    constexpr unsigned hsize = 1 << H;
+
+    uint64_t xs[H];
+
+    xs[0] = uint64_t{1} << (qs[L] + 1);
+    ms[0] = (uint64_t{1} << qs[L]) - 1;
+    for (unsigned i = 1; i < H; ++i) {
+      xs[i] = uint64_t{1} << (qs[L + i] + 1);
+      ms[i] = ((uint64_t{1} << qs[L + i]) - 1) ^ (xs[i - 1] - 1);
+    }
+    ms[H] = ((uint64_t{1} << num_qubits) - 1) ^ (xs[H - 1] - 1);
+
+    for (unsigned i = 0; i < hsize; ++i) {
+      uint64_t a = 0;
+      for (uint64_t k = 0; k < H; ++k) {
+        a += xs[k] * ((i >> k) & 1);
+      }
+      xss[i] = a;
+    }
+  }
+
+  template <unsigned H, unsigned L, unsigned R, typename fp_type>
+  static void FillMatrix(unsigned qmaskl, const fp_type* matrix, fp_type* w) {
+    constexpr unsigned gsize = 1 << (H + L);
+    constexpr unsigned hsize = 1 << H;
+    constexpr unsigned lsize = 1 << L;
+    constexpr unsigned rsize = 1 << R;
+
+    unsigned s = 0;
+
+    for (unsigned i = 0; i < hsize; ++i) {
+      for (unsigned j = 0; j < gsize; ++j) {
+        unsigned p0 = 2 * i * lsize * gsize + 2 * lsize * (j / lsize);
+
+        for (unsigned k = 0; k < rsize; ++k) {
+          unsigned l = bits::CompressBits(k, R, qmaskl);
+          unsigned p = p0 + 2 * (gsize * l + (j + l) % lsize);
+
+          w[s + 0] = matrix[p];
+          w[s + rsize] = matrix[p + 1];
+
+          ++s;
+        }
+
+        s += rsize;
+      }
+    }
+  }
+
+  template <unsigned H, unsigned R, typename fp_type>
+  static void FillControlledMatrixH(uint64_t cvalsl, uint64_t cmaskl,
+                                    const fp_type* matrix, fp_type* w) {
+    constexpr unsigned hsize = 1 << H;
+    constexpr unsigned rsize = 1 << R;
+
+    unsigned s = 0;
+
+    for (unsigned i = 0; i < hsize; ++i) {
+      for (unsigned j = 0; j < hsize; ++j) {
+        unsigned p = hsize * i + j;
+        fp_type v = i == j ? 1 : 0;
+
+        for (unsigned k = 0; k < rsize; ++k) {
+          w[s] = cvalsl == (k & cmaskl) ? matrix[2 * p] : v;
+          w[s + rsize] = cvalsl == (k & cmaskl) ? matrix[2 * p + 1] : 0;
+
+          ++s;
+        }
+
+        s += rsize;
+      }
+    }
+  }
+
+  template <unsigned H, unsigned L, unsigned R, typename fp_type>
+  static void FillControlledMatrixL(uint64_t cvalsl, uint64_t cmaskl,
+                                    unsigned qmaskl, const fp_type* matrix,
+                                    fp_type* w) {
+    constexpr unsigned gsize = 1 << (H + L);
+    constexpr unsigned hsize = 1 << H;
+    constexpr unsigned lsize = 1 << L;
+    constexpr unsigned rsize = 1 << R;
+
+    unsigned s = 0;
+
+    for (unsigned i = 0; i < hsize; ++i) {
+      for (unsigned j = 0; j < gsize; ++j) {
+        unsigned p0 = i * lsize * gsize + lsize * (j / lsize);
+
+        for (unsigned k = 0; k < rsize; ++k) {
+          unsigned l = bits::CompressBits(k, R, qmaskl);
+          unsigned p = p0 + gsize * l + (j + l) % lsize;
+
+          fp_type v = p / gsize == p % gsize ? 1 : 0;
+
+          w[s] = cvalsl == (k & cmaskl) ? matrix[2 * p] : v;
+          w[s + rsize] = cvalsl == (k & cmaskl) ? matrix[2 * p + 1] : 0;
+
+          ++s;
+        }
+
+        s += rsize;
+      }
+    }
+  }
+
+  struct Masks1 {
+    uint64_t imaskh;
+    uint64_t qmaskh;
+  };
+
+  template <unsigned H, unsigned R>
+  static Masks1 GetMasks1(const std::vector<unsigned>& qs) {
+    uint64_t qmaskh = 0;
+
+    for (unsigned i = 0; i < H; ++i) {
+      qmaskh |= uint64_t{1} << qs[i];
+    }
+
+    return {2 * (~qmaskh ^ ((1 << R) - 1)), 2 * qmaskh};
+  }
+
+  struct Masks2 {
+    uint64_t imaskh;
+    uint64_t qmaskh;
+    unsigned qmaskl;
+  };
+
+  template <unsigned H, unsigned L, unsigned R>
+  static Masks2 GetMasks2(const std::vector<unsigned>& qs) {
+    uint64_t qmaskh = 0;
+    unsigned qmaskl = 0;
+
+    for (unsigned i = 0; i < L; ++i) {
+      qmaskl |= 1 << qs[i];
+    }
+
+    for (unsigned i = L; i < H + L; ++i) {
+      qmaskh |= uint64_t{1} << qs[i];
+    }
+
+    return {2 * (~qmaskh ^ ((1 << R) - 1)), 2 * qmaskh, qmaskl};
+  }
+
+  struct Masks3 {
+    uint64_t imaskh;
+    uint64_t qmaskh;
+    uint64_t cvalsh;
+  };
+
+  template <unsigned H, unsigned R>
+  static Masks3 GetMasks3(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          const std::vector<unsigned>& cqs, uint64_t cvals) {
+    uint64_t qmaskh = 0;
+    uint64_t cmaskh = 0;
+
+    for (unsigned i = 0; i < H; ++i) {
+      qmaskh |= uint64_t{1} << qs[i];
+    }
+
+    for (auto q : cqs) {
+      cmaskh |= uint64_t{1} << q;
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals, num_qubits, cmaskh);
+
+    uint64_t maskh = ~(qmaskh | cmaskh) ^ ((1 << R) - 1);
+
+    return {2 * maskh, 2 * qmaskh, 2 * cvalsh};
+  }
+
+  struct Masks4 {
+    uint64_t imaskh;
+    uint64_t qmaskh;
+    uint64_t cvalsh;
+    uint64_t cvalsl;
+    uint64_t cmaskl;
+    unsigned cl;
+  };
+
+  template <unsigned H, unsigned R>
+  static Masks4 GetMasks4(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          const std::vector<unsigned>& cqs, uint64_t cvals) {
+    unsigned cl = 0;
+    uint64_t qmaskh = 0;
+    uint64_t cmaskh = 0;
+    uint64_t cmaskl = 0;
+
+    for (unsigned i = 0; i < H; ++i) {
+      qmaskh |= uint64_t{1} << qs[i];
+    }
+
+    for (auto q : cqs) {
+      if (q >= R) {
+        cmaskh |= uint64_t{1} << q;
+      } else {
+        ++cl;
+        cmaskl |= uint64_t{1} << q;
+      }
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals >> cl, num_qubits, cmaskh);
+    uint64_t cvalsl = bits::ExpandBits(cvals & ((1 << cl) - 1), R, cmaskl);
+
+    uint64_t maskh = ~(qmaskh | cmaskh) ^ ((1 << R) - 1);
+
+    return {2 * maskh, 2 * qmaskh, 2 * cvalsh, cvalsl, cmaskl, cl};
+  }
+
+  struct Masks5 {
+    uint64_t imaskh;
+    uint64_t qmaskh;
+    uint64_t cvalsh;
+    unsigned qmaskl;
+  };
+
+  template <unsigned H, unsigned L, unsigned R>
+  static Masks5 GetMasks5(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          const std::vector<unsigned>& cqs, uint64_t cvals) {
+    uint64_t qmaskh = 0;
+    uint64_t cmaskh = 0;
+    unsigned qmaskl = 0;
+
+    for (unsigned i = 0; i < L; ++i) {
+      qmaskl |= 1 << qs[i];
+    }
+
+    for (unsigned i = L; i < H + L; ++i) {
+      qmaskh |= uint64_t{1} << qs[i];
+    }
+
+    for (auto q : cqs) {
+      cmaskh |= uint64_t{1} << q;
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals, num_qubits, cmaskh);
+
+    uint64_t maskh = ~(qmaskh | cmaskh) ^ ((1 << R) - 1);
+
+    return {2 * maskh, 2 * qmaskh, 2 * cvalsh, qmaskl};
+  }
+
+  struct Masks6 {
+    uint64_t imaskh;
+    uint64_t qmaskh;
+    uint64_t cvalsh;
+    uint64_t cvalsl;
+    uint64_t cmaskl;
+    unsigned qmaskl;
+    unsigned cl;
+  };
+
+  template <unsigned H, unsigned L, unsigned R>
+  static Masks6 GetMasks6(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          const std::vector<unsigned>& cqs, uint64_t cvals) {
+    unsigned cl = 0;
+    uint64_t qmaskh = 0;
+    uint64_t cmaskh = 0;
+    uint64_t cmaskl = 0;
+    unsigned qmaskl = 0;
+
+    for (unsigned i = 0; i < L; ++i) {
+      qmaskl |= 1 << qs[i];
+    }
+
+    for (unsigned i = L; i < H + L; ++i) {
+      qmaskh |= uint64_t{1} << qs[i];
+    }
+
+    for (auto q : cqs) {
+      if (q >= R) {
+        cmaskh |= uint64_t{1} << q;
+      } else {
+        ++cl;
+        cmaskl |= uint64_t{1} << q;
+      }
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals >> cl, num_qubits, cmaskh);
+    uint64_t cvalsl = bits::ExpandBits(cvals & ((1 << cl) - 1), R, cmaskl);
+
+    uint64_t maskh = ~(qmaskh | cmaskh) ^ ((1 << R) - 1);
+
+    return {2 * maskh, 2 * qmaskh, 2 * cvalsh, cvalsl, cmaskl, qmaskl, cl};
+  }
+
+  struct Masks7 {
+    uint64_t cvalsh;
+    uint64_t cmaskh;
+  };
+
+  static Masks7 GetMasks7(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          const std::vector<unsigned>& cqs, uint64_t cvals) {
+    uint64_t cmaskh = 0;
+
+    for (auto q : cqs) {
+      cmaskh |= uint64_t{1} << q;
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals, num_qubits, cmaskh);
+
+    return {cvalsh, cmaskh};
+  }
+
+  struct Masks8 {
+    uint64_t cvalsh;
+    uint64_t cmaskh;
+    uint64_t cvalsl;
+    uint64_t cmaskl;
+  };
+
+  template <unsigned R>
+  static Masks8 GetMasks8(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          const std::vector<unsigned>& cqs, uint64_t cvals) {
+    unsigned cl = 0;
+    uint64_t cmaskh = 0;
+    uint64_t cmaskl = 0;
+
+    for (auto q : cqs) {
+      if (q >= R) {
+        cmaskh |= uint64_t{1} << q;
+      } else {
+        ++cl;
+        cmaskl |= uint64_t{1} << q;
+      }
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals >> cl, num_qubits, cmaskh);
+    uint64_t cvalsl = bits::ExpandBits(cvals & ((1 << cl) - 1), R, cmaskl);
+
+    return {cvalsh, cmaskh, cvalsl, cmaskl};
+  }
+
+  struct Masks9 {
+    uint64_t cvalsh;
+    uint64_t cmaskh;
+    unsigned qmaskl;
+  };
+
+  template <unsigned L>
+  static Masks9 GetMasks9(unsigned num_qubits, const std::vector<unsigned>& qs,
+                          const std::vector<unsigned>& cqs, uint64_t cvals) {
+    uint64_t cmaskh = 0;
+    unsigned qmaskl = 0;
+
+    for (unsigned i = 0; i < L; ++i) {
+      qmaskl |= 1 << qs[i];
+    }
+
+    for (auto q : cqs) {
+      cmaskh |= uint64_t{1} << q;
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals, num_qubits, cmaskh);
+
+    return {cvalsh, cmaskh, qmaskl};
+  }
+
+  struct Masks10 {
+    uint64_t cvalsh;
+    uint64_t cmaskh;
+    uint64_t cvalsl;
+    uint64_t cmaskl;
+    unsigned qmaskl;
+  };
+
+  template <unsigned L, unsigned R>
+  static Masks10 GetMasks10(unsigned num_qubits,
+                            const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals) {
+    unsigned cl = 0;
+    uint64_t cmaskh = 0;
+    uint64_t cmaskl = 0;
+    unsigned qmaskl = 0;
+
+    for (unsigned i = 0; i < L; ++i) {
+      qmaskl |= 1 << qs[i];
+    }
+
+    for (auto q : cqs) {
+      if (q >= R) {
+        cmaskh |= uint64_t{1} << q;
+      } else {
+        ++cl;
+        cmaskl |= uint64_t{1} << q;
+      }
+    }
+
+    uint64_t cvalsh = bits::ExpandBits(cvals >> cl, num_qubits, cmaskh);
+    uint64_t cvalsl = bits::ExpandBits(cvals & ((1 << cl) - 1), R, cmaskl);
+
+    return {cvalsh, cmaskh, cvalsl, cmaskl, qmaskl};
+  }
+
+  template <unsigned L>
+  static unsigned GetQMask(const std::vector<unsigned>& qs) {
+    unsigned qmaskl = 0;
+
+    for (unsigned i = 0; i < L; ++i) {
+      qmaskl |= 1 << qs[i];
+    }
+
+    return qmaskl;
+  }
+
+  template <unsigned R>
+  static unsigned MaskedAdd(
+      unsigned a, unsigned b, unsigned mask, unsigned lsize) {
+    unsigned c = bits::CompressBits(a, R, mask);
+    return bits::ExpandBits((c + b) % lsize, R, mask);
+  }
+};
+
+template <>
+inline void SimulatorBase::FillIndices<0, 1>(unsigned num_qubits,
+                                             const std::vector<unsigned>& qs,
+                                             uint64_t* ms, uint64_t* xss) {
+  ms[0] = -1;
+  xss[0] = 0;
+}
+
+template <>
+inline void SimulatorBase::FillIndices<0, 2>(unsigned num_qubits,
+                                             const std::vector<unsigned>& qs,
+                                             uint64_t* ms, uint64_t* xss) {
+  ms[0] = -1;
+  xss[0] = 0;
+}
+
+template <>
+inline void SimulatorBase::FillIndices<0, 3>(unsigned num_qubits,
+                                             const std::vector<unsigned>& qs,
+                                             uint64_t* ms, uint64_t* xss) {
+  ms[0] = -1;
+  xss[0] = 0;
+}
+
+}  // namespace qsim
+
+#endif  // SIMULATOR_H_
diff --git a/lib/simulator_avx.h b/lib/simulator_avx.h
index f0dbaa5e..cb596808 100644
--- a/lib/simulator_avx.h
+++ b/lib/simulator_avx.h
@@ -17,11 +17,12 @@
 
 #include <immintrin.h>
 
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "statespace_avx.h"
 
 namespace qsim {
@@ -30,7 +31,7 @@ namespace qsim {
  * Quantum circuit simulator with AVX vectorization.
  */
 template <typename For>
-class SimulatorAVX final {
+class SimulatorAVX final : public SimulatorBase {
  public:
   using StateSpace = StateSpaceAVX<For>;
   using State = typename StateSpace::State;
@@ -52,62 +53,62 @@ class SimulatorAVX final {
     switch (qs.size()) {
     case 1:
       if (qs[0] > 2) {
-        ApplyGate1H(qs, matrix, state);
+        ApplyGateH<1>(qs, matrix, state);
       } else {
-        ApplyGate1L(qs, matrix, state);
+        ApplyGateL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 2) {
-        ApplyGate2HH(qs, matrix, state);
+        ApplyGateH<2>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate2HL(qs, matrix, state);
+        ApplyGateL<1, 1>(qs, matrix, state);
       } else {
-        ApplyGate2LL(qs, matrix, state);
+        ApplyGateL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 2) {
-        ApplyGate3HHH(qs, matrix, state);
+        ApplyGateH<3>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate3HHL(qs, matrix, state);
+        ApplyGateL<2, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate3HLL(qs, matrix, state);
+        ApplyGateL<1, 2>(qs, matrix, state);
       } else {
-        ApplyGate3LLL(qs, matrix, state);
+        ApplyGateL<0, 3>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 2) {
-        ApplyGate4HHHH(qs, matrix, state);
+        ApplyGateH<4>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate4HHHL(qs, matrix, state);
+        ApplyGateL<3, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate4HHLL(qs, matrix, state);
+        ApplyGateL<2, 2>(qs, matrix, state);
       } else {
-        ApplyGate4HLLL(qs, matrix, state);
+        ApplyGateL<1, 3>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 2) {
-        ApplyGate5HHHHH(qs, matrix, state);
+        ApplyGateH<5>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate5HHHHL(qs, matrix, state);
+        ApplyGateL<4, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate5HHHLL(qs, matrix, state);
+        ApplyGateL<3, 2>(qs, matrix, state);
       } else {
-        ApplyGate5HHLLL(qs, matrix, state);
+        ApplyGateL<2, 3>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 2) {
-        ApplyGate6HHHHHH(qs, matrix, state);
+        ApplyGateH<6>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate6HHHHHL(qs, matrix, state);
+        ApplyGateL<5, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate6HHHHLL(qs, matrix, state);
+        ApplyGateL<4, 2>(qs, matrix, state);
       } else {
-        ApplyGate6HHHLLL(qs, matrix, state);
+        ApplyGateL<3, 3>(qs, matrix, state);
       }
       break;
     default:
@@ -120,13 +121,16 @@ class SimulatorAVX final {
    * Applies a controlled gate using AVX instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
                            const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+    // Assume cqs[0] < cqs[1] < cqs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -136,90 +140,90 @@ class SimulatorAVX final {
     case 1:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate1H_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1H_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<1>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate1L_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1L_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 2:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate2HH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<2>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<2>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate2HL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate2LL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2LL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 3:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate3HHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<3>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<3>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate3HHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate3HLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate3LLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3LLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 4:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HHHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<4>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<4>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HHHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HHLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HLLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HLLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
@@ -244,62 +248,62 @@ class SimulatorAVX final {
     switch (qs.size()) {
     case 1:
       if (qs[0] > 2) {
-        return ExpectationValue1H(qs, matrix, state);
+        return ExpectationValueH<1>(qs, matrix, state);
       } else {
-        return ExpectationValue1L(qs, matrix, state);
+        return ExpectationValueL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 2) {
-        return ExpectationValue2HH(qs, matrix, state);
+        return ExpectationValueH<2>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        return ExpectationValue2HL(qs, matrix, state);
+        return ExpectationValueL<1, 1>(qs, matrix, state);
       } else {
-        return ExpectationValue2LL(qs, matrix, state);
+        return ExpectationValueL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 2) {
-        return ExpectationValue3HHH(qs, matrix, state);
+        return ExpectationValueH<3>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        return ExpectationValue3HHL(qs, matrix, state);
+        return ExpectationValueL<2, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        return ExpectationValue3HLL(qs, matrix, state);
+        return ExpectationValueL<1, 2>(qs, matrix, state);
       } else {
-        return ExpectationValue3LLL(qs, matrix, state);
+        return ExpectationValueL<0, 3>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 2) {
-        return ExpectationValue4HHHH(qs, matrix, state);
+        return ExpectationValueH<4>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        return ExpectationValue4HHHL(qs, matrix, state);
+        return ExpectationValueL<3, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        return ExpectationValue4HHLL(qs, matrix, state);
+        return ExpectationValueL<2, 2>(qs, matrix, state);
       } else {
-        return ExpectationValue4HLLL(qs, matrix, state);
+        return ExpectationValueL<1, 3>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 2) {
-        return ExpectationValue5HHHHH(qs, matrix, state);
+        return ExpectationValueH<5>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        return ExpectationValue5HHHHL(qs, matrix, state);
+        return ExpectationValueL<4, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        return ExpectationValue5HHHLL(qs, matrix, state);
+        return ExpectationValueL<3, 2>(qs, matrix, state);
       } else {
-        return ExpectationValue5HHLLL(qs, matrix, state);
+        return ExpectationValueL<2, 3>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 2) {
-        return ExpectationValue6HHHHHH(qs, matrix, state);
+        return ExpectationValueH<6>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        return ExpectationValue6HHHHHL(qs, matrix, state);
+        return ExpectationValueL<5, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        return ExpectationValue6HHHHLL(qs, matrix, state);
+        return ExpectationValueL<4, 2>(qs, matrix, state);
       } else {
-        return ExpectationValue6HHHLLL(qs, matrix, state);
+        return ExpectationValueL<3, 3>(qs, matrix, state);
       }
       break;
     default:
@@ -318,44 +322,31 @@ class SimulatorAVX final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
 
+#ifdef __BMI2__
+
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 ru, iu, rn, in;
-      __m256 rs[2], is[2];
+      __m256 rs[hsize], is[hsize];
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+        rs[k] = _mm256_load_ps(p0 + p);
+        is[k] = _mm256_load_ps(p0 + p + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm256_set1_ps(v[j]);
         iu = _mm256_set1_ps(v[j + 1]);
         rn = _mm256_mul_ps(rs[0], ru);
@@ -365,89 +356,64 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm256_set1_ps(v[j]);
           iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks1<H, 3>(qs);
 
-    unsigned k = 4;
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, m.imaskh, m.qmaskh, state.get());
   }
 
-  void ApplyGate1L(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, const __m256i* idx,
+                fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m256 rn, in;
-      __m256 rs[2], is[2];
+      __m256 rs[gsize], is[gsize];
+
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-      auto p0 = rstate + 16 * i;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0);
-        is[2 * l] = _mm256_load_ps(p0 + 8);
+        rs[k2] = _mm256_load_ps(p0 + p);
+        is[k2] = _mm256_load_ps(p0 + p + 8);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -455,71 +421,60 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    auto m = GetMasks2<H, L, 3>(qs);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 3 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, idx, rstate);
+    for_.Run(size, f, w, m.imaskh, m.qmaskh, idx, state.get());
   }
 
-  void ApplyGate2HH(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 ru, iu, rn, in;
-      __m256 rs[4], is[4];
+      __m256 rs[hsize], is[hsize];
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
+      auto p0 = rstate + (_pdep_u64(i, imaskh) | cvalsh);
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+        rs[k] = _mm256_load_ps(p0 + p);
+        is[k] = _mm256_load_ps(p0 + p + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm256_set1_ps(v[j]);
         iu = _mm256_set1_ps(v[j + 1]);
         rn = _mm256_mul_ps(rs[0], ru);
@@ -529,110 +484,124 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm256_set1_ps(v[j]);
           iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks3<H, 3>(state.num_qubits(), qs, cqs, cvals);
 
-    unsigned k = 5;
+    unsigned k = 3 + H + cqs.size();
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, m.imaskh, m.qmaskh, m.cvalsh, state.get());
   }
 
-  void ApplyGate2HL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
+                fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    unsigned p[8];
-    __m256i idx[1];
+      __m256 rn, in;
+      __m256 rs[hsize], is[hsize];
 
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
+      auto p0 = rstate + (_pdep_u64(i, imaskh) | cvalsh);
 
-    unsigned qmask = (1 << qs[0]);
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
+        rs[k] = _mm256_load_ps(p0 + p);
+        is[k] = _mm256_load_ps(p0 + p + 8);
       }
 
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
+      uint64_t j = 0;
 
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
+      for (unsigned k = 0; k < hsize; ++k) {
+        rn = _mm256_mul_ps(rs[0], w[j]);
+        in = _mm256_mul_ps(rs[0], w[j + 1]);
+        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
+        in = _mm256_fmadd_ps(is[0], w[j], in);
+
+        j += 2;
 
-        unsigned l = 2 * (4 * i + m);
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
+          j += 2;
         }
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
-    }
+    };
+
+    __m256 w[1 << (1 + 2 * H)];
+
+    auto m = GetMasks4<H, 3>(state.num_qubits(), qs, cqs, cvals);
+    FillControlledMatrixH<H, 3>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 3 + H + cqs.size() - m.cl;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
+    uint64_t size = uint64_t{1} << n;
+
+    for_.Run(size, f, w, m.imaskh, m.qmaskh, m.cvalsh, state.get());
+  }
 
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 const __m256i* idx, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m256 rn, in;
-      __m256 rs[4], is[4];
+      __m256 rs[gsize], is[gsize];
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
+      auto p0 = rstate + (_pdep_u64(i, imaskh) | cvalsh);
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
+        rs[k2] = _mm256_load_ps(p0 + p);
+        is[k2] = _mm256_load_ps(p0 + p + 8);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -640,87 +609,149 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
+    if (CH) {
+      auto m = GetMasks5<H, L, 3>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
+
+      unsigned r = 3 + H + cqs.size();
+      unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
+      uint64_t size = uint64_t{1} << n;
+
+      for_.Run(size, f, w, m.imaskh, m.qmaskh, m.cvalsh, idx, state.get());
+    } else {
+      auto m = GetMasks6<H, L, 3>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillControlledMatrixL<H, L, 3>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
+
+      unsigned r = 3 + H + cqs.size() - m.cl;
+      unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
+      uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, idx, rstate);
+      for_.Run(size, f, w, m.imaskh, m.qmaskh, m.cvalsh, idx, state.get());
+    }
   }
 
-  void ApplyGate2LL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    unsigned p[8];
-    __m256i idx[3];
+  template <unsigned H>
+  std::complex<double> ExpectationValueH(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
+                uint64_t imaskh, uint64_t qmaskh, const fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    auto s = StateSpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
+      __m256 ru, iu, rn, in;
+      __m256 rs[hsize], is[hsize];
 
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        rs[k] = _mm256_load_ps(p0 + p);
+        is[k] = _mm256_load_ps(p0 + p + 8);
       }
 
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
+      double re = 0;
+      double im = 0;
+      uint64_t j = 0;
 
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
+      for (unsigned k = 0; k < hsize; ++k) {
+        ru = _mm256_set1_ps(v[j]);
+        iu = _mm256_set1_ps(v[j + 1]);
+        rn = _mm256_mul_ps(rs[0], ru);
+        in = _mm256_mul_ps(rs[0], iu);
+        rn = _mm256_fnmadd_ps(is[0], iu, rn);
+        in = _mm256_fmadd_ps(is[0], ru, in);
 
-        unsigned l = 2 * (4 * i + m);
+        j += 2;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+        for (unsigned l = 1; l < hsize; ++l) {
+          ru = _mm256_set1_ps(v[j]);
+          iu = _mm256_set1_ps(v[j + 1]);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
+          j += 2;
         }
+
+        __m256 v_re = _mm256_fmadd_ps(is[k], in, _mm256_mul_ps(rs[k], rn));
+        __m256 v_im = _mm256_fnmadd_ps(is[k], rn, _mm256_mul_ps(rs[k], in));
+
+        re += detail::HorizontalSumAVX(v_re);
+        im += detail::HorizontalSumAVX(v_im);
       }
-    }
 
+      return std::complex<double>{re, im};
+    };
+
+    auto m = GetMasks1<H, 3>(qs);
+
+    unsigned k = 3 + H;
+    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    uint64_t size = uint64_t{1} << n;
+
+    using Op = std::plus<std::complex<double>>;
+    return
+        for_.RunReduce(size, f, Op(), matrix, m.imaskh, m.qmaskh, state.get());
+  }
+
+  template <unsigned H, unsigned L>
+  std::complex<double> ExpectationValueL(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, const __m256i* idx,
+                const fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m256 rn, in;
-      __m256 rs[4], is[4];
+      __m256 rs[gsize], is[gsize];
 
-      auto p0 = rstate + 16 * i;
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0);
-        is[4 * l] = _mm256_load_ps(p0 + 8);
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
+        rs[k2] = _mm256_load_ps(p0 + p);
+        is[k2] = _mm256_load_ps(p0 + p + 8);
+
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
+      double re = 0;
+      double im = 0;
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -728,72 +759,73 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
+        unsigned m = lsize * k;
+
+        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
+        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
+
+        re += detail::HorizontalSumAVX(v_re);
+        im += detail::HorizontalSumAVX(v_im);
       }
+
+      return std::complex<double>{re, im};
     };
 
-    fp_type* rstate = state.get();
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    auto m = GetMasks2<H, L, 3>(qs);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 3 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, idx, rstate);
+    using Op = std::plus<std::complex<double>>;
+    return
+        for_.RunReduce(size, f, Op(), w, m.imaskh, m.qmaskh, idx, state.get());
   }
 
-  void ApplyGate3HHH(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
+#else  // __BMI2__
 
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
+                const uint64_t* ms, const uint64_t* xss, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 ru, iu, rn, in;
-      __m256 rs[8], is[8];
+      __m256 rs[hsize], is[hsize];
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
+      i *= 8;
+
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
+      }
 
-      auto p0 = rstate + 2 * k;
+      auto p0 = rstate + 2 * ii;
 
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm256_load_ps(p0 + xss[k]);
+        is[k] = _mm256_load_ps(p0 + xss[k] + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 8; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm256_set1_ps(v[j]);
         iu = _mm256_set1_ps(v[j + 1]);
         rn = _mm256_mul_ps(rs[0], ru);
@@ -803,114 +835,71 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm256_set1_ps(v[j]);
           iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 6;
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, ms, xss, state.get());
   }
 
-  void ApplyGate3HHL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                const uint64_t* ms, const uint64_t* xss, const __m256i* idx,
+                fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        unsigned l = 2 * (8 * i + m);
+      __m256 rn, in;
+      __m256 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+      i *= 8;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
+      auto p0 = rstate + 2 * ii;
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        rs[k2] = _mm256_load_ps(p0 + xss[k]);
+        is[k2] = _mm256_load_ps(p0 + xss[k] + 8);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -918,108 +907,140 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    unsigned qmaskl = GetQMask<L>(qs);
+
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+    FillPermutationIndices<L>(qmaskl, idx);
+    FillMatrix<H, L, 3>(qmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 3 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, idx, rstate);
+    for_.Run(size, f, w, ms, xss, idx, state.get());
   }
 
-  void ApplyGate3HLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    unsigned p[8];
-    __m256i idx[3];
+      __m256 ru, iu, rn, in;
+      __m256 rs[hsize], is[hsize];
+
+      i *= 8;
 
-    auto s = StateSpace::Create(7);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
+      }
 
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
+      if ((ii & cmaskh) != cvalsh) return;
 
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
+      auto p0 = rstate + 2 * ii;
+
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm256_load_ps(p0 + xss[k]);
+        is[k] = _mm256_load_ps(p0 + xss[k] + 8);
       }
 
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
+      uint64_t j = 0;
 
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
+      for (unsigned k = 0; k < hsize; ++k) {
+        ru = _mm256_set1_ps(v[j]);
+        iu = _mm256_set1_ps(v[j + 1]);
+        rn = _mm256_mul_ps(rs[0], ru);
+        in = _mm256_mul_ps(rs[0], iu);
+        rn = _mm256_fnmadd_ps(is[0], iu, rn);
+        in = _mm256_fmadd_ps(is[0], ru, in);
 
-        unsigned l = 2 * (8 * i + m);
+        j += 2;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+        for (unsigned l = 1; l < hsize; ++l) {
+          ru = _mm256_set1_ps(v[j]);
+          iu = _mm256_set1_ps(v[j + 1]);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
+          j += 2;
         }
+
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
-    }
+    };
+
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+
+    auto m = GetMasks7(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 3 + H;
+    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    uint64_t size = uint64_t{1} << n;
 
+    for_.Run(size, f, matrix, ms, xss, m.cvalsh, m.cmaskh, state.get());
+  }
+
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 rn, in;
-      __m256 rs[8], is[8];
+      __m256 rs[hsize], is[hsize];
+
+      i *= 8;
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
+      }
 
-      auto p0 = rstate + 2 * k;
+      if ((ii & cmaskh) != cvalsh) return;
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
+      auto p0 = rstate + 2 * ii;
 
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm256_load_ps(p0 + xss[k]);
+        is[k] = _mm256_load_ps(p0 + xss[k] + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -1027,87 +1048,76 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m256 w[1 << (1 + 2 * H)];
 
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    auto m = GetMasks8<3>(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+    FillControlledMatrixH<H, 3>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 3 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, idx, rstate);
+    for_.Run(size, f, w, ms, xss, m.cvalsh, m.cmaskh, state.get());
   }
 
-  void ApplyGate3LLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    unsigned p[8];
-    __m256i idx[7];
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, const __m256i* idx, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
+      __m256 rn, in;
+      __m256 rs[gsize], is[gsize];
 
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
+      i *= 8;
 
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
 
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
+      if ((ii & cmaskh) != cvalsh) return;
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
+      auto p0 = rstate + 2 * ii;
 
-      auto p0 = rstate + 16 * i;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0);
-        is[8 * l] = _mm256_load_ps(p0 + 8);
+        rs[k2] = _mm256_load_ps(p0 + xss[k]);
+        is[k2] = _mm256_load_ps(p0 + xss[k] + 8);
 
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -1115,72 +1125,79 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+
+    unsigned r = 3 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, idx, rstate);
-  }
+    if (CH) {
+      auto m = GetMasks9<L>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
 
-  void ApplyGate4HHHH(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
+      for_.Run(size, f, w, ms, xss, m.cvalsh, m.cmaskh, idx, state.get());
+    } else {
+      auto m = GetMasks10<L, 3>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillControlledMatrixL<H, L, 3>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
+      for_.Run(size, f, w, ms, xss, m.cvalsh, m.cmaskh, idx, state.get());
     }
+  }
 
+  template <unsigned H>
+  std::complex<double> ExpectationValueH(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
                 const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
+                const fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 ru, iu, rn, in;
-      __m256 rs[16], is[16];
+      __m256 rs[hsize], is[hsize];
+
+      i *= 8;
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]);
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
+      }
 
-      auto p0 = rstate + 2 * k;
+      auto p0 = rstate + 2 * ii;
 
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm256_load_ps(p0 + xss[k]);
+        is[k] = _mm256_load_ps(p0 + xss[k] + 8);
       }
 
+      double re = 0;
+      double im = 0;
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 16; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm256_set1_ps(v[j]);
         iu = _mm256_set1_ps(v[j + 1]);
         rn = _mm256_mul_ps(rs[0], ru);
@@ -1190,6379 +1207,81 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 16; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm256_set1_ps(v[j]);
           iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        __m256 v_re = _mm256_fmadd_ps(is[k], in, _mm256_mul_ps(rs[k], rn));
+        __m256 v_im = _mm256_fnmadd_ps(is[k], rn, _mm256_mul_ps(rs[k], in));
+
+        re += detail::HorizontalSumAVX(v_re);
+        im += detail::HorizontalSumAVX(v_im);
       }
+
+      return std::complex<double>{re, im};
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 7;
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    using Op = std::plus<std::complex<double>>;
+    return for_.RunReduce(size, f, Op(), matrix, ms, xss, state.get());
   }
 
-  void ApplyGate4HHHL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(10);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate4HHLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(9);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate4HLLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate5HHHHH(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]) | (256 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate5HHHHL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(12);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate5HHHLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(11);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate5HHLLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(10);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (256 * i + 32 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate6HHHHHH(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]) | (256 * i & ms[5])
-          | (512 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate6HHHHHL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(14);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]) | (256 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate6HHHHLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(13);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate6HHHLLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(12);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (512 * i + 64 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyControlledGate1H_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate1H_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = StateSpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (2 * i + 2 * k + m);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate1L_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0);
-        is[2 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate1L_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0);
-        is[2 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2HH_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2HH_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = StateSpace::Create(7);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 4 * k + m);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2HL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2HL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2LL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0);
-        is[4 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2LL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0);
-        is[4 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HHH_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HHH_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = StateSpace::Create(9);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 8 * k + m);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HHL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HHL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(7);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(7);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3LLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0);
-        is[8 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3LLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0);
-        is[8 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = StateSpace::Create(11);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 16 * k + m);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(10);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(10);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(9);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(9);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue1H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue1L(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
-
-      auto p0 = rstate + 16 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0);
-        is[2 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue2HH(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue2HL(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue2LL(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      auto p0 = rstate + 16 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0);
-        is[4 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HHH(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HHL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HLL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(7);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue3LLL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      auto p0 = rstate + 16 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0);
-        is[8 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHHH(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHHL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(10);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHLL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(9);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HLLL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(8);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 8 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHHH(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]) | (256 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHHL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(12);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHLL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(11);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHLLL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = StateSpace::Create(10);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (256 * i + 32 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L>
+  std::complex<double> ExpectationValueL(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 8 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHHH(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
+                const uint64_t* ms, const uint64_t* xss, const __m256i* idx,
                 const fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]) | (256 * i & ms[5])
-          | (512 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m256 v_re = _mm256_fmadd_ps(is[l], in, _mm256_mul_ps(rs[l], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[l], rn, _mm256_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHHL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = StateSpace::Create(14);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
+      __m256 rn, in;
+      __m256 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+      i *= 8;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
 
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]) | (256 * i & ms[5]);
+      auto p0 = rstate + 2 * ii;
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
+        rs[k2] = _mm256_load_ps(p0 + xss[k]);
+        is[k2] = _mm256_load_ps(p0 + xss[k] + 8);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       double re = 0;
       double im = 0;
-
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 32; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -7570,16 +1289,16 @@ class SimulatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        unsigned m = 2 * l;
+        unsigned m = lsize * k;
 
         __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
         __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
@@ -7591,272 +1310,40 @@ class SimulatorAVX final {
       return std::complex<double>{re, im};
     };
 
-    const fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHLL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = StateSpace::Create(13);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]) | (128 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-      return std::complex<double>{re, im};
-    };
+    unsigned qmaskl = GetQMask<L>(qs);
 
-    const fp_type* rstate = state.get();
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+    FillPermutationIndices<L>(qmaskl, idx);
+    FillMatrix<H, L, 3>(qmaskl, matrix, (fp_type*) w);
 
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    unsigned r = 3 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
     using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
+    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, state.get());
   }
 
-  std::complex<double> ExpectationValue6HHHLLL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
+#endif  // __BMI2__
 
-    auto s = StateSpace::Create(12);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
+  template <unsigned L>
+  static void FillPermutationIndices(unsigned qmaskl, __m256i* idx) {
+    constexpr unsigned lsize = 1 << L;
 
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
+    for (unsigned i = 0; i < lsize - 1; ++i) {
+      unsigned p[8];
 
-    for (unsigned i = 0; i < 7; ++i) {
       for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
+        p[j] = MaskedAdd<3>(j, i + 1, qmaskl, lsize) | (j & (-1 ^ qmaskl));
       }
 
       idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
     }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (512 * i + 64 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, const fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t k = (8 * i & ms[0]) | (16 * i & ms[1]) | (32 * i & ms[2])
-          | (64 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 8 * l;
-
-        __m256 v_re = _mm256_fmadd_ps(is[m], in, _mm256_mul_ps(rs[m], rn));
-        __m256 v_im = _mm256_fnmadd_ps(is[m], rn, _mm256_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX(v_re);
-        im += detail::HorizontalSumAVX(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  static unsigned MaskedAdd(
-      unsigned a, unsigned b, unsigned mask, unsigned lsize) {
-    unsigned c = bits::CompressBits(a, 3, mask);
-    return bits::ExpandBits((c + b) % lsize, 3, mask);
   }
 
   For for_;
diff --git a/lib/simulator_avx512.h b/lib/simulator_avx512.h
index ddce44db..9e03a867 100644
--- a/lib/simulator_avx512.h
+++ b/lib/simulator_avx512.h
@@ -17,11 +17,12 @@
 
 #include <immintrin.h>
 
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "statespace_avx512.h"
 
 namespace qsim {
@@ -30,7 +31,7 @@ namespace qsim {
  * Quantum circuit simulator with AVX512 vectorization.
  */
 template <typename For>
-class SimulatorAVX512 final {
+class SimulatorAVX512 final : public SimulatorBase {
  public:
   using StateSpace = StateSpaceAVX512<For>;
   using State = typename StateSpace::State;
@@ -52,68 +53,68 @@ class SimulatorAVX512 final {
     switch (qs.size()) {
     case 1:
       if (qs[0] > 3) {
-        ApplyGate1H(qs, matrix, state);
+        ApplyGateH<1>(qs, matrix, state);
       } else {
-        ApplyGate1L(qs, matrix, state);
+        ApplyGateL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 3) {
-        ApplyGate2HH(qs, matrix, state);
+        ApplyGateH<2>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate2HL(qs, matrix, state);
+        ApplyGateL<1, 1>(qs, matrix, state);
       } else {
-        ApplyGate2LL(qs, matrix, state);
+        ApplyGateL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 3) {
-        ApplyGate3HHH(qs, matrix, state);
+        ApplyGateH<3>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate3HHL(qs, matrix, state);
+        ApplyGateL<2, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate3HLL(qs, matrix, state);
+        ApplyGateL<1, 2>(qs, matrix, state);
       } else {
-        ApplyGate3LLL(qs, matrix, state);
+        ApplyGateL<0, 3>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 3) {
-        ApplyGate4HHHH(qs, matrix, state);
+        ApplyGateH<4>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate4HHHL(qs, matrix, state);
+        ApplyGateL<3, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate4HHLL(qs, matrix, state);
+        ApplyGateL<2, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        ApplyGate4HLLL(qs, matrix, state);
+        ApplyGateL<1, 3>(qs, matrix, state);
       } else {
-        ApplyGate4LLLL(qs, matrix, state);
+        ApplyGateL<0, 4>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 3) {
-        ApplyGate5HHHHH(qs, matrix, state);
+        ApplyGateH<5>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate5HHHHL(qs, matrix, state);
+        ApplyGateL<4, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate5HHHLL(qs, matrix, state);
+        ApplyGateL<3, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        ApplyGate5HHLLL(qs, matrix, state);
+        ApplyGateL<2, 3>(qs, matrix, state);
       } else {
-        ApplyGate5HLLLL(qs, matrix, state);
+        ApplyGateL<1, 4>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 3) {
-        ApplyGate6HHHHHH(qs, matrix, state);
+        ApplyGateH<6>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate6HHHHHL(qs, matrix, state);
+        ApplyGateL<5, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate6HHHHLL(qs, matrix, state);
+        ApplyGateL<4, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        ApplyGate6HHHLLL(qs, matrix, state);
+        ApplyGateL<3, 3>(qs, matrix, state);
       } else {
-        ApplyGate6HHLLLL(qs, matrix, state);
+        ApplyGateL<2, 4>(qs, matrix, state);
       }
       break;
     default:
@@ -126,13 +127,16 @@ class SimulatorAVX512 final {
    * Applies a controlled gate using AVX512 instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
                            const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+    // Assume cqs[0] < cqs[1] < cqs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -142,96 +146,96 @@ class SimulatorAVX512 final {
     case 1:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate1H_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1H_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<1>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate1L_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1L_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 2:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate2HH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<2>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<2>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate2HL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate2LL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2LL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 3:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate3HHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<3>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<3>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate3HHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate3HLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate3LLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3LLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 4:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HHHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<4>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<4>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HHHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HHLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[3] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HLLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HLLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate4LLLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 4, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4LLLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 4, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
@@ -256,68 +260,68 @@ class SimulatorAVX512 final {
     switch (qs.size()) {
     case 1:
       if (qs[0] > 3) {
-        return ExpectationValue1H(qs, matrix, state);
+        return ExpectationValueH<1>(qs, matrix, state);
       } else {
-        return ExpectationValue1L(qs, matrix, state);
+        return ExpectationValueL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 3) {
-        return ExpectationValue2HH(qs, matrix, state);
+        return ExpectationValueH<2>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        return ExpectationValue2HL(qs, matrix, state);
+        return ExpectationValueL<1, 1>(qs, matrix, state);
       } else {
-        return ExpectationValue2LL(qs, matrix, state);
+        return ExpectationValueL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 3) {
-        return ExpectationValue3HHH(qs, matrix, state);
+        return ExpectationValueH<3>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        return ExpectationValue3HHL(qs, matrix, state);
+        return ExpectationValueL<2, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        return ExpectationValue3HLL(qs, matrix, state);
+        return ExpectationValueL<1, 2>(qs, matrix, state);
       } else {
-        return ExpectationValue3LLL(qs, matrix, state);
+        return ExpectationValueL<0, 3>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 3) {
-        return ExpectationValue4HHHH(qs, matrix, state);
+        return ExpectationValueH<4>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        return ExpectationValue4HHHL(qs, matrix, state);
+        return ExpectationValueL<3, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        return ExpectationValue4HHLL(qs, matrix, state);
+        return ExpectationValueL<2, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        return ExpectationValue4HLLL(qs, matrix, state);
+        return ExpectationValueL<1, 3>(qs, matrix, state);
       } else {
-        return ExpectationValue4LLLL(qs, matrix, state);
+        return ExpectationValueL<0, 4>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 3) {
-        return ExpectationValue5HHHHH(qs, matrix, state);
+        return ExpectationValueH<5>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        return ExpectationValue5HHHHL(qs, matrix, state);
+        return ExpectationValueL<4, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        return ExpectationValue5HHHLL(qs, matrix, state);
+        return ExpectationValueL<3, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        return ExpectationValue5HHLLL(qs, matrix, state);
+        return ExpectationValueL<2, 3>(qs, matrix, state);
       } else {
-        return ExpectationValue5HLLLL(qs, matrix, state);
+        return ExpectationValueL<1, 4>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 3) {
-        return ExpectationValue6HHHHHH(qs, matrix, state);
+        return ExpectationValueH<6>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        return ExpectationValue6HHHHHL(qs, matrix, state);
+        return ExpectationValueL<5, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        return ExpectationValue6HHHHLL(qs, matrix, state);
+        return ExpectationValueL<4, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        return ExpectationValue6HHHLLL(qs, matrix, state);
+        return ExpectationValueL<3, 3>(qs, matrix, state);
       } else {
-        return ExpectationValue6HHLLLL(qs, matrix, state);
+        return ExpectationValueL<2, 4>(qs, matrix, state);
       }
       break;
     default:
@@ -336,44 +340,28 @@ class SimulatorAVX512 final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m512 ru, iu, rn, in;
-      __m512 rs[2], is[2];
+      __m512 rs[hsize], is[hsize];
 
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
+        rs[k] = _mm512_load_ps(p0 + p);
+        is[k] = _mm512_load_ps(p0 + p + 16);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm512_set1_ps(v[j]);
         iu = _mm512_set1_ps(v[j + 1]);
         rn = _mm512_mul_ps(rs[0], ru);
@@ -383,91 +371,64 @@ class SimulatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm512_set1_ps(v[j]);
           iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
+          rn = _mm512_fmadd_ps(rs[l], ru, rn);
+          in = _mm512_fmadd_ps(rs[l], iu, in);
+          rn = _mm512_fnmadd_ps(is[l], iu, rn);
+          in = _mm512_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks1<H, 4>(qs);
 
-    unsigned k = 5;
+    unsigned k = 4 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, m.imaskh, m.qmaskh, state.get());
   }
 
-  void ApplyGate1L(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, const __m512i* idx,
+                fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m512 rn, in;
-      __m512 rs[2], is[2];
+      __m512 rs[gsize], is[gsize];
 
-      auto p0 = rstate + 32 * i;
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0);
-        is[2 * l] = _mm512_load_ps(p0 + 16);
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
+        rs[k2] = _mm512_load_ps(p0 + p);
+        is[k2] = _mm512_load_ps(p0 + p + 16);
+
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], rs[k2]);
+          is[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], is[k2]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm512_mul_ps(rs[0], w[j]);
         in = _mm512_mul_ps(rs[0], w[j + 1]);
         rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
@@ -475,71 +436,60 @@ class SimulatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm512_fmadd_ps(rs[l], w[j], rn);
+          in = _mm512_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm512_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm512_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m512i idx[1 << L];
+    __m512 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    auto m = GetMasks2<H, L, 4>(qs);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 4>(m.qmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 4 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, idx, rstate);
+    for_.Run(size, f, w, m.imaskh, m.qmaskh, idx, state.get());
   }
 
-  void ApplyGate2HH(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m512 ru, iu, rn, in;
-      __m512 rs[4], is[4];
+      __m512 rs[hsize], is[hsize];
 
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
+      auto p0 = rstate + (_pdep_u64(i, imaskh) | cvalsh);
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
+        rs[k] = _mm512_load_ps(p0 + p);
+        is[k] = _mm512_load_ps(p0 + p + 16);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm512_set1_ps(v[j]);
         iu = _mm512_set1_ps(v[j + 1]);
         rn = _mm512_mul_ps(rs[0], ru);
@@ -549,112 +499,57 @@ class SimulatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm512_set1_ps(v[j]);
           iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
+          rn = _mm512_fmadd_ps(rs[l], ru, rn);
+          in = _mm512_fmadd_ps(rs[l], iu, in);
+          rn = _mm512_fnmadd_ps(is[l], iu, rn);
+          in = _mm512_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks3<H, 4>(state.num_qubits(), qs, cqs, cvals);
 
-    unsigned k = 6;
+    unsigned k = 4 + H + cqs.size();
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, m.imaskh, m.qmaskh, m.cvalsh, state.get());
   }
 
-  void ApplyGate2HL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
+                fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
+      __m512 rn, in;
+      __m512 rs[hsize], is[hsize];
 
-      auto p0 = rstate + 2 * k;
+      auto p0 = rstate + (_pdep_u64(i, imaskh) | cvalsh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
+        rs[k] = _mm512_load_ps(p0 + p);
+        is[k] = _mm512_load_ps(p0 + p + 16);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm512_mul_ps(rs[0], w[j]);
         in = _mm512_mul_ps(rs[0], w[j + 1]);
         rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
@@ -662,89 +557,66 @@ class SimulatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm512_fmadd_ps(rs[l], w[j], rn);
+          in = _mm512_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm512_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm512_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m512 w[1 << (1 + 2 * H)];
 
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    auto m = GetMasks4<H, 4>(state.num_qubits(), qs, cqs, cvals);
+    FillControlledMatrixH<H, 4>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 4 + H + cqs.size() - m.cl;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, idx, rstate);
+    for_.Run(size, f, w, m.imaskh, m.qmaskh, m.cvalsh, state.get());
   }
 
-  void ApplyGate2LL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 const __m512i* idx, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m512 rn, in;
-      __m512 rs[4], is[4];
+      __m512 rs[gsize], is[gsize];
+
+      auto p0 = rstate + (_pdep_u64(i, imaskh) | cvalsh);
 
-      auto p0 = rstate + 32 * i;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0);
-        is[4 * l] = _mm512_load_ps(p0 + 16);
+        rs[k2] = _mm512_load_ps(p0 + p);
+        is[k2] = _mm512_load_ps(p0 + p + 16);
 
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], rs[k2]);
+          is[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], is[k2]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm512_mul_ps(rs[0], w[j]);
         in = _mm512_mul_ps(rs[0], w[j + 1]);
         rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
@@ -752,72 +624,74 @@ class SimulatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm512_fmadd_ps(rs[l], w[j], rn);
+          in = _mm512_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm512_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm512_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m512i idx[1 << L];
+    __m512 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
+    if (CH) {
+      auto m = GetMasks5<H, L, 4>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillMatrix<H, L, 4>(m.qmaskl, matrix, (fp_type*) w);
 
-    for_.Run(size, f, w, idx, rstate);
-  }
+      unsigned r = 4 + H + cqs.size();
+      unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
+      uint64_t size = uint64_t{1} << n;
 
-  void ApplyGate3HHH(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
+      for_.Run(size, f, w, m.imaskh, m.qmaskh, m.cvalsh, idx, state.get());
+    } else {
+      auto m = GetMasks6<H, L, 4>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillControlledMatrixL<H, L, 4>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
+      unsigned r = 4 + H + cqs.size() - m.cl;
+      unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
+      uint64_t size = uint64_t{1} << n;
+
+      for_.Run(size, f, w, m.imaskh, m.qmaskh, m.cvalsh, idx, state.get());
     }
+  }
 
+  template <unsigned H>
+  std::complex<double> ExpectationValueH(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, const fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m512 ru, iu, rn, in;
-      __m512 rs[8], is[8];
+      __m512 rs[hsize], is[hsize];
 
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
+        rs[k] = _mm512_load_ps(p0 + p);
+        is[k] = _mm512_load_ps(p0 + p + 16);
       }
 
+      double re = 0;
+      double im = 0;
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 8; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm512_set1_ps(v[j]);
         iu = _mm512_set1_ps(v[j + 1]);
         rn = _mm512_mul_ps(rs[0], ru);
@@ -827,116 +701,72 @@ class SimulatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm512_set1_ps(v[j]);
           iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
+          rn = _mm512_fmadd_ps(rs[l], ru, rn);
+          in = _mm512_fmadd_ps(rs[l], iu, in);
+          rn = _mm512_fnmadd_ps(is[l], iu, rn);
+          in = _mm512_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
+        __m512 v_re = _mm512_fmadd_ps(is[k], in, _mm512_mul_ps(rs[k], rn));
+        __m512 v_im = _mm512_fnmadd_ps(is[k], rn, _mm512_mul_ps(rs[k], in));
+
+        re += detail::HorizontalSumAVX512(v_re);
+        im += detail::HorizontalSumAVX512(v_im);
       }
+
+      return std::complex<double>{re, im};
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks1<H, 4>(qs);
 
-    unsigned k = 7;
+    unsigned k = 4 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    using Op = std::plus<std::complex<double>>;
+    return
+        for_.RunReduce(size, f, Op(), matrix, m.imaskh, m.qmaskh, state.get());
   }
 
-  void ApplyGate3HHL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L>
+  std::complex<double> ExpectationValueL(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, const __m512i* idx,
+                const fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m512 rn, in;
-      __m512 rs[8], is[8];
+      __m512 rs[gsize], is[gsize];
 
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
+      auto p0 = rstate + _pdep_u64(i, imaskh);
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
+        rs[k2] = _mm512_load_ps(p0 + p);
+        is[k2] = _mm512_load_ps(p0 + p + 16);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], rs[k2]);
+          is[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], is[k2]);
         }
       }
 
+      double re = 0;
+      double im = 0;
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm512_mul_ps(rs[0], w[j]);
         in = _mm512_mul_ps(rs[0], w[j + 1]);
         rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
@@ -944,7930 +774,58 @@ class SimulatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm512_fmadd_ps(rs[l], w[j], rn);
+          in = _mm512_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm512_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm512_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate3HLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
+        unsigned m = lsize * k;
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
+        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
+        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
 
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
+        re += detail::HorizontalSumAVX512(v_re);
+        im += detail::HorizontalSumAVX512(v_im);
       }
 
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
+      return std::complex<double>{re, im};
     };
 
-    fp_type* rstate = state.get();
+    __m512i idx[1 << L];
+    __m512 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    auto m = GetMasks2<H, L, 4>(qs);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 4>(m.qmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 4 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, idx, rstate);
+    using Op = std::plus<std::complex<double>>;
+    return
+        for_.RunReduce(size, f, Op(), w, m.imaskh, m.qmaskh, idx, state.get());
   }
 
-  void ApplyGate3LLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
+  template <unsigned L>
+  static void FillPermutationIndices(unsigned qmaskl, __m512i* idx) {
+    constexpr unsigned lsize = 1 << L;
 
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
+    for (unsigned i = 0; i < lsize; ++i) {
+      unsigned p[16];
 
-    for (unsigned i = 0; i < 7; ++i) {
       for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
+        p[j] = MaskedAdd<4>(j, i + 1, qmaskl, lsize) | (j & (-1 ^ qmaskl));
       }
 
       idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
                                 p[9], p[8], p[7], p[6], p[5], p[4],
                                 p[3], p[2], p[1], p[0]);
     }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      auto p0 = rstate + 32 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0);
-        is[8 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, idx, rstate);
-  }
-
-  void ApplyGate4HHHH(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate4HHHL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(11);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate4HHLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(10);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate4HLLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate4LLLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 16 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      auto p0 = rstate + 32 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0);
-        is[16 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, idx, rstate);
-  }
-
-  void ApplyGate5HHHHH(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]) | (512 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate5HHHHL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(13);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate5HHHLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(12);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate5HHLLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(11);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 32 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate5HLLLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[4] + 1);
-    ms[0] = (uint64_t{1} << qs[4]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(10);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (512 * i + 32 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[16 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate6HHHHHH(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]) | (512 * i & ms[5])
-          | (1024 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 10;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate6HHHHHL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(15);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]) | (512 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate6HHHHLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(14);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate6HHHLLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(13);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (512 * i + 64 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyGate6HHLLLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[4] + 1);
-    ms[0] = (uint64_t{1} << qs[4]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 4] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 4]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(12);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (1024 * i + 64 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[16 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, idx, rstate);
-  }
-
-  void ApplyControlledGate1H_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate1H_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = StateSpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (2 * i + 2 * k + m);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate1L_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0);
-        is[2 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate1L_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0);
-        is[2 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2HH_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2HH_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 4 * k + m);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2HL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2HL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2LL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0);
-        is[4 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate2LL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0);
-        is[4 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HHH_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HHH_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = StateSpace::Create(10);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 8 * k + m);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HHL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HHL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3HLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3LLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0);
-        is[8 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate3LLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0);
-        is[8 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = StateSpace::Create(12);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 16 * k + m);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(11);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(11);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(10);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(10);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4LLLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 16 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0);
-        is[16 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  void ApplyControlledGate4LLLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 16 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0);
-        is[16 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue1H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue1L(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
-
-      auto p0 = rstate + 32 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0);
-        is[2 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue2HH(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue2HL(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue2LL(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      auto p0 = rstate + 32 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0);
-        is[4 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HHH(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HHL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HLL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue3LLL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      auto p0 = rstate + 32 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0);
-        is[8 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHHH(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHHL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(11);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHLL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(10);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HLLL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(9);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 8 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue4LLLL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 16 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      auto p0 = rstate + 32 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0);
-        is[16 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHHH(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]) | (512 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHHL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(13);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHLL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(12);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHLLL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(11);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 32 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 8 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HLLLL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[4] + 1);
-    ms[0] = (uint64_t{1} << qs[4]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(10);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (512 * i + 32 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[16 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 16 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHHH(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]) | (512 * i & ms[5])
-          | (1024 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        __m512 v_re = _mm512_fmadd_ps(is[l], in, _mm512_mul_ps(rs[l], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[l], rn, _mm512_mul_ps(rs[l], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 10;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHHL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = StateSpace::Create(15);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]) | (512 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHLL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = StateSpace::Create(14);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]) | (256 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHLLL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = StateSpace::Create(13);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (512 * i + 64 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2])
-          | (128 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 8 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHLLLL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[4] + 1);
-    ms[0] = (uint64_t{1} << qs[4]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 4] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 4]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = StateSpace::Create(12);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (1024 * i + 64 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, const fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t k = (16 * i & ms[0]) | (32 * i & ms[1]) | (64 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[16 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        unsigned m = 16 * l;
-
-        __m512 v_re = _mm512_fmadd_ps(is[m], in, _mm512_mul_ps(rs[m], rn));
-        __m512 v_im = _mm512_fnmadd_ps(is[m], rn, _mm512_mul_ps(rs[m], in));
-
-        re += detail::HorizontalSumAVX512(v_re);
-        im += detail::HorizontalSumAVX512(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, idx, rstate);
-  }
-
-  static unsigned MaskedAdd(
-      unsigned a, unsigned b, unsigned mask, unsigned lsize) {
-    unsigned c = bits::CompressBits(a, 4, mask);
-    return bits::ExpandBits((c + b) % lsize, 4, mask);
   }
 
   For for_;
diff --git a/lib/simulator_basic.h b/lib/simulator_basic.h
index 707825e8..9e136c68 100644
--- a/lib/simulator_basic.h
+++ b/lib/simulator_basic.h
@@ -15,12 +15,12 @@
 #ifndef SIMULATOR_BASIC_H_
 #define SIMULATOR_BASIC_H_
 
-
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "statespace_basic.h"
 
 namespace qsim {
@@ -29,7 +29,7 @@ namespace qsim {
  * Quantum circuit simulator without vectorization.
  */
 template <typename For, typename FP = float>
-class SimulatorBasic final {
+class SimulatorBasic final : public SimulatorBase {
  public:
   using StateSpace = StateSpaceBasic<For, FP>;
   using State = typename StateSpace::State;
@@ -50,22 +50,22 @@ class SimulatorBasic final {
 
     switch (qs.size()) {
     case 1:
-      ApplyGate1H(qs, matrix, state);
+      ApplyGateH<1>(qs, matrix, state);
       break;
     case 2:
-      ApplyGate2H(qs, matrix, state);
+      ApplyGateH<2>(qs, matrix, state);
       break;
     case 3:
-      ApplyGate3H(qs, matrix, state);
+      ApplyGateH<3>(qs, matrix, state);
       break;
     case 4:
-      ApplyGate4H(qs, matrix, state);
+      ApplyGateH<4>(qs, matrix, state);
       break;
     case 5:
-      ApplyGate5H(qs, matrix, state);
+      ApplyGateH<5>(qs, matrix, state);
       break;
     case 6:
-      ApplyGate6H(qs, matrix, state);
+      ApplyGateH<6>(qs, matrix, state);
       break;
     default:
       // Not implemented.
@@ -77,13 +77,15 @@ class SimulatorBasic final {
    * Applies a controlled gate using non-vectorized instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
                            const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -91,16 +93,16 @@ class SimulatorBasic final {
 
     switch (qs.size()) {
     case 1:
-      ApplyControlledGate1H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<1>(qs, cqs, cvals, matrix, state);
       break;
     case 2:
-      ApplyControlledGate2H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<2>(qs, cqs, cvals, matrix, state);
       break;
     case 3:
-      ApplyControlledGate3H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<3>(qs, cqs, cvals, matrix, state);
       break;
     case 4:
-      ApplyControlledGate4H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<4>(qs, cqs, cvals, matrix, state);
       break;
     default:
       // Not implemented.
@@ -123,22 +125,22 @@ class SimulatorBasic final {
 
     switch (qs.size()) {
     case 1:
-      return ExpectationValue1H(qs, matrix, state);
+      return ExpectationValueH<1>(qs, matrix, state);
       break;
     case 2:
-      return ExpectationValue2H(qs, matrix, state);
+      return ExpectationValueH<2>(qs, matrix, state);
       break;
     case 3:
-      return ExpectationValue3H(qs, matrix, state);
+      return ExpectationValueH<3>(qs, matrix, state);
       break;
     case 4:
-      return ExpectationValue4H(qs, matrix, state);
+      return ExpectationValueH<4>(qs, matrix, state);
       break;
     case 5:
-      return ExpectationValue5H(qs, matrix, state);
+      return ExpectationValueH<5>(qs, matrix, state);
       break;
     case 6:
-      return ExpectationValue6H(qs, matrix, state);
+      return ExpectationValueH<6>(qs, matrix, state);
       break;
     default:
       // Not implemented.
@@ -156,1088 +158,144 @@ class SimulatorBasic final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[2], is[2];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 1;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate2H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
+                const uint64_t* ms, const uint64_t* xss, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
       fp_type rn, in;
-      fp_type rs[4], is[4];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2]);
+      fp_type rs[hsize], is[hsize];
 
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
 
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
+      auto p0 = rstate + 2 * ii;
 
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate3H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[8], is[8];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = *(p0 + xss[k]);
+        is[k] = *(p0 + xss[k] + 1);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 8; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = rs[0] * v[j] - is[0] * v[j + 1];
         in = rs[0] * v[j + 1] + is[0] * v[j];
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn += rs[l] * v[j] - is[l] * v[j + 1];
+          in += rs[l] * v[j + 1] + is[l] * v[j];
 
           j += 2;
         }
 
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
+        *(p0 + xss[k]) = rn;
+        *(p0 + xss[k] + 1) = in;
       }
     };
 
-    fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-  void ApplyGate4H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[16], is[16];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]) | (16 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    unsigned n = state.num_qubits() > H ? state.num_qubits() - H : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, ms, xss, state.get());
   }
 
-  void ApplyGate5H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateH(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs,
+                            uint64_t cvals, const fp_type* matrix,
+                            State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
                 const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[32], is[32];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]) | (16 * i & ms[4]) | (32 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate6H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[64], is[64];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]) | (16 * i & ms[4]) | (32 * i & ms[5])
-          | (64 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyControlledGate1H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 1 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
+                uint64_t cvalsh, uint64_t cmaskh, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    emaskh = ~emaskh;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
       fp_type rn, in;
-      fp_type rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
+      fp_type rs[hsize], is[hsize];
 
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
 
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
+      if ((ii & cmaskh) == cvalsh) {
+        auto p0 = rstate + 2 * ii;
 
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
+        for (unsigned k = 0; k < hsize; ++k) {
+          rs[k] = *(p0 + xss[k]);
+          is[k] = *(p0 + xss[k] + 1);
         }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
 
-    emaskh = ~emaskh;
+        uint64_t j = 0;
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
+        for (unsigned k = 0; k < hsize; ++k) {
+          rn = rs[0] * v[j] - is[0] * v[j + 1];
+          in = rs[0] * v[j + 1] + is[0] * v[j];
 
           j += 2;
-        }
 
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
+          for (unsigned l = 1; l < hsize; ++l) {
+            rn += rs[l] * v[j] - is[l] * v[j + 1];
+            in += rs[l] * v[j + 1] + is[l] * v[j];
 
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
+            j += 2;
+          }
 
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  std::complex<double> ExpectationValue1H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
+          *(p0 + xss[k]) = rn;
+          *(p0 + xss[k] + 1) = in;
         }
       }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[2], is[2];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        re += rs[l] * rn + is[l] * in;
-        im += rs[l] * in - is[l] * rn;
-      }
-
-      return std::complex<double>{re, im};
     };
 
-    const fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 1;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
 
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
+    auto m = GetMasks7(state.num_qubits(), qs, cqs, cvals);
 
-  std::complex<double> ExpectationValue2H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[4], is[4];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        re += rs[l] * rn + is[l] * in;
-        im += rs[l] * in - is[l] * rn;
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 2;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    unsigned n = state.num_qubits() > H ? state.num_qubits() - H : 0;
     uint64_t size = uint64_t{1} << n;
 
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, ms, xss, m.cvalsh, m.cmaskh, state.get());
   }
 
-  std::complex<double> ExpectationValue3H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  std::complex<double> ExpectationValueH(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
                 const uint64_t* ms, const uint64_t* xss,
                 const fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[8], is[8];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      double re = 0;
-      double im = 0;
+      constexpr unsigned hsize = 1 << H;
 
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        re += rs[l] * rn + is[l] * in;
-        im += rs[l] * in - is[l] * rn;
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue4H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
       fp_type rn, in;
-      fp_type rs[16], is[16];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]) | (16 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
+      fp_type rs[hsize], is[hsize];
 
-          j += 2;
-        }
-
-        re += rs[l] * rn + is[l] * in;
-        im += rs[l] * in - is[l] * rn;
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
 
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
+      auto p0 = rstate + 2 * ii;
 
-  std::complex<double> ExpectationValue5H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[32], is[32];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]) | (16 * i & ms[4]) | (32 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = *(p0 + xss[k]);
+        is[k] = *(p0 + xss[k] + 1);
       }
 
       double re = 0;
@@ -1245,111 +303,36 @@ class SimulatorBasic final {
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 32; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = rs[0] * v[j] - is[0] * v[j + 1];
         in = rs[0] * v[j + 1] + is[0] * v[j];
 
         j += 2;
 
-        for (unsigned n = 1; n < 32; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn += rs[l] * v[j] - is[l] * v[j + 1];
+          in += rs[l] * v[j + 1] + is[l] * v[j];
 
           j += 2;
         }
 
-        re += rs[l] * rn + is[l] * in;
-        im += rs[l] * in - is[l] * rn;
+        re += rs[k] * rn + is[k] * in;
+        im += rs[k] * in - is[k] * rn;
       }
 
       return std::complex<double>{re, im};
     };
 
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue6H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[64], is[64];
-
-      uint64_t k = (1 * i & ms[0]) | (2 * i & ms[1]) | (4 * i & ms[2])
-          | (8 * i & ms[3]) | (16 * i & ms[4]) | (32 * i & ms[5])
-          | (64 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        re += rs[l] * rn + is[l] * in;
-        im += rs[l] * in - is[l] * rn;
-      }
-
-      return std::complex<double>{re, im};
-    };
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    const fp_type* rstate = state.get();
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
 
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    unsigned n = state.num_qubits() > H ? state.num_qubits() - H : 0;
     uint64_t size = uint64_t{1} << n;
 
     using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
+    return for_.RunReduce(size, f, Op(), matrix, ms, xss, state.get());
   }
 
   For for_;
diff --git a/lib/simulator_sse.h b/lib/simulator_sse.h
index 760a707a..c0347eb6 100644
--- a/lib/simulator_sse.h
+++ b/lib/simulator_sse.h
@@ -17,11 +17,12 @@
 
 #include <smmintrin.h>
 
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "statespace_sse.h"
 
 namespace qsim {
@@ -30,7 +31,7 @@ namespace qsim {
  * Quantum circuit simulator with SSE vectorization.
  */
 template <typename For>
-class SimulatorSSE final {
+class SimulatorSSE final : public SimulatorBase {
  public:
   using StateSpace = StateSpaceSSE<For>;
   using State = typename StateSpace::State;
@@ -52,54 +53,54 @@ class SimulatorSSE final {
     switch (qs.size()) {
     case 1:
       if (qs[0] > 1) {
-        ApplyGate1H(qs, matrix, state);
+        ApplyGateH<1>(qs, matrix, state);
       } else {
-        ApplyGate1L(qs, matrix, state);
+        ApplyGateL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 1) {
-        ApplyGate2HH(qs, matrix, state);
+        ApplyGateH<2>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate2HL(qs, matrix, state);
+        ApplyGateL<1, 1>(qs, matrix, state);
       } else {
-        ApplyGate2LL(qs, matrix, state);
+        ApplyGateL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 1) {
-        ApplyGate3HHH(qs, matrix, state);
+        ApplyGateH<3>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate3HHL(qs, matrix, state);
+        ApplyGateL<2, 1>(qs, matrix, state);
       } else {
-        ApplyGate3HLL(qs, matrix, state);
+        ApplyGateL<1, 2>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 1) {
-        ApplyGate4HHHH(qs, matrix, state);
+        ApplyGateH<4>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate4HHHL(qs, matrix, state);
+        ApplyGateL<3, 1>(qs, matrix, state);
       } else {
-        ApplyGate4HHLL(qs, matrix, state);
+        ApplyGateL<2, 2>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 1) {
-        ApplyGate5HHHHH(qs, matrix, state);
+        ApplyGateH<5>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate5HHHHL(qs, matrix, state);
+        ApplyGateL<4, 1>(qs, matrix, state);
       } else {
-        ApplyGate5HHHLL(qs, matrix, state);
+        ApplyGateL<3, 2>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 1) {
-        ApplyGate6HHHHHH(qs, matrix, state);
+        ApplyGateH<6>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate6HHHHHL(qs, matrix, state);
+        ApplyGateL<5, 1>(qs, matrix, state);
       } else {
-        ApplyGate6HHHHLL(qs, matrix, state);
+        ApplyGateL<4, 2>(qs, matrix, state);
       }
       break;
     default:
@@ -112,13 +113,16 @@ class SimulatorSSE final {
    * Applies a controlled gate using SSE instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
                            const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+    // Assume cqs[0] < cqs[1] < cqs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -128,78 +132,78 @@ class SimulatorSSE final {
     case 1:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate1H_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1H_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<1>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate1L_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1L_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 2:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate2HH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<2>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<2>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate2HL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate2LL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2LL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 3:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate3HHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<3>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<3>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate3HHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate3HLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 4:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate4HHHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<4>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<4>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate4HHHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate4HHLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
@@ -224,54 +228,54 @@ class SimulatorSSE final {
     switch (qs.size()) {
     case 1:
       if (qs[0] > 1) {
-        return ExpectationValue1H(qs, matrix, state);
+        return ExpectationValueH<1>(qs, matrix, state);
       } else {
-        return ExpectationValue1L(qs, matrix, state);
+        return ExpectationValueL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 1) {
-        return ExpectationValue2HH(qs, matrix, state);
+        return ExpectationValueH<2>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        return ExpectationValue2HL(qs, matrix, state);
+        return ExpectationValueL<1, 1>(qs, matrix, state);
       } else {
-        return ExpectationValue2LL(qs, matrix, state);
+        return ExpectationValueL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 1) {
-        return ExpectationValue3HHH(qs, matrix, state);
+        return ExpectationValueH<3>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        return ExpectationValue3HHL(qs, matrix, state);
+        return ExpectationValueL<2, 1>(qs, matrix, state);
       } else {
-        return ExpectationValue3HLL(qs, matrix, state);
+        return ExpectationValueL<1, 2>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 1) {
-        return ExpectationValue4HHHH(qs, matrix, state);
+        return ExpectationValueH<4>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        return ExpectationValue4HHHL(qs, matrix, state);
+        return ExpectationValueL<3, 1>(qs, matrix, state);
       } else {
-        return ExpectationValue4HHLL(qs, matrix, state);
+        return ExpectationValueL<2, 2>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 1) {
-        return ExpectationValue5HHHHH(qs, matrix, state);
+        return ExpectationValueH<5>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        return ExpectationValue5HHHHL(qs, matrix, state);
+        return ExpectationValueL<4, 1>(qs, matrix, state);
       } else {
-        return ExpectationValue5HHHLL(qs, matrix, state);
+        return ExpectationValueL<3, 2>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 1) {
-        return ExpectationValue6HHHHHH(qs, matrix, state);
+        return ExpectationValueH<6>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        return ExpectationValue6HHHHHL(qs, matrix, state);
+        return ExpectationValueL<5, 1>(qs, matrix, state);
       } else {
-        return ExpectationValue6HHHHLL(qs, matrix, state);
+        return ExpectationValueL<4, 2>(qs, matrix, state);
       }
       break;
     default:
@@ -290,199 +294,34 @@ class SimulatorSSE final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate1L(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, State& state) const {
-    unsigned p[4];
-
-    auto s = StateSpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      auto p0 = rstate + 8 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm_load_ps(p0);
-        is[2 * l] = _mm_load_ps(p0 + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
+                const uint64_t* ms, const uint64_t* xss, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    for_.Run(size, f, w, qs[0], rstate);
-  }
+      __m128 ru, iu, rn, in;
+      __m128 rs[hsize], is[hsize];
 
-  void ApplyGate2HH(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
+      i *= 4;
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2]);
 
-      auto p0 = rstate + 2 * k;
+      auto p0 = rstate + 2 * ii;
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm_load_ps(p0 + xss[k]);
+        is[k] = _mm_load_ps(p0 + xss[k] + 4);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm_set1_ps(v[j]);
         iu = _mm_set1_ps(v[j + 1]);
         rn = _mm_mul_ps(rs[0], ru);
@@ -492,182 +331,81 @@ class SimulatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm_set1_ps(v[j]);
           iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], ru));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], iu));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], iu));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], ru));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 4;
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, ms, xss, state.get());
   }
 
-  void ApplyGate2HL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
                 const uint64_t* ms, const uint64_t* xss,
                 unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+      __m128 rn, in;
+      __m128 rs[gsize], is[gsize];
 
-          j += 2;
-        }
+      i *= 4;
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, qs[0], rstate);
-  }
-
-  void ApplyGate2LL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, State& state) const {
-    unsigned p[4];
-
-    auto s = StateSpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
+      auto p0 = rstate + 2 * ii;
 
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
+        rs[k2] = _mm_load_ps(p0 + xss[k]);
+        is[k2] = _mm_load_ps(p0 + xss[k] + 4);
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
+        if (L == 1) {
+          rs[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(rs[k2], rs[k2], 177)
+                               : _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(is[k2], is[k2], 177)
+                               : _mm_shuffle_ps(is[k2], is[k2], 78);
+        } else if (L == 2) {
+          rs[k2 + 1] = _mm_shuffle_ps(rs[k2], rs[k2], 57);
+          is[k2 + 1] = _mm_shuffle_ps(is[k2], is[k2], 57);
+          rs[k2 + 2] = _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 2] = _mm_shuffle_ps(is[k2], is[k2], 78);
+          rs[k2 + 3] = _mm_shuffle_ps(rs[k2], rs[k2], 147);
+          is[k2 + 3] = _mm_shuffle_ps(is[k2], is[k2], 147);
         }
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      auto p0 = rstate + 8 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm_load_ps(p0);
-        is[4 * l] = _mm_load_ps(p0 + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm_mul_ps(rs[0], w[j]);
         in = _mm_mul_ps(rs[0], w[j + 1]);
         rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
@@ -675,72 +413,68 @@ class SimulatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], w[j]));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], w[j + 1]));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], w[j + 1]));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], w[j]));
 
           j += 2;
         }
 
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m128 w[1 << (1 + 2 * H + L)];
+
+    unsigned qmaskl = GetQMask<L>(qs);
 
-    unsigned k = 2;
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+    FillMatrix<H, L, 2>(qmaskl, matrix, (fp_type*) w);
+
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, rstate);
+    for_.Run(size, f, w, ms, xss, qs[0], state.get());
   }
 
-  void ApplyGate3HHH(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m128 ru, iu, rn, in;
-      __m128 rs[8], is[8];
+      __m128 rs[hsize], is[hsize];
+
+      i *= 4;
+
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
+      }
 
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]);
+      if ((ii & cmaskh) != cvalsh) return;
 
-      auto p0 = rstate + 2 * k;
+      auto p0 = rstate + 2 * ii;
 
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm_load_ps(p0 + xss[k]);
+        is[k] = _mm_load_ps(p0 + xss[k] + 4);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 8; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm_set1_ps(v[j]);
         iu = _mm_set1_ps(v[j + 1]);
         rn = _mm_mul_ps(rs[0], ru);
@@ -750,105 +484,67 @@ class SimulatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm_set1_ps(v[j]);
           iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], ru));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], iu));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], iu));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], ru));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 5;
+    auto m = GetMasks7(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    for_.Run(size, f, matrix, ms, xss, m.cvalsh, m.cmaskh, state.get());
   }
 
-  void ApplyGate3HHL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(7);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-        unsigned l = 2 * (8 * i + m);
+      __m128 rn, in;
+      __m128 rs[hsize], is[hsize];
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
+      i *= 4;
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2]);
 
-      auto p0 = rstate + 2 * k;
+      if ((ii & cmaskh) != cvalsh) return;
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
+      auto p0 = rstate + 2 * ii;
 
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm_load_ps(p0 + xss[k]);
+        is[k] = _mm_load_ps(p0 + xss[k] + 4);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm_mul_ps(rs[0], w[j]);
         in = _mm_mul_ps(rs[0], w[j + 1]);
         rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
@@ -856,101 +552,85 @@ class SimulatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], w[j]));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], w[j + 1]));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], w[j + 1]));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], w[j]));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m128 w[1 << (1 + 2 * H)];
 
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    auto m = GetMasks8<2>(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+    FillControlledMatrixH<H, 2>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
+
+    unsigned r = 2 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, qs[0], rstate);
+    for_.Run(size, f, w, ms, xss, m.cvalsh, m.cmaskh, state.get());
   }
 
-  void ApplyGate3HLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(6);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, unsigned q0, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        unsigned l = 2 * (8 * i + m);
+      __m128 rn, in;
+      __m128 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
+      i *= 4;
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
-    }
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
+      if ((ii & cmaskh) != cvalsh) return;
 
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]);
+      auto p0 = rstate + 2 * ii;
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
+        rs[k2] = _mm_load_ps(p0 + xss[k]);
+        is[k2] = _mm_load_ps(p0 + xss[k] + 4);
 
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
+        if (L == 1) {
+          rs[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(rs[k2], rs[k2], 177)
+                               : _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(is[k2], is[k2], 177)
+                               : _mm_shuffle_ps(is[k2], is[k2], 78);
+        } else if (L == 2) {
+          rs[k2 + 1] = _mm_shuffle_ps(rs[k2], rs[k2], 57);
+          is[k2 + 1] = _mm_shuffle_ps(is[k2], is[k2], 57);
+          rs[k2 + 2] = _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 2] = _mm_shuffle_ps(is[k2], is[k2], 78);
+          rs[k2 + 3] = _mm_shuffle_ps(rs[k2], rs[k2], 147);
+          is[k2 + 3] = _mm_shuffle_ps(is[k2], is[k2], 147);
+        }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm_mul_ps(rs[0], w[j]);
         in = _mm_mul_ps(rs[0], w[j + 1]);
         rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
@@ -958,72 +638,76 @@ class SimulatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], w[j]));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], w[j + 1]));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], w[j + 1]));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], w[j]));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m128 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+
+    unsigned r = 2 + H;
+    unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, w, ms, xss, rstate);
-  }
+    if (CH) {
+      auto m = GetMasks9<L>(state.num_qubits(), qs, cqs, cvals);
+      FillMatrix<H, L, 2>(m.qmaskl, matrix, (fp_type*) w);
 
-  void ApplyGate4HHHH(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
+      for_.Run(size, f, w, ms, xss, m.cvalsh, m.cmaskh, qs[0], state.get());
+    } else {
+      auto m = GetMasks10<L, 2>(state.num_qubits(), qs, cqs, cvals);
+      FillControlledMatrixL<H, L, 2>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
+      for_.Run(size, f, w, ms, xss, m.cvalsh, m.cmaskh, qs[0], state.get());
     }
+  }
 
+  template <unsigned H>
+  std::complex<double> ExpectationValueH(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
                 const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
+                const fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m128 ru, iu, rn, in;
-      __m128 rs[16], is[16];
+      __m128 rs[hsize], is[hsize];
 
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]);
+      i *= 4;
+
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
+      }
 
-      auto p0 = rstate + 2 * k;
+      auto p0 = rstate + 2 * ii;
 
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm_load_ps(p0 + xss[k]);
+        is[k] = _mm_load_ps(p0 + xss[k] + 4);
       }
 
+      double re = 0;
+      double im = 0;
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 16; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm_set1_ps(v[j]);
         iu = _mm_set1_ps(v[j + 1]);
         rn = _mm_mul_ps(rs[0], ru);
@@ -1033,106 +717,90 @@ class SimulatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 16; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm_set1_ps(v[j]);
           iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], ru));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], iu));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], iu));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], ru));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[k], rn), _mm_mul_ps(is[k], in));
+        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[k], in), _mm_mul_ps(is[k], rn));
+
+        re += detail::HorizontalSumSSE(v_re);
+        im += detail::HorizontalSumSSE(v_im);
       }
+
+      return std::complex<double>{re, im};
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
 
-    unsigned k = 6;
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
 
-    for_.Run(size, f, matrix, ms, xss, rstate);
+    using Op = std::plus<std::complex<double>>;
+    return for_.RunReduce(size, f, Op(), matrix, ms, xss, state.get());
   }
 
-  void ApplyGate4HHHL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(9);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
+  template <unsigned H, unsigned L>
+  std::complex<double> ExpectationValueL(const std::vector<unsigned>& qs,
+                                         const fp_type* matrix,
+                                         const State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
+                const uint64_t* ms, const uint64_t* xss, unsigned q0,
+                const fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        unsigned l = 2 * (16 * i + m);
+      __m128 rn, in;
+      __m128 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
+      i *= 4;
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
+      uint64_t ii = i & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        i *= 2;
+        ii |= i & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
 
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]);
+      auto p0 = rstate + 2 * ii;
 
-      auto p0 = rstate + 2 * k;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
+        rs[k2] = _mm_load_ps(p0 + xss[k]);
+        is[k2] = _mm_load_ps(p0 + xss[k] + 4);
 
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
+        if (L == 1) {
+          rs[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(rs[k2], rs[k2], 177)
+                               : _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(is[k2], is[k2], 177)
+                               : _mm_shuffle_ps(is[k2], is[k2], 78);
+        } else if (L == 2) {
+          rs[k2 + 1] = _mm_shuffle_ps(rs[k2], rs[k2], 57);
+          is[k2 + 1] = _mm_shuffle_ps(is[k2], is[k2], 57);
+          rs[k2 + 2] = _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 2] = _mm_shuffle_ps(is[k2], is[k2], 78);
+          rs[k2 + 3] = _mm_shuffle_ps(rs[k2], rs[k2], 147);
+          is[k2 + 3] = _mm_shuffle_ps(is[k2], is[k2], 147);
+        }
       }
 
+      double re = 0;
+      double im = 0;
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 8; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm_mul_ps(rs[0], w[j]);
         in = _mm_mul_ps(rs[0], w[j + 1]);
         rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
@@ -1140,5017 +808,42 @@ class SimulatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], w[j]));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], w[j + 1]));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], w[j + 1]));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], w[j]));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        unsigned m = lsize * k;
+
+        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
+        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
+
+        re += detail::HorizontalSumSSE(v_re);
+        im += detail::HorizontalSumSSE(v_im);
       }
+
+      return std::complex<double>{re, im};
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m128 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
+    unsigned qmaskl = GetQMask<L>(qs);
 
-    for_.Run(size, f, w, ms, xss, qs[0], rstate);
-  }
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+    FillMatrix<H, L, 2>(qmaskl, matrix, (fp_type*) w);
 
-  void ApplyGate4HHLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(8);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, rstate);
-  }
-
-  void ApplyGate5HHHHH(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]) | (128 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate5HHHHL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(11);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, qs[0], rstate);
-  }
-
-  void ApplyGate5HHHLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(10);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, rstate);
-  }
-
-  void ApplyGate6HHHHHH(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]) | (128 * i & ms[5])
-          | (256 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss, rstate);
-  }
-
-  void ApplyGate6HHHHHL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(13);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]) | (128 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, qs[0], rstate);
-  }
-
-  void ApplyGate6HHHHLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(12);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss, rstate);
-  }
-
-  void ApplyControlledGate1H_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate1H_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (2 * i + 2 * k + m);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate1L_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm_load_ps(p0);
-        is[2 * l] = _mm_load_ps(p0 + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate1L_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm_load_ps(p0);
-        is[2 * l] = _mm_load_ps(p0 + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate2HH_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2HH_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(6);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 4 * k + m);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2HL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate2HL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate2LL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm_load_ps(p0);
-        is[4 * l] = _mm_load_ps(p0 + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate2LL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                State& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm_load_ps(p0);
-        is[4 * l] = _mm_load_ps(p0 + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HHH_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HHH_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(8);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 8 * k + m);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HHL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(7);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate3HHL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(7);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate3HLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(6);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate3HLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(6);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(10);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 16 * k + m);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(9);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate4HHHL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(9);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], rstate);
-  }
-
-  void ApplyControlledGate4HHLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(8);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(8);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = bits::ExpandBits(i, num_qubits, emaskh) | cmaskh;
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    for_.Run(size, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, rstate);
-  }
-
-  std::complex<double> ExpectationValue1H(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue1L(const std::vector<unsigned>& qs,
-                                          const fp_type* matrix,
-                                          const State& state) const {
-    unsigned p[4];
-
-    auto s = StateSpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned q0, const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      auto p0 = rstate + 8 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm_load_ps(p0);
-        is[2 * l] = _mm_load_ps(p0 + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 2;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, qs[0], rstate);
-  }
-
-  std::complex<double> ExpectationValue2HH(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue2HL(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, qs[0], rstate);
-  }
-
-  std::complex<double> ExpectationValue2LL(const std::vector<unsigned>& qs,
-                                           const fp_type* matrix,
-                                           const State& state) const {
-    unsigned p[4];
-
-    auto s = StateSpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      auto p0 = rstate + 8 * i;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm_load_ps(p0);
-        is[4 * l] = _mm_load_ps(p0 + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 2;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HHH(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue3HHL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(7);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, qs[0], rstate);
-  }
-
-  std::complex<double> ExpectationValue3HLL(const std::vector<unsigned>& qs,
-                                            const fp_type* matrix,
-                                            const State& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(6);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHHH(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHHL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(9);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, qs[0], rstate);
-  }
-
-  std::complex<double> ExpectationValue4HHLL(const std::vector<unsigned>& qs,
-                                             const fp_type* matrix,
-                                             const State& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(8);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHHH(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]) | (128 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHHL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(11);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, qs[0], rstate);
-  }
-
-  std::complex<double> ExpectationValue5HHHLL(const std::vector<unsigned>& qs,
-                                              const fp_type* matrix,
-                                              const State& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(10);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHHH(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]) | (128 * i & ms[5])
-          | (256 * i & ms[6]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[l], rn), _mm_mul_ps(is[l], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[l], in), _mm_mul_ps(is[l], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), matrix, ms, xss, rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHHL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(13);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]) | (128 * i & ms[5]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 2 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-
-    using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, qs[0], rstate);
-  }
-
-  std::complex<double> ExpectationValue6HHHHLL(const std::vector<unsigned>& qs,
-                                               const fp_type* matrix,
-                                               const State& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = StateSpace::Create(12);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t k = (4 * i & ms[0]) | (8 * i & ms[1]) | (16 * i & ms[2])
-          | (32 * i & ms[3]) | (64 * i & ms[4]);
-
-      auto p0 = rstate + 2 * k;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      double re = 0;
-      double im = 0;
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        unsigned m = 4 * l;
-
-        __m128 v_re = _mm_add_ps(_mm_mul_ps(rs[m], rn), _mm_mul_ps(is[m], in));
-        __m128 v_im = _mm_sub_ps(_mm_mul_ps(rs[m], in), _mm_mul_ps(is[m], rn));
-
-        re += detail::HorizontalSumSSE(v_re);
-        im += detail::HorizontalSumSSE(v_im);
-      }
-
-      return std::complex<double>{re, im};
-    };
-
-    const fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
+    unsigned k = 2 + H;
+    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    uint64_t size = uint64_t{1} << n;
 
     using Op = std::plus<std::complex<double>>;
-    return for_.RunReduce(size, f, Op(), w, ms, xss, rstate);
-  }
-
-  static unsigned MaskedAdd(
-      unsigned a, unsigned b, unsigned mask, unsigned lsize) {
-    unsigned c = bits::CompressBits(a, 2, mask);
-    return bits::ExpandBits((c + b) % lsize, 2, mask);
+    return for_.RunReduce(size, f, Op(), w, ms, xss, qs[0], state.get());
   }
 
   For for_;
diff --git a/pybind_interface/Makefile b/pybind_interface/Makefile
index 6a7dc7eb..8450bd17 100644
--- a/pybind_interface/Makefile
+++ b/pybind_interface/Makefile
@@ -11,7 +11,7 @@ QSIMLIB_DECIDE = ../qsimcirq/qsim_decide`python3-config --extension-suffix`
 PYBINDFLAGS_BASIC = -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_SSE = -msse4.1 -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 PYBINDFLAGS_AVX2 = -mavx2 -mfma -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
-PYBINDFLAGS_AVX512 = -mavx512f -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
+PYBINDFLAGS_AVX512 = -mavx512f -mbmi2 -Wall -shared -std=c++17 -fPIC `python3 -m pybind11 --includes`
 
 # The flags for the compilation of GPU-specific Pybind11 interfaces
 PYBINDFLAGS_CUDA = -std=c++14 -x cu -Xcompiler "-Wall -shared -fPIC `python3 -m pybind11 --includes`"
diff --git a/pybind_interface/avx512/CMakeLists.txt b/pybind_interface/avx512/CMakeLists.txt
index c265fe13..705d39db 100644
--- a/pybind_interface/avx512/CMakeLists.txt
+++ b/pybind_interface/avx512/CMakeLists.txt
@@ -5,7 +5,7 @@ project(qsim)
 IF (WIN32)
     set(CMAKE_CXX_FLAGS "/arch:AVX512 /O2 /openmp")
 ELSE()
-    set(CMAKE_CXX_FLAGS "-mavx512f -O3 -fopenmp")
+    set(CMAKE_CXX_FLAGS "-mavx512f -mbmi2 -O3 -fopenmp")
 ENDIF()
 
 if(APPLE)
diff --git a/tests/make.sh b/tests/make.sh
index 5df5a37e..7fd828c8 100755
--- a/tests/make.sh
+++ b/tests/make.sh
@@ -24,21 +24,24 @@ path_to_lib=googletest/googletest/make/lib
 g++ -O3 -I$path_to_include -L$path_to_lib -o bitstring_test.x bitstring_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o channels_cirq_test.x channels_cirq_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -o circuit_qsim_parser_test.x circuit_qsim_parser_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o expect_test.x expect_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o expect_nobmi2_test.x expect_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -mbmi2 -fopenmp -o expect_test.x expect_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -o fuser_basic_test.x fuser_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -o fuser_mqubit_test.x fuser_mqubit_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -o gates_qsim_test.x gates_qsim_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o hybrid_avx_test.x hybrid_avx_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -o matrix_test.x matrix_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o qtrajectory_avx_test.x qtrajectory_avx_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o qtrajectory_avx_nobmi2_test.x qtrajectory_avx_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -mbmi2 -o qtrajectory_avx_test.x qtrajectory_avx_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o run_qsim_test.x run_qsim_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o run_qsimh_test.x run_qsimh_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o simulator_avx_test.x simulator_avx_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -fopenmp -o simulator_avx512_test.x simulator_avx512_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o simulator_avx_nobmi2_test.x simulator_avx_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -mbmi2 -fopenmp -o simulator_avx_test.x simulator_avx_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mbmi2 -fopenmp -o simulator_avx512_test.x simulator_avx512_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o simulator_basic_test.x simulator_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -msse4 -fopenmp -o simulator_sse_test.x simulator_sse_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o statespace_avx_test.x statespace_avx_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -fopenmp -o statespace_avx512_test.x statespace_avx512_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mbmi2 -fopenmp -o statespace_avx512_test.x statespace_avx512_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o statespace_basic_test.x statespace_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -msse4 -fopenmp -o statespace_sse_test.x statespace_sse_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o unitary_calculator_avx_test.x unitary_calculator_avx_test.cc -lgtest -lpthread
@@ -46,7 +49,7 @@ g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mfma -fopenmp -o unitary_ca
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o unitary_calculator_basic_test.x unitary_calculator_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -msse4 -fopenmp -o unitary_calculator_sse_test.x unitary_calculator_sse_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o unitaryspace_avx_test.x unitaryspace_avx_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mfma -fopenmp -o unitaryspace_avx512_test.x unitaryspace_avx512_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mbmi2 -fopenmp -o unitaryspace_avx512_test.x unitaryspace_avx512_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o unitaryspace_basic_test.x unitaryspace_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -msse4 -fopenmp -o unitaryspace_sse_test.x unitaryspace_sse_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -o vectorspace_test.x vectorspace_test.cc -lgtest -lpthread

From 4005bec50f13697ce59ea70a6dea28a9c010f828 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Wed, 1 Dec 2021 16:01:35 +0100
Subject: [PATCH 172/246] Add comments.

---
 lib/simulator.h     | 44 ++++++++++++++++++++++++++++++++++++++++++--
 lib/simulator_avx.h | 12 ++++++------
 lib/simulator_sse.h |  8 ++++----
 3 files changed, 52 insertions(+), 12 deletions(-)

diff --git a/lib/simulator.h b/lib/simulator.h
index a5b799f5..d5af3c2a 100644
--- a/lib/simulator.h
+++ b/lib/simulator.h
@@ -26,6 +26,16 @@ namespace qsim {
  */
 class SimulatorBase {
  protected:
+  // The follwoing template parameters are used for functions below.
+  // H - the number of high (target) qubits.
+  // L - the number of low (target) qubits.
+  // R - SIMD register width in floats.
+
+  // Fills the table of masks (ms) that is used to calculate base state indices
+  // and the table of offset indices (xss) that is used to access the state
+  // vector entries in matrix-vector multiplication functions. This function is
+  // used in simulator_basic.h, simulator_sse.h and simulator_avx.h (no bmi2
+  // version).
   template <unsigned H, unsigned L = 0>
   static void FillIndices(unsigned num_qubits, const std::vector<unsigned>& qs,
                           uint64_t* ms, uint64_t* xss) {
@@ -50,6 +60,7 @@ class SimulatorBase {
     }
   }
 
+  // Fills gate matrix entries for gates with low qubits.
   template <unsigned H, unsigned L, unsigned R, typename fp_type>
   static void FillMatrix(unsigned qmaskl, const fp_type* matrix, fp_type* w) {
     constexpr unsigned gsize = 1 << (H + L);
@@ -78,6 +89,8 @@ class SimulatorBase {
     }
   }
 
+  // Fills gate matrix entries for controlled gates with high target qubits
+  // and low control qubits.
   template <unsigned H, unsigned R, typename fp_type>
   static void FillControlledMatrixH(uint64_t cvalsl, uint64_t cmaskl,
                                     const fp_type* matrix, fp_type* w) {
@@ -103,6 +116,8 @@ class SimulatorBase {
     }
   }
 
+  // Fills gate matrix entries for controlled gates with low target qubits
+  // and low control qubits.
   template <unsigned H, unsigned L, unsigned R, typename fp_type>
   static void FillControlledMatrixL(uint64_t cvalsl, uint64_t cmaskl,
                                     unsigned qmaskl, const fp_type* matrix,
@@ -135,6 +150,27 @@ class SimulatorBase {
     }
   }
 
+/*
+  The GetMasks* functions below provide various masks and related values.
+  GetMasks1, GetMasks2, GetMasks3, GetMasks4, GetMasks5 and GetMasks6 are
+  used in simulator_avx.h (BMI2 version) and in simulator_avx512.h. GetMasks7,
+  GetMasks8, GetMasks9, GetMasks10 and GetMasks11 are used in simulator_avx.h
+  (no BMI2 version) and in simulator_sse.h.
+
+  imaskh - inverted mask of high qubits (high control and target qubits).
+  qmaskh - mask of high qubits (high target qubits).
+  cvalsh - control bit values of high control qubits placed in correct
+           positions.
+  cvalsl - control bit values of low control qubits placed in correct positions.
+  cmaskh - mask of high control qubits.
+  cmaskl - mask of low control qubits.
+  qmaskl - mask of low qubits (low target qubits).
+  cl - the number of low control qubits.
+
+  Note that imaskh, qmaskh and cvalsh are multiplied by two in GetMasks1,
+  GetMasks2, GetMasks3, GetMasks4, GetMasks5 and GetMasks6.
+*/
+
   struct Masks1 {
     uint64_t imaskh;
     uint64_t qmaskh;
@@ -423,15 +459,19 @@ class SimulatorBase {
     return {cvalsh, cmaskh, cvalsl, cmaskl, qmaskl};
   }
 
+  struct Masks11 {
+    unsigned qmaskl;
+  };
+
   template <unsigned L>
-  static unsigned GetQMask(const std::vector<unsigned>& qs) {
+  static Masks11 GetMasks11(const std::vector<unsigned>& qs) {
     unsigned qmaskl = 0;
 
     for (unsigned i = 0; i < L; ++i) {
       qmaskl |= 1 << qs[i];
     }
 
-    return qmaskl;
+    return {qmaskl};
   }
 
   template <unsigned R>
diff --git a/lib/simulator_avx.h b/lib/simulator_avx.h
index cb596808..351e0832 100644
--- a/lib/simulator_avx.h
+++ b/lib/simulator_avx.h
@@ -926,11 +926,11 @@ class SimulatorAVX final : public SimulatorBase {
     __m256i idx[1 << L];
     __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned qmaskl = GetQMask<L>(qs);
+    auto m = GetMasks11<L>(qs);
 
     FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
-    FillPermutationIndices<L>(qmaskl, idx);
-    FillMatrix<H, L, 3>(qmaskl, matrix, (fp_type*) w);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
 
     unsigned r = 3 + H;
     unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
@@ -1315,11 +1315,11 @@ class SimulatorAVX final : public SimulatorBase {
     __m256i idx[1 << L];
     __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned qmaskl = GetQMask<L>(qs);
+    auto m = GetMasks11<L>(qs);
 
     FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
-    FillPermutationIndices<L>(qmaskl, idx);
-    FillMatrix<H, L, 3>(qmaskl, matrix, (fp_type*) w);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
 
     unsigned r = 3 + H;
     unsigned n = state.num_qubits() > r ? state.num_qubits() - r : 0;
diff --git a/lib/simulator_sse.h b/lib/simulator_sse.h
index c0347eb6..50279e22 100644
--- a/lib/simulator_sse.h
+++ b/lib/simulator_sse.h
@@ -431,10 +431,10 @@ class SimulatorSSE final : public SimulatorBase {
     uint64_t xss[1 << H];
     __m128 w[1 << (1 + 2 * H + L)];
 
-    unsigned qmaskl = GetQMask<L>(qs);
+    auto m = GetMasks11<L>(qs);
 
     FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
-    FillMatrix<H, L, 2>(qmaskl, matrix, (fp_type*) w);
+    FillMatrix<H, L, 2>(m.qmaskl, matrix, (fp_type*) w);
 
     unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
@@ -833,10 +833,10 @@ class SimulatorSSE final : public SimulatorBase {
     uint64_t xss[1 << H];
     __m128 w[1 << (1 + 2 * H + L)];
 
-    unsigned qmaskl = GetQMask<L>(qs);
+    auto m = GetMasks11<L>(qs);
 
     FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
-    FillMatrix<H, L, 2>(qmaskl, matrix, (fp_type*) w);
+    FillMatrix<H, L, 2>(m.qmaskl, matrix, (fp_type*) w);
 
     unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;

From 852792144e6bbee89e0d38adb141d153b579770e Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 2 Dec 2021 16:47:49 +0100
Subject: [PATCH 173/246] Update unitary calculators.

---
 lib/BUILD                       |    8 +-
 lib/unitary_calculator_avx.h    | 5687 +++-------------------------
 lib/unitary_calculator_avx512.h | 6255 ++-----------------------------
 lib/unitary_calculator_basic.h  |  833 +---
 lib/unitary_calculator_sse.h    | 4446 ++--------------------
 tests/make.sh                   |    5 +-
 6 files changed, 1115 insertions(+), 16119 deletions(-)

diff --git a/lib/BUILD b/lib/BUILD
index e40a58d3..d69ae1da 100644
--- a/lib/BUILD
+++ b/lib/BUILD
@@ -634,7 +634,7 @@ cc_library(
     name = "unitary_calculator_avx",
     hdrs = ["unitary_calculator_avx.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":unitaryspace_avx",
     ],
 )
@@ -643,7 +643,7 @@ cc_library(
     name = "unitary_calculator_avx512",
     hdrs = ["unitary_calculator_avx512.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":unitaryspace_avx512",
     ],
 )
@@ -652,7 +652,7 @@ cc_library(
     name = "unitary_calculator_basic",
     hdrs = ["unitary_calculator_basic.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":unitaryspace_basic",
     ],
 )
@@ -661,7 +661,7 @@ cc_library(
     name = "unitary_calculator_sse",
     hdrs = ["unitary_calculator_sse.h"],
     deps = [
-        ":bits",
+        ":simulator_base",
         ":unitaryspace_sse",
     ],
 )
diff --git a/lib/unitary_calculator_avx.h b/lib/unitary_calculator_avx.h
index 519ff26c..2bcb6780 100644
--- a/lib/unitary_calculator_avx.h
+++ b/lib/unitary_calculator_avx.h
@@ -17,21 +17,22 @@
 
 #include <immintrin.h>
 
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "unitaryspace_avx.h"
 
 namespace qsim {
 namespace unitary {
 
 /**
- * Quantum circuit unitary calculator with AVX vectorization.
+ * Quantum circuit simulator with AVX vectorization.
  */
 template <typename For>
-class UnitaryCalculatorAVX final {
+class UnitaryCalculatorAVX final : public SimulatorBase {
  public:
   using UnitarySpace = UnitarySpaceAVX<For>;
   using Unitary = typename UnitarySpace::Unitary;
@@ -50,68 +51,68 @@ class UnitaryCalculatorAVX final {
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyGate(const std::vector<unsigned>& qs,
-                 const fp_type* matrix, Unitary& state) const {
+                 const fp_type* matrix, State& state) const {
     // Assume qs[0] < qs[1] < qs[2] < ... .
 
     switch (qs.size()) {
     case 1:
       if (qs[0] > 2) {
-        ApplyGate1H(qs, matrix, state);
+        ApplyGateH<1>(qs, matrix, state);
       } else {
-        ApplyGate1L(qs, matrix, state);
+        ApplyGateL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 2) {
-        ApplyGate2HH(qs, matrix, state);
+        ApplyGateH<2>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate2HL(qs, matrix, state);
+        ApplyGateL<1, 1>(qs, matrix, state);
       } else {
-        ApplyGate2LL(qs, matrix, state);
+        ApplyGateL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 2) {
-        ApplyGate3HHH(qs, matrix, state);
+        ApplyGateH<3>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate3HHL(qs, matrix, state);
+        ApplyGateL<2, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate3HLL(qs, matrix, state);
+        ApplyGateL<1, 2>(qs, matrix, state);
       } else {
-        ApplyGate3LLL(qs, matrix, state);
+        ApplyGateL<0, 3>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 2) {
-        ApplyGate4HHHH(qs, matrix, state);
+        ApplyGateH<4>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate4HHHL(qs, matrix, state);
+        ApplyGateL<3, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate4HHLL(qs, matrix, state);
+        ApplyGateL<2, 2>(qs, matrix, state);
       } else {
-        ApplyGate4HLLL(qs, matrix, state);
+        ApplyGateL<1, 3>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 2) {
-        ApplyGate5HHHHH(qs, matrix, state);
+        ApplyGateH<5>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate5HHHHL(qs, matrix, state);
+        ApplyGateL<4, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate5HHHLL(qs, matrix, state);
+        ApplyGateL<3, 2>(qs, matrix, state);
       } else {
-        ApplyGate5HHLLL(qs, matrix, state);
+        ApplyGateL<2, 3>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 2) {
-        ApplyGate6HHHHHH(qs, matrix, state);
+        ApplyGateH<6>(qs, matrix, state);
       } else if (qs[1] > 2) {
-        ApplyGate6HHHHHL(qs, matrix, state);
+        ApplyGateL<5, 1>(qs, matrix, state);
       } else if (qs[2] > 2) {
-        ApplyGate6HHHHLL(qs, matrix, state);
+        ApplyGateL<4, 2>(qs, matrix, state);
       } else {
-        ApplyGate6HHHLLL(qs, matrix, state);
+        ApplyGateL<3, 3>(qs, matrix, state);
       }
       break;
     default:
@@ -124,13 +125,16 @@ class UnitaryCalculatorAVX final {
    * Applies a controlled gate using AVX instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
-                           const fp_type* matrix, Unitary& state) const {
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
+                           const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+    // Assume cqs[0] < cqs[1] < cqs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -140,90 +144,90 @@ class UnitaryCalculatorAVX final {
     case 1:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate1H_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1H_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<1>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate1L_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1L_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 2:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate2HH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<2>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<2>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate2HL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate2LL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2LL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 3:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate3HHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<3>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<3>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate3HHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate3HLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate3LLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3LLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 4:
       if (qs[0] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HHHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<4>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<4>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HHHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 2) {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HHLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 2) {
-          ApplyControlledGate4HLLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HLLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
@@ -241,46 +245,35 @@ class UnitaryCalculatorAVX final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
 
+#ifdef __BMI2__
+
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, uint64_t size,
+                uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 ru, iu, rn, in;
-      __m256 rs[2], is[2];
+      __m256 rs[hsize], is[hsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]);
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + _pdep_u64(r, imaskh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        rs[k] = _mm256_load_ps(p0 + p);
+        is[k] = _mm256_load_ps(p0 + p + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm256_set1_ps(v[j]);
         iu = _mm256_set1_ps(v[j + 1]);
         rn = _mm256_mul_ps(rs[0], ru);
@@ -290,94 +283,70 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm256_set1_ps(v[j]);
           iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks1<H, 3>(qs);
 
-    unsigned k = 4;
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             matrix, m.imaskh, m.qmaskh, size, raw_size, state.get());
   }
 
-  void ApplyGate1L(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(2);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                uint64_t imaskh, uint64_t qmaskh, const __m256i* idx,
+                uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+      __m256 rn, in;
+      __m256 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
+      auto p0 = rstate + row_size * s + _pdep_u64(r, imaskh);
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 16 * ii;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0);
-        is[2 * l] = _mm256_load_ps(p0 + 8);
+        rs[k2] = _mm256_load_ps(p0 + p);
+        is[k2] = _mm256_load_ps(p0 + p + 8);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -385,75 +354,66 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
+
+    auto m = GetMasks2<H, L, 3>(qs);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
 
-    unsigned k = 3;
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, idx, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             w, m.imaskh, m.qmaskh, idx, size, raw_size, state.get());
   }
 
-  void ApplyGate2HH(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 ru, iu, rn, in;
-      __m256 rs[4], is[4];
+      __m256 rs[hsize], is[hsize];
+
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2]);
+      auto p0 = rstate + row_size * s + (_pdep_u64(r, imaskh) | cvalsh);
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+        rs[k] = _mm256_load_ps(p0 + p);
+        is[k] = _mm256_load_ps(p0 + p + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm256_set1_ps(v[j]);
         iu = _mm256_set1_ps(v[j + 1]);
         rn = _mm256_mul_ps(rs[0], ru);
@@ -463,115 +423,63 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm256_set1_ps(v[j]);
           iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks3<H, 3>(state.num_qubits(), qs, cqs, cvals);
 
-    unsigned k = 5;
+    unsigned k = 3 + H + cqs.size();
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             matrix, m.imaskh, m.qmaskh, m.cvalsh, size, raw_size, state.get());
   }
 
-  void ApplyGate2HL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
+                uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 rn, in;
-      __m256 rs[4], is[4];
+      __m256 rs[hsize], is[hsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]);
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + (_pdep_u64(r, imaskh) | cvalsh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
+        rs[k] = _mm256_load_ps(p0 + p);
+        is[k] = _mm256_load_ps(p0 + p + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -579,92 +487,73 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m256 w[1 << (1 + 2 * H)];
+
+    auto m = GetMasks4<H, 3>(state.num_qubits(), qs, cqs, cvals);
+    FillControlledMatrixH<H, 3>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
 
-    unsigned k = 4;
+    unsigned k = 3 + H + cqs.size() - m.cl;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             w, m.imaskh, m.qmaskh, m.cvalsh, size, raw_size, state.get());
   }
 
-  void ApplyGate2LL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 const __m256i* idx, uint64_t size, uint64_t row_size,
                 fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m256 rn, in;
-      __m256 rs[4], is[4];
+      __m256 rs[gsize], is[gsize];
+
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 16 * ii;
+      auto p0 = rstate + row_size * s + (_pdep_u64(r, imaskh) | cvalsh);
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0);
-        is[4 * l] = _mm256_load_ps(p0 + 8);
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
+        rs[k2] = _mm256_load_ps(p0 + p);
+        is[k2] = _mm256_load_ps(p0 + p + 8);
+
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -672,76 +561,86 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm256_store_ps(p0 + p, rn);
+        _mm256_store_ps(p0 + p + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, idx, size, raw_size, rstate);
-  }
+    if (CH) {
+      auto m = GetMasks5<H, L, 3>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
 
-  void ApplyGate3HHH(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
+      unsigned k = 3 + H + cqs.size();
+      unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+      uint64_t size = uint64_t{1} << n;
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
+      for_.Run(size * size2, f, w, m.imaskh, m.qmaskh,
+               m.cvalsh, idx, size, raw_size, state.get());
+    } else {
+      auto m = GetMasks6<H, L, 3>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillControlledMatrixL<H, L, 3>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
+
+      unsigned k = 3 + H + cqs.size() - m.cl;
+      unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+      uint64_t size = uint64_t{1} << n;
+
+      for_.Run(size * size2, f, w, m.imaskh, m.qmaskh,
+               m.cvalsh, idx, size, raw_size, state.get());
     }
+  }
+
+#else  // __BMI2__
 
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
+                const uint64_t* ms, const uint64_t* xss, uint64_t size,
+                uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m256 ru, iu, rn, in;
-      __m256 rs[8], is[8];
+      __m256 rs[hsize], is[hsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]);
+      uint64_t r = 8 * (i % size);
+      uint64_t s = i / size;
+
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
+      }
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm256_load_ps(p0 + xss[k]);
+        is[k] = _mm256_load_ps(p0 + xss[k] + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 8; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm256_set1_ps(v[j]);
         iu = _mm256_set1_ps(v[j + 1]);
         rn = _mm256_mul_ps(rs[0], ru);
@@ -751,119 +650,74 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm256_set1_ps(v[j]);
           iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 6;
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, state.get());
   }
 
-  void ApplyGate3HHL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                const uint64_t* ms, const uint64_t* xss, const __m256i* idx,
+                uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        unsigned l = 2 * (8 * i + m);
+      __m256 rn, in;
+      __m256 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+      uint64_t r = 8 * (i % size);
+      uint64_t s = i / size;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2]);
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        rs[k2] = _mm256_load_ps(p0 + xss[k]);
+        is[k2] = _mm256_load_ps(p0 + xss[k] + 8);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -871,206 +725,149 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
+
+    auto m = GetMasks11<L>(qs);
 
-    unsigned k = 5;
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
+
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
+    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, state.get());
   }
 
-  void ApplyGate3HLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, uint64_t size, uint64_t row_size,
+                fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-        unsigned l = 2 * (8 * i + m);
+      __m256 ru, iu, rn, in;
+      __m256 rs[hsize], is[hsize];
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+      uint64_t r = 8 * (i % size);
+      uint64_t s = i / size;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]);
+      if ((t & cmaskh) != cvalsh) return;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm256_load_ps(p0 + xss[k]);
+        is[k] = _mm256_load_ps(p0 + xss[k] + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
+      for (unsigned k = 0; k < hsize; ++k) {
+        ru = _mm256_set1_ps(v[j]);
+        iu = _mm256_set1_ps(v[j + 1]);
+        rn = _mm256_mul_ps(rs[0], ru);
+        in = _mm256_mul_ps(rs[0], iu);
+        rn = _mm256_fnmadd_ps(is[0], iu, rn);
+        in = _mm256_fmadd_ps(is[0], ru, in);
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < hsize; ++l) {
+          ru = _mm256_set1_ps(v[j]);
+          iu = _mm256_set1_ps(v[j + 1]);
+          rn = _mm256_fmadd_ps(rs[l], ru, rn);
+          in = _mm256_fmadd_ps(rs[l], iu, in);
+          rn = _mm256_fnmadd_ps(is[l], iu, rn);
+          in = _mm256_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 4;
+    auto m = GetMasks7(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             matrix, ms, xss, m.cvalsh, m.cmaskh, size, raw_size, state.get());
   }
 
-  void ApplyGate3LLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, uint64_t size, uint64_t row_size,
+                fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-        unsigned l = 2 * (8 * i + m);
+      __m256 rn, in;
+      __m256 rs[hsize], is[hsize];
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
+      uint64_t r = 8 * (i % size);
+      uint64_t s = i / size;
 
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 16 * ii;
+      if ((t & cmaskh) != cvalsh) return;
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0);
-        is[8 * l] = _mm256_load_ps(p0 + 8);
+      auto p0 = rstate + row_size * s + 2 * t;
 
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm256_load_ps(p0 + xss[k]);
+        is[k] = _mm256_load_ps(p0 + xss[k] + 8);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm256_mul_ps(rs[0], w[j]);
         in = _mm256_mul_ps(rs[0], w[j + 1]);
         rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
@@ -1078,4650 +875,148 @@ class UnitaryCalculatorAVX final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m256 w[1 << (1 + 2 * H)];
+
+    auto m = GetMasks8<3>(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+    FillControlledMatrixH<H, 3>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
 
-    unsigned k = 3;
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, idx, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             w, ms, xss, m.cvalsh, m.cmaskh, size, raw_size, state.get());
   }
 
-  void ApplyGate4HHHH(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, const __m256i* idx, uint64_t size,
+                uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
+      __m256 rn, in;
+      __m256 rs[gsize], is[gsize];
+
+      uint64_t r = 8 * (i % size);
+      uint64_t s = i / size;
+
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-      xss[i] = a;
-    }
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[16], is[16];
+      if ((t & cmaskh) != cvalsh) return;
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]) | (128 * ii & ms[4]);
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
+        rs[k2] = _mm256_load_ps(p0 + xss[k]);
+        is[k2] = _mm256_load_ps(p0 + xss[k] + 8);
+
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm256_permutevar8x32_ps(rs[k2], idx[l - 1]);
+          is[k2 + l] = _mm256_permutevar8x32_ps(is[k2], idx[l - 1]);
+        }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rn = _mm256_mul_ps(rs[0], w[j]);
+        in = _mm256_mul_ps(rs[0], w[j + 1]);
+        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
+        in = _mm256_fmadd_ps(is[0], w[j], in);
 
         j += 2;
 
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm256_fmadd_ps(rs[l], w[j], rn);
+          in = _mm256_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm256_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm256_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
+        _mm256_store_ps(p0 + xss[k], rn);
+        _mm256_store_ps(p0 + xss[k] + 8, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m256i idx[1 << L];
+    __m256 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 7;
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 3 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
+    if (CH) {
+      auto m = GetMasks9<L>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillMatrix<H, L, 3>(m.qmaskl, matrix, (fp_type*) w);
 
-  void ApplyGate4HHHL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
+      for_.Run(size * size2, f, w, ms, xss, m.cvalsh,
+               m.cmaskh, idx, size, raw_size, state.get());
+    } else {
+      auto m = GetMasks10<L, 3>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillControlledMatrixL<H, L, 3>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
 
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
+      for_.Run(size * size2, f, w, ms, xss, m.cvalsh,
+               m.cmaskh, idx, size, raw_size, state.get());
     }
+  }
 
-    unsigned p[8];
-    __m256i idx[1];
+#endif  // __BMI2__
 
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
+  template <unsigned L>
+  static void FillPermutationIndices(unsigned qmaskl, __m256i* idx) {
+    constexpr unsigned lsize = 1 << L;
 
-    unsigned qmask = (1 << qs[0]);
+    for (unsigned i = 0; i < lsize - 1; ++i) {
+      unsigned p[8];
 
-    for (unsigned i = 0; i < 1; ++i) {
       for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
+        p[j] = MaskedAdd<3>(j, i + 1, qmaskl, lsize) | (j & (-1 ^ qmaskl));
       }
 
       idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
     }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate4HHLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate4HLLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHHH(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]) | (128 * ii & ms[4]) | (256 * ii & ms[5]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHHL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]) | (128 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHLLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (256 * i + 32 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHHH(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]) | (128 * ii & ms[4]) | (256 * ii & ms[5])
-          | (512 * ii & ms[6]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHHL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(7);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]) | (128 * ii & ms[4]) | (256 * ii & ms[5]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(7);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]) | (128 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHLLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (512 * i + 64 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (8 * ii & ms[0]) | (16 * ii & ms[1]) | (32 * ii & ms[2])
-          | (64 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1H_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1H_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (2 * i + 2 * k + m);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1L_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(2);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0);
-        is[2 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1L_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(2);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0);
-        is[2 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HH_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HH_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (4 * i + 4 * k + m);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2LL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0);
-        is[4 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2LL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0);
-        is[4 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHH_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHH_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (8 * i + 8 * k + m);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3LLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0);
-        is[8 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3LLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(3);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0);
-        is[8 * l] = _mm256_load_ps(p0 + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0, rn);
-        _mm256_store_ps(p0 + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 ru, iu, rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm256_set1_ps(v[j]);
-        iu = _mm256_set1_ps(v[j + 1]);
-        rn = _mm256_mul_ps(rs[0], ru);
-        in = _mm256_mul_ps(rs[0], iu);
-        rn = _mm256_fnmadd_ps(is[0], iu, rn);
-        in = _mm256_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm256_set1_ps(v[j]);
-          iu = _mm256_set1_ps(v[j + 1]);
-          rn = _mm256_fmadd_ps(rs[n], ru, rn);
-          in = _mm256_fmadd_ps(rs[n], iu, in);
-          rn = _mm256_fnmadd_ps(is[n], iu, rn);
-          in = _mm256_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-
-    auto s = UnitarySpace::Create(6);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (16 * i + 16 * k + m);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm256_load_ps(p0 + xss[l]);
-        is[l] = _mm256_load_ps(p0 + xss[l] + 8);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[1];
-
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm256_permutevar8x32_ps(rs[2 * l], idx[j - 1]);
-          is[2 * l + j] = _mm256_permutevar8x32_ps(is[2 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[3];
-
-    auto s = UnitarySpace::Create(5);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm256_permutevar8x32_ps(rs[4 * l], idx[j - 1]);
-          is[4 * l + j] = _mm256_permutevar8x32_ps(is[4 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 3, emaskl);
-
-    for (auto q : qs) {
-      if (q > 2) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 7;
-
-    unsigned p[8];
-    __m256i idx[7];
-
-    auto s = UnitarySpace::Create(4);
-    __m256* w = (__m256*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 8; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm256_set_epi32(p[7], p[6], p[5], p[4], p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 8; ++j) {
-          unsigned k = bits::CompressBits(j, 3, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 8; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[8 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 8; ++j) {
-          wf[8 * l + j + 8] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m256* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m256i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m256 rn, in;
-      __m256 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm256_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm256_load_ps(p0 + xss[l] + 8);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm256_permutevar8x32_ps(rs[8 * l], idx[j - 1]);
-          is[8 * l + j] = _mm256_permutevar8x32_ps(is[8 * l], idx[j - 1]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm256_mul_ps(rs[0], w[j]);
-        in = _mm256_mul_ps(rs[0], w[j + 1]);
-        rn = _mm256_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm256_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm256_fmadd_ps(rs[n], w[j], rn);
-          in = _mm256_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm256_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm256_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm256_store_ps(p0 + xss[l], rn);
-        _mm256_store_ps(p0 + xss[l] + 8, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  static unsigned MaskedAdd(
-      unsigned a, unsigned b, unsigned mask, unsigned lsize) {
-    unsigned c = bits::CompressBits(a, 3, mask);
-    return bits::ExpandBits((c + b) % lsize, 3, mask);
   }
 
   For for_;
diff --git a/lib/unitary_calculator_avx512.h b/lib/unitary_calculator_avx512.h
index 57ba6484..4020e313 100644
--- a/lib/unitary_calculator_avx512.h
+++ b/lib/unitary_calculator_avx512.h
@@ -17,21 +17,22 @@
 
 #include <immintrin.h>
 
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "unitaryspace_avx512.h"
 
 namespace qsim {
 namespace unitary {
 
 /**
- * Quantum circuit unitary calculator with AVX512 vectorization.
+ * Quantum circuit simulator with AVX512 vectorization.
  */
 template <typename For>
-class UnitaryCalculatorAVX512 final {
+class UnitaryCalculatorAVX512 final : public SimulatorBase {
  public:
   using UnitarySpace = UnitarySpaceAVX512<For>;
   using Unitary = typename UnitarySpace::Unitary;
@@ -50,74 +51,74 @@ class UnitaryCalculatorAVX512 final {
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyGate(const std::vector<unsigned>& qs,
-                 const fp_type* matrix, Unitary& state) const {
+                 const fp_type* matrix, State& state) const {
     // Assume qs[0] < qs[1] < qs[2] < ... .
 
     switch (qs.size()) {
     case 1:
       if (qs[0] > 3) {
-        ApplyGate1H(qs, matrix, state);
+        ApplyGateH<1>(qs, matrix, state);
       } else {
-        ApplyGate1L(qs, matrix, state);
+        ApplyGateL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 3) {
-        ApplyGate2HH(qs, matrix, state);
+        ApplyGateH<2>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate2HL(qs, matrix, state);
+        ApplyGateL<1, 1>(qs, matrix, state);
       } else {
-        ApplyGate2LL(qs, matrix, state);
+        ApplyGateL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 3) {
-        ApplyGate3HHH(qs, matrix, state);
+        ApplyGateH<3>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate3HHL(qs, matrix, state);
+        ApplyGateL<2, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate3HLL(qs, matrix, state);
+        ApplyGateL<1, 2>(qs, matrix, state);
       } else {
-        ApplyGate3LLL(qs, matrix, state);
+        ApplyGateL<0, 3>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 3) {
-        ApplyGate4HHHH(qs, matrix, state);
+        ApplyGateH<4>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate4HHHL(qs, matrix, state);
+        ApplyGateL<3, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate4HHLL(qs, matrix, state);
+        ApplyGateL<2, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        ApplyGate4HLLL(qs, matrix, state);
+        ApplyGateL<1, 3>(qs, matrix, state);
       } else {
-        ApplyGate4LLLL(qs, matrix, state);
+        ApplyGateL<0, 4>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 3) {
-        ApplyGate5HHHHH(qs, matrix, state);
+        ApplyGateH<5>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate5HHHHL(qs, matrix, state);
+        ApplyGateL<4, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate5HHHLL(qs, matrix, state);
+        ApplyGateL<3, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        ApplyGate5HHLLL(qs, matrix, state);
+        ApplyGateL<2, 3>(qs, matrix, state);
       } else {
-        ApplyGate5HLLLL(qs, matrix, state);
+        ApplyGateL<1, 4>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 3) {
-        ApplyGate6HHHHHH(qs, matrix, state);
+        ApplyGateH<6>(qs, matrix, state);
       } else if (qs[1] > 3) {
-        ApplyGate6HHHHHL(qs, matrix, state);
+        ApplyGateL<5, 1>(qs, matrix, state);
       } else if (qs[2] > 3) {
-        ApplyGate6HHHHLL(qs, matrix, state);
+        ApplyGateL<4, 2>(qs, matrix, state);
       } else if (qs[3] > 3) {
-        ApplyGate6HHHLLL(qs, matrix, state);
+        ApplyGateL<3, 3>(qs, matrix, state);
       } else {
-        ApplyGate6HHLLLL(qs, matrix, state);
+        ApplyGateL<2, 4>(qs, matrix, state);
       }
       break;
     default:
@@ -130,13 +131,16 @@ class UnitaryCalculatorAVX512 final {
    * Applies a controlled gate using AVX512 instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
-                           const fp_type* matrix, Unitary& state) const {
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
+                           const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+    // Assume cqs[0] < cqs[1] < cqs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -146,96 +150,96 @@ class UnitaryCalculatorAVX512 final {
     case 1:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate1H_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1H_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<1>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate1L_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1L_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 2:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate2HH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<2>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<2>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate2HL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate2LL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2LL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 3:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate3HHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<3>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<3>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate3HHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate3HLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate3LLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3LLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 4:
       if (qs[0] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HHHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<4>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<4>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HHHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[2] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HHLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[3] > 3) {
         if (cqs[0] > 3) {
-          ApplyControlledGate4HLLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HLLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 3, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 3) {
-          ApplyControlledGate4LLLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 4, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4LLLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 4, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
@@ -253,46 +257,32 @@ class UnitaryCalculatorAVX512 final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, uint64_t size,
+                uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m512 ru, iu, rn, in;
-      __m512 rs[2], is[2];
+      __m512 rs[hsize], is[hsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]);
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + _pdep_u64(r, imaskh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        rs[k] = _mm512_load_ps(p0 + p);
+        is[k] = _mm512_load_ps(p0 + p + 16);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm512_set1_ps(v[j]);
         iu = _mm512_set1_ps(v[j + 1]);
         rn = _mm512_mul_ps(rs[0], ru);
@@ -302,96 +292,70 @@ class UnitaryCalculatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm512_set1_ps(v[j]);
           iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
+          rn = _mm512_fmadd_ps(rs[l], ru, rn);
+          in = _mm512_fmadd_ps(rs[l], iu, in);
+          rn = _mm512_fnmadd_ps(is[l], iu, rn);
+          in = _mm512_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks1<H, 4>(qs);
 
-    unsigned k = 5;
+    unsigned k = 4 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             matrix, m.imaskh, m.qmaskh, size, raw_size, state.get());
   }
 
-  void ApplyGate1L(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(3);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
+                uint64_t imaskh, uint64_t qmaskh, const __m512i* idx,
+                uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
+      __m512 rn, in;
+      __m512 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
+      auto p0 = rstate + row_size * s + _pdep_u64(r, imaskh);
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 32 * ii;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0);
-        is[2 * l] = _mm512_load_ps(p0 + 16);
+        rs[k2] = _mm512_load_ps(p0 + p);
+        is[k2] = _mm512_load_ps(p0 + p + 16);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], rs[k2]);
+          is[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], is[k2]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm512_mul_ps(rs[0], w[j]);
         in = _mm512_mul_ps(rs[0], w[j + 1]);
         rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
@@ -399,75 +363,66 @@ class UnitaryCalculatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm512_fmadd_ps(rs[l], w[j], rn);
+          in = _mm512_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm512_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm512_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m512i idx[1 << L];
+    __m512 w[1 << (1 + 2 * H + L)];
+
+    auto m = GetMasks2<H, L, 4>(qs);
+    FillPermutationIndices<L>(m.qmaskl, idx);
+    FillMatrix<H, L, 4>(m.qmaskl, matrix, (fp_type*) w);
 
-    unsigned k = 4;
+    unsigned k = 4 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, idx, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             w, m.imaskh, m.qmaskh, idx, size, raw_size, state.get());
   }
 
-  void ApplyGate2HH(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m512 ru, iu, rn, in;
-      __m512 rs[4], is[4];
+      __m512 rs[hsize], is[hsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2]);
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + (_pdep_u64(r, imaskh) | cvalsh);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        rs[k] = _mm512_load_ps(p0 + p);
+        is[k] = _mm512_load_ps(p0 + p + 16);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm512_set1_ps(v[j]);
         iu = _mm512_set1_ps(v[j + 1]);
         rn = _mm512_mul_ps(rs[0], ru);
@@ -477,117 +432,63 @@ class UnitaryCalculatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm512_set1_ps(v[j]);
           iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
+          rn = _mm512_fmadd_ps(rs[l], ru, rn);
+          in = _mm512_fmadd_ps(rs[l], iu, in);
+          rn = _mm512_fnmadd_ps(is[l], iu, rn);
+          in = _mm512_fmadd_ps(is[l], ru, in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks3<H, 4>(state.num_qubits(), qs, cqs, cvals);
 
-    unsigned k = 6;
+    unsigned k = 4 + H + cqs.size();
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             matrix, m.imaskh, m.qmaskh, m.cvalsh, size, raw_size, state.get());
   }
 
-  void ApplyGate2HL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
+                uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m512 rn, in;
-      __m512 rs[4], is[4];
+      __m512 rs[hsize], is[hsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]);
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + (_pdep_u64(r, imaskh) | cvalsh);
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
+      for (unsigned k = 0; k < hsize; ++k) {
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
+        rs[k] = _mm512_load_ps(p0 + p);
+        is[k] = _mm512_load_ps(p0 + p + 16);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm512_mul_ps(rs[0], w[j]);
         in = _mm512_mul_ps(rs[0], w[j + 1]);
         rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
@@ -595,295 +496,73 @@ class UnitaryCalculatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm512_fmadd_ps(rs[l], w[j], rn);
+          in = _mm512_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm512_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm512_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate2LL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(3);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 32 * ii;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0);
-        is[4 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate3HHH(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
+    __m512 w[1 << (1 + 2 * H)];
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks4<H, 4>(state.num_qubits(), qs, cqs, cvals);
+    FillControlledMatrixH<H, 4>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
 
-    unsigned k = 7;
+    unsigned k = 4 + H + cqs.size() - m.cl;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             w, m.imaskh, m.qmaskh, m.cvalsh, size, raw_size, state.get());
   }
 
-  void ApplyGate3HHL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
+                uint64_t imaskh, uint64_t qmaskh, uint64_t cvalsh,
                 const __m512i* idx, uint64_t size, uint64_t row_size,
                 fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
+
       __m512 rn, in;
-      __m512 rs[8], is[8];
+      __m512 rs[gsize], is[gsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2]);
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + (_pdep_u64(r, imaskh) | cvalsh);
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
+        uint64_t p = _pdep_u64(k, qmaskh);
 
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
+        rs[k2] = _mm512_load_ps(p0 + p);
+        is[k2] = _mm512_load_ps(p0 + p + 16);
+
+        for (unsigned l = 1; l < lsize; ++l) {
+          rs[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], rs[k2]);
+          is[k2 + l] = _mm512_permutexvar_ps(idx[l - 1], is[k2]);
         }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm512_mul_ps(rs[0], w[j]);
         in = _mm512_mul_ps(rs[0], w[j + 1]);
         rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
@@ -891,5489 +570,69 @@ class UnitaryCalculatorAVX512 final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm512_fmadd_ps(rs[l], w[j], rn);
+          in = _mm512_fmadd_ps(rs[l], w[j + 1], in);
+          rn = _mm512_fnmadd_ps(is[l], w[j + 1], rn);
+          in = _mm512_fmadd_ps(is[l], w[j], in);
 
           j += 2;
         }
 
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
+        uint64_t p = _pdep_u64(k, qmaskh);
+
+        _mm512_store_ps(p0 + p, rn);
+        _mm512_store_ps(p0 + p + 16, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    __m512i idx[1 << L];
+    __m512 w[1 << (1 + 2 * H + L)];
 
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
+    if (CH) {
+      auto m = GetMasks5<H, L, 4>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillMatrix<H, L, 4>(m.qmaskl, matrix, (fp_type*) w);
 
-  void ApplyGate3HLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
+      unsigned k = 4 + H + cqs.size();
+      unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+      uint64_t size = uint64_t{1} << n;
 
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
+      for_.Run(size * size2, f, w, m.imaskh, m.qmaskh,
+               m.cvalsh, idx, size, raw_size, state.get());
+    } else {
+      auto m = GetMasks6<H, L, 4>(state.num_qubits(), qs, cqs, cvals);
+      FillPermutationIndices<L>(m.qmaskl, idx);
+      FillControlledMatrixL<H, L, 4>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
 
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
+      unsigned k = 4 + H + cqs.size() - m.cl;
+      unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+      uint64_t size = uint64_t{1} << n;
 
-    unsigned p[16];
-    __m512i idx[3];
+      for_.Run(size * size2, f, w, m.imaskh, m.qmaskh,
+               m.cvalsh, idx, size, raw_size, state.get());
+    }
+  }
 
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
+  template <unsigned L>
+  static void FillPermutationIndices(unsigned qmaskl, __m512i* idx) {
+    constexpr unsigned lsize = 1 << L;
 
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
+    for (unsigned i = 0; i < lsize; ++i) {
+      unsigned p[16];
 
-    for (unsigned i = 0; i < 3; ++i) {
       for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
+        p[j] = MaskedAdd<4>(j, i + 1, qmaskl, lsize) | (j & (-1 ^ qmaskl));
       }
 
       idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
                                 p[9], p[8], p[7], p[6], p[5], p[4],
                                 p[3], p[2], p[1], p[0]);
     }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate3LLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 32 * ii;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0);
-        is[8 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate4HHHH(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]) | (256 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate4HHHL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate4HHLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate4HLLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate4LLLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 16 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 32 * ii;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0);
-        is[16 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHHH(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]) | (256 * ii & ms[4]) | (512 * ii & ms[5]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHHL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]) | (256 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHLLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 32 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HLLLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[4] + 1);
-    ms[0] = (uint64_t{1} << qs[4]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (512 * i + 32 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[16 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHHH(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]) | (256 * ii & ms[4]) | (512 * ii & ms[5])
-          | (1024 * ii & ms[6]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 10;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHHL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(8);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]) | (256 * ii & ms[4]) | (512 * ii & ms[5]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 9;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]) | (256 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHLLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 3] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 3]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(7);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (512 * i + 64 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2])
-          | (128 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHLLLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[4] + 1);
-    ms[0] = (uint64_t{1} << qs[4]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 4] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 4]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = UnitarySpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (1024 * i + 64 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (16 * ii & ms[0]) | (32 * ii & ms[1]) | (64 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[16 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1H_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1H_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = UnitarySpace::Create(3);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (2 * i + 2 * k + m);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1L_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(3);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0);
-        is[2 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1L_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(3);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0);
-        is[2 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HH_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HH_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (4 * i + 4 * k + m);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2LL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(3);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0);
-        is[4 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2LL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(3);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0);
-        is[4 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHH_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHH_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (8 * i + 8 * k + m);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3LLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0);
-        is[8 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3LLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 8 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0);
-        is[8 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 ru, iu, rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm512_set1_ps(v[j]);
-        iu = _mm512_set1_ps(v[j + 1]);
-        rn = _mm512_mul_ps(rs[0], ru);
-        in = _mm512_mul_ps(rs[0], iu);
-        rn = _mm512_fnmadd_ps(is[0], iu, rn);
-        in = _mm512_fmadd_ps(is[0], ru, in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm512_set1_ps(v[j]);
-          iu = _mm512_set1_ps(v[j + 1]);
-          rn = _mm512_fmadd_ps(rs[n], ru, rn);
-          in = _mm512_fmadd_ps(rs[n], iu, in);
-          rn = _mm512_fnmadd_ps(is[n], iu, rn);
-          in = _mm512_fmadd_ps(is[n], ru, in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-
-    auto s = UnitarySpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (16 * i + 16 * k + m);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm512_load_ps(p0 + xss[l]);
-        is[l] = _mm512_load_ps(p0 + xss[l] + 16);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[1];
-
-    auto s = UnitarySpace::Create(6);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 2) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 2; ++j) {
-          rs[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[2 * l]);
-          is[2 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[2 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[3];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 3; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 4) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 4; ++j) {
-          rs[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[4 * l]);
-          is[4 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[4 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HLLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[3] + 1);
-    ms[0] = (uint64_t{1} << qs[3]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[7];
-
-    auto s = UnitarySpace::Create(5);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]);
-
-    for (unsigned i = 0; i < 7; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 8) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (128 * i + 16 * k + 8 * (m / 8) + (k + m) % 8);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[8 * l] = _mm512_load_ps(p0 + xss[l]);
-        is[8 * l] = _mm512_load_ps(p0 + xss[l] + 16);
-
-        for (unsigned j = 1; j < 8; ++j) {
-          rs[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[8 * l]);
-          is[8 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[8 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0 + xss[l], rn);
-        _mm512_store_ps(p0 + xss[l] + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4LLLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 16 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0);
-        is[16 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4LLLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 4, emaskl);
-
-    for (auto q : qs) {
-      if (q > 3) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 15;
-
-    unsigned p[16];
-    __m512i idx[15];
-
-    auto s = UnitarySpace::Create(4);
-    __m512* w = (__m512*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]) | (1 << qs[2]) | (1 << qs[3]);
-
-    for (unsigned i = 0; i < 15; ++i) {
-      for (unsigned j = 0; j < 16; ++j) {
-        p[j] = MaskedAdd(j, i + 1, qmask, 16) | (j & (-1 ^ qmask));
-      }
-
-      idx[i] = _mm512_set_epi32(p[15], p[14], p[13], p[12], p[11], p[10],
-                                p[9], p[8], p[7], p[6], p[5], p[4],
-                                p[3], p[2], p[1], p[0]);
-    }
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 16; ++j) {
-          unsigned k = bits::CompressBits(j, 4, qmask);
-          p[j] = 2 * (256 * i + 16 * k + 16 * (m / 16) + (k + m) % 16);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 16; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[16 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 16; ++j) {
-          wf[16 * l + j + 16] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m512* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                const __m512i* idx, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m512 rn, in;
-      __m512 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[16 * l] = _mm512_load_ps(p0);
-        is[16 * l] = _mm512_load_ps(p0 + 16);
-
-        for (unsigned j = 1; j < 16; ++j) {
-          rs[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], rs[16 * l]);
-          is[16 * l + j] = _mm512_permutexvar_ps(idx[j - 1], is[16 * l]);
-        }
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm512_mul_ps(rs[0], w[j]);
-        in = _mm512_mul_ps(rs[0], w[j + 1]);
-        rn = _mm512_fnmadd_ps(is[0], w[j + 1], rn);
-        in = _mm512_fmadd_ps(is[0], w[j], in);
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm512_fmadd_ps(rs[n], w[j], rn);
-          in = _mm512_fmadd_ps(rs[n], w[j + 1], in);
-          rn = _mm512_fnmadd_ps(is[n], w[j + 1], rn);
-          in = _mm512_fmadd_ps(is[n], w[j], in);
-
-          j += 2;
-        }
-
-        _mm512_store_ps(p0, rn);
-        _mm512_store_ps(p0 + 16, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, idx, size, raw_size, rstate);
-  }
-
-  static unsigned MaskedAdd(
-      unsigned a, unsigned b, unsigned mask, unsigned lsize) {
-    unsigned c = bits::CompressBits(a, 4, mask);
-    return bits::ExpandBits((c + b) % lsize, 4, mask);
   }
 
   For for_;
diff --git a/lib/unitary_calculator_basic.h b/lib/unitary_calculator_basic.h
index df5a3067..6b1821a9 100644
--- a/lib/unitary_calculator_basic.h
+++ b/lib/unitary_calculator_basic.h
@@ -15,12 +15,12 @@
 #ifndef UNITARY_CALCULATOR_BASIC_H_
 #define UNITARY_CALCULATOR_BASIC_H_
 
-
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "unitaryspace_basic.h"
 
 namespace qsim {
@@ -30,7 +30,7 @@ namespace unitary {
  * Quantum circuit unitary calculator without vectorization.
  */
 template <typename For, typename FP = float>
-class UnitaryCalculatorBasic final {
+class UnitaryCalculatorBasic final : public SimulatorBase {
  public:
   using UnitarySpace = UnitarySpaceBasic<For, FP>;
   using Unitary = typename UnitarySpace::Unitary;
@@ -49,27 +49,27 @@ class UnitaryCalculatorBasic final {
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyGate(const std::vector<unsigned>& qs,
-                 const fp_type* matrix, Unitary& state) const {
+                 const fp_type* matrix, State& state) const {
     // Assume qs[0] < qs[1] < qs[2] < ... .
 
     switch (qs.size()) {
     case 1:
-      ApplyGate1H(qs, matrix, state);
+      ApplyGateH<1>(qs, matrix, state);
       break;
     case 2:
-      ApplyGate2H(qs, matrix, state);
+      ApplyGateH<2>(qs, matrix, state);
       break;
     case 3:
-      ApplyGate3H(qs, matrix, state);
+      ApplyGateH<3>(qs, matrix, state);
       break;
     case 4:
-      ApplyGate4H(qs, matrix, state);
+      ApplyGateH<4>(qs, matrix, state);
       break;
     case 5:
-      ApplyGate5H(qs, matrix, state);
+      ApplyGateH<5>(qs, matrix, state);
       break;
     case 6:
-      ApplyGate6H(qs, matrix, state);
+      ApplyGateH<6>(qs, matrix, state);
       break;
     default:
       // Not implemented.
@@ -81,13 +81,15 @@ class UnitaryCalculatorBasic final {
    * Applies a controlled gate using non-vectorized instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
-                           const fp_type* matrix, Unitary& state) const {
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
+                           const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -95,16 +97,16 @@ class UnitaryCalculatorBasic final {
 
     switch (qs.size()) {
     case 1:
-      ApplyControlledGate1H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<1>(qs, cqs, cvals, matrix, state);
       break;
     case 2:
-      ApplyControlledGate2H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<2>(qs, cqs, cvals, matrix, state);
       break;
     case 3:
-      ApplyControlledGate3H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<3>(qs, cqs, cvals, matrix, state);
       break;
     case 4:
-      ApplyControlledGate4H(qs, cqs, cmask, matrix, state);
+      ApplyControlledGateH<4>(qs, cqs, cvals, matrix, state);
       break;
     default:
       // Not implemented.
@@ -120,793 +122,132 @@ class UnitaryCalculatorBasic final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (1 * ii & ms[0]) | (2 * ii & ms[1]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 1;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate2H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
+                const uint64_t* ms, const uint64_t* xss, uint64_t size,
+                uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
       fp_type rn, in;
-      fp_type rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (1 * ii & ms[0]) | (2 * ii & ms[1]) | (4 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
+      fp_type rs[hsize], is[hsize];
 
-  void ApplyGate3H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (1 * ii & ms[0]) | (2 * ii & ms[1]) | (4 * ii & ms[2])
-          | (8 * ii & ms[3]);
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = *(p0 + xss[k]);
+        is[k] = *(p0 + xss[k] + 1);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 8; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = rs[0] * v[j] - is[0] * v[j + 1];
         in = rs[0] * v[j + 1] + is[0] * v[j];
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn += rs[l] * v[j] - is[l] * v[j + 1];
+          in += rs[l] * v[j + 1] + is[l] * v[j];
 
           j += 2;
         }
 
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
+        *(p0 + xss[k]) = rn;
+        *(p0 + xss[k] + 1) = in;
       }
     };
 
-    fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate4H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (1 * ii & ms[0]) | (2 * ii & ms[1]) | (4 * ii & ms[2])
-          | (8 * ii & ms[3]) | (16 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    fp_type* rstate = state.get();
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
 
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    unsigned n = state.num_qubits() > H ? state.num_qubits() - H : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, state.get());
   }
 
-  void ApplyGate5H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateH(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs,
+                            uint64_t cvals, const fp_type* matrix,
+                            State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (1 * ii & ms[0]) | (2 * ii & ms[1]) | (4 * ii & ms[2])
-          | (8 * ii & ms[3]) | (16 * ii & ms[4]) | (32 * ii & ms[5]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, uint64_t size, uint64_t row_size,
+                fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate6H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
       fp_type rn, in;
-      fp_type rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (1 * ii & ms[0]) | (2 * ii & ms[1]) | (4 * ii & ms[2])
-          | (8 * ii & ms[3]) | (16 * ii & ms[4]) | (32 * ii & ms[5])
-          | (64 * ii & ms[6]);
+      fp_type rs[hsize], is[hsize];
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      uint64_t r = i % size;
+      uint64_t s = i / size;
 
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
 
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
+      if ((t & cmaskh) == cvalsh) {
+        auto p0 = rstate + row_size * s + 2 * t;
 
-          j += 2;
+        for (unsigned k = 0; k < hsize; ++k) {
+          rs[k] = *(p0 + xss[k]);
+          is[k] = *(p0 + xss[k] + 1);
         }
 
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[2], is[2];
+        uint64_t j = 0;
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
+        for (unsigned k = 0; k < hsize; ++k) {
+          rn = rs[0] * v[j] - is[0] * v[j + 1];
+          in = rs[0] * v[j + 1] + is[0] * v[j];
 
           j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 1 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
 
-    emaskh = ~emaskh;
+          for (unsigned l = 1; l < hsize; ++l) {
+            rn += rs[l] * v[j] - is[l] * v[j + 1];
+            in += rs[l] * v[j + 1] + is[l] * v[j];
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
+            j += 2;
+          }
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
+          *(p0 + xss[k]) = rn;
+          *(p0 + xss[k] + 1) = in;
         }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 2 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4H(const std::vector<unsigned>& qs,
-                             const std::vector<unsigned>& cqs,
-                             uint64_t cmask, const fp_type* matrix,
-                             Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      fp_type rn, in;
-      fp_type rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = *(p0 + xss[l]);
-        is[l] = *(p0 + xss[l] + 1);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = rs[0] * v[j] - is[0] * v[j + 1];
-        in = rs[0] * v[j + 1] + is[0] * v[j];
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn += rs[n] * v[j] - is[n] * v[j + 1];
-          in += rs[n] * v[j + 1] + is[n] * v[j];
-
-          j += 2;
-        }
-
-        *(p0 + xss[l]) = rn;
-        *(p0 + xss[l] + 1) = in;
-      }
-    };
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks7(state.num_qubits(), qs, cqs, cvals);
 
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
+    unsigned n = state.num_qubits() > H ? state.num_qubits() - H : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             matrix, ms, xss, m.cvalsh, m.cmaskh, size, raw_size, state.get());
   }
 
   For for_;
diff --git a/lib/unitary_calculator_sse.h b/lib/unitary_calculator_sse.h
index 2e458526..9ff9c98e 100644
--- a/lib/unitary_calculator_sse.h
+++ b/lib/unitary_calculator_sse.h
@@ -17,21 +17,22 @@
 
 #include <smmintrin.h>
 
-#include <algorithm>
 #include <complex>
 #include <cstdint>
+#include <functional>
+#include <vector>
 
-#include "bits.h"
+#include "simulator.h"
 #include "unitaryspace_sse.h"
 
 namespace qsim {
 namespace unitary {
 
 /**
- * Quantum circuit unitary calculator with SSE vectorization.
+ * Quantum circuit simulator with SSE vectorization.
  */
 template <typename For>
-class UnitaryCalculatorSSE final {
+class UnitaryCalculatorSSE final : public SimulatorBase {
  public:
   using UnitarySpace = UnitarySpaceSSE<For>;
   using Unitary = typename UnitarySpace::Unitary;
@@ -50,60 +51,60 @@ class UnitaryCalculatorSSE final {
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyGate(const std::vector<unsigned>& qs,
-                 const fp_type* matrix, Unitary& state) const {
+                 const fp_type* matrix, State& state) const {
     // Assume qs[0] < qs[1] < qs[2] < ... .
 
     switch (qs.size()) {
     case 1:
       if (qs[0] > 1) {
-        ApplyGate1H(qs, matrix, state);
+        ApplyGateH<1>(qs, matrix, state);
       } else {
-        ApplyGate1L(qs, matrix, state);
+        ApplyGateL<0, 1>(qs, matrix, state);
       }
       break;
     case 2:
       if (qs[0] > 1) {
-        ApplyGate2HH(qs, matrix, state);
+        ApplyGateH<2>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate2HL(qs, matrix, state);
+        ApplyGateL<1, 1>(qs, matrix, state);
       } else {
-        ApplyGate2LL(qs, matrix, state);
+        ApplyGateL<0, 2>(qs, matrix, state);
       }
       break;
     case 3:
       if (qs[0] > 1) {
-        ApplyGate3HHH(qs, matrix, state);
+        ApplyGateH<3>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate3HHL(qs, matrix, state);
+        ApplyGateL<2, 1>(qs, matrix, state);
       } else {
-        ApplyGate3HLL(qs, matrix, state);
+        ApplyGateL<1, 2>(qs, matrix, state);
       }
       break;
     case 4:
       if (qs[0] > 1) {
-        ApplyGate4HHHH(qs, matrix, state);
+        ApplyGateH<4>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate4HHHL(qs, matrix, state);
+        ApplyGateL<3, 1>(qs, matrix, state);
       } else {
-        ApplyGate4HHLL(qs, matrix, state);
+        ApplyGateL<2, 2>(qs, matrix, state);
       }
       break;
     case 5:
       if (qs[0] > 1) {
-        ApplyGate5HHHHH(qs, matrix, state);
+        ApplyGateH<5>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate5HHHHL(qs, matrix, state);
+        ApplyGateL<4, 1>(qs, matrix, state);
       } else {
-        ApplyGate5HHHLL(qs, matrix, state);
+        ApplyGateL<3, 2>(qs, matrix, state);
       }
       break;
     case 6:
       if (qs[0] > 1) {
-        ApplyGate6HHHHHH(qs, matrix, state);
+        ApplyGateH<6>(qs, matrix, state);
       } else if (qs[1] > 1) {
-        ApplyGate6HHHHHL(qs, matrix, state);
+        ApplyGateL<5, 1>(qs, matrix, state);
       } else {
-        ApplyGate6HHHHLL(qs, matrix, state);
+        ApplyGateL<4, 2>(qs, matrix, state);
       }
       break;
     default:
@@ -116,13 +117,16 @@ class UnitaryCalculatorSSE final {
    * Applies a controlled gate using SSE instructions.
    * @param qs Indices of the qubits affected by this gate.
    * @param cqs Indices of control qubits.
-   * @param cmask Bit mask of control qubit values.
+   * @param cvals Bit mask of control qubit values.
    * @param matrix Matrix representation of the gate to be applied.
    * @param state The state of the system, to be updated by this method.
    */
   void ApplyControlledGate(const std::vector<unsigned>& qs,
-                           const std::vector<unsigned>& cqs, uint64_t cmask,
-                           const fp_type* matrix, Unitary& state) const {
+                           const std::vector<unsigned>& cqs, uint64_t cvals,
+                           const fp_type* matrix, State& state) const {
+    // Assume qs[0] < qs[1] < qs[2] < ... .
+    // Assume cqs[0] < cqs[1] < cqs[2] < ... .
+
     if (cqs.size() == 0) {
       ApplyGate(qs, matrix, state);
       return;
@@ -132,78 +136,78 @@ class UnitaryCalculatorSSE final {
     case 1:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate1H_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1H_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<1>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate1L_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate1L_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 2:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate2HH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<2>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<2>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate2HL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2HL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate2LL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate2LL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<0, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 3:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate3HHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<3>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<3>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate3HHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate3HLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate3HLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<1, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
     case 4:
       if (qs[0] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate4HHHH_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHH<4>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHH_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateHL<4>(qs, cqs, cvals, matrix, state);
         }
       } else if (qs[1] > 1) {
         if (cqs[0] > 1) {
-          ApplyControlledGate4HHHL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHHL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<3, 1, 0>(qs, cqs, cvals, matrix, state);
         }
       } else {
         if (cqs[0] > 1) {
-          ApplyControlledGate4HHLL_H(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 1>(qs, cqs, cvals, matrix, state);
         } else {
-          ApplyControlledGate4HHLL_L(qs, cqs, cmask, matrix, state);
+          ApplyControlledGateL<2, 2, 0>(qs, cqs, cvals, matrix, state);
         }
       }
       break;
@@ -221,46 +225,36 @@ class UnitaryCalculatorSSE final {
   }
 
  private:
-  void ApplyGate1H(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
+  template <unsigned H>
+  void ApplyGateH(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
+                const uint64_t* ms, const uint64_t* xss, uint64_t size,
+                uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
+
       __m128 ru, iu, rn, in;
-      __m128 rs[2], is[2];
+      __m128 rs[hsize], is[hsize];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]);
+      uint64_t r = 4 * (i % size);
+      uint64_t s = i / size;
+
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
+      }
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm_load_ps(p0 + xss[k]);
+        is[k] = _mm_load_ps(p0 + xss[k] + 4);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm_set1_ps(v[j]);
         iu = _mm_set1_ps(v[j + 1]);
         rn = _mm_mul_ps(rs[0], ru);
@@ -270,85 +264,84 @@ class UnitaryCalculatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm_set1_ps(v[j]);
           iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], ru));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], iu));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], iu));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], ru));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 3;
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, state.get());
   }
 
-  void ApplyGate1L(const std::vector<unsigned>& qs,
-                   const fp_type* matrix, Unitary& state) const {
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(2);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
+  template <unsigned H, unsigned L>
+  void ApplyGateL(const std::vector<unsigned>& qs,
+                  const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
+                const uint64_t* ms, const uint64_t* xss, unsigned q0,
+                uint64_t size, uint64_t row_size, fp_type* rstate) {
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-        unsigned l = 2 * (2 * i + m);
+      __m128 rn, in;
+      __m128 rs[gsize], is[gsize];
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
+      uint64_t r = 4 * (i % size);
+      uint64_t s = i / size;
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-    }
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 8 * ii;
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm_load_ps(p0);
-        is[2 * l] = _mm_load_ps(p0 + 4);
+        rs[k2] = _mm_load_ps(p0 + xss[k]);
+        is[k2] = _mm_load_ps(p0 + xss[k] + 4);
 
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
+        if (L == 1) {
+          rs[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(rs[k2], rs[k2], 177)
+                               : _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(is[k2], is[k2], 177)
+                               : _mm_shuffle_ps(is[k2], is[k2], 78);
+        } else if (L == 2) {
+          rs[k2 + 1] = _mm_shuffle_ps(rs[k2], rs[k2], 57);
+          is[k2 + 1] = _mm_shuffle_ps(is[k2], is[k2], 57);
+          rs[k2 + 2] = _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 2] = _mm_shuffle_ps(is[k2], is[k2], 78);
+          rs[k2 + 3] = _mm_shuffle_ps(rs[k2], rs[k2], 147);
+          is[k2 + 3] = _mm_shuffle_ps(is[k2], is[k2], 147);
+        }
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm_mul_ps(rs[0], w[j]);
         in = _mm_mul_ps(rs[0], w[j + 1]);
         rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
@@ -356,75 +349,72 @@ class UnitaryCalculatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], w[j]));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], w[j + 1]));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], w[j + 1]));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], w[j]));
 
           j += 2;
         }
 
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m128 w[1 << (1 + 2 * H + L)];
+
+    auto m = GetMasks11<L>(qs);
 
-    unsigned k = 2;
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
+    FillMatrix<H, L, 2>(m.qmaskl, matrix, (fp_type*) w);
+
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, w, qs[0], size, raw_size, rstate);
+    for_.Run(size * size2, f,  w, ms, xss, qs[0], size, raw_size, state.get());
   }
 
-  void ApplyGate2HH(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
+  template <unsigned H>
+  void ApplyControlledGateHH(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
+    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, uint64_t size, uint64_t row_size,
+                fp_type* rstate) {
+      constexpr unsigned hsize = 1 << H;
 
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
+      __m128 ru, iu, rn, in;
+      __m128 rs[hsize], is[hsize];
 
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
+      uint64_t r = 4 * (i % size);
+      uint64_t s = i / size;
 
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[4], is[4];
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
+      }
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2]);
+      if ((t & cmaskh) != cvalsh) return;
 
-      auto p0 = rstate + row_size * r + 2 * c;
+      auto p0 = rstate + row_size * s + 2 * t;
 
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm_load_ps(p0 + xss[k]);
+        is[k] = _mm_load_ps(p0 + xss[k] + 4);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 4; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         ru = _mm_set1_ps(v[j]);
         iu = _mm_set1_ps(v[j + 1]);
         rn = _mm_mul_ps(rs[0], ru);
@@ -434,191 +424,72 @@ class UnitaryCalculatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
+        for (unsigned l = 1; l < hsize; ++l) {
           ru = _mm_set1_ps(v[j]);
           iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], ru));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], iu));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], iu));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], ru));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
 
-    unsigned k = 4;
+    auto m = GetMasks7(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             matrix, ms, xss, m.cvalsh, m.cmaskh, size, raw_size, state.get());
   }
 
-  void ApplyGate2HL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H>
+  void ApplyControlledGateHL(const std::vector<unsigned>& qs,
+                             const std::vector<unsigned>& cqs, uint64_t cvals,
+                             const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, uint64_t size, uint64_t row_size,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, uint64_t size, uint64_t row_size,
                 fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyGate2LL(const std::vector<unsigned>& qs,
-                    const fp_type* matrix, Unitary& state) const {
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(2);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
+      constexpr unsigned hsize = 1 << H;
 
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
+      __m128 rn, in;
+      __m128 rs[hsize], is[hsize];
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
+      uint64_t r = 4 * (i % size);
+      uint64_t s = i / size;
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
 
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      auto p0 = rstate + row_size * r + 8 * ii;
+      if ((t & cmaskh) != cvalsh) return;
 
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm_load_ps(p0);
-        is[4 * l] = _mm_load_ps(p0 + 4);
+      auto p0 = rstate + row_size * s + 2 * t;
 
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
+      for (unsigned k = 0; k < hsize; ++k) {
+        rs[k] = _mm_load_ps(p0 + xss[k]);
+        is[k] = _mm_load_ps(p0 + xss[k] + 4);
       }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 1; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm_mul_ps(rs[0], w[j]);
         in = _mm_mul_ps(rs[0], w[j + 1]);
         rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
@@ -626,295 +497,90 @@ class UnitaryCalculatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+        for (unsigned l = 1; l < hsize; ++l) {
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], w[j]));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], w[j + 1]));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], w[j + 1]));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], w[j]));
 
           j += 2;
         }
 
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
-
-    unsigned k = 2;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, size, raw_size, rstate);
-  }
-
-  void ApplyGate3HHH(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m128 w[1 << (1 + 2 * H)];
 
-    fp_type* rstate = state.get();
+    auto m = GetMasks8<2>(state.num_qubits(), qs, cqs, cvals);
+    FillIndices<H>(state.num_qubits(), qs, ms, xss);
+    FillControlledMatrixH<H, 2>(m.cvalsl, m.cmaskl, matrix, (fp_type*) w);
 
-    unsigned k = 5;
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
+    for_.Run(size * size2, f,
+             w, ms, xss, m.cvalsh, m.cmaskh, size, raw_size, state.get());
   }
 
-  void ApplyGate3HHL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
+  template <unsigned H, unsigned L, bool CH>
+  void ApplyControlledGateL(const std::vector<unsigned>& qs,
+                            const std::vector<unsigned>& cqs, uint64_t cvals,
+                            const fp_type* matrix, State& state) const {
     auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, uint64_t size, uint64_t row_size,
+                const uint64_t* ms, const uint64_t* xss, uint64_t cvalsh,
+                uint64_t cmaskh, unsigned q0, uint64_t size, uint64_t row_size,
                 fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, qs[0], size, raw_size, rstate);
-  }
+      constexpr unsigned gsize = 1 << (H + L);
+      constexpr unsigned hsize = 1 << H;
+      constexpr unsigned lsize = 1 << L;
 
-  void ApplyGate3HLL(const std::vector<unsigned>& qs,
-                     const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
+      __m128 rn, in;
+      __m128 rs[gsize], is[gsize];
 
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
+      uint64_t r = 4 * (i % size);
+      uint64_t s = i / size;
 
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
+      uint64_t t = r & ms[0];
+      for (unsigned j = 1; j <= H; ++j) {
+        r *= 2;
+        t |= r & ms[j];
       }
-      xss[i] = a;
-    }
 
-    unsigned p[4];
+      if ((t & cmaskh) != cvalsh) return;
 
-    auto s = UnitarySpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
+      auto p0 = rstate + row_size * s + 2 * t;
 
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
+      for (unsigned k = 0; k < hsize; ++k) {
+        unsigned k2 = lsize * k;
 
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
+        rs[k2] = _mm_load_ps(p0 + xss[k]);
+        is[k2] = _mm_load_ps(p0 + xss[k] + 4);
 
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
+        if (L == 1) {
+          rs[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(rs[k2], rs[k2], 177)
+                               : _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 1] = q0 == 0 ? _mm_shuffle_ps(is[k2], is[k2], 177)
+                               : _mm_shuffle_ps(is[k2], is[k2], 78);
+        } else if (L == 2) {
+          rs[k2 + 1] = _mm_shuffle_ps(rs[k2], rs[k2], 57);
+          is[k2 + 1] = _mm_shuffle_ps(is[k2], is[k2], 57);
+          rs[k2 + 2] = _mm_shuffle_ps(rs[k2], rs[k2], 78);
+          is[k2 + 2] = _mm_shuffle_ps(is[k2], is[k2], 78);
+          rs[k2 + 3] = _mm_shuffle_ps(rs[k2], rs[k2], 147);
+          is[k2 + 3] = _mm_shuffle_ps(is[k2], is[k2], 147);
         }
       }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
 
       uint64_t j = 0;
 
-      for (unsigned l = 0; l < 2; ++l) {
+      for (unsigned k = 0; k < hsize; ++k) {
         rn = _mm_mul_ps(rs[0], w[j]);
         in = _mm_mul_ps(rs[0], w[j + 1]);
         rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
@@ -922,3612 +588,46 @@ class UnitaryCalculatorSSE final {
 
         j += 2;
 
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
+        for (unsigned l = 1; l < gsize; ++l) {
+          rn = _mm_add_ps(rn, _mm_mul_ps(rs[l], w[j]));
+          in = _mm_add_ps(in, _mm_mul_ps(rs[l], w[j + 1]));
+          rn = _mm_sub_ps(rn, _mm_mul_ps(is[l], w[j + 1]));
+          in = _mm_add_ps(in, _mm_mul_ps(is[l], w[j]));
 
           j += 2;
         }
 
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
+        _mm_store_ps(p0 + xss[k], rn);
+        _mm_store_ps(p0 + xss[k] + 4, in);
       }
     };
 
-    fp_type* rstate = state.get();
-
-    unsigned k = 3;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate4HHHH(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]) | (64 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
+    uint64_t ms[H + 1];
+    uint64_t xss[1 << H];
+    __m128 w[1 << (1 + 2 * H + L)];
 
-    fp_type* rstate = state.get();
+    FillIndices<H, L>(state.num_qubits(), qs, ms, xss);
 
-    unsigned k = 6;
+    unsigned k = 2 + H;
     unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
     uint64_t size = uint64_t{1} << n;
     uint64_t size2 = uint64_t{1} << state.num_qubits();
     uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
 
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
+    if (CH) {
+      auto m = GetMasks9<L>(state.num_qubits(), qs, cqs, cvals);
+      FillMatrix<H, L, 2>(m.qmaskl, matrix, (fp_type*) w);
 
-  void ApplyGate4HHHL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
+      for_.Run(size * size2, f, w, ms, xss,
+               m.cvalsh, m.cmaskh, qs[0], size, raw_size, state.get());
+    } else {
+      auto m = GetMasks10<L, 2>(state.num_qubits(), qs, cqs, cvals);
+      FillControlledMatrixL<H, L, 2>(
+          m.cvalsl, m.cmaskl, m.qmaskl, matrix, (fp_type*) w);
 
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
+      for_.Run(size * size2, f, w, ms, xss,
+               m.cvalsh, m.cmaskh, qs[0], size, raw_size, state.get());
     }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyGate4HHLL(const std::vector<unsigned>& qs,
-                      const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHHH(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]) | (64 * ii & ms[4]) | (128 * ii & ms[5]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHHL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(6);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 32 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]) | (64 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyGate5HHHLL(const std::vector<unsigned>& qs,
-                       const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 32; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (128 * i + 32 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (32 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[32], is[32];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 32; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHHH(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[6];
-    uint64_t ms[7];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 6; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[6] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[5] - 1);
-
-    uint64_t xss[64];
-    for (unsigned i = 0; i < 64; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 6; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]) | (64 * ii & ms[4]) | (128 * ii & ms[5])
-          | (256 * ii & ms[6]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 64; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 8;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHHL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[5];
-    uint64_t ms[6];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 5; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[5] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[4] - 1);
-
-    uint64_t xss[32];
-    for (unsigned i = 0; i < 32; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 5; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(7);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 32; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (128 * i + 64 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]) | (64 * ii & ms[4]) | (128 * ii & ms[5]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 32; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 7;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyGate6HHHHLL(const std::vector<unsigned>& qs,
-                        const fp_type* matrix, Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(6);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 64; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (256 * i + 64 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (64 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[64], is[64];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = (4 * ii & ms[0]) | (8 * ii & ms[1]) | (16 * ii & ms[2])
-          | (32 * ii & ms[3]) | (64 * ii & ms[4]);
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 64; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1H_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1H_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(2);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (2 * i + 2 * k + m);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1L_H(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(2);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm_load_ps(p0);
-        is[2 * l] = _mm_load_ps(p0 + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate1L_L(const std::vector<unsigned>& qs,
-                               const std::vector<unsigned>& cqs,
-                               uint64_t cmask, const fp_type* matrix,
-                               Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(2);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 2; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 2 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (2 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 2 == (p[j] / 2) % 2 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[2], is[2];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[2 * l] = _mm_load_ps(p0);
-        is[2 * l] = _mm_load_ps(p0 + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 2; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HH_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HH_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (4 * i + 4 * k + m);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2HL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 4 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2LL_H(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(2);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm_load_ps(p0);
-        is[4 * l] = _mm_load_ps(p0 + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate2LL_L(const std::vector<unsigned>& qs,
-                                const std::vector<unsigned>& cqs,
-                                uint64_t cmask, const fp_type* matrix,
-                                Unitary& state) const {
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(2);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 1; ++i) {
-      for (unsigned m = 0; m < 4; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 4 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (4 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 4 == (p[j] / 2) % 4 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[4], is[4];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rs[4 * l] = _mm_load_ps(p0);
-        is[4 * l] = _mm_load_ps(p0 + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 1; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 4; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0, rn);
-        _mm_store_ps(p0 + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 2 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHH_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHH_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (8 * i + 8 * k + m);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HHL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 8 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HLL_H(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate3HLL_L(const std::vector<unsigned>& qs,
-                                 const std::vector<unsigned>& cqs,
-                                 uint64_t cmask, const fp_type* matrix,
-                                 Unitary& state) const {
-    uint64_t xs[1];
-    uint64_t ms[2];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    ms[1] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[0] - 1);
-
-    uint64_t xss[2];
-    for (unsigned i = 0; i < 2; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 1; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(3);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 2; ++i) {
-      for (unsigned m = 0; m < 8; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 8 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (8 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 8 == (p[j] / 2) % 8 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[8], is[8];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 2; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 8; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 3 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const fp_type* v,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 ru, iu, rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        ru = _mm_set1_ps(v[j]);
-        iu = _mm_set1_ps(v[j + 1]);
-        rn = _mm_mul_ps(rs[0], ru);
-        in = _mm_mul_ps(rs[0], iu);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], iu));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], ru));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          ru = _mm_set1_ps(v[j]);
-          iu = _mm_set1_ps(v[j + 1]);
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], ru));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], iu));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], iu));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], ru));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, matrix, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHH_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[4];
-    uint64_t ms[5];
-
-    xs[0] = uint64_t{1} << (qs[0] + 1);
-    ms[0] = (uint64_t{1} << qs[0]) - 1;
-    for (unsigned i = 1; i < 4; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 0] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 0]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[4] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[3] - 1);
-
-    uint64_t xss[16];
-    for (unsigned i = 0; i < 16; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 4; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 16; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (16 * i + 16 * k + m);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rs[l] = _mm_load_ps(p0 + xss[l]);
-        is[l] = _mm_load_ps(p0 + xss[l] + 4);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 16; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 6 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHHL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[3];
-    uint64_t ms[4];
-
-    xs[0] = uint64_t{1} << (qs[1] + 1);
-    ms[0] = (uint64_t{1} << qs[1]) - 1;
-    for (unsigned i = 1; i < 3; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 1] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 1]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[3] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[2] - 1);
-
-    uint64_t xss[8];
-    for (unsigned i = 0; i < 8; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 3; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(5);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]);
-
-    for (unsigned i = 0; i < 8; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (32 * i + 16 * k + 2 * (m / 2) + (k + m) % 2);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                unsigned q0, uint64_t size, uint64_t row_size,
-                fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rs[2 * l] = _mm_load_ps(p0 + xss[l]);
-        is[2 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(rs[2 * l], rs[2 * l], 177)
-                                : _mm_shuffle_ps(rs[2 * l], rs[2 * l], 78);
-        is[2 * l + 1] = q0 == 0 ? _mm_shuffle_ps(is[2 * l], is[2 * l], 177)
-                                : _mm_shuffle_ps(is[2 * l], is[2 * l], 78);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 8; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 5 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, qs[0], size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_H(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      emaskh |= uint64_t{1} << q;
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask, state.num_qubits(), emaskh);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j] = matrix[p[j]];
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = matrix[p[j] + 1];
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size();
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  void ApplyControlledGate4HHLL_L(const std::vector<unsigned>& qs,
-                                  const std::vector<unsigned>& cqs,
-                                  uint64_t cmask, const fp_type* matrix,
-                                  Unitary& state) const {
-    uint64_t xs[2];
-    uint64_t ms[3];
-
-    xs[0] = uint64_t{1} << (qs[2] + 1);
-    ms[0] = (uint64_t{1} << qs[2]) - 1;
-    for (unsigned i = 1; i < 2; ++i) {
-      xs[i] = uint64_t{1} << (qs[i + 2] + 1);
-      ms[i] = ((uint64_t{1} << qs[i + 2]) - 1) ^ (xs[i - 1] - 1);
-    }
-    ms[2] = ((uint64_t{1} << state.num_qubits()) - 1) ^ (xs[1] - 1);
-
-    uint64_t xss[4];
-    for (unsigned i = 0; i < 4; ++i) {
-      uint64_t a = 0;
-      for (uint64_t k = 0; k < 2; ++k) {
-        if (((i >> k) & 1) == 1) {
-          a += xs[k];
-        }
-      }
-      xss[i] = a;
-    }
-
-    unsigned cl = 0;
-    uint64_t emaskl = 0;
-    uint64_t emaskh = 0;
-
-    for (auto q : cqs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      } else {
-        ++cl;
-        emaskl |= uint64_t{1} << q;
-      }
-    }
-
-    uint64_t cmaskh = bits::ExpandBits(cmask >> cl, state.num_qubits(), emaskh);
-    uint64_t cmaskl = bits::ExpandBits(cmask & ((1 << cl) - 1), 2, emaskl);
-
-    for (auto q : qs) {
-      if (q > 1) {
-        emaskh |= uint64_t{1} << q;
-      }
-    }
-
-    emaskh = ~emaskh ^ 3;
-
-    unsigned p[4];
-
-    auto s = UnitarySpace::Create(4);
-    __m128* w = (__m128*) s.get();
-    fp_type* wf = (fp_type*) w;
-
-    unsigned qmask = (1 << qs[0]) | (1 << qs[1]);
-
-    for (unsigned i = 0; i < 4; ++i) {
-      for (unsigned m = 0; m < 16; ++m) {
-        for (unsigned j = 0; j < 4; ++j) {
-          unsigned k = bits::CompressBits(j, 2, qmask);
-          p[j] = 2 * (64 * i + 16 * k + 4 * (m / 4) + (k + m) % 4);
-        }
-
-        unsigned l = 2 * (16 * i + m);
-
-        for (unsigned j = 0; j < 4; ++j) {
-          fp_type v = (p[j] / 2) / 16 == (p[j] / 2) % 16 ? 1 : 0;
-          wf[4 * l + j] = cmaskl == (j & emaskl) ? matrix[p[j]] : v;
-        }
-
-        for (unsigned j = 0; j < 4; ++j) {
-          wf[4 * l + j + 4] = cmaskl == (j & emaskl) ? matrix[p[j] + 1] : 0;
-        }
-      }
-    }
-
-    auto f = [](unsigned n, unsigned m, uint64_t i, const __m128* w,
-                const uint64_t* ms, const uint64_t* xss,
-                unsigned num_qubits, uint64_t cmaskh, uint64_t emaskh,
-                uint64_t size, uint64_t row_size, fp_type* rstate) {
-      __m128 rn, in;
-      __m128 rs[16], is[16];
-
-      uint64_t ii = i % size;
-      uint64_t r = i / size;
-      uint64_t c = bits::ExpandBits(ii, num_qubits, emaskh) | cmaskh;
-
-      auto p0 = rstate + row_size * r + 2 * c;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rs[4 * l] = _mm_load_ps(p0 + xss[l]);
-        is[4 * l] = _mm_load_ps(p0 + xss[l] + 4);
-
-        rs[4 * l + 1] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 57);
-        is[4 * l + 1] = _mm_shuffle_ps(is[4 * l], is[4 * l], 57);
-        rs[4 * l + 2] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 78);
-        is[4 * l + 2] = _mm_shuffle_ps(is[4 * l], is[4 * l], 78);
-        rs[4 * l + 3] = _mm_shuffle_ps(rs[4 * l], rs[4 * l], 147);
-        is[4 * l + 3] = _mm_shuffle_ps(is[4 * l], is[4 * l], 147);
-      }
-
-      uint64_t j = 0;
-
-      for (unsigned l = 0; l < 4; ++l) {
-        rn = _mm_mul_ps(rs[0], w[j]);
-        in = _mm_mul_ps(rs[0], w[j + 1]);
-        rn = _mm_sub_ps(rn, _mm_mul_ps(is[0], w[j + 1]));
-        in = _mm_add_ps(in, _mm_mul_ps(is[0], w[j]));
-
-        j += 2;
-
-        for (unsigned n = 1; n < 16; ++n) {
-          rn = _mm_add_ps(rn, _mm_mul_ps(rs[n], w[j]));
-          in = _mm_add_ps(in, _mm_mul_ps(rs[n], w[j + 1]));
-          rn = _mm_sub_ps(rn, _mm_mul_ps(is[n], w[j + 1]));
-          in = _mm_add_ps(in, _mm_mul_ps(is[n], w[j]));
-
-          j += 2;
-        }
-
-        _mm_store_ps(p0 + xss[l], rn);
-        _mm_store_ps(p0 + xss[l] + 4, in);
-      }
-    };
-
-    fp_type* rstate = state.get();
-
-    unsigned k = 4 + cqs.size() - cl;
-    unsigned n = state.num_qubits() > k ? state.num_qubits() - k : 0;
-    uint64_t size = uint64_t{1} << n;
-    uint64_t size2 = uint64_t{1} << state.num_qubits();
-    uint64_t raw_size = UnitarySpace::MinRowSize(state.num_qubits());
-
-    for_.Run(size * size2, f, w, ms, xss,
-             state.num_qubits(), cmaskh, emaskh, size, raw_size, rstate);
-  }
-
-  static unsigned MaskedAdd(
-      unsigned a, unsigned b, unsigned mask, unsigned lsize) {
-    unsigned c = bits::CompressBits(a, 2, mask);
-    return bits::ExpandBits((c + b) % lsize, 2, mask);
   }
 
   For for_;
diff --git a/tests/make.sh b/tests/make.sh
index 7fd828c8..fbac04f0 100755
--- a/tests/make.sh
+++ b/tests/make.sh
@@ -44,8 +44,9 @@ g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o statespace_av
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mbmi2 -fopenmp -o statespace_avx512_test.x statespace_avx512_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o statespace_basic_test.x statespace_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -msse4 -fopenmp -o statespace_sse_test.x statespace_sse_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o unitary_calculator_avx_test.x unitary_calculator_avx_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mfma -fopenmp -o unitary_calculator_avx512_test.x unitary_calculator_avx512_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o unitary_calculator_avx_test.x unitary_calculator_avx_nobmi2_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -mbmi2 -fopenmp -o unitary_calculator_avx_test.x unitary_calculator_avx_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mbmi2 -mfma -fopenmp -o unitary_calculator_avx512_test.x unitary_calculator_avx512_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o unitary_calculator_basic_test.x unitary_calculator_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -msse4 -fopenmp -o unitary_calculator_sse_test.x unitary_calculator_sse_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o unitaryspace_avx_test.x unitaryspace_avx_test.cc -lgtest -lpthread

From c22bee042e78a1e71c173d1dd4c014fca1c52531 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 2 Dec 2021 08:43:11 -0800
Subject: [PATCH 174/246] Review comments.

---
 qsimcirq/qsim_simulator.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 904b06d1..d2a00516 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -379,9 +379,10 @@ def _sample_measure_results(
             for key, op in meas_ops.items():
                 meas_indices = [qubit_map[qubit] for qubit in op.qubits]
                 invert_mask = op.gate.full_invert_mask()
-                # Match result order to order in ops, then apply invert mask
-                permuted_results = full_results[:, meas_indices]
-                results[key] = np.logical_xor(permuted_results, invert_mask)
+                # Apply invert mask to re-ordered results
+                results[key] = np.logical_xor(
+                    full_results[:, meas_indices], invert_mask
+                )
 
         else:
             options["c"] = self._translate_circuit(
@@ -399,11 +400,9 @@ def _sample_measure_results(
                 options["s"] = self.get_seed()
                 measurements[i] = sampler_fn(options)
 
-            for key, bound in bounds.items():
+            for key, (start, end) in bounds.items():
                 invert_mask = meas_ops[key].gate.full_invert_mask()
-                permutation = list(range(bound[0], bound[1]))
-                permuted_measurements = measurements[:, permutation]
-                results[key] = np.logical_xor(permuted_measurements, invert_mask)
+                results[key] = np.logical_xor(measurements[:, start:end], invert_mask)
 
         return results
 

From be42204173ff841a6446dba7b9228930ac378aed Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 2 Dec 2021 18:47:32 +0100
Subject: [PATCH 175/246] Fix typo.

---
 tests/make.sh | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/tests/make.sh b/tests/make.sh
index fbac04f0..9ccb228d 100755
--- a/tests/make.sh
+++ b/tests/make.sh
@@ -18,7 +18,6 @@
 # Prefer using the Makefile (e.g. `make -C tests/`) if possible.
 
 path_to_include=googletest/googletest/include
-path_to_lib=googletest/lib
 path_to_lib=googletest/googletest/make/lib
 
 g++ -O3 -I$path_to_include -L$path_to_lib -o bitstring_test.x bitstring_test.cc -lgtest -lpthread
@@ -44,7 +43,7 @@ g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o statespace_av
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mbmi2 -fopenmp -o statespace_avx512_test.x statespace_avx512_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o statespace_basic_test.x statespace_basic_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -msse4 -fopenmp -o statespace_sse_test.x statespace_sse_test.cc -lgtest -lpthread
-g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o unitary_calculator_avx_test.x unitary_calculator_avx_nobmi2_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o unitary_calculator_avx_nobmi2_test.x unitary_calculator_avx_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -mbmi2 -fopenmp -o unitary_calculator_avx_test.x unitary_calculator_avx_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx512f -mbmi2 -mfma -fopenmp -o unitary_calculator_avx512_test.x unitary_calculator_avx512_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -fopenmp -o unitary_calculator_basic_test.x unitary_calculator_basic_test.cc -lgtest -lpthread

From 94957c62b3937e77c81657ed3e2037bacddf4331 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 2 Dec 2021 20:10:44 +0100
Subject: [PATCH 176/246] Fix typos.

---
 lib/unitary_calculator_avx.h    | 2 +-
 lib/unitary_calculator_avx512.h | 2 +-
 lib/unitary_calculator_sse.h    | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/unitary_calculator_avx.h b/lib/unitary_calculator_avx.h
index 2bcb6780..5e566ca9 100644
--- a/lib/unitary_calculator_avx.h
+++ b/lib/unitary_calculator_avx.h
@@ -29,7 +29,7 @@ namespace qsim {
 namespace unitary {
 
 /**
- * Quantum circuit simulator with AVX vectorization.
+ * Quantum circuit unitary calculator with AVX vectorization.
  */
 template <typename For>
 class UnitaryCalculatorAVX final : public SimulatorBase {
diff --git a/lib/unitary_calculator_avx512.h b/lib/unitary_calculator_avx512.h
index 4020e313..81053678 100644
--- a/lib/unitary_calculator_avx512.h
+++ b/lib/unitary_calculator_avx512.h
@@ -29,7 +29,7 @@ namespace qsim {
 namespace unitary {
 
 /**
- * Quantum circuit simulator with AVX512 vectorization.
+ * Quantum circuit unitary calculator with AVX512 vectorization.
  */
 template <typename For>
 class UnitaryCalculatorAVX512 final : public SimulatorBase {
diff --git a/lib/unitary_calculator_sse.h b/lib/unitary_calculator_sse.h
index 9ff9c98e..a3c3f2eb 100644
--- a/lib/unitary_calculator_sse.h
+++ b/lib/unitary_calculator_sse.h
@@ -29,7 +29,7 @@ namespace qsim {
 namespace unitary {
 
 /**
- * Quantum circuit simulator with SSE vectorization.
+ * Quantum circuit unitary calculator with SSE vectorization.
  */
 template <typename For>
 class UnitaryCalculatorSSE final : public SimulatorBase {

From f8df3baaf57b8c72acf9fc3390e780735c3805e8 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 2 Dec 2021 13:13:54 -0800
Subject: [PATCH 177/246] Fix dtype and XOR

---
 qsimcirq/qsim_simulator.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index d2a00516..b28078c9 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -380,9 +380,7 @@ def _sample_measure_results(
                 meas_indices = [qubit_map[qubit] for qubit in op.qubits]
                 invert_mask = op.gate.full_invert_mask()
                 # Apply invert mask to re-ordered results
-                results[key] = np.logical_xor(
-                    full_results[:, meas_indices], invert_mask
-                )
+                results[key] = full_results[:, meas_indices] ^ invert_mask
 
         else:
             options["c"] = self._translate_circuit(
@@ -394,7 +392,8 @@ def _sample_measure_results(
                 shape=(
                     repetitions,
                     sum(cirq.num_qubits(op) for op in meas_ops.values()),
-                )
+                ),
+                dtype=int,
             )
             for i in range(repetitions):
                 options["s"] = self.get_seed()
@@ -402,7 +401,7 @@ def _sample_measure_results(
 
             for key, (start, end) in bounds.items():
                 invert_mask = meas_ops[key].gate.full_invert_mask()
-                results[key] = np.logical_xor(measurements[:, start:end], invert_mask)
+                results[key] = measurements[:, start:end] ^ invert_mask
 
         return results
 

From 254304c503772ee1ff79f3082be06183f56c6ed0 Mon Sep 17 00:00:00 2001
From: Michael Broughton <mbbrough@google.com>
Date: Mon, 6 Dec 2021 14:52:26 -0800
Subject: [PATCH 178/246] Adds 1-RDM feature to MPS.

---
 lib/mps_statespace.h         | 148 +++++++++++++++-
 tests/mps_statespace_test.cc | 315 +++++++++++++++++++++++++++++++++++
 2 files changed, 461 insertions(+), 2 deletions(-)

diff --git a/lib/mps_statespace.h b/lib/mps_statespace.h
index 9e59599c..1ca77906 100644
--- a/lib/mps_statespace.h
+++ b/lib/mps_statespace.h
@@ -28,6 +28,7 @@
 #include <memory>
 
 #include "../eigen/Eigen/Dense"
+#include "../eigen/unsupported/Eigen/CXX11/Tensor"
 
 namespace qsim {
 
@@ -180,8 +181,8 @@ class MPSStateSpace {
     fp_type* state2_raw = state2.get();
 
     // Contract leftmost blocks together, store result in state1 scratch.
-    ConstMatrixMap top((Complex*) state2_raw, 2, bond_dim);
-    ConstMatrixMap bot((Complex*) state1_raw, 2, bond_dim);
+    ConstMatrixMap top((Complex*)state2_raw, 2, bond_dim);
+    ConstMatrixMap bot((Complex*)state1_raw, 2, bond_dim);
     MatrixMap partial_contract((Complex*)(state1_raw + end), bond_dim,
                                bond_dim);
     MatrixMap partial_contract2(
@@ -232,6 +233,149 @@ class MPSStateSpace {
     return partial_contract(0, 0);
   }
 
+  // Compute the 2x2 1-RDM of state on index. Result written to rdm.
+  // Requires: scratch to be allocated.
+  static void ReduceDensityMatrix(MPS& state, MPS& scratch, int index,
+                                  fp_type* rdm) {
+    const auto num_qubits = state.num_qubits();
+    const auto bond_dim = state.bond_dim();
+    const auto end = Size(state);
+    const bool last_index = (index == num_qubits - 1);
+    const auto right_dim = (last_index ? 1 : bond_dim);
+    auto offset = 0;
+    fp_type* state_raw = state.get();
+    fp_type* scratch_raw = scratch.get();
+
+    Copy(state, scratch);
+
+    // Contract leftmost blocks together, store result in state scratch.
+    ConstMatrixMap top((Complex*)scratch_raw, 2, bond_dim);
+    ConstMatrixMap bot((Complex*)state_raw, 2, bond_dim);
+    MatrixMap partial_contract((Complex*)(state_raw + end), bond_dim, bond_dim);
+    MatrixMap partial_contract2(
+        (Complex*)(state_raw + end + 2 * bond_dim * bond_dim), bond_dim,
+        2 * bond_dim);
+
+    partial_contract.setZero();
+    partial_contract(0, 0) = 1;
+    if (index > 0) {
+      partial_contract.noalias() = top.adjoint() * bot;
+    }
+
+    // Contract all internal blocks together.
+    for (unsigned i = 1; i < index; ++i) {
+      offset = GetBlockOffset(state, i);
+
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(state_raw + end + 2 * bond_dim * bond_dim),
+                    bond_dim, 2 * bond_dim);
+
+      // Merge bot into left boundary merged tensor.
+      new (&bot) ConstMatrixMap((Complex*)(state_raw + offset), bond_dim,
+                                2 * bond_dim);
+      partial_contract2.noalias() = partial_contract * bot;
+
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(state_raw + end + 2 * bond_dim * bond_dim),
+                    2 * bond_dim, bond_dim);
+
+      // Merge top into partial_contract2.
+      new (&top) ConstMatrixMap((Complex*)(scratch_raw + offset), 2 * bond_dim,
+                                bond_dim);
+      partial_contract.noalias() = top.adjoint() * partial_contract2;
+    }
+
+    // The [bond_dim, bond_dim] block in state_raw now contains the contraction
+    // up to, but not including index.
+    // Contract rightmost blocks.
+    offset = GetBlockOffset(state, num_qubits - 1);
+    new (&top) ConstMatrixMap((Complex*)(scratch_raw + offset), bond_dim, 2);
+    new (&bot) ConstMatrixMap((Complex*)(state_raw + offset), bond_dim, 2);
+    new (&partial_contract)
+        MatrixMap((Complex*)(scratch_raw + end), bond_dim, bond_dim);
+    new (&partial_contract2)
+        MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
+                  bond_dim, 2 * bond_dim);
+
+    partial_contract.setZero();
+    partial_contract(0, 0) = 1;
+    if (index < num_qubits - 1) {
+      partial_contract.noalias() = top * bot.adjoint();
+    }
+
+    for (unsigned i = num_qubits - 2; i > index; i--) {
+      offset = GetBlockOffset(state, i);
+
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
+                    2 * bond_dim, bond_dim);
+
+      // Merge bot into left boundary merged tensor.
+      new (&bot) ConstMatrixMap((Complex*)(state_raw + offset), 2 * bond_dim,
+                                bond_dim);
+      partial_contract2.noalias() = bot * partial_contract.adjoint();
+
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
+                    bond_dim, 2 * bond_dim);
+
+      // Merge top into partial_contract2.
+      new (&top) ConstMatrixMap((Complex*)(scratch_raw + offset), bond_dim,
+                                2 * bond_dim);
+      // [bd, bd] = [2bd, bd] @ [bd, 2bd]
+      partial_contract.noalias() = top * partial_contract2.adjoint();
+    }
+
+    // The [bond_dim, bond_dim] block in scratch_raw now contains the
+    // contraction down from the end, but not including the index. Begin final
+    // contraction steps.
+
+    // Get leftmost [bd, bd] contraction and contract with top.
+
+    offset = GetBlockOffset(state, index);
+    new (&partial_contract)
+        MatrixMap((Complex*)(state_raw + end), bond_dim, bond_dim);
+    new (&top)
+        ConstMatrixMap((Complex*)(state_raw + offset), bond_dim, 2 * right_dim);
+    new (&partial_contract2)
+        MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
+                  bond_dim, 2 * right_dim);
+    partial_contract2.noalias() = partial_contract * top.conjugate();
+    // copy the bottom contraction scratch_raw to state_raw to save space.
+    memcpy(state_raw + end, scratch_raw + end,
+           bond_dim * bond_dim * 2 * sizeof(fp_type));
+
+    // Contract top again for correct shape.
+    fp_type* contract3_target = (last_index ? rdm : scratch_raw);
+    MatrixMap partial_contract3((Complex*)contract3_target, 2 * right_dim,
+                                2 * right_dim);
+    partial_contract3.noalias() = top.transpose() * partial_contract2;
+
+    // If we are contracting the last index, all the needed transforms are done.
+    if (last_index) {
+      return;
+    }
+
+    // Conduct final tensor contraction operations. Cannot be easily compiled to
+    // matmul.
+    const Eigen::TensorMap<const Eigen::Tensor<Complex, 4, Eigen::RowMajor>>
+        t_4d((Complex*)scratch_raw, 2, bond_dim, 2, bond_dim);
+    const Eigen::TensorMap<const Eigen::Tensor<Complex, 2, Eigen::RowMajor>>
+        t_2d((Complex*)(state_raw + end), bond_dim, bond_dim);
+
+    const Eigen::array<Eigen::IndexPair<int>, 2> product_dims = {
+        Eigen::IndexPair<int>(1, 0),
+        Eigen::IndexPair<int>(3, 1),
+    };
+    Eigen::TensorMap<Eigen::Tensor<Complex, 2, Eigen::RowMajor>> out(
+        (Complex*)rdm, 2, 2);
+    out = t_4d.contract(t_2d, product_dims);
+  }
+
   // Testing only. Convert the MPS to a wavefunction under "normal" ordering.
   // Requires: wf be allocated beforehand with bond_dim * 2 ^ num_qubits -1
   // memory.
diff --git a/tests/mps_statespace_test.cc b/tests/mps_statespace_test.cc
index 4860c1ff..4f86154d 100644
--- a/tests/mps_statespace_test.cc
+++ b/tests/mps_statespace_test.cc
@@ -586,6 +586,321 @@ TEST(MPSStateSpaceTest, InnerProduct4) {
   EXPECT_NEAR(f, 0.5524, 1e-4);
 }
 
+TEST(MPSStateSpaceTest, ReduceDensityMatrixLarge){
+  auto ss = MPSStateSpace<For, float>(1);
+  auto mps = ss.Create(5, 8);
+  auto scratch = ss.Create(5, 8);
+
+  // Set to highly entangled five qubit state.
+  memset(mps.get(), 0, ss.RawSize(mps));
+  mps.get()[ 0 ] = 0.2309518310679887 ;
+  mps.get()[ 1 ] = 0.6567032847786496 ;
+  mps.get()[ 2 ] = 0.2768328727585293 ;
+  mps.get()[ 3 ] = 0.6623938314484864 ;
+  mps.get()[ 16 ] = -0.2726304616546085 ;
+  mps.get()[ 17 ] = -0.6641345176352952 ;
+  mps.get()[ 18 ] = 0.3010495535897523 ;
+  mps.get()[ 19 ] = 0.627667980511763 ;
+  mps.get()[ 32 ] = -0.3191944318061405 ;
+  mps.get()[ 33 ] = 0.3643805550045959 ;
+  mps.get()[ 34 ] = -0.04874347818313596 ;
+  mps.get()[ 35 ] = 0.6919258000829638 ;
+  mps.get()[ 36 ] = 0.49609358835838246 ;
+  mps.get()[ 37 ] = -0.04574935292831311 ;
+  mps.get()[ 38 ] = 0.09997934427265631 ;
+  mps.get()[ 39 ] = -0.16126613211648944 ;
+  mps.get()[ 48 ] = 0.11471063502833712 ;
+  mps.get()[ 49 ] = -0.17128708246811702 ;
+  mps.get()[ 50 ] = -0.537166251460361 ;
+  mps.get()[ 51 ] = 0.2131135551453959 ;
+  mps.get()[ 52 ] = -0.19584141695097979 ;
+  mps.get()[ 53 ] = -0.5224748182520113 ;
+  mps.get()[ 54 ] = -0.4786314439048336 ;
+  mps.get()[ 55 ] = -0.28829738309774056 ;
+  mps.get()[ 64 ] = -0.22760229053474473 ;
+  mps.get()[ 65 ] = -0.3983913913209793 ;
+  mps.get()[ 66 ] = 0.02677088226132468 ;
+  mps.get()[ 67 ] = 0.019402378895274214 ;
+  mps.get()[ 68 ] = 0.11824715374271104 ;
+  mps.get()[ 69 ] = -0.6255924221100192 ;
+  mps.get()[ 70 ] = 0.4373827784232901 ;
+  mps.get()[ 71 ] = 0.43787715330879845 ;
+  mps.get()[ 80 ] = 0.46930961473374244 ;
+  mps.get()[ 81 ] = 0.5404386307552339 ;
+  mps.get()[ 82 ] = -0.4215827008929379 ;
+  mps.get()[ 83 ] = 0.07792743601226776 ;
+  mps.get()[ 84 ] = -0.17872276471126872 ;
+  mps.get()[ 85 ] = -0.05634054845076332 ;
+  mps.get()[ 86 ] = 0.31229453092671483 ;
+  mps.get()[ 87 ] = 0.41379458050793116 ;
+  mps.get()[ 168 ] = 1.0 ;
+  mps.get()[ 169 ] = 0.0 ;
+  mps.get()[ 186 ] = 1.0 ;
+  mps.get()[ 187 ] = 0.0 ;
+  mps.get()[ 204 ] = 1.0 ;
+  mps.get()[ 205 ] = 0.0 ;
+  mps.get()[ 222 ] = 1.0 ;
+  mps.get()[ 223 ] = 0.0 ;
+  mps.get()[ 288 ] = -0.6130799737070379 ;
+  mps.get()[ 289 ] = 0.0 ;
+  mps.get()[ 290 ] = 0.043268104759918435 ;
+  mps.get()[ 291 ] = -0.18995272475290723 ;
+  mps.get()[ 292 ] = 0.12876152804781352 ;
+  mps.get()[ 293 ] = -0.11893213425423177 ;
+  mps.get()[ 294 ] = 0.1607817034199853 ;
+  mps.get()[ 295 ] = 0.24665465943552506 ;
+  mps.get()[ 296 ] = 0.24552427823440562 ;
+  mps.get()[ 297 ] = 0.03609285713030893 ;
+  mps.get()[ 298 ] = -0.15990808712940063 ;
+  mps.get()[ 299 ] = 0.24468178722817494 ;
+  mps.get()[ 300 ] = -0.4914494834254487 ;
+  mps.get()[ 301 ] = 0.2405398049739527 ;
+  mps.get()[ 302 ] = -0.14134232805639232 ;
+  mps.get()[ 303 ] = 0.0487940490917071 ;
+  mps.get()[ 304 ] = 0.2742172608377126 ;
+  mps.get()[ 305 ] = 0.047271896662111734 ;
+  mps.get()[ 306 ] = -0.18146376283725354 ;
+  mps.get()[ 307 ] = 0.33152462391237286 ;
+  mps.get()[ 308 ] = 0.0773807177545771 ;
+  mps.get()[ 309 ] = 0.24654528023213645 ;
+  mps.get()[ 310 ] = 0.008528550130968378 ;
+  mps.get()[ 311 ] = 0.2390239731739813 ;
+  mps.get()[ 312 ] = -0.508089429071731 ;
+  mps.get()[ 313 ] = -0.002320091211748876 ;
+  mps.get()[ 314 ] = -0.13528872019886337 ;
+  mps.get()[ 315 ] = 0.31045800372692844 ;
+  mps.get()[ 316 ] = -0.3746798814674866 ;
+  mps.get()[ 317 ] = 0.1374707983071416 ;
+  mps.get()[ 318 ] = 0.06279287873849984 ;
+  mps.get()[ 319 ] = 0.345950035760249 ;
+  mps.get()[ 320 ] = 0.2170489335583332 ;
+  mps.get()[ 321 ] = 0.0 ;
+  mps.get()[ 322 ] = 0.25343359465176174 ;
+  mps.get()[ 323 ] = -0.06460873268181125 ;
+  mps.get()[ 324 ] = 0.46101262974278245 ;
+  mps.get()[ 325 ] = -0.2092480984031435 ;
+  mps.get()[ 326 ] = 0.13091963057724038 ;
+  mps.get()[ 327 ] = 0.22386537991270267 ;
+  mps.get()[ 328 ] = 0.12356459122286649 ;
+  mps.get()[ 329 ] = -0.4070091557135954 ;
+  mps.get()[ 330 ] = -0.28135621185555465 ;
+  mps.get()[ 331 ] = -0.3875888286693259 ;
+  mps.get()[ 332 ] = 0.03359145124758722 ;
+  mps.get()[ 333 ] = 0.08762316323030826 ;
+  mps.get()[ 334 ] = 0.2470684092385266 ;
+  mps.get()[ 335 ] = 0.2841719777265282 ;
+  mps.get()[ 336 ] = -0.10369449090740858 ;
+  mps.get()[ 337 ] = -0.06989422362389419 ;
+  mps.get()[ 338 ] = 0.22469512904806252 ;
+  mps.get()[ 339 ] = -0.5302042447544824 ;
+  mps.get()[ 340 ] = 0.1385544129616299 ;
+  mps.get()[ 341 ] = 0.16964924283127805 ;
+  mps.get()[ 342 ] = -0.04065543762807928 ;
+  mps.get()[ 343 ] = 0.005959393071539496 ;
+  mps.get()[ 344 ] = -0.4512829757314996 ;
+  mps.get()[ 345 ] = -0.2586701038412787 ;
+  mps.get()[ 346 ] = 0.5529069902589456 ;
+  mps.get()[ 347 ] = -0.03606848742855439 ;
+  mps.get()[ 348 ] = -0.14118940851816178 ;
+  mps.get()[ 349 ] = -0.06994728084240831 ;
+  mps.get()[ 350 ] = 0.018957416881223405 ;
+  mps.get()[ 351 ] = 0.01819725521128998 ;
+  mps.get()[ 352 ] = -0.17686033082431762 ;
+  mps.get()[ 353 ] = 0.0 ;
+  mps.get()[ 354 ] = 0.2931301972780771 ;
+  mps.get()[ 355 ] = 0.21016759261710286 ;
+  mps.get()[ 356 ] = -0.11356014183124072 ;
+  mps.get()[ 357 ] = -0.46047703337338425 ;
+  mps.get()[ 358 ] = -0.13658537870586535 ;
+  mps.get()[ 359 ] = -0.40395680360094305 ;
+  mps.get()[ 360 ] = -0.2192834055419525 ;
+  mps.get()[ 361 ] = 0.1147739015484587 ;
+  mps.get()[ 362 ] = 0.0406334021199655 ;
+  mps.get()[ 363 ] = -0.13324853969745315 ;
+  mps.get()[ 364 ] = -0.08677952965904745 ;
+  mps.get()[ 365 ] = -0.06520136749772663 ;
+  mps.get()[ 366 ] = -0.2592315135086059 ;
+  mps.get()[ 367 ] = 0.5217332205571495 ;
+  mps.get()[ 368 ] = 0.04262419252580863 ;
+  mps.get()[ 369 ] = 0.3848508087888552 ;
+  mps.get()[ 370 ] = 0.07107418272505975 ;
+  mps.get()[ 371 ] = -0.23184566218302685 ;
+  mps.get()[ 372 ] = 0.2521398405505697 ;
+  mps.get()[ 373 ] = 0.07367621634957493 ;
+  mps.get()[ 374 ] = 0.35237066854683313 ;
+  mps.get()[ 375 ] = -0.037975076688907206 ;
+  mps.get()[ 376 ] = 0.04017444083340625 ;
+  mps.get()[ 377 ] = 0.3474071346882127 ;
+  mps.get()[ 378 ] = -0.09328244237604688 ;
+  mps.get()[ 379 ] = 0.254631755111914 ;
+  mps.get()[ 380 ] = 0.11980261826920166 ;
+  mps.get()[ 381 ] = -0.5763161558192667 ;
+  mps.get()[ 382 ] = 0.03761704118581086 ;
+  mps.get()[ 383 ] = 0.23001403035505844 ;
+  mps.get()[ 384 ] = -0.26919429961914343 ;
+  mps.get()[ 385 ] = 0.0 ;
+  mps.get()[ 386 ] = -0.26974433859093544 ;
+  mps.get()[ 387 ] = 0.07475159568942476 ;
+  mps.get()[ 388 ] = 0.4614017944048309 ;
+  mps.get()[ 389 ] = -0.1653283114243778 ;
+  mps.get()[ 390 ] = -0.5969489482357646 ;
+  mps.get()[ 391 ] = -0.010072342322176322 ;
+  mps.get()[ 392 ] = -0.0019403159041931585 ;
+  mps.get()[ 393 ] = -0.07573380596911085 ;
+  mps.get()[ 394 ] = 0.05771235935096261 ;
+  mps.get()[ 395 ] = 0.32234604777657144 ;
+  mps.get()[ 396 ] = 0.28055767387417235 ;
+  mps.get()[ 397 ] = -0.08179104024696918 ;
+  mps.get()[ 398 ] = 0.22420649690508931 ;
+  mps.get()[ 399 ] = 0.06214434558530708 ;
+  mps.get()[ 400 ] = -0.10312646494528237 ;
+  mps.get()[ 401 ] = -0.46866618040645364 ;
+  mps.get()[ 402 ] = -0.3880666432855699 ;
+  mps.get()[ 403 ] = -0.03681826251267426 ;
+  mps.get()[ 404 ] = -0.25192564830049524 ;
+  mps.get()[ 405 ] = -0.024048027190332867 ;
+  mps.get()[ 406 ] = 0.2710542945659806 ;
+  mps.get()[ 407 ] = 0.22315379238735505 ;
+  mps.get()[ 408 ] = 0.1774445513167211 ;
+  mps.get()[ 409 ] = -0.08929584369397156 ;
+  mps.get()[ 410 ] = 0.2513518619982434 ;
+  mps.get()[ 411 ] = 0.010901632944735585 ;
+  mps.get()[ 412 ] = 0.20937810155968847 ;
+  mps.get()[ 413 ] = -0.14207394095443068 ;
+  mps.get()[ 414 ] = 0.09108907016995436 ;
+  mps.get()[ 415 ] = 0.5053457101186702 ;
+  mps.get()[ 544 ] = -0.23436455 ;
+  mps.get()[ 545 ] = 0.53141874 ;
+  mps.get()[ 546 ] = 0.06564701 ;
+  mps.get()[ 547 ] = -0.016569737 ;
+  mps.get()[ 560 ] = 0.27552164 ;
+  mps.get()[ 561 ] = 0.39324737 ;
+  mps.get()[ 562 ] = 0.03920218 ;
+  mps.get()[ 563 ] = 0.3126193 ;
+  mps.get()[ 576 ] = 0.08090294 ;
+  mps.get()[ 577 ] = 0.067396805 ;
+  mps.get()[ 578 ] = 0.38391852 ;
+  mps.get()[ 579 ] = 0.49181914 ;
+  mps.get()[ 592 ] = -0.34309888 ;
+  mps.get()[ 593 ] = -0.16689296 ;
+  mps.get()[ 594 ] = 0.3111027 ;
+  mps.get()[ 595 ] = 0.33973938 ;
+  mps.get()[ 608 ] = -0.39236507 ;
+  mps.get()[ 609 ] = 0.21032207 ;
+  mps.get()[ 610 ] = 0.084636666 ;
+  mps.get()[ 611 ] = -0.026731271 ;
+  mps.get()[ 624 ] = 0.048989747 ;
+  mps.get()[ 625 ] = -0.22122668 ;
+  mps.get()[ 626 ] = 0.24929003 ;
+  mps.get()[ 627 ] = -0.23605682 ;
+  mps.get()[ 640 ] = 0.02890851 ;
+  mps.get()[ 641 ] = -0.008860635 ;
+  mps.get()[ 642 ] = -0.30513528 ;
+  mps.get()[ 643 ] = 0.14362136 ;
+  mps.get()[ 656 ] = 0.008236099 ;
+  mps.get()[ 657 ] = 0.15793985 ;
+  mps.get()[ 658 ] = 0.16013248 ;
+  mps.get()[ 659 ] = -0.17186542 ;
+  mps.get()[ 672 ] = 2.1042667e-32 ;
+  mps.get()[ 673 ] = -1.7309414e-32 ;
+  mps.get()[ 674 ] = -1.18279285e-32 ;
+  mps.get()[ 675 ] = 4.1110057e-33 ;
+  mps.get()[ 688 ] = 1.6622225e-33 ;
+  mps.get()[ 689 ] = 1.718814e-32 ;
+  mps.get()[ 690 ] = -1.2495627e-32 ;
+  mps.get()[ 691 ] = 1.3456783e-32 ;
+  mps.get()[ 704 ] = -1.5954751e-32 ;
+  mps.get()[ 705 ] = 1.0564825e-32 ;
+  mps.get()[ 706 ] = 8.3999555e-33 ;
+  mps.get()[ 707 ] = 7.0071443e-34 ;
+  mps.get()[ 720 ] = 3.413174e-34 ;
+  mps.get()[ 721 ] = -1.01854646e-32 ;
+  mps.get()[ 722 ] = 1.0789845e-32 ;
+  mps.get()[ 723 ] = -5.4311017e-33 ;
+  mps.get()[ 800 ] = 0.503408 ;
+  mps.get()[ 801 ] = 0.0 ;
+  mps.get()[ 802 ] = -0.48754588 ;
+  mps.get()[ 803 ] = 0.38097852 ;
+  mps.get()[ 804 ] = -0.4678266 ;
+  mps.get()[ 805 ] = 0.0 ;
+  mps.get()[ 806 ] = -0.29991406 ;
+  mps.get()[ 807 ] = 0.2343591 ;
+
+  // The below snippets compute the following:
+  //        |
+  //      +---+ +---+ +---+ +---+ +---+
+  // mps2 | 0 +-+ 1 +-+ 2 +-+ 3 |-+ 4 |
+  //      +-+-+ +-+-+ +-+-+ +-+-+ +-+-+
+  //              |     |     |     |
+  //              |     |     |     |
+  //      +-+-+ +-+-+ +-+-+ +-+-+ +-+-+
+  // mps  | 0 +-+ 1 +-+ 2 +-+ 3 |-+ 4 |
+  //      +---+ +---+ +---+ +---+ +---+
+  //        |
+  //-----------------------------------------
+  //              |
+  //      +---+ +---+ +---+ +---+ +---+
+  // mps2 | 0 +-+ 1 +-+ 2 +-+ 3 |-+ 4 |
+  //      +-+-+ +-+-+ +-+-+ +-+-+ +-+-+
+  //        |           |     |     |
+  //        |           |     |     |
+  //      +-+-+ +-+-+ +-+-+ +-+-+ +-+-+
+  // mps  | 0 +-+ 1 +-+ 2 +-+ 3 |-+ 4 |
+  //      +---+ +---+ +---+ +---+ +---+
+  //              |
+  //-----------------------------------------
+  // And so on.
+
+  float *rdm = new float[8];
+  ss.ReduceDensityMatrix(mps, scratch, 0, rdm);
+  EXPECT_NEAR(rdm[ 0 ], 0.43434495 , 1e-4);
+  EXPECT_NEAR(rdm[ 1 ], 0.0 , 1e-4);
+  EXPECT_NEAR(rdm[ 2 ], 0.0452075 , 1e-4);
+  EXPECT_NEAR(rdm[ 3 ], -0.06079552 , 1e-4);
+  EXPECT_NEAR(rdm[ 4 ], 0.0452075 , 1e-4);
+  EXPECT_NEAR(rdm[ 5 ], 0.06079552 , 1e-4);
+  EXPECT_NEAR(rdm[ 6 ], 0.5656554 , 1e-4);
+  EXPECT_NEAR(rdm[ 7 ], 0.0 , 1e-4);
+  ss.ReduceDensityMatrix(mps, scratch, 1, rdm);
+  EXPECT_NEAR(rdm[ 0 ], 0.39097905 , 1e-4);
+  EXPECT_NEAR(rdm[ 1 ], 0.0 , 1e-4);
+  EXPECT_NEAR(rdm[ 2 ], 0.02212441 , 1e-4);
+  EXPECT_NEAR(rdm[ 3 ], -0.026811063 , 1e-4);
+  EXPECT_NEAR(rdm[ 4 ], 0.02212441 , 1e-4);
+  EXPECT_NEAR(rdm[ 5 ], 0.026811063 , 1e-4);
+  EXPECT_NEAR(rdm[ 6 ], 0.6090213 , 1e-4);
+  EXPECT_NEAR(rdm[ 7 ], 0.0 , 1e-4);
+  ss.ReduceDensityMatrix(mps, scratch, 2, rdm);
+  EXPECT_NEAR(rdm[ 0 ], 0.49911368 , 1e-4);
+  EXPECT_NEAR(rdm[ 1 ], 0.0 , 1e-4);
+  EXPECT_NEAR(rdm[ 2 ], -0.1224697 , 1e-4);
+  EXPECT_NEAR(rdm[ 3 ], 0.030501436 , 1e-4);
+  EXPECT_NEAR(rdm[ 4 ], -0.1224697 , 1e-4);
+  EXPECT_NEAR(rdm[ 5 ], -0.030501436 , 1e-4);
+  EXPECT_NEAR(rdm[ 6 ], 0.5008867 , 1e-4);
+  EXPECT_NEAR(rdm[ 7 ], 0.0 , 1e-4);
+  ss.ReduceDensityMatrix(mps, scratch, 3, rdm);
+  EXPECT_NEAR(rdm[ 0 ], 0.5358647 , 1e-4);
+  EXPECT_NEAR(rdm[ 1 ], 0.0 , 1e-4);
+  EXPECT_NEAR(rdm[ 2 ], 0.11097979 , 1e-4);
+  EXPECT_NEAR(rdm[ 3 ], 0.08869759 , 1e-4);
+  EXPECT_NEAR(rdm[ 4 ], 0.11097979 , 1e-4);
+  EXPECT_NEAR(rdm[ 5 ], -0.08869759 , 1e-4);
+  EXPECT_NEAR(rdm[ 6 ], 0.4641356 , 1e-4);
+  EXPECT_NEAR(rdm[ 7 ], 0.0 , 1e-4);
+  ss.ReduceDensityMatrix(mps, scratch, 4, rdm);
+  EXPECT_NEAR(rdm[ 0 ], 0.47228184 , 1e-4);
+  EXPECT_NEAR(rdm[ 1 ], 0.0 , 1e-4);
+  EXPECT_NEAR(rdm[ 2 ], -0.105126746 , 1e-4);
+  EXPECT_NEAR(rdm[ 3 ], -0.082148254 , 1e-4);
+  EXPECT_NEAR(rdm[ 4 ], -0.105126746 , 1e-4);
+  EXPECT_NEAR(rdm[ 5 ], 0.082148254 , 1e-4);
+  EXPECT_NEAR(rdm[ 6 ], 0.5277185 , 1e-4);
+  EXPECT_NEAR(rdm[ 7 ], 0.0 , 1e-4);
+  delete[](rdm);
+
+}
+
 }  // namespace
 }  // namespace mps
 }  // namespace qsim

From 793712ca1047d920929b1efbcd0bae72245ebbea Mon Sep 17 00:00:00 2001
From: Michael Broughton <mbbrough@google.com>
Date: Tue, 7 Dec 2021 14:37:58 -0800
Subject: [PATCH 179/246] Sergei feedback.

---
 lib/mps_statespace.h         | 30 +++++++++++++-----------------
 tests/mps_statespace_test.cc |  3 +--
 2 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/lib/mps_statespace.h b/lib/mps_statespace.h
index 1ca77906..acdf69db 100644
--- a/lib/mps_statespace.h
+++ b/lib/mps_statespace.h
@@ -234,7 +234,7 @@ class MPSStateSpace {
   }
 
   // Compute the 2x2 1-RDM of state on index. Result written to rdm.
-  // Requires: scratch to be allocated.
+  // Requires: scratch and rdm to be allocated.
   static void ReduceDensityMatrix(MPS& state, MPS& scratch, int index,
                                   fp_type* rdm) {
     const auto num_qubits = state.num_qubits();
@@ -245,6 +245,9 @@ class MPSStateSpace {
     auto offset = 0;
     fp_type* state_raw = state.get();
     fp_type* scratch_raw = scratch.get();
+    fp_type* state_raw_workspace = state_raw + end + 2 * bond_dim * bond_dim;
+    fp_type* scratch_raw_workspace =
+        scratch_raw + end + 2 * bond_dim * bond_dim;
 
     Copy(state, scratch);
 
@@ -252,9 +255,8 @@ class MPSStateSpace {
     ConstMatrixMap top((Complex*)scratch_raw, 2, bond_dim);
     ConstMatrixMap bot((Complex*)state_raw, 2, bond_dim);
     MatrixMap partial_contract((Complex*)(state_raw + end), bond_dim, bond_dim);
-    MatrixMap partial_contract2(
-        (Complex*)(state_raw + end + 2 * bond_dim * bond_dim), bond_dim,
-        2 * bond_dim);
+    MatrixMap partial_contract2((Complex*)(state_raw_workspace), bond_dim,
+                                2 * bond_dim);
 
     partial_contract.setZero();
     partial_contract(0, 0) = 1;
@@ -268,8 +270,7 @@ class MPSStateSpace {
 
       // reshape:
       new (&partial_contract2)
-          MatrixMap((Complex*)(state_raw + end + 2 * bond_dim * bond_dim),
-                    bond_dim, 2 * bond_dim);
+          MatrixMap((Complex*)(state_raw_workspace), bond_dim, 2 * bond_dim);
 
       // Merge bot into left boundary merged tensor.
       new (&bot) ConstMatrixMap((Complex*)(state_raw + offset), bond_dim,
@@ -278,8 +279,7 @@ class MPSStateSpace {
 
       // reshape:
       new (&partial_contract2)
-          MatrixMap((Complex*)(state_raw + end + 2 * bond_dim * bond_dim),
-                    2 * bond_dim, bond_dim);
+          MatrixMap((Complex*)(state_raw_workspace), 2 * bond_dim, bond_dim);
 
       // Merge top into partial_contract2.
       new (&top) ConstMatrixMap((Complex*)(scratch_raw + offset), 2 * bond_dim,
@@ -296,8 +296,7 @@ class MPSStateSpace {
     new (&partial_contract)
         MatrixMap((Complex*)(scratch_raw + end), bond_dim, bond_dim);
     new (&partial_contract2)
-        MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
-                  bond_dim, 2 * bond_dim);
+        MatrixMap((Complex*)(scratch_raw_workspace), bond_dim, 2 * bond_dim);
 
     partial_contract.setZero();
     partial_contract(0, 0) = 1;
@@ -305,13 +304,12 @@ class MPSStateSpace {
       partial_contract.noalias() = top * bot.adjoint();
     }
 
-    for (unsigned i = num_qubits - 2; i > index; i--) {
+    for (unsigned i = num_qubits - 2; i > index; --i) {
       offset = GetBlockOffset(state, i);
 
       // reshape:
       new (&partial_contract2)
-          MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
-                    2 * bond_dim, bond_dim);
+          MatrixMap((Complex*)(scratch_raw_workspace), 2 * bond_dim, bond_dim);
 
       // Merge bot into left boundary merged tensor.
       new (&bot) ConstMatrixMap((Complex*)(state_raw + offset), 2 * bond_dim,
@@ -320,8 +318,7 @@ class MPSStateSpace {
 
       // reshape:
       new (&partial_contract2)
-          MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
-                    bond_dim, 2 * bond_dim);
+          MatrixMap((Complex*)(scratch_raw_workspace), bond_dim, 2 * bond_dim);
 
       // Merge top into partial_contract2.
       new (&top) ConstMatrixMap((Complex*)(scratch_raw + offset), bond_dim,
@@ -342,8 +339,7 @@ class MPSStateSpace {
     new (&top)
         ConstMatrixMap((Complex*)(state_raw + offset), bond_dim, 2 * right_dim);
     new (&partial_contract2)
-        MatrixMap((Complex*)(scratch_raw + end + 2 * bond_dim * bond_dim),
-                  bond_dim, 2 * right_dim);
+        MatrixMap((Complex*)(scratch_raw_workspace), bond_dim, 2 * right_dim);
     partial_contract2.noalias() = partial_contract * top.conjugate();
     // copy the bottom contraction scratch_raw to state_raw to save space.
     memcpy(state_raw + end, scratch_raw + end,
diff --git a/tests/mps_statespace_test.cc b/tests/mps_statespace_test.cc
index 4f86154d..190f08df 100644
--- a/tests/mps_statespace_test.cc
+++ b/tests/mps_statespace_test.cc
@@ -851,7 +851,7 @@ TEST(MPSStateSpaceTest, ReduceDensityMatrixLarge){
   //-----------------------------------------
   // And so on.
 
-  float *rdm = new float[8];
+  float rdm[8];
   ss.ReduceDensityMatrix(mps, scratch, 0, rdm);
   EXPECT_NEAR(rdm[ 0 ], 0.43434495 , 1e-4);
   EXPECT_NEAR(rdm[ 1 ], 0.0 , 1e-4);
@@ -897,7 +897,6 @@ TEST(MPSStateSpaceTest, ReduceDensityMatrixLarge){
   EXPECT_NEAR(rdm[ 5 ], 0.082148254 , 1e-4);
   EXPECT_NEAR(rdm[ 6 ], 0.5277185 , 1e-4);
   EXPECT_NEAR(rdm[ 7 ], 0.0 , 1e-4);
-  delete[](rdm);
 
 }
 

From 02392f489e96201f16fec12be2daf9b0e95cf6a8 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Thu, 16 Dec 2021 09:12:02 -0800
Subject: [PATCH 180/246] Add url to setup.py

---
 setup.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup.py b/setup.py
index 2fc70507..121b4dad 100644
--- a/setup.py
+++ b/setup.py
@@ -90,6 +90,7 @@ def build_extension(self, ext):
 setup(
     name="qsimcirq",
     version=__version__,
+    url="https://github.com/quantumlib/qsim",
     author="Vamsi Krishna Devabathini",
     author_email="devabathini92@gmail.com",
     python_requires=">=3.3.0",

From f3d63cbd93acc5b1e666908cf0522f5806c98ed6 Mon Sep 17 00:00:00 2001
From: Michael Broughton <mbbrough@google.com>
Date: Fri, 17 Dec 2021 02:32:21 -0800
Subject: [PATCH 181/246] Adds working bitstring Sample function to MPS.

---
 lib/mps_statespace.h         |  64 +++++++++++
 tests/mps_statespace_test.cc | 204 +++++++++++++++++++++++++++++++++++
 2 files changed, 268 insertions(+)

diff --git a/lib/mps_statespace.h b/lib/mps_statespace.h
index acdf69db..641d0332 100644
--- a/lib/mps_statespace.h
+++ b/lib/mps_statespace.h
@@ -25,7 +25,9 @@
 #include <cstdint>
 #include <cstdlib>
 #include <cstring>
+#include <iostream>
 #include <memory>
+#include <random>
 
 #include "../eigen/Eigen/Dense"
 #include "../eigen/unsupported/Eigen/CXX11/Tensor"
@@ -372,6 +374,68 @@ class MPSStateSpace {
     out = t_4d.contract(t_2d, product_dims);
   }
 
+  // Draw a single bitstring sample from state using scratch and scratch2
+  // as working space.
+  static void SampleOnce(MPS& state, MPS& scratch, MPS& scratch2,
+                         std::mt19937* random_gen, std::vector<bool>* sample) {
+    const auto bond_dim = state.bond_dim();
+    const auto num_qubits = state.num_qubits();
+    std::default_random_engine generator;
+    fp_type* scratch_raw = scratch.get();
+    fp_type rdm[8];
+
+    sample->reserve(num_qubits);
+    Copy(state, scratch);
+    Copy(state, scratch2);
+
+    // Sample left block.
+    ReduceDensityMatrix(scratch, scratch2, 0, rdm);
+    auto p0 = rdm[0] / (rdm[0] + rdm[6]);
+    std::bernoulli_distribution distribution(1 - p0);
+    auto bit_val = distribution(*random_gen);
+
+    sample->push_back(bit_val);
+    MatrixMap tensor_block((Complex*)scratch_raw, 2, bond_dim);
+    tensor_block.row(!bit_val).setZero();
+    tensor_block.imag() *= -1;
+
+    // Sample internal blocks.
+    for (unsigned i = 1; i < num_qubits - 1; i++) {
+      ReduceDensityMatrix(scratch, scratch2, i, rdm);
+      p0 = rdm[0] / (rdm[0] + rdm[6]);
+      distribution = std::bernoulli_distribution(1 - p0);
+      bit_val = distribution(*random_gen);
+
+      sample->push_back(bit_val);
+      const auto mem_start = GetBlockOffset(scratch, i);
+      new (&tensor_block) MatrixMap((Complex*)(scratch_raw + mem_start),
+                                    bond_dim * 2, bond_dim);
+      for (unsigned j = !bit_val; j < 2 * bond_dim; j += 2) {
+        tensor_block.row(j).setZero();
+      }
+      tensor_block.imag() *= -1;
+    }
+
+    // Sample right block.
+    ReduceDensityMatrix(scratch, scratch2, num_qubits - 1, rdm);
+    p0 = rdm[0] / (rdm[0] + rdm[6]);
+    distribution = std::bernoulli_distribution(1 - p0);
+    bit_val = distribution(*random_gen);
+    sample->push_back(bit_val);
+  }
+
+  // Draw num_samples bitstring samples from state and store the result
+  // bit vectors in results. Uses scratch and scratch2 as workspace.
+  static void Sample(MPS& state, MPS& scratch, MPS& scratch2,
+                     unsigned num_samples, unsigned seed,
+                     std::vector<std::vector<bool>>* results) {
+    std::mt19937 rand_source(seed);
+    results->reserve(num_samples);
+    for (unsigned i = 0; i < num_samples; i++) {
+      SampleOnce(state, scratch, scratch2, &rand_source, &(*results)[i]);
+    }
+  }
+
   // Testing only. Convert the MPS to a wavefunction under "normal" ordering.
   // Requires: wf be allocated beforehand with bond_dim * 2 ^ num_qubits -1
   // memory.
diff --git a/tests/mps_statespace_test.cc b/tests/mps_statespace_test.cc
index 190f08df..28c92ed3 100644
--- a/tests/mps_statespace_test.cc
+++ b/tests/mps_statespace_test.cc
@@ -16,6 +16,7 @@
 
 #include "../lib/formux.h"
 #include "gtest/gtest.h"
+#include "gmock/gmock.h"
 
 namespace qsim {
 
@@ -900,6 +901,209 @@ TEST(MPSStateSpaceTest, ReduceDensityMatrixLarge){
 
 }
 
+TEST(MPSStateSpaceTest, SampleOnceSimple){
+  auto ss = MPSStateSpace<For, float>(1);
+  auto mps = ss.Create(3, 4);
+  auto scratch = ss.Create(3, 4);
+  auto scratch2 = ss.Create(3, 4);
+  std::mt19937 rand_source(1234);
+  std::vector<bool> results;
+
+  // Set to |100>.
+  results.clear();
+  ss.SetStateZero(mps);
+  mps.get()[0] = 0;
+  mps.get()[8] = 1;
+  ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
+  ASSERT_THAT(results, testing::ElementsAre(1, 0, 0));
+  //EXPECT_EQ(1,2);
+
+  // Set to |010>.
+  results.clear();
+  ss.SetStateZero(mps);
+  mps.get()[16] = 0;
+  mps.get()[24] = 1;
+  ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
+  ASSERT_THAT(results, testing::ElementsAre(0, 1, 0));
+
+  // Set to |001>.
+  results.clear();
+  ss.SetStateZero(mps);
+  mps.get()[80] = 0;
+  mps.get()[82] = 1;
+  ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
+  ASSERT_THAT(results, testing::ElementsAre(0, 0, 1));
+
+  // Set to |101>.
+  results.clear();
+  ss.SetStateZero(mps);
+  mps.get()[0] = 0;
+  mps.get()[8] = 1;
+  mps.get()[80] = 0;
+  mps.get()[82] = 1;
+  ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
+  ASSERT_THAT(results, testing::ElementsAre(1, 0, 1));
+}
+
+TEST(MPSStateSpaceTest, SampleGHZ){
+  const int num_samples = 10000;
+  auto ss = MPSStateSpace<For, float>(1);
+  auto mps = ss.Create(3, 4);
+  auto scratch = ss.Create(3, 4);
+  auto scratch2 = ss.Create(3, 4);
+  std::vector<std::vector<bool>> results(
+    num_samples, std::vector<bool>({}));
+
+  memset(mps.get(), 0, ss.RawSize(mps));
+  mps.get()[0] = 1;
+  mps.get()[10] = 1;
+  mps.get()[16] = 1;
+  mps.get()[42] = -1;
+  mps.get()[80] = 0.70710677;
+  mps.get()[86] = -0.70710677;
+
+  float count = 0;
+  ss.Sample(mps, scratch, scratch2, num_samples, 1234, &results);
+  for(int i = 0 ; i < num_samples; i++){
+    ASSERT_THAT(results[i], testing::AnyOf(testing::ElementsAre(1, 1, 1),
+                                           testing::ElementsAre(0, 0, 0)));
+    count += results[i][0];
+  }
+  EXPECT_NEAR(count / float(num_samples), 0.5, 1e-2);
+}
+
+TEST(MPSStateSpaceTest, SampleComplex){
+  const int num_samples = 10000;
+  auto ss = MPSStateSpace<For, float>(1);
+  auto mps = ss.Create(4, 4);
+  auto scratch = ss.Create(4, 4);
+  auto scratch2 = ss.Create(4, 4);
+  std::vector<std::vector<bool>> results(
+    num_samples, std::vector<bool>({}));
+
+  memset(mps.get(), 0, ss.RawSize(mps));
+  mps.get()[ 0 ] = 0.033688569334715854 ;
+  mps.get()[ 1 ] = -0.10444182602180123 ;
+  mps.get()[ 2 ] = 0.9076354671683359 ;
+  mps.get()[ 3 ] = 0.405160344657187 ;
+  mps.get()[ 8 ] = -0.9595253512026178 ;
+  mps.get()[ 9 ] = -0.25936097827312377 ;
+  mps.get()[ 10 ] = -0.03987001675676861 ;
+  mps.get()[ 11 ] = 0.10224185693597321 ;
+  mps.get()[ 16 ] = -0.4350591822776815 ;
+  mps.get()[ 17 ] = 0.22228546667942578 ;
+  mps.get()[ 18 ] = -0.6285732819602607 ;
+  mps.get()[ 19 ] = 0.5943422063507785 ;
+  mps.get()[ 20 ] = -0.02428345908884816 ;
+  mps.get()[ 21 ] = 0.026256572727652475 ;
+  mps.get()[ 22 ] = 0.0728063572325396 ;
+  mps.get()[ 23 ] = -0.07991114142962712 ;
+  mps.get()[ 24 ] = -0.1642035571020447 ;
+  mps.get()[ 25 ] = -0.8209212529030018 ;
+  mps.get()[ 26 ] = 0.21124207331921135 ;
+  mps.get()[ 27 ] = 0.4033152234452636 ;
+  mps.get()[ 28 ] = -0.11315780332634073 ;
+  mps.get()[ 29 ] = -0.18477947087021204 ;
+  mps.get()[ 30 ] = -0.11199707215175961 ;
+  mps.get()[ 31 ] = -0.17985444082650426 ;
+  mps.get()[ 32 ] = -0.18059162771674087 ;
+  mps.get()[ 33 ] = -0.12173196101857839 ;
+  mps.get()[ 34 ] = 0.19817171168239098 ;
+  mps.get()[ 35 ] = 0.063054719070231 ;
+  mps.get()[ 36 ] = 0.45024015745008505 ;
+  mps.get()[ 37 ] = 0.11068157212593255 ;
+  mps.get()[ 38 ] = 0.8106501683288581 ;
+  mps.get()[ 39 ] = 0.19287240226762353 ;
+  mps.get()[ 40 ] = -0.08702392413741208 ;
+  mps.get()[ 41 ] = 0.07370887245848737 ;
+  mps.get()[ 42 ] = -0.018412987786278347 ;
+  mps.get()[ 43 ] = 0.027921764369775018 ;
+  mps.get()[ 44 ] = 0.42351439662329743 ;
+  mps.get()[ 45 ] = -0.7466201917698305 ;
+  mps.get()[ 46 ] = -0.24298735917837008 ;
+  mps.get()[ 47 ] = 0.4359199055764641 ;
+  mps.get()[ 80 ] = 0.422436255430577 ;
+  mps.get()[ 81 ] = 0.0 ;
+  mps.get()[ 82 ] = 0.1211402132186689 ;
+  mps.get()[ 83 ] = -0.819174648113452 ;
+  mps.get()[ 84 ] = 0.0 ;
+  mps.get()[ 85 ] = -7.333691512826885e-20 ;
+  mps.get()[ 88 ] = -0.8676720638499252 ;
+  mps.get()[ 89 ] = 0.1360568551008419 ;
+  mps.get()[ 90 ] = 0.011793867549118184 ;
+  mps.get()[ 91 ] = -0.44097834083157716 ;
+  mps.get()[ 96 ] = -0.08978879818674973 ;
+  mps.get()[ 97 ] = 0.0 ;
+  mps.get()[ 98 ] = -0.021807957717091198 ;
+  mps.get()[ 99 ] = -0.05873893136151775 ;
+  mps.get()[ 100 ] = 0.0 ;
+  mps.get()[ 101 ] = -9.89518074266081e-19 ;
+  mps.get()[ 104 ] = 0.14307979940517454 ;
+  mps.get()[ 105 ] = 0.06032194765563529 ;
+  mps.get()[ 106 ] = 0.22589440044405648 ;
+  mps.get()[ 107 ] = -0.2397609424987549 ;
+  mps.get()[ 112 ] = 0.12734430206944722 ;
+  mps.get()[ 113 ] = 0.0 ;
+  mps.get()[ 114 ] = -0.003114595079760157 ;
+  mps.get()[ 115 ] = 0.06816683893204967 ;
+  mps.get()[ 116 ] = 2.722010100011512e-17 ;
+  mps.get()[ 117 ] = 1.9629880528929172e-18 ;
+  mps.get()[ 120 ] = 0.014022255715263434 ;
+  mps.get()[ 121 ] = 0.017127855001478075 ;
+  mps.get()[ 122 ] = 0.025812082320798548 ;
+  mps.get()[ 123 ] = -0.027110021000464 ;
+  mps.get()[ 128 ] = -0.018262196707018574 ;
+  mps.get()[ 129 ] = 0.0 ;
+  mps.get()[ 130 ] = 0.0032725358458428836 ;
+  mps.get()[ 131 ] = 0.0310845568816579 ;
+  mps.get()[ 132 ] = 1.935877805637811e-17 ;
+  mps.get()[ 133 ] = -1.0370773958773989e-18 ;
+  mps.get()[ 136 ] = -0.028632305212090994 ;
+  mps.get()[ 137 ] = 0.012199896816087576 ;
+  mps.get()[ 138 ] = 0.0009323445588941451 ;
+  mps.get()[ 139 ] = -0.014212789540748644 ;
+  mps.get()[ 144 ] = -0.07762944756130831 ;
+  mps.get()[ 145 ] = -0.25063255485414937 ;
+  mps.get()[ 146 ] = 0.515385895406013 ;
+  mps.get()[ 147 ] = 0.7314486807404007 ;
+  mps.get()[ 148 ] = 0.20689214104052 ;
+  mps.get()[ 149 ] = 0.2781707321332216 ;
+  mps.get()[ 150 ] = 0.08286244916183945 ;
+  mps.get()[ 151 ] = 0.05888783848647657 ;
+
+  ss.Sample(mps, scratch, scratch2, num_samples, 12345, &results);
+ 
+  std::vector<float> expected({
+    0.00467637,
+    0.0020386,
+    0.00112952,
+    0.0269848,
+    0.00704221,
+    0.00147802,
+    0.00243688,
+    0.0350753,
+    0.0324814,
+    0.0141599,
+    0.0412371,
+    0.0780275,
+    0.0644363,
+    0.140995,
+    0.0355866,
+    0.512215,
+  });
+  std::vector<float> hist(16, 0);
+  for(int i =0;i<num_samples;i++){
+    int index = 0;
+    for(int j =0;j<4;j++){
+      index |= (results[i][j]) << (4 - j - 1);
+    }
+    hist[index] += 1;
+  }
+  for(int i =0;i<16;i++){
+    EXPECT_NEAR(hist[i] / float(num_samples), expected[i], 1e-2);
+  }
+}
+
 }  // namespace
 }  // namespace mps
 }  // namespace qsim

From dd0f7f1603d8a192a533519abb93be712e1eaa60 Mon Sep 17 00:00:00 2001
From: Michael Broughton <mbbrough@google.com>
Date: Fri, 17 Dec 2021 02:35:52 -0800
Subject: [PATCH 182/246] remove iostream include.

---
 lib/mps_statespace.h | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/mps_statespace.h b/lib/mps_statespace.h
index 641d0332..c017e650 100644
--- a/lib/mps_statespace.h
+++ b/lib/mps_statespace.h
@@ -25,7 +25,6 @@
 #include <cstdint>
 #include <cstdlib>
 #include <cstring>
-#include <iostream>
 #include <memory>
 #include <random>
 

From fa36fd74e8baafec61d1944c961ed5e902633bd3 Mon Sep 17 00:00:00 2001
From: Michael Broughton <mbbrough@google.com>
Date: Fri, 17 Dec 2021 13:08:26 -0800
Subject: [PATCH 183/246] remove use of gmock.

---
 tests/mps_statespace_test.cc | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/tests/mps_statespace_test.cc b/tests/mps_statespace_test.cc
index 28c92ed3..9473eaf9 100644
--- a/tests/mps_statespace_test.cc
+++ b/tests/mps_statespace_test.cc
@@ -16,7 +16,6 @@
 
 #include "../lib/formux.h"
 #include "gtest/gtest.h"
-#include "gmock/gmock.h"
 
 namespace qsim {
 
@@ -915,8 +914,9 @@ TEST(MPSStateSpaceTest, SampleOnceSimple){
   mps.get()[0] = 0;
   mps.get()[8] = 1;
   ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
-  ASSERT_THAT(results, testing::ElementsAre(1, 0, 0));
-  //EXPECT_EQ(1,2);
+  EXPECT_EQ(results[0], 1);
+  EXPECT_EQ(results[1], 0);
+  EXPECT_EQ(results[2], 0);
 
   // Set to |010>.
   results.clear();
@@ -924,7 +924,9 @@ TEST(MPSStateSpaceTest, SampleOnceSimple){
   mps.get()[16] = 0;
   mps.get()[24] = 1;
   ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
-  ASSERT_THAT(results, testing::ElementsAre(0, 1, 0));
+  EXPECT_EQ(results[0], 0);
+  EXPECT_EQ(results[1], 1);
+  EXPECT_EQ(results[2], 0);
 
   // Set to |001>.
   results.clear();
@@ -932,7 +934,9 @@ TEST(MPSStateSpaceTest, SampleOnceSimple){
   mps.get()[80] = 0;
   mps.get()[82] = 1;
   ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
-  ASSERT_THAT(results, testing::ElementsAre(0, 0, 1));
+  EXPECT_EQ(results[0], 0);
+  EXPECT_EQ(results[1], 0);
+  EXPECT_EQ(results[2], 1);
 
   // Set to |101>.
   results.clear();
@@ -942,7 +946,9 @@ TEST(MPSStateSpaceTest, SampleOnceSimple){
   mps.get()[80] = 0;
   mps.get()[82] = 1;
   ss.SampleOnce(mps, scratch, scratch2, &rand_source, &results);
-  ASSERT_THAT(results, testing::ElementsAre(1, 0, 1));
+  EXPECT_EQ(results[0], 1);
+  EXPECT_EQ(results[1], 0);
+  EXPECT_EQ(results[2], 1);
 }
 
 TEST(MPSStateSpaceTest, SampleGHZ){
@@ -965,8 +971,10 @@ TEST(MPSStateSpaceTest, SampleGHZ){
   float count = 0;
   ss.Sample(mps, scratch, scratch2, num_samples, 1234, &results);
   for(int i = 0 ; i < num_samples; i++){
-    ASSERT_THAT(results[i], testing::AnyOf(testing::ElementsAre(1, 1, 1),
-                                           testing::ElementsAre(0, 0, 0)));
+    bool all_same = 1;
+    all_same &= results[i][0] == results[i][1];
+    all_same &= results[i][1] == results[i][2];
+    EXPECT_EQ(all_same, 1);
     count += results[i][0];
   }
   EXPECT_NEAR(count / float(num_samples), 0.5, 1e-2);

From 70f7a2bfe24a65635efa63f41514c3ddb5efbf03 Mon Sep 17 00:00:00 2001
From: Michael Broughton <mbbrough@google.com>
Date: Tue, 21 Dec 2021 04:21:19 -0800
Subject: [PATCH 184/246] Moved to O(n) sampling algorithm.

---
 lib/mps_statespace.h         | 153 ++++++++++++++++++++++---
 tests/mps_statespace_test.cc | 210 ++++++++++++++++++-----------------
 2 files changed, 243 insertions(+), 120 deletions(-)

diff --git a/lib/mps_statespace.h b/lib/mps_statespace.h
index c017e650..721b626e 100644
--- a/lib/mps_statespace.h
+++ b/lib/mps_statespace.h
@@ -22,9 +22,11 @@
 #include <malloc.h>
 #endif
 
+#include <algorithm>
 #include <cstdint>
 #include <cstdlib>
 #include <cstring>
+#include <iostream>
 #include <memory>
 #include <random>
 
@@ -324,7 +326,7 @@ class MPSStateSpace {
       // Merge top into partial_contract2.
       new (&top) ConstMatrixMap((Complex*)(scratch_raw + offset), bond_dim,
                                 2 * bond_dim);
-      // [bd, bd] = [2bd, bd] @ [bd, 2bd]
+      // [bd, bd] = [bd, 2bd] @ [bd, 2bd]
       partial_contract.noalias() = top * partial_contract2.adjoint();
     }
 
@@ -377,46 +379,165 @@ class MPSStateSpace {
   // as working space.
   static void SampleOnce(MPS& state, MPS& scratch, MPS& scratch2,
                          std::mt19937* random_gen, std::vector<bool>* sample) {
+    // TODO: carefully profile with perf and optimize temp storage
+    //  locations for cache friendliness.
     const auto bond_dim = state.bond_dim();
     const auto num_qubits = state.num_qubits();
+    const auto end = Size(state);
+    const auto left_frontier_offset = GetBlockOffset(state, num_qubits + 1);
     std::default_random_engine generator;
+    fp_type* state_raw = state.get();
     fp_type* scratch_raw = scratch.get();
+    fp_type* scratch2_raw = scratch2.get();
     fp_type rdm[8];
 
     sample->reserve(num_qubits);
     Copy(state, scratch);
     Copy(state, scratch2);
 
-    // Sample left block.
-    ReduceDensityMatrix(scratch, scratch2, 0, rdm);
+    // Store prefix contractions in scratch2.
+    auto offset = GetBlockOffset(state, num_qubits - 1);
+    ConstMatrixMap top((Complex*)(state_raw + offset), bond_dim, 2);
+    ConstMatrixMap bot((Complex*)(scratch_raw + offset), bond_dim, 2);
+    MatrixMap partial_contract((Complex*)(scratch2_raw + offset), bond_dim,
+                               bond_dim);
+    MatrixMap partial_contract2((Complex*)(scratch_raw + end), bond_dim,
+                                2 * bond_dim);
+    partial_contract.noalias() = top * bot.adjoint();
+
+    for (unsigned i = num_qubits - 2; i > 0; --i) {
+      offset = GetBlockOffset(state, i);
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(scratch_raw + end), 2 * bond_dim, bond_dim);
+
+      // Merge bot into left boundary merged tensor.
+      new (&bot) ConstMatrixMap((Complex*)(scratch_raw + offset), 2 * bond_dim,
+                                bond_dim);
+      partial_contract2.noalias() = bot * partial_contract.adjoint();
+
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(scratch_raw + end), bond_dim, 2 * bond_dim);
+
+      // Merge top into partial_contract2.
+      new (&top) ConstMatrixMap((Complex*)(state_raw + offset), bond_dim,
+                                2 * bond_dim);
+
+      // merge into partial_contract -> scracth2_raw.
+      new (&partial_contract)
+          MatrixMap((Complex*)(scratch2_raw + offset), bond_dim, bond_dim);
+      partial_contract.noalias() = top * partial_contract2.adjoint();
+    }
+
+    // Compute RDM-0 and draw first sample.
+    offset = GetBlockOffset(state, 1);
+    new (&top) ConstMatrixMap((Complex*)state_raw, 2, bond_dim);
+    new (&bot) ConstMatrixMap((Complex*)scratch_raw, 2, bond_dim);
+    new (&partial_contract)
+        MatrixMap((Complex*)(scratch2_raw + offset), bond_dim, bond_dim);
+    new (&partial_contract2)
+        MatrixMap((Complex*)(scratch_raw + end), 2, bond_dim);
+
+    partial_contract2.noalias() = bot * partial_contract.adjoint();
+
+    new (&partial_contract) MatrixMap((Complex*)rdm, 2, 2);
+    partial_contract.noalias() = top * partial_contract2.adjoint();
     auto p0 = rdm[0] / (rdm[0] + rdm[6]);
     std::bernoulli_distribution distribution(1 - p0);
     auto bit_val = distribution(*random_gen);
-
     sample->push_back(bit_val);
-    MatrixMap tensor_block((Complex*)scratch_raw, 2, bond_dim);
-    tensor_block.row(!bit_val).setZero();
-    tensor_block.imag() *= -1;
 
-    // Sample internal blocks.
+    // collapse state.
+    new (&partial_contract) MatrixMap((Complex*)scratch_raw, 2, bond_dim);
+    partial_contract.row(!bit_val).setZero();
+
+    // Prepare left contraction frontier.
+    new (&partial_contract2) MatrixMap(
+        (Complex*)(scratch2_raw + left_frontier_offset), bond_dim, bond_dim);
+    partial_contract2.noalias() =
+        partial_contract.transpose() * partial_contract.conjugate();
+
+    // Compute RDM-i and draw internal tensor samples.
     for (unsigned i = 1; i < num_qubits - 1; i++) {
-      ReduceDensityMatrix(scratch, scratch2, i, rdm);
+      // Get leftmost [bd, bd] contraction and contract with top.
+      offset = GetBlockOffset(state, i);
+      new (&partial_contract) MatrixMap(
+          (Complex*)(scratch2_raw + left_frontier_offset), bond_dim, bond_dim);
+      new (&top) ConstMatrixMap((Complex*)(state_raw + offset), bond_dim,
+                                2 * bond_dim);
+      new (&partial_contract2)
+          MatrixMap((Complex*)(state_raw + end), bond_dim, 2 * bond_dim);
+      partial_contract2.noalias() = partial_contract * top.conjugate();
+
+      // Contract top again for correct shape.
+      MatrixMap partial_contract3((Complex*)(scratch_raw + end), 2 * bond_dim,
+                                  2 * bond_dim);
+      partial_contract3.noalias() = top.transpose() * partial_contract2;
+
+      // Conduct final tensor contraction operations. Cannot be easily compiled
+      // to matmul. Perf reports shows only ~6% of runtime spent here on large
+      // systems.
+      offset = GetBlockOffset(state, i + 1);
+      const Eigen::TensorMap<const Eigen::Tensor<Complex, 4, Eigen::RowMajor>>
+          t_4d((Complex*)(scratch_raw + end), 2, bond_dim, 2, bond_dim);
+      const Eigen::TensorMap<const Eigen::Tensor<Complex, 2, Eigen::RowMajor>>
+          t_2d((Complex*)(scratch2_raw + offset), bond_dim, bond_dim);
+
+      const Eigen::array<Eigen::IndexPair<int>, 2> product_dims = {
+          Eigen::IndexPair<int>(1, 0),
+          Eigen::IndexPair<int>(3, 1),
+      };
+      Eigen::TensorMap<Eigen::Tensor<Complex, 2, Eigen::RowMajor>> out(
+          (Complex*)rdm, 2, 2);
+      out = t_4d.contract(t_2d, product_dims);
+
+      // Sample bit and collapse state.
       p0 = rdm[0] / (rdm[0] + rdm[6]);
       distribution = std::bernoulli_distribution(1 - p0);
       bit_val = distribution(*random_gen);
 
       sample->push_back(bit_val);
-      const auto mem_start = GetBlockOffset(scratch, i);
-      new (&tensor_block) MatrixMap((Complex*)(scratch_raw + mem_start),
-                                    bond_dim * 2, bond_dim);
+      offset = GetBlockOffset(state, i);
+      new (&partial_contract)
+          MatrixMap((Complex*)(scratch_raw + offset), bond_dim * 2, bond_dim);
       for (unsigned j = !bit_val; j < 2 * bond_dim; j += 2) {
-        tensor_block.row(j).setZero();
+        partial_contract.row(j).setZero();
       }
-      tensor_block.imag() *= -1;
+
+      // Update left frontier.
+      new (&partial_contract) MatrixMap(
+          (Complex*)(scratch2_raw + left_frontier_offset), bond_dim, bond_dim);
+
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(state_raw + end), bond_dim, 2 * bond_dim);
+
+      // Merge bot into left boundary merged tensor.
+      new (&bot) ConstMatrixMap((Complex*)(scratch_raw + offset), bond_dim,
+                                2 * bond_dim);
+      partial_contract2.noalias() = partial_contract * bot.conjugate();
+
+      // reshape:
+      new (&partial_contract2)
+          MatrixMap((Complex*)(state_raw + end), 2 * bond_dim, bond_dim);
+
+      // Merge top into partial_contract2.
+      new (&top) ConstMatrixMap((Complex*)(scratch_raw + offset), 2 * bond_dim,
+                                bond_dim);
+      partial_contract.noalias() = top.transpose() * partial_contract2;
     }
 
-    // Sample right block.
-    ReduceDensityMatrix(scratch, scratch2, num_qubits - 1, rdm);
+    // Compute RDM-(n-1) and sample.
+    offset = GetBlockOffset(state, num_qubits - 1);
+    new (&partial_contract2)
+        MatrixMap((Complex*)(state_raw + end), bond_dim, 2);
+
+    new (&top) ConstMatrixMap((Complex*)(state_raw + offset), bond_dim, 2);
+    partial_contract2.noalias() = partial_contract * top.conjugate();
+    new (&partial_contract) MatrixMap((Complex*)rdm, 2, 2);
+    partial_contract.noalias() = top.transpose() * partial_contract2;
+
     p0 = rdm[0] / (rdm[0] + rdm[6]);
     distribution = std::bernoulli_distribution(1 - p0);
     bit_val = distribution(*random_gen);
diff --git a/tests/mps_statespace_test.cc b/tests/mps_statespace_test.cc
index 9473eaf9..1ea037c5 100644
--- a/tests/mps_statespace_test.cc
+++ b/tests/mps_statespace_test.cc
@@ -976,6 +976,7 @@ TEST(MPSStateSpaceTest, SampleGHZ){
     all_same &= results[i][1] == results[i][2];
     EXPECT_EQ(all_same, 1);
     count += results[i][0];
+    EXPECT_EQ(results[i].size(), 3);
   }
   EXPECT_NEAR(count / float(num_samples), 0.5, 1e-2);
 }
@@ -990,126 +991,127 @@ TEST(MPSStateSpaceTest, SampleComplex){
     num_samples, std::vector<bool>({}));
 
   memset(mps.get(), 0, ss.RawSize(mps));
-  mps.get()[ 0 ] = 0.033688569334715854 ;
-  mps.get()[ 1 ] = -0.10444182602180123 ;
-  mps.get()[ 2 ] = 0.9076354671683359 ;
-  mps.get()[ 3 ] = 0.405160344657187 ;
-  mps.get()[ 8 ] = -0.9595253512026178 ;
-  mps.get()[ 9 ] = -0.25936097827312377 ;
-  mps.get()[ 10 ] = -0.03987001675676861 ;
-  mps.get()[ 11 ] = 0.10224185693597321 ;
-  mps.get()[ 16 ] = -0.4350591822776815 ;
-  mps.get()[ 17 ] = 0.22228546667942578 ;
-  mps.get()[ 18 ] = -0.6285732819602607 ;
-  mps.get()[ 19 ] = 0.5943422063507785 ;
-  mps.get()[ 20 ] = -0.02428345908884816 ;
-  mps.get()[ 21 ] = 0.026256572727652475 ;
-  mps.get()[ 22 ] = 0.0728063572325396 ;
-  mps.get()[ 23 ] = -0.07991114142962712 ;
-  mps.get()[ 24 ] = -0.1642035571020447 ;
-  mps.get()[ 25 ] = -0.8209212529030018 ;
-  mps.get()[ 26 ] = 0.21124207331921135 ;
-  mps.get()[ 27 ] = 0.4033152234452636 ;
-  mps.get()[ 28 ] = -0.11315780332634073 ;
-  mps.get()[ 29 ] = -0.18477947087021204 ;
-  mps.get()[ 30 ] = -0.11199707215175961 ;
-  mps.get()[ 31 ] = -0.17985444082650426 ;
-  mps.get()[ 32 ] = -0.18059162771674087 ;
-  mps.get()[ 33 ] = -0.12173196101857839 ;
-  mps.get()[ 34 ] = 0.19817171168239098 ;
-  mps.get()[ 35 ] = 0.063054719070231 ;
-  mps.get()[ 36 ] = 0.45024015745008505 ;
-  mps.get()[ 37 ] = 0.11068157212593255 ;
-  mps.get()[ 38 ] = 0.8106501683288581 ;
-  mps.get()[ 39 ] = 0.19287240226762353 ;
-  mps.get()[ 40 ] = -0.08702392413741208 ;
-  mps.get()[ 41 ] = 0.07370887245848737 ;
-  mps.get()[ 42 ] = -0.018412987786278347 ;
-  mps.get()[ 43 ] = 0.027921764369775018 ;
-  mps.get()[ 44 ] = 0.42351439662329743 ;
-  mps.get()[ 45 ] = -0.7466201917698305 ;
-  mps.get()[ 46 ] = -0.24298735917837008 ;
-  mps.get()[ 47 ] = 0.4359199055764641 ;
-  mps.get()[ 80 ] = 0.422436255430577 ;
+  mps.get()[ 0 ] = -0.4917038696869799 ;
+  mps.get()[ 1 ] = 0.016731957658280873 ;
+  mps.get()[ 2 ] = 0.86132663373237 ;
+  mps.get()[ 3 ] = 0.12674293823327035 ;
+  mps.get()[ 8 ] = -0.5023020703950029 ;
+  mps.get()[ 9 ] = -0.711083648814302 ;
+  mps.get()[ 10 ] = -0.20727818303023368 ;
+  mps.get()[ 11 ] = -0.4461932766843352 ;
+  mps.get()[ 16 ] = 0.15655121570640956 ;
+  mps.get()[ 17 ] = 0.4732738079187066 ;
+  mps.get()[ 18 ] = -0.08511634068671248 ;
+  mps.get()[ 19 ] = 0.4509108800471812 ;
+  mps.get()[ 20 ] = 0.3399824326377983 ;
+  mps.get()[ 21 ] = 0.26456637633430585 ;
+  mps.get()[ 22 ] = 0.5923848721836553 ;
+  mps.get()[ 23 ] = -0.06659540240231236 ;
+  mps.get()[ 24 ] = 0.3386920440520109 ;
+  mps.get()[ 25 ] = -0.5078386788732782 ;
+  mps.get()[ 26 ] = -0.5938438138167242 ;
+  mps.get()[ 27 ] = -0.2253530600030204 ;
+  mps.get()[ 28 ] = -0.08439705180650249 ;
+  mps.get()[ 29 ] = 0.18289872169116567 ;
+  mps.get()[ 30 ] = 0.33989833066754255 ;
+  mps.get()[ 31 ] = -0.2604753706869852 ;
+  mps.get()[ 32 ] = 0.3013840839514031 ;
+  mps.get()[ 33 ] = -0.10757629710841352 ;
+  mps.get()[ 34 ] = -0.043855659850960294 ;
+  mps.get()[ 35 ] = -0.0999497956398576 ;
+  mps.get()[ 36 ] = 0.6336147397284169 ;
+  mps.get()[ 37 ] = 0.43658807519265264 ;
+  mps.get()[ 38 ] = -0.448346536528476 ;
+  mps.get()[ 39 ] = 0.30428652791930944 ;
+  mps.get()[ 40 ] = 0.2954131683108271 ;
+  mps.get()[ 41 ] = -0.4349910681437736 ;
+  mps.get()[ 42 ] = 0.35640542464599323 ;
+  mps.get()[ 43 ] = 0.4970533197510696 ;
+  mps.get()[ 44 ] = -0.37101487814696105 ;
+  mps.get()[ 45 ] = 0.2100308254832807 ;
+  mps.get()[ 46 ] = 0.10591704897593116 ;
+  mps.get()[ 47 ] = 0.3955295090226334 ;
+  mps.get()[ 80 ] = -0.24953341864058454 ;
   mps.get()[ 81 ] = 0.0 ;
-  mps.get()[ 82 ] = 0.1211402132186689 ;
-  mps.get()[ 83 ] = -0.819174648113452 ;
-  mps.get()[ 84 ] = 0.0 ;
-  mps.get()[ 85 ] = -7.333691512826885e-20 ;
-  mps.get()[ 88 ] = -0.8676720638499252 ;
-  mps.get()[ 89 ] = 0.1360568551008419 ;
-  mps.get()[ 90 ] = 0.011793867549118184 ;
-  mps.get()[ 91 ] = -0.44097834083157716 ;
-  mps.get()[ 96 ] = -0.08978879818674973 ;
+  mps.get()[ 82 ] = -0.5480093086703182 ;
+  mps.get()[ 83 ] = -0.20497358945530025 ;
+  mps.get()[ 84 ] = -1.1887516198406813e-16 ;
+  mps.get()[ 85 ] = 3.714848812002129e-18 ;
+  mps.get()[ 88 ] = 0.6045663379213811 ;
+  mps.get()[ 89 ] = -0.3501271865840065 ;
+  mps.get()[ 90 ] = -0.29968140886676936 ;
+  mps.get()[ 91 ] = 0.40493683779718603 ;
+  mps.get()[ 96 ] = 0.3073334814703704 ;
   mps.get()[ 97 ] = 0.0 ;
-  mps.get()[ 98 ] = -0.021807957717091198 ;
-  mps.get()[ 99 ] = -0.05873893136151775 ;
-  mps.get()[ 100 ] = 0.0 ;
-  mps.get()[ 101 ] = -9.89518074266081e-19 ;
-  mps.get()[ 104 ] = 0.14307979940517454 ;
-  mps.get()[ 105 ] = 0.06032194765563529 ;
-  mps.get()[ 106 ] = 0.22589440044405648 ;
-  mps.get()[ 107 ] = -0.2397609424987549 ;
-  mps.get()[ 112 ] = 0.12734430206944722 ;
+  mps.get()[ 98 ] = 0.07297353820052123 ;
+  mps.get()[ 99 ] = -0.2859132301813451 ;
+  mps.get()[ 100 ] = -1.7214471606144266e-16 ;
+  mps.get()[ 101 ] = 5.379522376920083e-18 ;
+  mps.get()[ 104 ] = -0.18689238699414557 ;
+  mps.get()[ 105 ] = -0.4911602105890581 ;
+  mps.get()[ 106 ] = -0.30326863844349566 ;
+  mps.get()[ 107 ] = -0.22667282775953723 ;
+  mps.get()[ 112 ] = -0.10881711525857803 ;
   mps.get()[ 113 ] = 0.0 ;
-  mps.get()[ 114 ] = -0.003114595079760157 ;
-  mps.get()[ 115 ] = 0.06816683893204967 ;
-  mps.get()[ 116 ] = 2.722010100011512e-17 ;
-  mps.get()[ 117 ] = 1.9629880528929172e-18 ;
-  mps.get()[ 120 ] = 0.014022255715263434 ;
-  mps.get()[ 121 ] = 0.017127855001478075 ;
-  mps.get()[ 122 ] = 0.025812082320798548 ;
-  mps.get()[ 123 ] = -0.027110021000464 ;
-  mps.get()[ 128 ] = -0.018262196707018574 ;
+  mps.get()[ 114 ] = -0.146152770590198 ;
+  mps.get()[ 115 ] = 0.2149415742117364 ;
+  mps.get()[ 116 ] = -4.72314539505504e-16 ;
+  mps.get()[ 117 ] = 1.1519866817207415e-17 ;
+  mps.get()[ 120 ] = -0.01567698028444534 ;
+  mps.get()[ 121 ] = 0.013440646849502781 ;
+  mps.get()[ 122 ] = -0.17367051562799563 ;
+  mps.get()[ 123 ] = -0.24954843447516284 ;
+  mps.get()[ 128 ] = 0.24030153622040965 ;
   mps.get()[ 129 ] = 0.0 ;
-  mps.get()[ 130 ] = 0.0032725358458428836 ;
-  mps.get()[ 131 ] = 0.0310845568816579 ;
-  mps.get()[ 132 ] = 1.935877805637811e-17 ;
-  mps.get()[ 133 ] = -1.0370773958773989e-18 ;
-  mps.get()[ 136 ] = -0.028632305212090994 ;
-  mps.get()[ 137 ] = 0.012199896816087576 ;
-  mps.get()[ 138 ] = 0.0009323445588941451 ;
-  mps.get()[ 139 ] = -0.014212789540748644 ;
-  mps.get()[ 144 ] = -0.07762944756130831 ;
-  mps.get()[ 145 ] = -0.25063255485414937 ;
-  mps.get()[ 146 ] = 0.515385895406013 ;
-  mps.get()[ 147 ] = 0.7314486807404007 ;
-  mps.get()[ 148 ] = 0.20689214104052 ;
-  mps.get()[ 149 ] = 0.2781707321332216 ;
-  mps.get()[ 150 ] = 0.08286244916183945 ;
-  mps.get()[ 151 ] = 0.05888783848647657 ;
+  mps.get()[ 130 ] = -0.08309837568058188 ;
+  mps.get()[ 131 ] = 0.07924116582885271 ;
+  mps.get()[ 132 ] = -7.075275311738327e-17 ;
+  mps.get()[ 133 ] = 3.930708506521293e-18 ;
+  mps.get()[ 136 ] = 0.0725269370009367 ;
+  mps.get()[ 137 ] = 0.06123701427497634 ;
+  mps.get()[ 138 ] = -0.006630682493419155 ;
+  mps.get()[ 139 ] = 0.015491880670142021 ;
+  mps.get()[ 144 ] = -0.021403127627426542 ;
+  mps.get()[ 145 ] = 0.04422341855596844 ;
+  mps.get()[ 146 ] = 0.27602112861704176 ;
+  mps.get()[ 147 ] = 0.7790060986745896 ;
+  mps.get()[ 148 ] = 0.25252680029727903 ;
+  mps.get()[ 149 ] = 0.49967041792054084 ;
+  mps.get()[ 150 ] = -0.031679241045523554 ;
+  mps.get()[ 151 ] = -0.010202895067710558 ;
 
   ss.Sample(mps, scratch, scratch2, num_samples, 12345, &results);
- 
   std::vector<float> expected({
-    0.00467637,
-    0.0020386,
-    0.00112952,
-    0.0269848,
-    0.00704221,
-    0.00147802,
-    0.00243688,
-    0.0350753,
-    0.0324814,
-    0.0141599,
-    0.0412371,
-    0.0780275,
-    0.0644363,
-    0.140995,
-    0.0355866,
-    0.512215,
+    0.036801,
+    0.040697,
+    0.002013,
+    0.064595,
+    0.014892,
+    0.082028,
+    0.008521,
+    0.168310,
+    0.022078,
+    0.005907,
+    0.024806,
+    0.189074,
+    0.090056,
+    0.023125,
+    0.116683,
+    0.110406
   });
   std::vector<float> hist(16, 0);
   for(int i =0;i<num_samples;i++){
     int index = 0;
-    for(int j =0;j<4;j++){
-      index |= (results[i][j]) << (4 - j - 1);
-    }
+    index += 8 * results[i][0];
+    index += 4 * results[i][1];
+    index += 2 * results[i][2];
+    index += 1 * results[i][3];
     hist[index] += 1;
   }
   for(int i =0;i<16;i++){
     EXPECT_NEAR(hist[i] / float(num_samples), expected[i], 1e-2);
   }
+
 }
 
 }  // namespace

From e4ef58397087074deddcf9e71776ceacda310fba Mon Sep 17 00:00:00 2001
From: Michael Broughton <mbbrough@google.com>
Date: Tue, 21 Dec 2021 04:28:33 -0800
Subject: [PATCH 185/246] remove unused includes.

---
 lib/mps_statespace.h | 2 --
 1 file changed, 2 deletions(-)

diff --git a/lib/mps_statespace.h b/lib/mps_statespace.h
index 721b626e..9b3acf31 100644
--- a/lib/mps_statespace.h
+++ b/lib/mps_statespace.h
@@ -22,11 +22,9 @@
 #include <malloc.h>
 #endif
 
-#include <algorithm>
 #include <cstdint>
 #include <cstdlib>
 #include <cstring>
-#include <iostream>
 #include <memory>
 #include <random>
 

From 04bac34fe6f130ee4c34ef22343ca3cc93d6bc9f Mon Sep 17 00:00:00 2001
From: igorpeshansky <igorpeshansky@users.noreply.github.com>
Date: Tue, 21 Dec 2021 19:22:40 -0500
Subject: [PATCH 186/246] Fix deprecated logging agent install script.

See https://cloud.google.com/logging/docs/agent/installation for the latest installation instructions.
---
 .../multinode/terraform/htcondor/startup-centos.sh          | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
index bec6eb6c..7ec9572d 100644
--- a/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
+++ b/docs/tutorials/multinode/terraform/htcondor/startup-centos.sh
@@ -101,8 +101,8 @@ eval $CONDOR_STARTUP_CMD
 ##############################################################
 # Install and configure logging agent for StackDriver
 ##############################################################
-curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
-bash install-logging-agent.sh
+curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
+bash add-logging-agent-repo.sh --also-install
 
 # Install Custom Metric Plugin:
 google-fluentd-gem install fluent-plugin-stackdriver-monitoring
@@ -186,4 +186,4 @@ fi
 
 # Now we can let everyone know that the setup is complete.
 
-wall "******* HTCondor system configuration complete ********"
\ No newline at end of file
+wall "******* HTCondor system configuration complete ********"

From 6460deb7e6fb9ec23372ffa0a582ae6ae83a4ccc Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Tue, 4 Jan 2022 15:59:08 +0100
Subject: [PATCH 187/246] Update fusers.

---
 lib/fuser_basic.h          | 67 +++++++++++++++++------------
 lib/fuser_mqubit.h         | 87 ++++++++++++++++++++++----------------
 tests/fuser_basic_test.cc  | 35 +++++++++++++++
 tests/fuser_mqubit_test.cc | 35 +++++++++++++++
 4 files changed, 161 insertions(+), 63 deletions(-)

diff --git a/lib/fuser_basic.h b/lib/fuser_basic.h
index abc006e8..39748bba 100644
--- a/lib/fuser_basic.h
+++ b/lib/fuser_basic.h
@@ -56,7 +56,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    * two-qubit gates will get fused. To respect specific time boundaries while
    * fusing gates, use the other version of this method below.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by 'gates'.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
    *   Gate times of the gates that act on the same qubits should be ordered.
    *   Gates that are out of time order should not cross the time boundaries
@@ -66,18 +66,18 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(const Parameter& param,
-                                          unsigned num_qubits,
+                                          unsigned max_qubit1,
                                           const std::vector<Gate>& gates,
                                           bool fuse_matrix = true) {
     return FuseGates(
-        param, num_qubits, gates.cbegin(), gates.cend(), {}, fuse_matrix);
+        param, max_qubit1, gates.cbegin(), gates.cend(), {}, fuse_matrix);
   }
 
   /**
    * Stores sets of gates that can be applied together. Only one- and
    * two-qubit gates will get fused.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by 'gates'.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
    *   Gate times of the gates that act on the same qubits should be ordered.
    *   Gates that are out of time order should not cross the time boundaries
@@ -91,10 +91,10 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    */
   static std::vector<GateFused> FuseGates(
       const Parameter& param,
-      unsigned num_qubits, const std::vector<Gate>& gates,
+      unsigned max_qubit1, const std::vector<Gate>& gates,
       const std::vector<unsigned>& times_to_split_at,
       bool fuse_matrix = true) {
-    return FuseGates(param, num_qubits, gates.cbegin(), gates.cend(),
+    return FuseGates(param, max_qubit1, gates.cbegin(), gates.cend(),
                      times_to_split_at, fuse_matrix);
   }
 
@@ -103,7 +103,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    * two-qubit gates will get fused. To respect specific time boundaries while
    * fusing gates, use the other version of this method below.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by gates.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
    *   (or pointers to gates) in. Gate times of the gates that act on the same
    *   qubits should be ordered. Gates that are out of time order should not
@@ -113,18 +113,18 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
-      const Parameter& param, unsigned num_qubits,
+      const Parameter& param, unsigned max_qubit1,
       typename std::vector<Gate>::const_iterator gfirst,
       typename std::vector<Gate>::const_iterator glast,
       bool fuse_matrix = true) {
-    return FuseGates(param, num_qubits, gfirst, glast, {}, fuse_matrix);
+    return FuseGates(param, max_qubit1, gfirst, glast, {}, fuse_matrix);
   }
 
   /**
    * Stores sets of gates that can be applied together. Only one- and
    * two-qubit gates will get fused.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by gates.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
    *   (or pointers to gates) in. Gate times of the gates that act on the same
    *   qubits should be ordered. Gates that are out of time order should not
@@ -138,7 +138,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
-      const Parameter& param, unsigned num_qubits,
+      const Parameter& param, unsigned max_qubit1,
       typename std::vector<Gate>::const_iterator gfirst,
       typename std::vector<Gate>::const_iterator glast,
       const std::vector<unsigned>& times_to_split_at,
@@ -162,7 +162,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
     std::vector<const RGate*> gates_seq;
 
     // Lattice of gates: qubits "hyperplane" and time direction.
-    std::vector<std::vector<const RGate*>> gates_lat(num_qubits);
+    std::vector<std::vector<const RGate*>> gates_lat(max_qubit1);
 
     // Current unfused gate.
     auto gate_it = gfirst;
@@ -171,7 +171,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
       gates_seq.resize(0);
       gates_seq.reserve(num_gates);
 
-      for (unsigned k = 0; k < num_qubits; ++k) {
+      for (unsigned k = 0; k < max_qubit1; ++k) {
         gates_lat[k].resize(0);
         gates_lat[k].reserve(128);
       }
@@ -182,9 +182,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
 
         if (gate.time > times[l]) break;
 
-        if (GateIsOutOfOrder(gate.time, gate.qubits, gates_lat)
-            || GateIsOutOfOrder(gate.time, gate.controlled_by, gates_lat)) {
-          IO::errorf("gate is out of time order.\n");
+        if (!ValidateGate(gate, max_qubit1, gates_lat)) {
           gates_fused.resize(0);
           return gates_fused;
         }
@@ -193,7 +191,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
           auto& mea_gates_at_time = measurement_gates[gate.time];
           if (mea_gates_at_time.size() == 0) {
             gates_seq.push_back(&gate);
-            mea_gates_at_time.reserve(num_qubits);
+            mea_gates_at_time.reserve(max_qubit1);
           }
 
           mea_gates_at_time.push_back(&gate);
@@ -217,7 +215,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
         }
       }
 
-      std::vector<unsigned> last(num_qubits, 0);
+      std::vector<unsigned> last(max_qubit1, 0);
 
       const RGate* delayed_measurement_gate = nullptr;
 
@@ -281,7 +279,7 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
         }
       }
 
-      for (unsigned q = 0; q < num_qubits; ++q) {
+      for (unsigned q = 0; q < max_qubit1; ++q) {
         auto l = last[q];
         if (l == gates_lat[q].size()) continue;
 
@@ -360,17 +358,32 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
     return k;
   }
 
-  template <typename GatesLat>
-  static bool GateIsOutOfOrder(unsigned time,
-                               const std::vector<unsigned>& qubits,
-                               const GatesLat& gates_lat) {
-    for (unsigned q : qubits) {
-      if (!gates_lat[q].empty() && time <= gates_lat[q].back()->time) {
-        return true;
+  template <typename Gate2, typename GatesLat>
+  static bool ValidateGate(const Gate2& gate, unsigned max_qubit1,
+                           const GatesLat& gates_lat) {
+    for (unsigned q : gate.qubits) {
+      if (q >= max_qubit1) {
+        IO::errorf("gate qubits are out of range.\n");
+        return false;
+      }
+      if (!gates_lat[q].empty() && gate.time <= gates_lat[q].back()->time) {
+        IO::errorf("gate is out of time order.\n");
+        return false;
+      }
+    }
+
+    for (unsigned q : gate.controlled_by) {
+      if (q >= max_qubit1) {
+        IO::errorf("gate qubits are out of range.\n");
+        return false;
+      }
+      if (!gates_lat[q].empty() && gate.time <= gates_lat[q].back()->time) {
+        IO::errorf("gate is out of time order.\n");
+        return false;
       }
     }
 
-    return false;
+    return true;
   }
 };
 
diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index 08a40d11..31415653 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -156,7 +156,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    * time boundaries while fusing gates, use the other version of this method
    * below.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by 'gates'.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
    *   Gate times of the gates that act on the same qubits should be ordered.
    *   Gates that are out of time order should not cross the time boundaries
@@ -166,17 +166,17 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(const Parameter& param,
-                                          unsigned num_qubits,
+                                          unsigned max_qubit1,
                                           const std::vector<Gate>& gates,
                                           bool fuse_matrix = true) {
     return FuseGates(
-        param, num_qubits, gates.cbegin(), gates.cend(), {}, fuse_matrix);
+        param, max_qubit1, gates.cbegin(), gates.cend(), {}, fuse_matrix);
   }
 
   /**
    * Stores sets of gates that can be applied together.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by 'gates'.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gates The gates (or pointers to the gates) to be fused.
    *   Gate times of the gates that act on the same qubits should be ordered.
    *   Gates that are out of time order should not cross the time boundaries
@@ -190,10 +190,10 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    */
   static std::vector<GateFused> FuseGates(
       const Parameter& param,
-      unsigned num_qubits, const std::vector<Gate>& gates,
+      unsigned max_qubit1, const std::vector<Gate>& gates,
       const std::vector<unsigned>& times_to_split_at,
       bool fuse_matrix = true) {
-    return FuseGates(param, num_qubits, gates.cbegin(), gates.cend(),
+    return FuseGates(param, max_qubit1, gates.cbegin(), gates.cend(),
                      times_to_split_at, fuse_matrix);
   }
 
@@ -202,7 +202,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    * time boundaries while fusing gates, use the other version of this method
    * below.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by gates.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
    *   (or pointers to gates) in. Gate times of the gates that act on the same
    *   qubits should be ordered. Gates that are out of time order should not
@@ -212,17 +212,17 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
-      const Parameter& param, unsigned num_qubits,
+      const Parameter& param, unsigned max_qubit1,
       typename std::vector<Gate>::const_iterator gfirst,
       typename std::vector<Gate>::const_iterator glast,
       bool fuse_matrix = true) {
-    return FuseGates(param, num_qubits, gfirst, glast, {}, fuse_matrix);
+    return FuseGates(param, max_qubit1, gfirst, glast, {}, fuse_matrix);
   }
 
   /**
    * Stores sets of gates that can be applied together.
    * @param param Options for gate fusion.
-   * @param num_qubits The number of qubits acted on by gates.
+   * @param max_qubit1 The maximum qubit index (plus one) acted on by 'gates'.
    * @param gfirst, glast The iterator range [gfirst, glast) to fuse gates
    *   (or pointers to gates) in. Gate times of the gates that act on the same
    *   qubits should be ordered. Gates that are out of time order should not
@@ -236,7 +236,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
    *   acting on a specific pair of qubits which can be applied as a group.
    */
   static std::vector<GateFused> FuseGates(
-      const Parameter& param, unsigned num_qubits,
+      const Parameter& param, unsigned max_qubit1,
       typename std::vector<Gate>::const_iterator gfirst,
       typename std::vector<Gate>::const_iterator glast,
       const std::vector<unsigned>& times_to_split_at,
@@ -253,7 +253,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
     auto epochs =
         Base::MergeWithMeasurementTimes(gfirst, glast, times_to_split_at);
 
-    LinkManager link_manager(num_qubits * num_gates);
+    LinkManager link_manager(max_qubit1 * num_gates);
 
     // Auxillary data structures.
     // Sequence of intermediate fused gates.
@@ -261,10 +261,10 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
     // Gate "lattice".
     std::vector<Link*> gates_lat;
     // Sequences of intermediate fused gates ordered by gate size.
-    std::vector<std::vector<GateF*>> fgates(num_qubits + 1);
+    std::vector<std::vector<GateF*>> fgates(max_qubit1 + 1);
 
     gates_seq.reserve(num_gates);
-    gates_lat.reserve(num_qubits);
+    gates_lat.reserve(max_qubit1);
 
     Scratch scratch;
 
@@ -277,10 +277,10 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
     scratch.stack.reserve(8);
 
     Stat stat;
-    stat.num_gates.resize(num_qubits + 1, 0);
+    stat.num_gates.resize(max_qubit1 + 1, 0);
 
     unsigned max_fused_size = std::min(unsigned{6}, param.max_fused_size);
-    max_fused_size = std::min(max_fused_size, num_qubits);
+    max_fused_size = std::min(max_fused_size, max_qubit1);
 
     auto gate_it = gfirst;
 
@@ -288,9 +288,9 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
     for (std::size_t l = 0; l < epochs.size(); ++l) {
       gates_seq.resize(0);
       gates_lat.resize(0);
-      gates_lat.resize(num_qubits, nullptr);
+      gates_lat.resize(max_qubit1, nullptr);
 
-      for (unsigned i = 0; i <= num_qubits; ++i) {
+      for (unsigned i = 0; i <= max_qubit1; ++i) {
         fgates[i].resize(0);
       }
 
@@ -303,9 +303,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
         if (gate.time > epochs[l]) break;
 
-        if (GateIsOutOfOrder(gate.time, gate.qubits, gates_lat)
-            || GateIsOutOfOrder(gate.time, gate.controlled_by, gates_lat)) {
-          IO::errorf("gate is out of time order.\n");
+        if (!ValidateGate(gate, max_qubit1, gates_lat)) {
           fused_gates.resize(0);
           return fused_gates;
         }
@@ -320,8 +318,8 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
             gates_seq.push_back({&gate, {}, {}, {}, 0, kMeaCnt});
             last_mea_gate = &gates_seq.back();
 
-            last_mea_gate->qubits.reserve(num_qubits);
-            last_mea_gate->links.reserve(num_qubits);
+            last_mea_gate->qubits.reserve(max_qubit1);
+            last_mea_gate->links.reserve(max_qubit1);
 
             ++stat.num_fused_mea_gates;
           }
@@ -394,12 +392,12 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
       if (max_fused_size > 2) {
         FuseGateSequences(
-            max_fused_size, num_qubits, scratch, gates_seq, stat, fused_gates);
+            max_fused_size, max_qubit1, scratch, gates_seq, stat, fused_gates);
       } else {
         unsigned prev_time = 0;
 
         std::vector<GateF*> orphaned_gates;
-        orphaned_gates.reserve(num_qubits);
+        orphaned_gates.reserve(max_qubit1);
 
         for (auto& fgate : gates_seq) {
           if (fgate.gates.size() == 0) continue;
@@ -484,13 +482,13 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
   //
   // max_fused_size = 6: _-_-_
   static void FuseGateSequences(unsigned max_fused_size,
-                                unsigned num_qubits, Scratch& scratch,
+                                unsigned max_qubit1, Scratch& scratch,
                                 std::vector<GateF>& gates_seq, Stat& stat,
                                 std::vector<GateFused>& fused_gates) {
     unsigned prev_time = 0;
 
     std::vector<GateF*> orphaned_gates;
-    orphaned_gates.reserve(num_qubits);
+    orphaned_gates.reserve(max_qubit1);
 
     for (auto& fgate : gates_seq) {
       if (prev_time != fgate.parent->time) {
@@ -1031,7 +1029,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
     if (verbosity < 5) return;
 
     IO::messagef("fused gate qubits:\n");
-    for (const auto g : fused_gates) {
+    for (const auto& g : fused_gates) {
       IO::messagef("%6u  ", g.parent->time);
       if (g.parent->kind == gate::kMeasurement) {
         IO::messagef("m");
@@ -1052,17 +1050,34 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
     }
   }
 
-  template <typename GatesLat>
-  static bool GateIsOutOfOrder(unsigned time,
-                               const std::vector<unsigned>& qubits,
-                               const GatesLat& gates_lat) {
-    for (unsigned q : qubits) {
-      if (gates_lat[q] != nullptr && time <= gates_lat[q]->val->parent->time) {
-        return true;
+  template <typename Gate2, typename GatesLat>
+  static bool ValidateGate(const Gate2& gate, unsigned max_qubit1,
+                           const GatesLat& gates_lat) {
+    for (unsigned q : gate.qubits) {
+      if (q >= max_qubit1) {
+        IO::errorf("gate qubits are out of range.\n");
+        return false;
+      }
+      if (gates_lat[q] != nullptr
+          && gate.time <= gates_lat[q]->val->parent->time) {
+        IO::errorf("gate is out of time order.\n");
+        return false;
+      }
+    }
+
+    for (unsigned q : gate.controlled_by) {
+      if (q >= max_qubit1) {
+        IO::errorf("gate qubits are out of range.\n");
+        return false;
+      }
+      if (gates_lat[q] != nullptr
+          && gate.time <= gates_lat[q]->val->parent->time) {
+        IO::errorf("gate is out of time order.\n");
+        return false;
       }
     }
 
-    return false;
+    return true;
   }
 };
 
diff --git a/tests/fuser_basic_test.cc b/tests/fuser_basic_test.cc
index 250d9f30..1eb85c28 100644
--- a/tests/fuser_basic_test.cc
+++ b/tests/fuser_basic_test.cc
@@ -1438,6 +1438,41 @@ TEST(FuserBasicTest, InvalidTimeOrder) {
   }
 }
 
+TEST(FuserBasicTest, QubitsOutOfRange) {
+  using Gate = GateQSim<float>;
+  using Fuser = BasicGateFuser<IO, Gate>;
+
+  Fuser::Parameter param;
+  param.verbosity = 0;
+
+  {
+    unsigned num_qubits = 3;
+    std::vector<Gate> circuit = {
+      GateCZ<float>::Create(0, 0, 3),
+      GateCZ<float>::Create(0, 1, 2),
+    };
+
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end(), false);
+
+    EXPECT_EQ(fused_gates.size(), 0);
+  }
+
+  {
+    unsigned num_qubits = 3;
+    auto gate = GateZ<float>::Create(0, 2);
+    std::vector<Gate> circuit = {
+      GateCZ<float>::Create(0, 0, 1),
+      MakeControlledGate({3}, gate),
+    };
+
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end(), false);
+
+    EXPECT_EQ(fused_gates.size(), 0);
+  }
+}
+
 }  // namespace qsim
 
 int main(int argc, char** argv) {
diff --git a/tests/fuser_mqubit_test.cc b/tests/fuser_mqubit_test.cc
index c41c6549..cf49b73b 100644
--- a/tests/fuser_mqubit_test.cc
+++ b/tests/fuser_mqubit_test.cc
@@ -982,6 +982,41 @@ TEST(FuserMultiQubitTest, InvalidTimeOrder) {
   }
 }
 
+TEST(FuserMultiQubitTest, QubitsOutOfRange) {
+  using Fuser = MultiQubitGateFuser<IO, DummyGate>;
+
+  Fuser::Parameter param;
+  param.verbosity = 0;
+
+  {
+    unsigned num_qubits = 3;
+    std::vector<DummyGate> circuit = {
+      CreateDummyGate(0, {0, 3}),
+      CreateDummyGate(0, {1, 2}),
+    };
+
+    param.max_fused_size = 2;
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end(), false);
+
+    EXPECT_EQ(fused_gates.size(), 0);
+  }
+
+  {
+    unsigned num_qubits = 3;
+    std::vector<DummyGate> circuit = {
+      CreateDummyGate(0, {0, 1}),
+      CreateDummyControlledGate(0, {2}, {3}),
+    };
+
+    param.max_fused_size = 2;
+    auto fused_gates = Fuser::FuseGates(
+        param, num_qubits, circuit.begin(), circuit.end(), false);
+
+    EXPECT_EQ(fused_gates.size(), 0);
+  }
+}
+
 TEST(FuserMultiQubitTest, OrphanedGates) {
   using Fuser = MultiQubitGateFuser<IO, DummyGate>;
 

From 558a44643b37e82f5b77038c34e826f38dcb6358 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 4 Jan 2022 17:39:39 +0000
Subject: [PATCH 188/246] Update to dev version 2022-01-04

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index bf85e4ce..c95999d5 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.11.1"
+__version__ = "0.11.2.dev20220104"

From 2b57cab96c1e5b415e68068169f12111c82a27e1 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Tue, 4 Jan 2022 19:19:37 +0100
Subject: [PATCH 189/246] Recommended fixes.

---
 lib/fuser_basic.h  | 10 ++++++----
 lib/fuser_mqubit.h | 10 ++++++----
 2 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/lib/fuser_basic.h b/lib/fuser_basic.h
index 39748bba..2fafb14a 100644
--- a/lib/fuser_basic.h
+++ b/lib/fuser_basic.h
@@ -363,22 +363,24 @@ class BasicGateFuser final : public Fuser<IO, Gate> {
                            const GatesLat& gates_lat) {
     for (unsigned q : gate.qubits) {
       if (q >= max_qubit1) {
-        IO::errorf("gate qubits are out of range.\n");
+        IO::errorf("fuser: gate qubit %u is out of range "
+                   "(should be smaller than %u).\n", q, max_qubit1);
         return false;
       }
       if (!gates_lat[q].empty() && gate.time <= gates_lat[q].back()->time) {
-        IO::errorf("gate is out of time order.\n");
+        IO::errorf("fuser: gate at time %u is out of time order.\n", gate.time);
         return false;
       }
     }
 
     for (unsigned q : gate.controlled_by) {
       if (q >= max_qubit1) {
-        IO::errorf("gate qubits are out of range.\n");
+        IO::errorf("fuser: gate qubit %u is out of range "
+                   "(should be smaller than %u).\n", q, max_qubit1);
         return false;
       }
       if (!gates_lat[q].empty() && gate.time <= gates_lat[q].back()->time) {
-        IO::errorf("gate is out of time order.\n");
+        IO::errorf("fuser: gate at time %u is out of time order.\n", gate.time);
         return false;
       }
     }
diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index 31415653..4ab4f100 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -1055,24 +1055,26 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
                            const GatesLat& gates_lat) {
     for (unsigned q : gate.qubits) {
       if (q >= max_qubit1) {
-        IO::errorf("gate qubits are out of range.\n");
+        IO::errorf("fuser: gate qubit %u is out of range "
+                   "(should be smaller than %u).\n", q, max_qubit1);
         return false;
       }
       if (gates_lat[q] != nullptr
           && gate.time <= gates_lat[q]->val->parent->time) {
-        IO::errorf("gate is out of time order.\n");
+        IO::errorf("fuser: gate at time %u is out of time order.\n", gate.time);
         return false;
       }
     }
 
     for (unsigned q : gate.controlled_by) {
       if (q >= max_qubit1) {
-        IO::errorf("gate qubits are out of range.\n");
+        IO::errorf("fuser: gate qubit %u is out of range "
+                   "(should be smaller than %u).\n", q, max_qubit1);
         return false;
       }
       if (gates_lat[q] != nullptr
           && gate.time <= gates_lat[q]->val->parent->time) {
-        IO::errorf("gate is out of time order.\n");
+        IO::errorf("fuser: gate at time %u is out of time order.\n", gate.time);
         return false;
       }
     }

From 91bc014a1bde878c286b50daaa4a2367df2959e0 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Wed, 5 Jan 2022 17:22:12 +0100
Subject: [PATCH 190/246] immintrin.h is not included in CUDA code.

---
 apps/qsim_amplitudes.cc                       |  1 +
 apps/qsim_base.cc                             |  2 +-
 apps/qsim_von_neumann.cc                      |  2 +-
 apps/qsimh_amplitudes.cc                      |  1 +
 apps/qsimh_base.cc                            |  1 +
 lib/BUILD                                     |  9 ++++
 lib/util.h                                    | 21 ---------
 lib/util_cpu.h                                | 43 +++++++++++++++++++
 pybind_interface/avx2/pybind_main_avx2.cpp    |  1 +
 .../avx512/pybind_main_avx512.cpp             |  1 +
 pybind_interface/basic/pybind_main_basic.cpp  |  1 +
 pybind_interface/cuda/pybind_main_cuda.cpp    |  3 ++
 .../custatevec/pybind_main_custatevec.cpp     |  3 ++
 pybind_interface/pybind_main.cpp              |  1 -
 pybind_interface/sse/pybind_main_sse.cpp      |  1 +
 tests/BUILD                                   |  2 +-
 tests/simulator_testfixture.h                 |  2 +-
 17 files changed, 69 insertions(+), 26 deletions(-)
 create mode 100644 lib/util_cpu.h

diff --git a/apps/qsim_amplitudes.cc b/apps/qsim_amplitudes.cc
index 01d50b96..d37fdd6b 100644
--- a/apps/qsim_amplitudes.cc
+++ b/apps/qsim_amplitudes.cc
@@ -30,6 +30,7 @@
 #include "../lib/run_qsim.h"
 #include "../lib/simmux.h"
 #include "../lib/util.h"
+#include "../lib/util_cpu.h"
 
 constexpr char usage[] = "usage:\n  ./qsim_amplitudes -c circuit_file "
                          "-d times_to_save_results -i input_files "
diff --git a/apps/qsim_base.cc b/apps/qsim_base.cc
index 8d365e9a..5a7604d5 100644
--- a/apps/qsim_base.cc
+++ b/apps/qsim_base.cc
@@ -26,7 +26,7 @@
 #include "../lib/io_file.h"
 #include "../lib/run_qsim.h"
 #include "../lib/simmux.h"
-#include "../lib/util.h"
+#include "../lib/util_cpu.h"
 
 constexpr char usage[] = "usage:\n  ./qsim_base -c circuit -d maxtime "
                          "-s seed -t threads -f max_fused_size "
diff --git a/apps/qsim_von_neumann.cc b/apps/qsim_von_neumann.cc
index c2264909..46576083 100644
--- a/apps/qsim_von_neumann.cc
+++ b/apps/qsim_von_neumann.cc
@@ -28,7 +28,7 @@
 #include "../lib/io_file.h"
 #include "../lib/run_qsim.h"
 #include "../lib/simmux.h"
-#include "../lib/util.h"
+#include "../lib/util_cpu.h"
 
 constexpr char usage[] = "usage:\n  ./qsim_von_neumann -c circuit -d maxtime "
                          "-s seed -t threads -f max_fused_size "
diff --git a/apps/qsimh_amplitudes.cc b/apps/qsimh_amplitudes.cc
index cfb5b09a..7cb1b085 100644
--- a/apps/qsimh_amplitudes.cc
+++ b/apps/qsimh_amplitudes.cc
@@ -30,6 +30,7 @@
 #include "../lib/run_qsimh.h"
 #include "../lib/simmux.h"
 #include "../lib/util.h"
+#include "../lib/util_cpu.h"
 
 constexpr char usage[] = "usage:\n  ./qsimh_amplitudes -c circuit_file "
                          "-d maxtime -k part1_qubits "
diff --git a/apps/qsimh_base.cc b/apps/qsimh_base.cc
index c1656a8b..eb0c9c6c 100644
--- a/apps/qsimh_base.cc
+++ b/apps/qsimh_base.cc
@@ -30,6 +30,7 @@
 #include "../lib/run_qsimh.h"
 #include "../lib/simmux.h"
 #include "../lib/util.h"
+#include "../lib/util_cpu.h"
 
 constexpr char usage[] = "usage:\n  ./qsimh_base -c circuit_file "
                          "-d maximum_time -k part1_qubits "
diff --git a/lib/BUILD b/lib/BUILD
index d69ae1da..cc56dbd2 100644
--- a/lib/BUILD
+++ b/lib/BUILD
@@ -61,6 +61,7 @@ cc_library(
         "unitary_calculator_basic.h",
         "unitary_calculator_sse.h",
         "util.h",
+        "util_cpu.h",
         "vectorspace.h",
     ],
 )
@@ -123,6 +124,7 @@ cc_library(
         "unitary_calculator_basic.h",
         "unitary_calculator_sse.h",
         "util.h",
+        "util_cpu.h",
         "util_cuda.h",
         "vectorspace.h",
         "vectorspace_cuda.h",
@@ -170,6 +172,7 @@ cc_library(
         "unitary_calculator_basic.h",
         "unitary_calculator_sse.h",
         "util.h",
+        "util_cpu.h",
         "vectorspace.h",
     ],
 )
@@ -208,6 +211,7 @@ cc_library(
         "statespace_basic.h",
         "statespace_sse.h",
         "util.h",
+        "util_cpu.h",
         "vectorspace.h",
     ],
 )
@@ -238,6 +242,11 @@ cc_library(
     hdrs = ["util.h"],
 )
 
+cc_library(
+    name = "util_cpu",
+    hdrs = ["util_cpu.h"],
+)
+
 # cuda_library
 cc_library(
     name = "util_cuda",
diff --git a/lib/util.h b/lib/util.h
index 933730c3..726a0192 100644
--- a/lib/util.h
+++ b/lib/util.h
@@ -15,10 +15,6 @@
 #ifndef UTIL_H_
 #define UTIL_H_
 
-#ifdef __SSE__
-# include <immintrin.h>
-#endif
-
 #include <algorithm>
 #include <chrono>
 #include <random>
@@ -88,23 +84,6 @@ inline std::vector<DistrRealType> GenerateRandomValues(
   return rs;
 }
 
-// This function sets flush-to-zero and denormals-are-zeros MXCSR control
-// flags. This prevents rare cases of performance slowdown potentially at
-// the cost of a tiny precision loss.
-inline void SetFlushToZeroAndDenormalsAreZeros() {
-#ifdef __SSE2__
-  _mm_setcsr(_mm_getcsr() | 0x8040);
-#endif
-}
-
-// This function clears flush-to-zero and denormals-are-zeros MXCSR control
-// flags.
-inline void ClearFlushToZeroAndDenormalsAreZeros() {
-#ifdef __SSE2__
-  _mm_setcsr(_mm_getcsr() & ~unsigned{0x8040});
-#endif
-}
-
 }  // namespace qsim
 
 #endif  // UTIL_H_
diff --git a/lib/util_cpu.h b/lib/util_cpu.h
new file mode 100644
index 00000000..8e024252
--- /dev/null
+++ b/lib/util_cpu.h
@@ -0,0 +1,43 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef UTIL_CPU_H_
+#define UTIL_CPU_H_
+
+#ifdef __SSE2__
+# include <immintrin.h>
+#endif
+
+namespace qsim {
+
+// This function sets flush-to-zero and denormals-are-zeros MXCSR control
+// flags. This prevents rare cases of performance slowdown potentially at
+// the cost of a tiny precision loss.
+inline void SetFlushToZeroAndDenormalsAreZeros() {
+#ifdef __SSE2__
+  _mm_setcsr(_mm_getcsr() | 0x8040);
+#endif
+}
+
+// This function clears flush-to-zero and denormals-are-zeros MXCSR control
+// flags.
+inline void ClearFlushToZeroAndDenormalsAreZeros() {
+#ifdef __SSE2__
+  _mm_setcsr(_mm_getcsr() & ~unsigned{0x8040});
+#endif
+}
+
+}  // namespace qsim
+
+#endif  // UTIL_CPU_H_
diff --git a/pybind_interface/avx2/pybind_main_avx2.cpp b/pybind_interface/avx2/pybind_main_avx2.cpp
index 5729d163..1f7dc084 100644
--- a/pybind_interface/avx2/pybind_main_avx2.cpp
+++ b/pybind_interface/avx2/pybind_main_avx2.cpp
@@ -16,6 +16,7 @@
 
 #include "../../lib/formux.h"
 #include "../../lib/simulator_avx.h"
+#include "../../lib/util_cpu.h"
 
 namespace qsim {
   template <typename For>
diff --git a/pybind_interface/avx512/pybind_main_avx512.cpp b/pybind_interface/avx512/pybind_main_avx512.cpp
index 0073a1e0..b87ececb 100644
--- a/pybind_interface/avx512/pybind_main_avx512.cpp
+++ b/pybind_interface/avx512/pybind_main_avx512.cpp
@@ -16,6 +16,7 @@
 
 #include "../../lib/formux.h"
 #include "../../lib/simulator_avx512.h"
+#include "../../lib/util_cpu.h"
 
 namespace qsim {
   template <typename For>
diff --git a/pybind_interface/basic/pybind_main_basic.cpp b/pybind_interface/basic/pybind_main_basic.cpp
index 55cb5484..51fdc608 100644
--- a/pybind_interface/basic/pybind_main_basic.cpp
+++ b/pybind_interface/basic/pybind_main_basic.cpp
@@ -16,6 +16,7 @@
 
 #include "../../lib/formux.h"
 #include "../../lib/simulator_basic.h"
+#include "../../lib/util_cpu.h"
 
 namespace qsim {
   template <typename For>
diff --git a/pybind_interface/cuda/pybind_main_cuda.cpp b/pybind_interface/cuda/pybind_main_cuda.cpp
index 391cb976..88fa3a61 100644
--- a/pybind_interface/cuda/pybind_main_cuda.cpp
+++ b/pybind_interface/cuda/pybind_main_cuda.cpp
@@ -41,6 +41,9 @@ namespace qsim {
     StateSpace::Parameter ss_params;
     Simulator::Parameter sim_params;
   };
+
+  inline void SetFlushToZeroAndDenormalsAreZeros() {}
+  inline void ClearFlushToZeroAndDenormalsAreZeros() {}
 }
 
 #include "../pybind_main.cpp"
diff --git a/pybind_interface/custatevec/pybind_main_custatevec.cpp b/pybind_interface/custatevec/pybind_main_custatevec.cpp
index 109cedae..1e399633 100644
--- a/pybind_interface/custatevec/pybind_main_custatevec.cpp
+++ b/pybind_interface/custatevec/pybind_main_custatevec.cpp
@@ -53,6 +53,9 @@ struct Factory {
   custatevecHandle_t custatevec_handle;
 };
 
+inline void SetFlushToZeroAndDenormalsAreZeros() {}
+inline void ClearFlushToZeroAndDenormalsAreZeros() {}
+
 }
 
 #include "../pybind_main.cpp"
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 428372d1..d02c0693 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -30,7 +30,6 @@
 #include "../lib/qtrajectory.h"
 #include "../lib/run_qsim.h"
 #include "../lib/run_qsimh.h"
-#include "../lib/util.h"
 
 using namespace qsim;
 
diff --git a/pybind_interface/sse/pybind_main_sse.cpp b/pybind_interface/sse/pybind_main_sse.cpp
index 4c72a65a..674aecad 100644
--- a/pybind_interface/sse/pybind_main_sse.cpp
+++ b/pybind_interface/sse/pybind_main_sse.cpp
@@ -16,6 +16,7 @@
 
 #include "../../lib/formux.h"
 #include "../../lib/simulator_sse.h"
+#include "../../lib/util_cpu.h"
 
 namespace qsim {
   template <typename For>
diff --git a/tests/BUILD b/tests/BUILD
index 47f90535..af59659e 100644
--- a/tests/BUILD
+++ b/tests/BUILD
@@ -265,7 +265,7 @@ cc_library(
         "//lib:gate_appl",
         "//lib:gates_qsim",
         "//lib:io",
-        "//lib:util",
+        "//lib:util_cpu",
     ],
     testonly = 1,
 )
diff --git a/tests/simulator_testfixture.h b/tests/simulator_testfixture.h
index 05cad5a6..ef335565 100644
--- a/tests/simulator_testfixture.h
+++ b/tests/simulator_testfixture.h
@@ -27,7 +27,7 @@
 #include "../lib/gate_appl.h"
 #include "../lib/gates_qsim.h"
 #include "../lib/io.h"
-#include "../lib/util.h"
+#include "../lib/util_cpu.h"
 
 namespace qsim {
 

From eb71c308aaba20d685a7612c3b4722fc6f241ab3 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 13 Jan 2022 14:19:37 +0100
Subject: [PATCH 191/246] Fix expectation values.

---
 lib/expect.h                     | 21 +++++++++++++++------
 lib/qtrajectory.h                |  2 +-
 pybind_interface/pybind_main.cpp |  8 +++++---
 tests/expect_test.cc             | 10 +++++++---
 4 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/lib/expect.h b/lib/expect.h
index 66ff817d..38fabfe4 100644
--- a/lib/expect.h
+++ b/lib/expect.h
@@ -42,18 +42,27 @@ struct OpString {
  * @param ket Temporary state vector.
  * @return The computed expectation value.
  */
-template <typename Fuser, typename Simulator, typename Gate>
+template <typename IO, typename Fuser, typename Gate, typename Simulator>
 std::complex<double> ExpectationValue(
     const typename Fuser::Parameter& param,
     const std::vector<OpString<Gate>>& strings,
-    const typename Simulator::StateSpace& ss, const Simulator& simulator,
-    const typename Simulator::State& state, typename Simulator::State& ket) {
+    const typename Simulator::StateSpace& state_space,
+    const Simulator& simulator, const typename Simulator::State& state,
+    typename Simulator::State& ket) {
   std::complex<double> eval = 0;
 
+  if (state_space.IsNull(ket) || ket.num_qubits() < state.num_qubits()) {
+    ket = state_space.Create(state.num_qubits());
+    if (state_space.IsNull(ket)) {
+      IO::errorf("not enough memory: is the number of qubits too large?\n");
+      return eval;
+    }
+  }
+
   for (const auto& str : strings) {
     if (str.ops.size() == 0) continue;
 
-    ss.Copy(state, ket);
+    state_space.Copy(state, ket);
 
     if (str.ops.size() == 1) {
       const auto& op = str.ops[0];
@@ -70,7 +79,7 @@ std::complex<double> ExpectationValue(
       }
     }
 
-    eval += str.weight * ss.InnerProduct(state, ket);
+    eval += str.weight * state_space.InnerProduct(state, ket);
   }
 
   return eval;
@@ -88,7 +97,7 @@ std::complex<double> ExpectationValue(
  * @param state The state of the system.
  * @return The computed expectation value.
  */
-template <typename IO, typename Fuser, typename Simulator, typename Gate>
+template <typename IO, typename Fuser, typename Gate, typename Simulator>
 std::complex<double> ExpectationValue(
     const std::vector<OpString<Gate>>& strings,
     const Simulator& simulator, const typename Simulator::State& state) {
diff --git a/lib/qtrajectory.h b/lib/qtrajectory.h
index bba4708c..773238c6 100644
--- a/lib/qtrajectory.h
+++ b/lib/qtrajectory.h
@@ -279,7 +279,7 @@ class QuantumTrajectorySimulator {
 
       NormalizeState(!unitary, state_space, unitary, state);
 
-      if (state_space.IsNull(scratch)) {
+      if (state_space.IsNull(scratch) || scratch.num_qubits() < num_qubits) {
         scratch = CreateState(num_qubits, state_space);
         if (state_space.IsNull(scratch)) {
           return false;
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index d02c0693..afdfbd16 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -692,9 +692,11 @@ class SimulatorHelper {
       if (opsum_qubits <= 6) {
         results.push_back(ExpectationValue<IO, Fuser>(opsum, simulator, state));
       } else {
-        Fuser::Parameter param;
-        results.push_back(ExpectationValue<Fuser>(
-            param, opsum, state_space, simulator, state, scratch));
+        Fuser::Parameter params;
+        params.max_fused_size = max_fused_size;
+        params.verbosity = verbosity;
+        results.push_back(ExpectationValue<IO, Fuser>(
+            params, opsum, state_space, simulator, state, scratch));
       }
     }
     return results;
diff --git a/tests/expect_test.cc b/tests/expect_test.cc
index 19f4eb10..61e0fa77 100644
--- a/tests/expect_test.cc
+++ b/tests/expect_test.cc
@@ -94,7 +94,7 @@ TEST(ExpectTest, ExpectationValue) {
   Fuser::Parameter param;
   param.max_fused_size = 4;
 
-  State tmp_state = state_space.Create(num_qubits);
+  State tmp_state = state_space.Null();
 
   for (unsigned k = 1; k <= 6; ++k) {
     std::vector<OpString<GateQSim<fp_type>>> strings;
@@ -120,8 +120,12 @@ TEST(ExpectTest, ExpectationValue) {
       }
     }
 
-    auto evala = ExpectationValue<Fuser>(param, strings, state_space, simulator,
-                                         state, tmp_state);
+    if (k == 2) {
+      tmp_state = state_space.Create(num_qubits - 2);
+    }
+
+    auto evala = ExpectationValue<IO, Fuser>(param, strings, state_space,
+                                             simulator, state, tmp_state);
 
     EXPECT_NEAR(std::real(evala), expected_real[k - 1], 1e-6);
     EXPECT_NEAR(std::imag(evala), 0, 1e-8);

From 19c6cd8a6dc2f449f53637afcf204cd6d59a005a Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 14 Jan 2022 14:36:53 -0800
Subject: [PATCH 192/246] Intermediate expectation values.

---
 pybind_interface/pybind_main.cpp | 140 ++++++++++++++++++++++++++
 pybind_interface/pybind_main.h   | 124 +++++++++++++++++++++++
 qsimcirq/qsim_simulator.py       | 168 ++++++++++++++++++++++++++++++-
 qsimcirq_tests/qsimcirq_test.py  |  54 ++++++++++
 4 files changed, 484 insertions(+), 2 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index afdfbd16..7a63cc28 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -559,6 +559,71 @@ class SimulatorHelper {
     return results;
   }
 
+  template <typename StateType>
+  static std::vector<std::vector<std::complex<double>>>
+  simulate_moment_expectation_values(
+      const py::dict &options,
+      const std::vector<std::tuple<uint64_t, std::vector<
+        std::tuple<std::vector<OpString<Cirq::GateCirq<float>>>, unsigned>
+      >>>& opsums_and_qubit_counts,
+      bool is_noisy, const StateType& input_state) {
+    auto helper = SimulatorHelper(options, is_noisy);
+    if (!helper.is_valid) {
+      return {};
+    }
+    std::vector<std::vector<std::complex<double>>> results(
+      opsums_and_qubit_counts.size()
+    );
+    if (!is_noisy) {
+      // Init outside of simulation to enable stepping.
+      helper.init_state(input_state);
+      uint64_t begin = 0;
+      for (unsigned i = 0; i < opsums_and_qubit_counts.size(); ++i) {
+        auto& pair = opsums_and_qubit_counts[i];
+        uint64_t end = std::get<0>(pair);
+        auto& counts = std::get<1>(pair);
+        if (!helper.simulate_subcircuit(begin, end)) {
+          return {};
+        }
+        results[i] = helper.get_expectation_value(counts);
+        begin = end;
+      }
+      return results;
+    }
+
+    // Aggregate expectation values for noisy circuits.
+    // TODO: split over steps
+    for (unsigned i = 0; i < opsums_and_qubit_counts.size(); ++i) {
+      auto& counts = std::get<1>(opsums_and_qubit_counts[i]);
+      results[i] = std::vector<std::complex<double>>(counts.size(), 0);
+    }
+    for (unsigned rep = 0; rep < helper.noisy_reps; ++rep) {
+      // Init outside of simulation to enable stepping.
+      helper.init_state(input_state);
+      uint64_t begin = 0;
+      for (unsigned i = 0; i < opsums_and_qubit_counts.size(); ++i) {
+        auto& pair = opsums_and_qubit_counts[i];
+        uint64_t end = std::get<0>(pair);
+        auto& counts = std::get<1>(pair);
+        if (!helper.simulate_subcircuit(begin, end)) {
+          return {};
+        }
+        auto evs = helper.get_expectation_value(counts);
+        for (unsigned j = 0; j < evs.size(); ++j) {
+          results[i][j] += evs[j];
+        }
+        begin = end;
+      }
+    }
+    double inverse_num_reps = 1.0 / helper.noisy_reps;
+    for (unsigned i = 0; i < results.size(); ++i) {
+      for (unsigned j = 0; j < results[i].size(); ++j) {
+        results[i][j] *= inverse_num_reps;
+      }
+    }
+    return results;
+  }
+
  private:
   SimulatorHelper(const py::dict &options, bool noisy)
       : factory(Factory(1, 1, 1)),
@@ -658,6 +723,37 @@ class SimulatorHelper {
     return result;
   }
 
+  bool simulate_subcircuit(uint64_t begin, uint64_t end) {
+    bool result = false;
+
+    if (is_noisy) {
+      std::vector<uint64_t> stat;
+      auto params = get_noisy_params();
+      NoisyCircuit<Gate> subncircuit;
+      subncircuit.num_qubits = ncircuit.num_qubits;
+      subncircuit.channels = std::vector<Channel<Gate>>(
+        ncircuit.channels.begin() + begin,
+        ncircuit.channels.begin() + end
+      );
+
+      Simulator simulator = factory.CreateSimulator();
+      StateSpace state_space = factory.CreateStateSpace();
+
+      result = NoisyRunner::RunOnce(params, subncircuit, seed, state_space,
+                                    simulator, scratch, state, stat);
+    } else {
+      Circuit<Gate> subcircuit;
+      subcircuit.num_qubits = circuit.num_qubits;
+      subcircuit.gates = std::vector<Gate>(
+        circuit.gates.begin() + begin,
+        circuit.gates.begin() + end
+      );
+      result = Runner::Run(get_params(), factory, subcircuit, state);
+    }
+    seed += 1;
+    return result;
+  }
+
   py::array_t<float> release_state_to_python() {
     StateSpace state_space = factory.CreateStateSpace();
     state_space.InternalToNormalOrder(state);
@@ -770,6 +866,28 @@ std::vector<std::complex<double>> qsim_simulate_expectation_values(
     options, opsums_and_qubit_counts, false, input_vector);
 }
 
+std::vector<std::vector<std::complex<double>>>
+qsim_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<std::vector<OpString<Cirq::GateCirq<float>>>, unsigned>
+    >>>& opsums_and_qubit_counts,
+    uint64_t input_state) {
+  return SimulatorHelper::simulate_moment_expectation_values(
+    options, opsums_and_qubit_counts, false, input_state);
+}
+
+std::vector<std::vector<std::complex<double>>>
+qsim_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<std::vector<OpString<Cirq::GateCirq<float>>>, unsigned>
+    >>>& opsums_and_qubit_counts,
+    const py::array_t<float> &input_vector) {
+  return SimulatorHelper::simulate_moment_expectation_values(
+    options, opsums_and_qubit_counts, false, input_vector);
+}
+
 std::vector<std::complex<double>> qtrajectory_simulate_expectation_values(
     const py::dict &options,
     const std::vector<std::tuple<
@@ -790,6 +908,28 @@ std::vector<std::complex<double>> qtrajectory_simulate_expectation_values(
     options, opsums_and_qubit_counts, true, input_vector);
 }
 
+std::vector<std::vector<std::complex<double>>>
+qtrajectory_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<std::vector<OpString<Cirq::GateCirq<float>>>, unsigned>
+    >>>& opsums_and_qubit_counts,
+    uint64_t input_state) {
+  return SimulatorHelper::simulate_moment_expectation_values(
+    options, opsums_and_qubit_counts, true, input_state);
+}
+
+std::vector<std::vector<std::complex<double>>>
+qtrajectory_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<std::vector<OpString<Cirq::GateCirq<float>>>, unsigned>
+    >>>& opsums_and_qubit_counts,
+    const py::array_t<float> &input_vector) {
+  return SimulatorHelper::simulate_moment_expectation_values(
+    options, opsums_and_qubit_counts, true, input_vector);
+}
+
 // Methods for sampling.
 
 std::vector<unsigned> qsim_sample(const py::dict &options) {
diff --git a/pybind_interface/pybind_main.h b/pybind_interface/pybind_main.h
index 90bcab6e..0b433a8a 100644
--- a/pybind_interface/pybind_main.h
+++ b/pybind_interface/pybind_main.h
@@ -116,6 +116,24 @@ std::vector<std::complex<double>> qsim_simulate_expectation_values(
                               qsim::Cirq::GateCirq<float>>>,
                           unsigned>>& opsums_and_qubit_counts,
     const py::array_t<float> &input_vector);
+std::vector<std::vector<std::complex<double>>>
+qsim_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<
+        std::vector<qsim::OpString<qsim::Cirq::GateCirq<float>>>,
+        unsigned
+    >>>>& opsums_and_qubit_counts,
+    uint64_t input_state);
+std::vector<std::vector<std::complex<double>>>
+qsim_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<
+        std::vector<qsim::OpString<qsim::Cirq::GateCirq<float>>>,
+        unsigned
+    >>>>& opsums_and_qubit_counts,
+    const py::array_t<float> &input_vector);
 std::vector<std::complex<double>> qtrajectory_simulate_expectation_values(
     const py::dict &options,
     const std::vector<std::tuple<
@@ -130,6 +148,24 @@ std::vector<std::complex<double>> qtrajectory_simulate_expectation_values(
                               qsim::Cirq::GateCirq<float>>>,
                           unsigned>>& opsums_and_qubit_counts,
     const py::array_t<float> &input_vector);
+std::vector<std::vector<std::complex<double>>>
+qtrajectory_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<
+        std::vector<qsim::OpString<qsim::Cirq::GateCirq<float>>>,
+        unsigned
+    >>>>& opsums_and_qubit_counts,
+    uint64_t input_state);
+std::vector<std::vector<std::complex<double>>>
+qtrajectory_simulate_moment_expectation_values(
+    const py::dict &options,
+    const std::vector<std::tuple<uint64_t, std::vector<
+      std::tuple<
+        std::vector<qsim::OpString<qsim::Cirq::GateCirq<float>>>,
+        unsigned
+    >>>>& opsums_and_qubit_counts,
+    const py::array_t<float> &input_vector);
 
 // Hybrid simulator.
 std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
@@ -186,6 +222,25 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
               &qsim_simulate_expectation_values),                                     \
             "Call the qsim simulator for expectation value simulation");              \
                                                                                       \
+      m.def("qsim_simulate_moment_expectation_values",                                \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                uint64_t)>(                                                           \
+              &qsim_simulate_moment_expectation_values),                              \
+            "Call the qsim simulator for step-by-step expectation value simulation"); \
+      m.def("qsim_simulate_moment_expectation_values",                                \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                const py::array_t<float>&)>(                                          \
+              &qsim_simulate_moment_expectation_values),                              \
+            "Call the qsim simulator for step-by-step expectation value simulation"); \
+                                                                                      \
       m.def("qtrajectory_simulate_expectation_values",                                \
             static_cast<std::vector<std::complex<double>>(*)(                         \
                 const py::dict&,                                                      \
@@ -201,9 +256,31 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
               &qtrajectory_simulate_expectation_values),                              \
             "Call the qtrajectory simulator for expectation value simulation");       \
                                                                                       \
+      m.def("qtrajectory_simulate_moment_expectation_values",                         \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                uint64_t)>(                                                           \
+              &qtrajectory_simulate_moment_expectation_values),                       \
+            "Call the qtrajectory simulator for step-by-step "                        \
+            "expectation value simulation");                                          \
+      m.def("qtrajectory_simulate_moment_expectation_values",                         \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                const py::array_t<float>&)>(                                          \
+              &qtrajectory_simulate_moment_expectation_values),                       \
+            "Call the qtrajectory simulator for step-by-step "                        \
+            "expectation value simulation");                                          \
+                                                                                      \
       /* Method for hybrid simulation */                                              \
       m.def("qsimh_simulate", &qsimh_simulate, "Call the qsimh simulator");           \
                                                                                       \
+      using KrausOperator = qsim::KrausOperator<GateCirq>;                            \
       using GateKind = qsim::Cirq::GateKind;                                          \
       using Circuit = qsim::Circuit<GateCirq>;                                        \
       using NoisyCircuit = qsim::NoisyCircuit<GateCirq>;                              \
@@ -223,6 +300,12 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
         .def_readwrite("weight", &OpString::weight)                                   \
         .def_readwrite("ops", &OpString::ops);                                        \
                                                                                       \
+      py::class_<KrausOperator>(m, "KrausOperator")                                   \
+        .def(py::init<>());                                                           \
+                                                                                      \
+      py::class_<GateCirq>(m, "GateCirq")                                             \
+        .def(py::init<>());                                                           \
+                                                                                      \
       py::enum_<GateKind>(m, "GateKind")                                              \
         .value("kI1", GateKind::kI1)                                                  \
         .value("kI2", GateKind::kI2)                                                  \
@@ -346,6 +429,26 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
               &qsim_simulate_expectation_values),                                     \
             "Call the qsim simulator for expectation value simulation");              \
                                                                                       \
+      m.def("qsim_simulate_moment_expectation_values",                                \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                uint64_t)>(                                                           \
+              &qsim_simulate_moment_expectation_values),                              \
+            "Call the qsim simulator for step-by-step expectation value simulation"); \
+      m.def("qsim_simulate_moment_expectation_values",                                \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                const py::array_t<float>&)>(                                          \
+              &qsim_simulate_moment_expectation_values),                              \
+            "Call the qsim simulator for step-by-step expectation value simulation"); \
+                                                                                      \
+                                                                                      \
       m.def("qtrajectory_simulate_expectation_values",                                \
             static_cast<std::vector<std::complex<double>>(*)(                         \
                 const py::dict&,                                                      \
@@ -361,6 +464,27 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
               &qtrajectory_simulate_expectation_values),                              \
             "Call the qtrajectory simulator for expectation value simulation");       \
                                                                                       \
+      m.def("qtrajectory_simulate_moment_expectation_values",                         \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                uint64_t)>(                                                           \
+              &qtrajectory_simulate_moment_expectation_values),                       \
+            "Call the qtrajectory simulator for step-by-step "                        \
+            "expectation value simulation");                                          \
+      m.def("qtrajectory_simulate_moment_expectation_values",                         \
+            static_cast<std::vector<std::vector<std::complex<double>>>(*)(            \
+                const py::dict&,                                                      \
+                const std::vector<std::tuple<uint64_t, std::vector<                   \
+                  std::tuple<std::vector<OpString>, unsigned>                         \
+                >>>&,                                                                 \
+                const py::array_t<float>&)>(                                          \
+              &qtrajectory_simulate_moment_expectation_values),                       \
+            "Call the qtrajectory simulator for step-by-step "                        \
+            "expectation value simulation");                                          \
+                                                                                      \
       /* Method for hybrid simulation */                                              \
       m.def("qsimh_simulate", &qsimh_simulate, "Call the qsimh simulator");
 #endif
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index b28078c9..c7460983 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -14,7 +14,8 @@
 
 from collections import deque
 from dataclasses import dataclass
-from typing import Any, Dict, List, Optional, Sequence, Tuple, Union
+from typing import Any, Dict, Iterator, List, Optional, Sequence, Tuple, Union
+from xml.etree.ElementPath import ops
 
 import cirq
 
@@ -595,7 +596,7 @@ def simulate_expectation_values_sweep(
         Args:
             program: The circuit to simulate.
             observables: An observable or list of observables.
-            param_resolver: Parameters to run with the program.
+            params: Parameters to run with the program.
             qubit_order: Determines the canonical ordering of the qubits. This
                 is often used in specifying the initial state, i.e. the
                 ordering of the computational basis states.
@@ -698,6 +699,144 @@ def simulate_expectation_values_sweep(
 
         return results
 
+    def simulate_moment_expectation_values(
+        self,
+        program: cirq.Circuit,
+        indexed_observables: Union[
+            Dict[int, Union[cirq.PauliSumLike, List[cirq.PauliSumLike]]],
+            cirq.PauliSumLike,
+            List[cirq.PauliSumLike],
+        ],
+        param_resolver: cirq.ParamResolver,
+        qubit_order: cirq.QubitOrderOrList = cirq.QubitOrder.DEFAULT,
+        initial_state: Any = None,
+    ) -> List[List[float]]:
+        """Calculates expectation values at each moment of a circuit.
+
+        Args:
+            program: The circuit to simulate.
+            indexed_observables: A map of moment indices to an observable
+                or list of observables to calculate after that moment. As a
+                convenience, users can instead pass in a single observable
+                or observable list to calculate after ALL moments.
+            param_resolver: Parameters to run with the program.
+            qubit_order: Determines the canonical ordering of the qubits. This
+                is often used in specifying the initial state, i.e. the
+                ordering of the computational basis states.
+            initial_state: The initial state for the simulation. The form of
+                this state depends on the simulation implementation. See
+                documentation of the implementing class for details.
+            permit_terminal_measurements: If the provided circuit ends with
+                measurement(s), this method will generate an error unless this
+                is set to True. This is meant to prevent measurements from
+                ruining expectation value calculations.
+
+        Returns:
+            A list of expectation values for each moment m in the circuit,
+            where value `n` corresponds to `indexed_observables[m][n]`.
+
+        Raises:
+            ValueError if 'program' has terminal measurement(s) and
+            'permit_terminal_measurements' is False. (Note: We cannot test this
+            until Cirq's `are_any_measurements_terminal` is released.)
+        """
+        if not isinstance(indexed_observables, Dict):
+            if not isinstance(indexed_observables, List):
+                indexed_observables = [
+                    (i, [indexed_observables]) for i, _ in enumerate(program)
+                ]
+            else:
+                indexed_observables = [
+                    (i, indexed_observables) for i, _ in enumerate(program)
+                ]
+        else:
+            indexed_observables = [
+                (i, obs) if isinstance(obs, List) else (i, [obs])
+                for i, obs in indexed_observables.items()
+            ]
+        indexed_observables.sort(key=lambda x: x[0])
+        psum_pairs = [
+            (i, [cirq.PauliSum.wrap(pslike) for pslike in obs_list])
+            for i, obs_list in indexed_observables
+        ]
+
+        all_qubits = program.all_qubits()
+        cirq_order = cirq.QubitOrder.as_qubit_order(qubit_order).order_for(all_qubits)
+        qsim_order = list(reversed(cirq_order))
+        num_qubits = len(qsim_order)
+        qubit_map = {qubit: index for index, qubit in enumerate(qsim_order)}
+
+        opsums_and_qcount_map = {}
+        for i, psumlist in psum_pairs:
+            opsums_and_qcount_map[i] = []
+            for psum in psumlist:
+                opsum = []
+                opsum_qubits = set()
+                for pstr in psum:
+                    opstring = qsim.OpString()
+                    opstring.weight = pstr.coefficient
+                    for q, pauli in pstr.items():
+                        op = pauli.on(q)
+                        opsum_qubits.add(q)
+                        qsimc.add_op_to_opstring(op, qubit_map, opstring)
+                    opsum.append(opstring)
+                opsums_and_qcount_map[i].append((opsum, len(opsum_qubits)))
+
+        if initial_state is None:
+            initial_state = 0
+        if not isinstance(initial_state, (int, np.ndarray)):
+            raise TypeError("initial_state must be an int or state vector.")
+
+        # Add noise to the circuit if a noise model was provided.
+        program = qsimc.QSimCircuit(
+            self.noise.noisy_moments(program, sorted(all_qubits))
+            if self.noise is not cirq.NO_NOISE
+            else program,
+            device=program.device,
+        )
+
+        options = {}
+        options.update(self.qsim_options)
+
+        param_resolver = cirq.to_resolvers(param_resolver)
+        if isinstance(initial_state, np.ndarray):
+            if initial_state.dtype != np.complex64:
+                raise TypeError(f"initial_state vector must have dtype np.complex64.")
+            input_vector = initial_state.view(np.float32)
+            if len(input_vector) != 2 ** num_qubits * 2:
+                raise ValueError(
+                    f"initial_state vector size must match number of qubits."
+                    f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
+                )
+
+        is_noisy = _needs_trajectories(program)
+        if is_noisy:
+            translator_fn_name = "translate_cirq_to_qtrajectory"
+            ev_simulator_fn = (
+                self._sim_module.qtrajectory_simulate_moment_expectation_values
+            )
+        else:
+            translator_fn_name = "translate_cirq_to_qsim"
+            ev_simulator_fn = self._sim_module.qsim_simulate_moment_expectation_values
+
+        solved_circuit = cirq.resolve_parameters(program, param_resolver)
+        options["c"], opsum_reindex = self._translate_moments(
+            solved_circuit,
+            translator_fn_name,
+            cirq_order,
+            is_noisy,
+        )
+        opsums_and_qubit_counts = []
+        for m, opsum_qc in opsums_and_qcount_map.items():
+            pair = (opsum_reindex[m], opsum_qc)
+            opsums_and_qubit_counts.append(pair)
+        options["s"] = self.get_seed()
+
+        if isinstance(initial_state, int):
+            return ev_simulator_fn(options, opsums_and_qubit_counts, initial_state)
+        elif isinstance(initial_state, np.ndarray):
+            return ev_simulator_fn(options, opsums_and_qubit_counts, input_vector)
+
     def _translate_circuit(
         self,
         circuit: Any,
@@ -718,3 +857,28 @@ def _translate_circuit(
             self._translated_circuits.append((circuit, translated_circuit))
 
         return translated_circuit
+
+    def _translate_moments(
+        self,
+        circuit: Any,
+        translator_fn_name: str,
+        qubit_order: cirq.QubitOrderOrList,
+        is_noisy: bool,
+    ):
+        """Translates a circuit by moments.
+
+        Returns:
+            A tuple containing the translated circuit and the gate indices
+            corresponding to moment boundaries.
+        """
+        reindex = [0]
+        for moment in circuit:
+            subc = self._translate_circuit(
+                qsimc.QSimCircuit(cirq.Circuit(moment)),
+                translator_fn_name,
+                qubit_order,
+            )
+            reindex.append(len(subc.channels if is_noisy else subc.gates) + reindex[-1])
+
+        full_circuit = self._translate_circuit(circuit, translator_fn_name, qubit_order)
+        return full_circuit, reindex[1:]
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 2ccccd7d..f5c0cea8 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -471,6 +471,60 @@ def test_expectation_values(mode: str):
     assert cirq.approx_eq(qsim_result, cirq_result, atol=1e-6)
 
 
+@pytest.mark.parametrize("mode", ["noiseless", "noisy"])
+def test_moment_expectation_values(mode: str):
+    # Perform a single-pass Rabi oscillation, measuring Z at each step.
+    q0 = cirq.LineQubit(0)
+    steps = 20
+    circuit = cirq.Circuit(*[cirq.X(q0) ** 0.05 for _ in range(steps)])
+    psum = cirq.Z(q0)
+    params = {}
+
+    if mode == "noisy":
+        circuit.append(NoiseTrigger().on(q0))
+
+    qsim_simulator = qsimcirq.QSimSimulator()
+    qsim_result = qsim_simulator.simulate_moment_expectation_values(
+        circuit, psum, params
+    )
+    # Omit noise trigger element
+    results = [r[0] for r in qsim_result][:20]
+    assert np.allclose(
+        [result.real for result in results],
+        [np.cos(np.pi * (i + 1) / 20) for i in range(steps)],
+        atol=1e-6,
+    )
+
+
+@pytest.mark.parametrize("mode", ["noiseless", "noisy"])
+def test_select_moment_expectation_values(mode: str):
+    # Measure different observables after specified steps.
+    q0, q1 = cirq.LineQubit.range(2)
+    circuit = cirq.Circuit(
+        cirq.Moment(cirq.X(q0), cirq.H(q1)),
+        cirq.Moment(cirq.H(q0), cirq.Z(q1)),
+        cirq.Moment(cirq.Z(q0), cirq.H(q1)),
+        cirq.Moment(cirq.H(q0), cirq.X(q1)),
+    )
+    psum_map = {
+        0: cirq.Z(q0),
+        1: [cirq.X(q0), cirq.Z(q1)],
+        3: [cirq.Z(q0), cirq.Z(q1)],
+    }
+    params = {}
+
+    if mode == "noisy":
+        circuit.append(NoiseTrigger().on(q0))
+
+    qsim_simulator = qsimcirq.QSimSimulator()
+    qsim_result = qsim_simulator.simulate_moment_expectation_values(
+        circuit, psum_map, params
+    )
+    expected_results = [[-1], [-1, 0], [1, 1]]
+    for i, result in enumerate(qsim_result):
+        assert np.allclose(result, expected_results[i])
+
+
 def test_expectation_values_terminal_measurement_check():
     a, b = [
         cirq.GridQubit(0, 0),

From dc62bf485f6f6c444c702ab1211f393a7f0d1262 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 18 Jan 2022 09:18:21 -0800
Subject: [PATCH 193/246] Use existing subcircuit method for noisy sim

---
 pybind_interface/pybind_main.cpp | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 7a63cc28..ec842cfd 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -729,18 +729,15 @@ class SimulatorHelper {
     if (is_noisy) {
       std::vector<uint64_t> stat;
       auto params = get_noisy_params();
-      NoisyCircuit<Gate> subncircuit;
-      subncircuit.num_qubits = ncircuit.num_qubits;
-      subncircuit.channels = std::vector<Channel<Gate>>(
-        ncircuit.channels.begin() + begin,
-        ncircuit.channels.begin() + end
-      );
-
       Simulator simulator = factory.CreateSimulator();
       StateSpace state_space = factory.CreateStateSpace();
 
-      result = NoisyRunner::RunOnce(params, subncircuit, seed, state_space,
-                                    simulator, scratch, state, stat);
+      result = NoisyRunner::RunOnce(
+        params, ncircuit.num_qubits,
+        ncircuit.channels.begin() + begin,
+        ncircuit.channels.begin() + end,
+        seed, state_space, simulator, scratch, state, stat
+      );
     } else {
       Circuit<Gate> subcircuit;
       subcircuit.num_qubits = circuit.num_qubits;

From 3a074162b307a863132113522e07c07a6b9c605a Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Tue, 18 Jan 2022 12:09:00 -0800
Subject: [PATCH 194/246] Only translate circuit once.

---
 pybind_interface/pybind_main.cpp | 46 ++++++++++++++++++++++++++++++++
 pybind_interface/pybind_main.h   | 11 ++++++++
 qsimcirq/qsim_simulator.py       |  7 ++++-
 qsimcirq_tests/qsimcirq_test.py  |  2 +-
 4 files changed, 64 insertions(+), 2 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index ec842cfd..7c95067d 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -273,6 +273,25 @@ void control_last_gate(const std::vector<unsigned>& qubits,
   MakeControlledGate(qubits, values, circuit->gates.back());
 }
 
+void compose_circuits(Circuit<Cirq::GateCirq<float>>* target,
+                      Circuit<Cirq::GateCirq<float>>* suffix) {
+  // Consumes 'suffix' and composes it onto the end of 'target'.
+  // After calling this method, 'suffix' should be discarded.
+  unsigned target_time = 0;
+  for (const auto& gate : target->gates) {
+    if (gate.time >= target_time) {
+      // Target duration is the max gate time, plus one.
+      target_time = gate.time + 1;
+    }
+  }
+  for (auto& gate : suffix->gates) {
+    gate.time += target_time;
+  }
+  target->gates.insert(target->gates.end(),
+                       std::make_move_iterator(suffix->gates.begin()),
+                       std::make_move_iterator(suffix->gates.end()));
+}
+
 template <typename Gate>
 Channel<Gate> create_single_gate_channel(Gate gate) {
   auto gate_kind = KrausOperator<Gate>::kNormal;
@@ -342,6 +361,33 @@ void add_channel(const unsigned time,
   ncircuit->channels.push_back(channel);
 }
 
+void compose_noisy_circuits(NoisyCircuit<Cirq::GateCirq<float>>* target,
+                            NoisyCircuit<Cirq::GateCirq<float>>* suffix) {
+  // Consumes 'suffix' and composes it onto the end of 'target'.
+  // After calling this method, 'suffix' should be discarded.
+  unsigned target_time = 0;
+  for (const auto& channel : target->channels) {
+    for (const auto& kraus_op : channel) {
+      for (const auto& op : kraus_op.ops) {
+        if (op.time >= target_time) {
+          // Target duration is the max gate time, plus one.
+          target_time = op.time + 1;
+        }
+      }
+    }
+  }
+  for (auto& channel : suffix->channels) {
+    for (auto& kraus_op : channel) {
+      for (auto& op : kraus_op.ops) {
+        op.time += target_time;
+      }
+    }
+  }
+  target->channels.insert(target->channels.end(),
+                          std::make_move_iterator(suffix->channels.begin()),
+                          std::make_move_iterator(suffix->channels.end()));
+}
+
 void add_gate_to_opstring(const Cirq::GateKind gate_kind,
                           const std::vector<unsigned>& qubits,
                           OpString<Cirq::GateCirq<float>>* opstring) {
diff --git a/pybind_interface/pybind_main.h b/pybind_interface/pybind_main.h
index 0b433a8a..3349b363 100644
--- a/pybind_interface/pybind_main.h
+++ b/pybind_interface/pybind_main.h
@@ -47,6 +47,9 @@ void control_last_gate(const std::vector<unsigned>& qubits,
                        const std::vector<unsigned>& values,
                        qsim::Circuit<qsim::Cirq::GateCirq<float>>* circuit);
 
+void compose_circuits(qsim::Circuit<qsim::Cirq::GateCirq<float>>* target,
+                      qsim::Circuit<qsim::Cirq::GateCirq<float>>* suffix);
+
 // Methods for mutating noisy circuits.
 void add_gate_channel(
     const qsim::Cirq::GateKind gate_kind,
@@ -75,6 +78,10 @@ void add_channel(const unsigned time,
                      prob_matrix_unitary_triples,
                  qsim::NoisyCircuit<qsim::Cirq::GateCirq<float>>* ncircuit);
 
+void compose_noisy_circuits(
+  qsim::NoisyCircuit<qsim::Cirq::GateCirq<float>>* target,
+  qsim::NoisyCircuit<qsim::Cirq::GateCirq<float>>* suffix);
+
 // Method for populating opstrings.
 void add_gate_to_opstring(
     const qsim::Cirq::GateKind gate_kind,
@@ -361,6 +368,8 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
             "Adds a matrix-defined gate to the given circuit.");                      \
       m.def("control_last_gate", &control_last_gate,                                  \
             "Applies controls to the final gate of a circuit.");                      \
+      m.def("compose_circuits", &compose_circuits,                                    \
+            "Composes target and suffix circuits into a single circuit.");            \
                                                                                       \
       m.def("add_gate_channel", &add_gate_channel,                                    \
             "Adds a gate to the given noisy circuit.");                               \
@@ -373,6 +382,8 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
                                                                                       \
       m.def("add_channel", &add_channel,                                              \
             "Adds a channel to the given noisy circuit.");                            \
+      m.def("compose_noisy_circuits", &compose_noisy_circuits,                        \
+            "Composes target and suffix noisy circuits into a single noisy circuit.");\
                                                                                       \
       m.def("add_gate_to_opstring", &add_gate_to_opstring,                            \
             "Adds a gate to the given opstring.");
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index c7460983..9ac8cb6e 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -872,6 +872,8 @@ def _translate_moments(
             corresponding to moment boundaries.
         """
         reindex = [0]
+        full_circuit = qsim.NoisyCircuit() if is_noisy else qsim.Circuit()
+        full_circuit.num_qubits = len(circuit.all_qubits())
         for moment in circuit:
             subc = self._translate_circuit(
                 qsimc.QSimCircuit(cirq.Circuit(moment)),
@@ -879,6 +881,9 @@ def _translate_moments(
                 qubit_order,
             )
             reindex.append(len(subc.channels if is_noisy else subc.gates) + reindex[-1])
+            if is_noisy:
+                qsim.compose_noisy_circuits(full_circuit, subc)
+            else:
+                qsim.compose_circuits(full_circuit, subc)
 
-        full_circuit = self._translate_circuit(circuit, translator_fn_name, qubit_order)
         return full_circuit, reindex[1:]
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index f5c0cea8..ac855a87 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -488,7 +488,7 @@ def test_moment_expectation_values(mode: str):
         circuit, psum, params
     )
     # Omit noise trigger element
-    results = [r[0] for r in qsim_result][:20]
+    results = [r[0] for r in qsim_result][:steps]
     assert np.allclose(
         [result.real for result in results],
         [np.cos(np.pi * (i + 1) / 20) for i in range(steps)],

From 48125821591695522230d3a14c7af359556e5f36 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 19 Jan 2022 13:28:47 -0800
Subject: [PATCH 195/246] Handle gate-counting in translate_circuit.

---
 pybind_interface/pybind_main.cpp |  1 -
 qsimcirq/qsim_circuit.py         | 14 +++++---
 qsimcirq/qsim_simulator.py       | 58 ++++++++++----------------------
 qsimcirq/qsimh_simulator.py      |  2 +-
 4 files changed, 28 insertions(+), 47 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 7c95067d..e58f3d98 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -638,7 +638,6 @@ class SimulatorHelper {
     }
 
     // Aggregate expectation values for noisy circuits.
-    // TODO: split over steps
     for (unsigned i = 0; i < opsums_and_qubit_counts.size(); ++i) {
       auto& counts = std::get<1>(opsums_and_qubit_counts[i]);
       results[i] = std::vector<std::complex<double>>(counts.size(), 0);
diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index a4811e2b..053c9e6f 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -285,7 +285,8 @@ def translate_cirq_to_qsim(
         """
         Translates this Cirq circuit to the qsim representation.
         :qubit_order: Ordering of qubits
-        :return: a C++ qsim Circuit object
+        :return: a tuple of (C++ qsim Circuit object, moment boundary
+            gate indices)
         """
 
         qsim_circuit = qsim.Circuit()
@@ -309,6 +310,7 @@ def to_matrix(op: cirq.ops.GateOperation):
 
         qubit_to_index_dict = {q: i for i, q in enumerate(ordered_qubits)}
         time_offset = 0
+        moment_indices = []
         for moment in self:
             ops_by_gate = [
                 cirq.decompose(op, fallback_decomposer=to_matrix, keep=has_qsim_kind)
@@ -326,8 +328,9 @@ def to_matrix(op: cirq.ops.GateOperation):
                     gate_kind = _cirq_gate_kind(qsim_op.gate)
                     add_op_to_circuit(qsim_op, time, qubit_to_index_dict, qsim_circuit)
             time_offset += moment_length
+            moment_indices.append(len(qsim_circuit.gates))
 
-        return qsim_circuit
+        return qsim_circuit, moment_indices
 
     def translate_cirq_to_qtrajectory(
         self, qubit_order: cirq.ops.QubitOrderOrList = cirq.ops.QubitOrder.DEFAULT
@@ -335,7 +338,8 @@ def translate_cirq_to_qtrajectory(
         """
         Translates this noisy Cirq circuit to the qsim representation.
         :qubit_order: Ordering of qubits
-        :return: a C++ qsim NoisyCircuit object
+        :return: a tuple of (C++ qsim NoisyCircuit object, moment boundary
+            gate indices)
         """
         qsim_ncircuit = qsim.NoisyCircuit()
         ordered_qubits = cirq.ops.QubitOrder.as_qubit_order(qubit_order).order_for(
@@ -359,6 +363,7 @@ def to_matrix(op: cirq.ops.GateOperation):
 
         qubit_to_index_dict = {q: i for i, q in enumerate(ordered_qubits)}
         time_offset = 0
+        moment_indices = []
         for moment in self:
             moment_length = 0
             ops_by_gate = []
@@ -419,5 +424,6 @@ def to_matrix(op: cirq.ops.GateOperation):
                     qubits = [qubit_to_index_dict[q] for q in channel.qubits]
                     qsim.add_channel(time_offset, qubits, chdata, qsim_ncircuit)
             time_offset += moment_length
+            moment_indices.append(len(qsim_ncircuit.channels))
 
-        return qsim_ncircuit
+        return qsim_ncircuit, moment_indices
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 9ac8cb6e..c52b8474 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -241,7 +241,11 @@ def __init__(
         else:
             self._sim_module = qsim
 
-        # Deque of (<original cirq circuit>, <translated qsim circuit>) tuples.
+        # Deque of (
+        #   <original cirq circuit>,
+        #   <translated qsim circuit>,
+        #   <moment_gate_indices>
+        # ) tuples.
         self._translated_circuits = deque(maxlen=circuit_memoization_size)
 
     def get_seed(self):
@@ -363,7 +367,7 @@ def _sample_measure_results(
                     for op in program.moments[i]
                 )
             translator_fn_name = "translate_cirq_to_qsim"
-            options["c"] = self._translate_circuit(
+            options["c"], _ = self._translate_circuit(
                 program,
                 translator_fn_name,
                 cirq.QubitOrder.DEFAULT,
@@ -384,7 +388,7 @@ def _sample_measure_results(
                 results[key] = full_results[:, meas_indices] ^ invert_mask
 
         else:
-            options["c"] = self._translate_circuit(
+            options["c"], _ = self._translate_circuit(
                 program,
                 translator_fn_name,
                 cirq.QubitOrder.DEFAULT,
@@ -463,7 +467,7 @@ def compute_amplitudes_sweep(
 
         for prs in param_resolvers:
             solved_circuit = cirq.resolve_parameters(program, prs)
-            options["c"] = self._translate_circuit(
+            options["c"], _ = self._translate_circuit(
                 solved_circuit,
                 translator_fn_name,
                 cirq_order,
@@ -553,7 +557,7 @@ def simulate_sweep(
         for prs in param_resolvers:
             solved_circuit = cirq.resolve_parameters(program, prs)
 
-            options["c"] = self._translate_circuit(
+            options["c"], _ = self._translate_circuit(
                 solved_circuit,
                 translator_fn_name,
                 cirq_order,
@@ -684,7 +688,7 @@ def simulate_expectation_values_sweep(
 
         for prs in param_resolvers:
             solved_circuit = cirq.resolve_parameters(program, prs)
-            options["c"] = self._translate_circuit(
+            options["c"], _ = self._translate_circuit(
                 solved_circuit,
                 translator_fn_name,
                 cirq_order,
@@ -820,11 +824,10 @@ def simulate_moment_expectation_values(
             ev_simulator_fn = self._sim_module.qsim_simulate_moment_expectation_values
 
         solved_circuit = cirq.resolve_parameters(program, param_resolver)
-        options["c"], opsum_reindex = self._translate_moments(
+        options["c"], opsum_reindex = self._translate_circuit(
             solved_circuit,
             translator_fn_name,
             cirq_order,
-            is_noisy,
         )
         opsums_and_qubit_counts = []
         for m, opsum_qc in opsums_and_qcount_map.items():
@@ -846,44 +849,17 @@ def _translate_circuit(
         # If the circuit is memoized, reuse the corresponding translated
         # circuit.
         translated_circuit = None
-        for original, translated in self._translated_circuits:
+        for original, translated, m_indices in self._translated_circuits:
             if original == circuit:
                 translated_circuit = translated
+                moment_indices = m_indices
                 break
 
         if translated_circuit is None:
             translator_fn = getattr(circuit, translator_fn_name)
-            translated_circuit = translator_fn(qubit_order)
-            self._translated_circuits.append((circuit, translated_circuit))
-
-        return translated_circuit
-
-    def _translate_moments(
-        self,
-        circuit: Any,
-        translator_fn_name: str,
-        qubit_order: cirq.QubitOrderOrList,
-        is_noisy: bool,
-    ):
-        """Translates a circuit by moments.
-
-        Returns:
-            A tuple containing the translated circuit and the gate indices
-            corresponding to moment boundaries.
-        """
-        reindex = [0]
-        full_circuit = qsim.NoisyCircuit() if is_noisy else qsim.Circuit()
-        full_circuit.num_qubits = len(circuit.all_qubits())
-        for moment in circuit:
-            subc = self._translate_circuit(
-                qsimc.QSimCircuit(cirq.Circuit(moment)),
-                translator_fn_name,
-                qubit_order,
+            translated_circuit, moment_indices = translator_fn(qubit_order)
+            self._translated_circuits.append(
+                (circuit, translated_circuit, moment_indices)
             )
-            reindex.append(len(subc.channels if is_noisy else subc.gates) + reindex[-1])
-            if is_noisy:
-                qsim.compose_noisy_circuits(full_circuit, subc)
-            else:
-                qsim.compose_circuits(full_circuit, subc)
 
-        return full_circuit, reindex[1:]
+        return translated_circuit, moment_indices
diff --git a/qsimcirq/qsimh_simulator.py b/qsimcirq/qsimh_simulator.py
index ccf1c1a0..6a060c42 100644
--- a/qsimcirq/qsimh_simulator.py
+++ b/qsimcirq/qsimh_simulator.py
@@ -65,7 +65,7 @@ def compute_amplitudes_sweep(
 
             solved_circuit = cirq.resolve_parameters(program, prs)
 
-            options["c"] = solved_circuit.translate_cirq_to_qsim(qubit_order)
+            options["c"], _ = solved_circuit.translate_cirq_to_qsim(qubit_order)
 
             options.update(self.qsimh_options)
             amplitudes = qsim.qsimh_simulate(options)

From c82c5e6b4998fde65308a09e271ffa7a524fe91b Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 19 Jan 2022 13:38:14 -0800
Subject: [PATCH 196/246] Remove compose_circuit methods

---
 pybind_interface/pybind_main.cpp | 46 --------------------------------
 pybind_interface/pybind_main.h   | 11 --------
 2 files changed, 57 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index e58f3d98..015c29a6 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -273,25 +273,6 @@ void control_last_gate(const std::vector<unsigned>& qubits,
   MakeControlledGate(qubits, values, circuit->gates.back());
 }
 
-void compose_circuits(Circuit<Cirq::GateCirq<float>>* target,
-                      Circuit<Cirq::GateCirq<float>>* suffix) {
-  // Consumes 'suffix' and composes it onto the end of 'target'.
-  // After calling this method, 'suffix' should be discarded.
-  unsigned target_time = 0;
-  for (const auto& gate : target->gates) {
-    if (gate.time >= target_time) {
-      // Target duration is the max gate time, plus one.
-      target_time = gate.time + 1;
-    }
-  }
-  for (auto& gate : suffix->gates) {
-    gate.time += target_time;
-  }
-  target->gates.insert(target->gates.end(),
-                       std::make_move_iterator(suffix->gates.begin()),
-                       std::make_move_iterator(suffix->gates.end()));
-}
-
 template <typename Gate>
 Channel<Gate> create_single_gate_channel(Gate gate) {
   auto gate_kind = KrausOperator<Gate>::kNormal;
@@ -361,33 +342,6 @@ void add_channel(const unsigned time,
   ncircuit->channels.push_back(channel);
 }
 
-void compose_noisy_circuits(NoisyCircuit<Cirq::GateCirq<float>>* target,
-                            NoisyCircuit<Cirq::GateCirq<float>>* suffix) {
-  // Consumes 'suffix' and composes it onto the end of 'target'.
-  // After calling this method, 'suffix' should be discarded.
-  unsigned target_time = 0;
-  for (const auto& channel : target->channels) {
-    for (const auto& kraus_op : channel) {
-      for (const auto& op : kraus_op.ops) {
-        if (op.time >= target_time) {
-          // Target duration is the max gate time, plus one.
-          target_time = op.time + 1;
-        }
-      }
-    }
-  }
-  for (auto& channel : suffix->channels) {
-    for (auto& kraus_op : channel) {
-      for (auto& op : kraus_op.ops) {
-        op.time += target_time;
-      }
-    }
-  }
-  target->channels.insert(target->channels.end(),
-                          std::make_move_iterator(suffix->channels.begin()),
-                          std::make_move_iterator(suffix->channels.end()));
-}
-
 void add_gate_to_opstring(const Cirq::GateKind gate_kind,
                           const std::vector<unsigned>& qubits,
                           OpString<Cirq::GateCirq<float>>* opstring) {
diff --git a/pybind_interface/pybind_main.h b/pybind_interface/pybind_main.h
index 3349b363..0b433a8a 100644
--- a/pybind_interface/pybind_main.h
+++ b/pybind_interface/pybind_main.h
@@ -47,9 +47,6 @@ void control_last_gate(const std::vector<unsigned>& qubits,
                        const std::vector<unsigned>& values,
                        qsim::Circuit<qsim::Cirq::GateCirq<float>>* circuit);
 
-void compose_circuits(qsim::Circuit<qsim::Cirq::GateCirq<float>>* target,
-                      qsim::Circuit<qsim::Cirq::GateCirq<float>>* suffix);
-
 // Methods for mutating noisy circuits.
 void add_gate_channel(
     const qsim::Cirq::GateKind gate_kind,
@@ -78,10 +75,6 @@ void add_channel(const unsigned time,
                      prob_matrix_unitary_triples,
                  qsim::NoisyCircuit<qsim::Cirq::GateCirq<float>>* ncircuit);
 
-void compose_noisy_circuits(
-  qsim::NoisyCircuit<qsim::Cirq::GateCirq<float>>* target,
-  qsim::NoisyCircuit<qsim::Cirq::GateCirq<float>>* suffix);
-
 // Method for populating opstrings.
 void add_gate_to_opstring(
     const qsim::Cirq::GateKind gate_kind,
@@ -368,8 +361,6 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
             "Adds a matrix-defined gate to the given circuit.");                      \
       m.def("control_last_gate", &control_last_gate,                                  \
             "Applies controls to the final gate of a circuit.");                      \
-      m.def("compose_circuits", &compose_circuits,                                    \
-            "Composes target and suffix circuits into a single circuit.");            \
                                                                                       \
       m.def("add_gate_channel", &add_gate_channel,                                    \
             "Adds a gate to the given noisy circuit.");                               \
@@ -382,8 +373,6 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
                                                                                       \
       m.def("add_channel", &add_channel,                                              \
             "Adds a channel to the given noisy circuit.");                            \
-      m.def("compose_noisy_circuits", &compose_noisy_circuits,                        \
-            "Composes target and suffix noisy circuits into a single noisy circuit.");\
                                                                                       \
       m.def("add_gate_to_opstring", &add_gate_to_opstring,                            \
             "Adds a gate to the given opstring.");

From bcf026ec61afdb160d301b705729f14759343b36 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 21 Jan 2022 12:54:11 -0800
Subject: [PATCH 197/246] Remove gates reference in Python

---
 pybind_interface/pybind_main.h |  7 -------
 qsimcirq/qsim_circuit.py       | 12 ++++++++----
 2 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/pybind_interface/pybind_main.h b/pybind_interface/pybind_main.h
index 0b433a8a..aed6b615 100644
--- a/pybind_interface/pybind_main.h
+++ b/pybind_interface/pybind_main.h
@@ -280,7 +280,6 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
       /* Method for hybrid simulation */                                              \
       m.def("qsimh_simulate", &qsimh_simulate, "Call the qsimh simulator");           \
                                                                                       \
-      using KrausOperator = qsim::KrausOperator<GateCirq>;                            \
       using GateKind = qsim::Cirq::GateKind;                                          \
       using Circuit = qsim::Circuit<GateCirq>;                                        \
       using NoisyCircuit = qsim::NoisyCircuit<GateCirq>;                              \
@@ -300,12 +299,6 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
         .def_readwrite("weight", &OpString::weight)                                   \
         .def_readwrite("ops", &OpString::ops);                                        \
                                                                                       \
-      py::class_<KrausOperator>(m, "KrausOperator")                                   \
-        .def(py::init<>());                                                           \
-                                                                                      \
-      py::class_<GateCirq>(m, "GateCirq")                                             \
-        .def(py::init<>());                                                           \
-                                                                                      \
       py::enum_<GateKind>(m, "GateKind")                                              \
         .value("kI1", GateKind::kI1)                                                  \
         .value("kI2", GateKind::kI2)                                                  \
diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index 053c9e6f..912f8fd7 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -310,6 +310,7 @@ def to_matrix(op: cirq.ops.GateOperation):
 
         qubit_to_index_dict = {q: i for i, q in enumerate(ordered_qubits)}
         time_offset = 0
+        gate_count = 0
         moment_indices = []
         for moment in self:
             ops_by_gate = [
@@ -325,10 +326,10 @@ def to_matrix(op: cirq.ops.GateOperation):
                         continue
                     qsim_op = gate_ops[gi]
                     time = time_offset + gi
-                    gate_kind = _cirq_gate_kind(qsim_op.gate)
                     add_op_to_circuit(qsim_op, time, qubit_to_index_dict, qsim_circuit)
+                    gate_count += 1
             time_offset += moment_length
-            moment_indices.append(len(qsim_circuit.gates))
+            moment_indices.append(gate_count)
 
         return qsim_circuit, moment_indices
 
@@ -363,6 +364,7 @@ def to_matrix(op: cirq.ops.GateOperation):
 
         qubit_to_index_dict = {q: i for i, q in enumerate(ordered_qubits)}
         time_offset = 0
+        gate_count = 0
         moment_indices = []
         for moment in self:
             moment_length = 0
@@ -397,8 +399,8 @@ def to_matrix(op: cirq.ops.GateOperation):
                         continue
                     qsim_op = gate_ops[gi]
                     time = time_offset + gi
-                    gate_kind = _cirq_gate_kind(qsim_op.gate)
                     add_op_to_circuit(qsim_op, time, qubit_to_index_dict, qsim_ncircuit)
+                    gate_count += 1
                 # Handle mixture output.
                 for mixture in ops_by_mix:
                     mixdata = []
@@ -410,6 +412,7 @@ def to_matrix(op: cirq.ops.GateOperation):
                         mixdata.append((prob, mat.view(np.float32), unitary))
                     qubits = [qubit_to_index_dict[q] for q in mixture.qubits]
                     qsim.add_channel(time_offset, qubits, mixdata, qsim_ncircuit)
+                    gate_count += 1
                 # Handle channel output.
                 for channel in ops_by_channel:
                     chdata = []
@@ -423,7 +426,8 @@ def to_matrix(op: cirq.ops.GateOperation):
                         chdata.append((lower_bound_prob, mat.view(np.float32), unitary))
                     qubits = [qubit_to_index_dict[q] for q in channel.qubits]
                     qsim.add_channel(time_offset, qubits, chdata, qsim_ncircuit)
+                    gate_count += 1
             time_offset += moment_length
-            moment_indices.append(len(qsim_ncircuit.channels))
+            moment_indices.append(gate_count)
 
         return qsim_ncircuit, moment_indices

From f1990876a484cfc24f1786bb59c063797158fa46 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 24 Jan 2022 08:22:21 -0800
Subject: [PATCH 198/246] Use resize

---
 pybind_interface/pybind_main.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 015c29a6..3cde361b 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -594,7 +594,7 @@ class SimulatorHelper {
     // Aggregate expectation values for noisy circuits.
     for (unsigned i = 0; i < opsums_and_qubit_counts.size(); ++i) {
       auto& counts = std::get<1>(opsums_and_qubit_counts[i]);
-      results[i] = std::vector<std::complex<double>>(counts.size(), 0);
+      results[i].resize(counts.size(), 0);
     }
     for (unsigned rep = 0; rep < helper.noisy_reps; ++rep) {
       // Init outside of simulation to enable stepping.

From 52a197962497d5591693c7afb72a18676487098e Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Thu, 27 Jan 2022 17:31:26 +0100
Subject: [PATCH 199/246] Remove temporary vector from trajectories.

---
 apps/qsim_qtrajectory_cuda.cu    |   4 +-
 docs/choose_hw.md                |   8 +-
 lib/BUILD                        |   5 +-
 lib/channel.h                    |  68 ++++++++
 lib/channels_cirq.h              |  51 ++++--
 lib/channels_qsim.h              |  22 ++-
 lib/matrix.h                     |  33 ++++
 lib/qtrajectory.h                |  52 +++----
 pybind_interface/pybind_main.cpp |   8 +-
 tests/BUILD                      |  18 +++
 tests/channel_test.cc            | 256 +++++++++++++++++++++++++++++++
 tests/make.sh                    |   1 +
 tests/qtrajectory_testfixture.h  | 125 +++++++++++++--
 13 files changed, 578 insertions(+), 73 deletions(-)
 create mode 100644 tests/channel_test.cc

diff --git a/apps/qsim_qtrajectory_cuda.cu b/apps/qsim_qtrajectory_cuda.cu
index ab9f122a..223add5e 100644
--- a/apps/qsim_qtrajectory_cuda.cu
+++ b/apps/qsim_qtrajectory_cuda.cu
@@ -242,7 +242,6 @@ int main(int argc, char* argv[]) {
   StateSpace state_space = factory.CreateStateSpace();
 
   State state = state_space.Create(circuit.num_qubits);
-  State scratch = state_space.Null();
 
   if (state_space.IsNull(state)) {
     IO::errorf("not enough memory: is the number of qubits too large?\n");
@@ -274,8 +273,7 @@ int main(int argc, char* argv[]) {
     for (unsigned s = 0; s < noisy_circuits.size(); ++s) {
       std::vector<uint64_t> stat;
       if (!QTSimulator::RunOnce(param3, noisy_circuits[s], seed++,
-                                state_space, simulator, scratch, state,
-                                stat)) {
+                                state_space, simulator, state, stat)) {
         return 1;
       }
 
diff --git a/docs/choose_hw.md b/docs/choose_hw.md
index 09dd9177..3be2bc06 100644
--- a/docs/choose_hw.md
+++ b/docs/choose_hw.md
@@ -38,10 +38,7 @@ below](#5_consider_multiple_compute_nodes).
 ### 2. Estimate your memory requirements
 
 You can estimate your memory requirements with the following rule of thumb:
-
-*   Noiseless simulation: $ memory\ required = 8 \cdot 2^N bytes $ for an N-qubit
-    circuit
-*   Noisy simulation: $ memory\ required = 16 \cdot 2^N bytes $ for an N-qubit circuit
+$ memory\ required = 8 \cdot 2^N bytes $ for an N-qubit circuit
 
 In addition to memory size, consider the bandwidth of your memory. qsim performs
 best when it can use the maximum number of threads. Multi-threaded simulation
@@ -121,8 +118,7 @@ depth beyond 20 qubits.
     *   How you can represent your noise model using Kraus operator formalism:
         *   Performance is best in the case where all Kraus operators are
             proportional to unitary matrices, such as when using only a
-            depolarizing channel. In this case, memory requirements are equal to
-            noiseless memory requirements (8\*2^n bytes).
+            depolarizing channel.
         *   Using noise which cannot be represented with Kraus operators
             proportional to unitary matrices, can slow down simulations by a
             factor of up to 6** **compared to using a depolarizing channel only
diff --git a/lib/BUILD b/lib/BUILD
index cc56dbd2..9be39dea 100644
--- a/lib/BUILD
+++ b/lib/BUILD
@@ -561,7 +561,10 @@ cc_library(
 cc_library(
     name = "channel",
     hdrs = ["channel.h"],
-    deps = [":gate"],
+    deps = [
+        ":gate",
+        ":matrix",
+    ],
 )
 
 cc_library(
diff --git a/lib/channel.h b/lib/channel.h
index 5f2a187b..372a174c 100644
--- a/lib/channel.h
+++ b/lib/channel.h
@@ -15,7 +15,11 @@
 #ifndef CHANNEL_H_
 #define CHANNEL_H_
 
+#include <set>
+#include <vector>
+
 #include "gate.h"
+#include "matrix.h"
 
 namespace qsim {
 
@@ -24,6 +28,8 @@ namespace qsim {
  */
 template <typename Gate>
 struct KrausOperator {
+  using fp_type = typename Gate::fp_type;
+
   enum Kind {
     kNormal = 0,
     kMeasurement = gate::kMeasurement,
@@ -49,6 +55,68 @@ struct KrausOperator {
    * one operation.
    */
   std::vector<Gate> ops;
+
+  /**
+   * Product of K^\dagger and K. This can be empty if unitary = true.
+   */
+  Matrix<fp_type> kd_k;
+
+  /**
+   * Qubits kd_k acts on. This can be empty if unitary = true.
+   */
+  std::vector<unsigned> qubits;
+
+  /**
+   * Calculates the product of "K^\dagger K". Sets qubits "K^\dagger K" acts on.
+   */
+  void CalculateKdKMatrix() {
+    if (ops.size() == 1) {
+      kd_k = ops[0].matrix;
+      MatrixDaggerMultiply(ops[0].qubits.size(), ops[0].matrix, kd_k);
+      qubits = ops[0].qubits;
+    } else if (ops.size() > 1) {
+      std::set<unsigned> qubit_map;
+
+      for (const auto& op : ops) {
+        for (unsigned q : op.qubits) {
+          qubit_map.insert(q);
+        }
+      }
+
+      unsigned num_qubits = qubit_map.size();
+
+      qubits.resize(0);
+      qubits.reserve(num_qubits);
+
+      for (auto it = qubit_map.begin(); it != qubit_map.end(); ++it) {
+        qubits.push_back(*it);
+      }
+
+      MatrixIdentity(unsigned{1} << num_qubits, kd_k);
+
+      for (const auto& op : ops) {
+        if (op.qubits.size() == num_qubits) {
+          MatrixMultiply(num_qubits, op.matrix, kd_k);
+        } else {
+          unsigned mask = 0;
+
+          for (auto q : op.qubits) {
+            for (unsigned i = 0; i < num_qubits; ++i) {
+              if (q == qubits[i]) {
+                mask |= unsigned{1} << i;
+                break;
+              }
+            }
+          }
+
+          MatrixMultiply(mask, op.qubits.size(), op.matrix, num_qubits, kd_k);
+        }
+      }
+
+      auto m = kd_k;
+      MatrixDaggerMultiply(num_qubits, m, kd_k);
+    }
+  }
 };
 
 /**
diff --git a/lib/channels_cirq.h b/lib/channels_cirq.h
index a8fd87ce..69f1df9d 100644
--- a/lib/channels_cirq.h
+++ b/lib/channels_cirq.h
@@ -237,11 +237,22 @@ struct GeneralizedAmplitudeDampingChannel {
     using M = Cirq::MatrixGate1<fp_type>;
     auto normal = KrausOperator<GateCirq<fp_type>>::kNormal;
 
-
-    return {{normal, 0, p1, {M::Create(time, q, {t1, 0,  0, 0,  0, 0, r1, 0})}},
-            {normal, 0, p2, {M::Create(time, q, {r2, 0,  0, 0,  0, 0, t2, 0})}},
-            {normal, 0, p3, {M::Create(time, q, { 0, 0, s1, 0,  0,  0, 0, 0})}},
-            {normal, 0, p3, {M::Create(time, q, { 0, 0,  0, 0, s2, 0,  0, 0})}},
+    return {{normal, 0, p1,
+             {M::Create(time, q, {t1, 0, 0, 0, 0, 0, r1, 0})},
+             {t1 * t1, 0, 0, 0, 0, 0, r1 * r1, 0}, {q},
+            },
+            {normal, 0, p2,
+             {M::Create(time, q, {r2, 0, 0, 0, 0, 0, t2, 0})},
+             {r2 * r2, 0, 0, 0, 0, 0, t2 * t2, 0}, {q},
+            },
+            {normal, 0, p3,
+             {M::Create(time, q, {0, 0, s1, 0, 0, 0, 0, 0})},
+             {0, 0, 0, 0, 0, 0, s1 * s1, 0}, {q},
+            },
+            {normal, 0, p3,
+             {M::Create(time, q, {0, 0, 0, 0, s2, 0, 0, 0})},
+             {s2 * s2, 0, 0, 0, 0, 0, 0, 0}, {q},
+            },
            };
   }
 
@@ -281,8 +292,14 @@ struct AmplitudeDampingChannel {
     using M = Cirq::MatrixGate1<fp_type>;
     auto normal = KrausOperator<GateCirq<fp_type>>::kNormal;
 
-    return {{normal, 0, p1, {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})}},
-            {normal, 0, p2, {M::Create(time, q, {0, 0, s, 0, 0, 0, 0, 0})}},
+    return {{normal, 0, p1,
+             {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})},
+             {1, 0, 0, 0, 0, 0, r * r, 0}, {q},
+            },
+            {normal, 0, p2,
+             {M::Create(time, q, {0, 0, s, 0, 0, 0, 0, 0})},
+             {0, 0, 0, 0, 0, 0, s * s, 0}, {q},
+            },
            };
   }
 
@@ -320,8 +337,14 @@ struct PhaseDampingChannel {
     using M = Cirq::MatrixGate1<fp_type>;
     auto normal = KrausOperator<GateCirq<fp_type>>::kNormal;
 
-    return {{normal, 0, p1, {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})}},
-            {normal, 0, p2, {M::Create(time, q, {0, 0, 0, 0, 0, 0, s, 0})}},
+    return {{normal, 0, p1,
+             {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})},
+             {1, 0, 0, 0, 0, 0, r * r, 0}, {q},
+            },
+            {normal, 0, p2,
+             {M::Create(time, q, {0, 0, 0, 0, 0, 0, s, 0})},
+             {0, 0, 0, 0, 0, 0, s * s, 0}, {q},
+            },
            };
   }
 
@@ -351,8 +374,14 @@ struct ResetChannel {
     using M = Cirq::MatrixGate1<fp_type>;
     auto normal = KrausOperator<GateCirq<fp_type>>::kNormal;
 
-    return {{normal, 0, 0, {M::Create(time, q, {1, 0, 0, 0, 0, 0, 0, 0})}},
-            {normal, 0, 0, {M::Create(time, q, {0, 0, 1, 0, 0, 0, 0, 0})}},
+    return {{normal, 0, 0,
+             {M::Create(time, q, {1, 0, 0, 0, 0, 0, 0, 0})},
+             {1, 0, 0, 0, 0, 0, 0, 0}, {q},
+            },
+            {normal, 0, 0,
+             {M::Create(time, q, {0, 0, 1, 0, 0, 0, 0, 0})},
+             {0, 0, 0, 0, 0, 0, 1, 0}, {q},
+            },
            };
   }
 };
diff --git a/lib/channels_qsim.h b/lib/channels_qsim.h
index 9630de07..5c07bccf 100644
--- a/lib/channels_qsim.h
+++ b/lib/channels_qsim.h
@@ -42,8 +42,15 @@ struct AmplitudeDampingChannel {
     using M = GateMatrix1<fp_type>;
     auto normal = KrausOperator<GateQSim<fp_type>>::kNormal;
 
-    return {{normal, 0, p1, {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})}},
-            {normal, 0, p2, {M::Create(time, q, {0, 0, s, 0, 0, 0, 0, 0})}}};
+    return {{normal, 0, p1,
+             {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})},
+             {1, 0, 0, 0, 0, 0, r * r, 0}, {q},
+            },
+            {normal, 0, p2,
+             {M::Create(time, q, {0, 0, s, 0, 0, 0, 0, 0})},
+             {0, 0, 0, 0, 0, 0, s * s, 0}, {q},
+            },
+           };
   }
 
   Channel<GateQSim<fp_type>> Create(unsigned time, unsigned q) const {
@@ -79,8 +86,15 @@ struct PhaseDampingChannel {
     using M = GateMatrix1<fp_type>;
     auto normal = KrausOperator<GateQSim<fp_type>>::kNormal;
 
-    return {{normal, 0, p1, {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})}},
-            {normal, 0, p2, {M::Create(time, q, {0, 0, 0, 0, 0, 0, s, 0})}}};
+    return {{normal, 0, p1,
+             {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})},
+             {1, 0, 0, 0, 0, 0, r * r, 0}, {q},
+            },
+            {normal, 0, p2,
+             {M::Create(time, q, {0, 0, 0, 0, 0, 0, s, 0})},
+             {0, 0, 0, 0, 0, 0, s * s, 0}, {q},
+            },
+           };
   }
 
   Channel<GateQSim<fp_type>> Create(unsigned time, unsigned q) const {
diff --git a/lib/matrix.h b/lib/matrix.h
index f9725eca..e126a02d 100644
--- a/lib/matrix.h
+++ b/lib/matrix.h
@@ -92,6 +92,39 @@ inline void MatrixMultiply(
   }
 }
 
+/**
+ * Multiplies two gate matrices of equal size: m2 = m1^\dagger m2.
+ * @q Number of gate qubits. The number of matrix rows (columns) is 2^q.
+ * @m1 Matrix m1.
+ * @m2 Input matrix m2. Output product of matrices m2 = m1 m2.
+ */
+template <typename fp_type1, typename fp_type2>
+inline void MatrixDaggerMultiply(
+    unsigned q, const Matrix<fp_type1>& m1, Matrix<fp_type2>& m2) {
+  Matrix<fp_type2> mt = m2;
+  unsigned n = unsigned{1} << q;
+
+  for (unsigned i = 0; i < n; ++i) {
+    for (unsigned j = 0; j < n; ++j) {
+      fp_type2 re = 0;
+      fp_type2 im = 0;
+
+      for (unsigned k = 0; k < n; ++k) {
+        fp_type2 r1 = m1[2 * (n * k + i)];
+        fp_type2 i1 = m1[2 * (n * k + i) + 1];
+        fp_type2 r2 = mt[2 * (n * k + j)];
+        fp_type2 i2 = mt[2 * (n * k + j) + 1];
+
+        re += r1 * r2 + i1 * i2;
+        im += r1 * i2 - i1 * r2;
+      }
+
+      m2[2 * (n * i + j)] = re;
+      m2[2 * (n * i + j) + 1] = im;
+    }
+  }
+}
+
 /**
  * Multiplies two gate matrices: m2 = m1 m2. The size of m1 should not exceed
  *   the size of m2.
diff --git a/lib/qtrajectory.h b/lib/qtrajectory.h
index 773238c6..1b5c7555 100644
--- a/lib/qtrajectory.h
+++ b/lib/qtrajectory.h
@@ -116,7 +116,6 @@ class QuantumTrajectorySimulator {
     gates.reserve(4 * std::size_t(cend - cbeg));
 
     State state = state_space.Null();
-    State scratch = state_space.Null();
 
     std::vector<uint64_t> stat;
 
@@ -126,7 +125,7 @@ class QuantumTrajectorySimulator {
       }
 
       if (!RunIteration(param, num_qubits, cbeg, cend, r,
-                        state_space, simulator, gates, scratch, state, stat)) {
+                        state_space, simulator, gates, state, stat)) {
         return false;
       }
 
@@ -144,7 +143,6 @@ class QuantumTrajectorySimulator {
    * @param state_space StateSpace object required to manipulate state vector.
    * @param simulator Simulator object. Provides specific implementations for
    *   applying gates.
-   * @param scratch A temporary state vector. Used for samping Kraus operators.
    * @param state The state of the system, to be updated by this method.
    * @param stat Statistics of sampled Kraus operator indices and/or measured
    *   bitstrings, to be populated by this method.
@@ -153,11 +151,10 @@ class QuantumTrajectorySimulator {
   static bool RunOnce(const Parameter& param,
                       const NoisyCircuit<Gate>& circuit, uint64_t r,
                       const StateSpace& state_space, const Simulator& simulator,
-                      State& scratch, State& state,
-                      std::vector<uint64_t>& stat) {
+                      State& state, std::vector<uint64_t>& stat) {
     return RunOnce(param, circuit.num_qubits, circuit.channels.begin(),
                    circuit.channels.end(), r, state_space, simulator,
-                   scratch, state, stat);
+                   state, stat);
   }
 
   /**
@@ -170,7 +167,6 @@ class QuantumTrajectorySimulator {
    * @param state_space StateSpace object required to manipulate state vector.
    * @param simulator Simulator object. Provides specific implementations for
    *   applying gates.
-   * @param scratch A temporary state vector. Used for samping Kraus operators.
    * @param state The state of the system, to be updated by this method.
    * @param stat Statistics of sampled Kraus operator indices and/or measured
    *   bitstrings, to be populated by this method.
@@ -180,13 +176,13 @@ class QuantumTrajectorySimulator {
                       ncircuit_iterator<Gate> cbeg,
                       ncircuit_iterator<Gate> cend,
                       uint64_t r, const StateSpace& state_space,
-                      const Simulator& simulator, State& scratch, State& state,
+                      const Simulator& simulator, State& state,
                       std::vector<uint64_t>& stat) {
     std::vector<const Gate*> gates;
     gates.reserve(4 * std::size_t(cend - cbeg));
 
     if (!RunIteration(param, num_qubits, cbeg, cend, r,
-                      state_space, simulator, gates, scratch, state, stat)) {
+                      state_space, simulator, gates, state, stat)) {
       return false;
     }
 
@@ -199,7 +195,7 @@ class QuantumTrajectorySimulator {
                            ncircuit_iterator<Gate> cend,
                            uint64_t rep, const StateSpace& state_space,
                            const Simulator& simulator,
-                           std::vector<const Gate*>& gates, State& scratch,
+                           std::vector<const Gate*>& gates,
                            State& state, std::vector<uint64_t>& stat) {
     if (param.collect_kop_stat || param.collect_mea_stat) {
       stat.reserve(std::size_t(cend - cbeg));
@@ -279,14 +275,8 @@ class QuantumTrajectorySimulator {
 
       NormalizeState(!unitary, state_space, unitary, state);
 
-      if (state_space.IsNull(scratch) || scratch.num_qubits() < num_qubits) {
-        scratch = CreateState(num_qubits, state_space);
-        if (state_space.IsNull(scratch)) {
-          return false;
-        }
-      }
-
-      state_space.Copy(state, scratch);
+      double max_prob = 0;
+      std::size_t max_prob_index = 0;
 
       // Perform sampling of Kraus operators using norms of updated states.
       for (std::size_t i = 0; i < channel.size(); ++i) {
@@ -294,35 +284,29 @@ class QuantumTrajectorySimulator {
 
         if (kop.unitary) continue;
 
-        // Apply the Kraus operator.
-        if (kop.ops.size() == 1) {
-          ApplyGate(simulator, kop.ops[0], state);
-        } else {
-          DeferOps(kop.ops, gates);
+        double prob = std::real(
+            simulator.ExpectationValue(kop.qubits, kop.kd_k.data(), state));
 
-          if (!ApplyDeferredOps(param, num_qubits, simulator, gates, state)) {
-            return false;
-          }
+        if (prob > max_prob) {
+          max_prob = prob;
+          max_prob_index = i;
         }
 
-        double n2 = state_space.Norm(state);
-
-        cp += n2 - kop.prob;
+        cp += prob - kop.prob;
 
         if (r < cp || i == channel.size() - 1) {
           // Sample ith Kraus operator if r < cp
-          // Sample the first Kraus operator if r is greater than the sum of
-          // all probablities due to round-off errors.
-          uint64_t k = r < cp ? i : 0;
+          // Sample the highest probability Kraus operator if r is greater
+          // than the sum of all probablities due to round-off errors.
+          uint64_t k = r < cp ? i : max_prob_index;
 
+          DeferOps(channel[k].ops, gates);
           CollectStat(param.collect_kop_stat, k, stat);
 
           unitary = false;
 
           break;
         }
-
-        state_space.Copy(scratch, state);
       }
     }
 
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index 3cde361b..e6788088 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -22,6 +22,7 @@
 #include <vector>
 
 #include "../lib/bitstring.h"
+#include "../lib/channel.h"
 #include "../lib/expect.h"
 #include "../lib/formux.h"
 #include "../lib/fuser_mqubit.h"
@@ -338,6 +339,9 @@ void add_channel(const unsigned time,
     channel.emplace_back(KrausOperator<Gate>{
       KrausOperator<Gate>::kNormal, is_unitary, prob, {gate}
     });
+    if (!is_unitary) {
+      channel.back().CalculateKdKMatrix();
+    }
   }
   ncircuit->channels.push_back(channel);
 }
@@ -714,7 +718,7 @@ class SimulatorHelper {
       StateSpace state_space = factory.CreateStateSpace();
 
       result = NoisyRunner::RunOnce(params, ncircuit, seed, state_space,
-                                    simulator, scratch, state, stat);
+                                    simulator, state, stat);
     } else {
       result = Runner::Run(get_params(), factory, circuit, state);
     }
@@ -735,7 +739,7 @@ class SimulatorHelper {
         params, ncircuit.num_qubits,
         ncircuit.channels.begin() + begin,
         ncircuit.channels.begin() + end,
-        seed, state_space, simulator, scratch, state, stat
+        seed, state_space, simulator, state, stat
       );
     } else {
       Circuit<Gate> subcircuit;
diff --git a/tests/BUILD b/tests/BUILD
index af59659e..dadd7751 100644
--- a/tests/BUILD
+++ b/tests/BUILD
@@ -31,6 +31,23 @@ cc_test(
     ],
 )
 
+cc_test(
+    name = "channel_test",
+    srcs = ["channel_test.cc"],
+    deps = [
+        "@com_google_googletest//:gtest_main",
+        "//lib:channel",
+        "//lib:formux",
+        "//lib:gates_cirq",
+        "//lib:matrix",
+        "//lib:simulator",
+    ],
+    copts = select({
+        ":windows": windows_copts,
+        "//conditions:default": [],
+    }),
+)
+
 cc_test(
     name = "channels_cirq_test",
     srcs = ["channels_cirq_test.cc"],
@@ -197,6 +214,7 @@ cc_library(
     }),
     deps = [
         "@com_google_googletest//:gtest_main",
+        "//lib:channel",
         "//lib:channels_cirq",
         "//lib:circuit_noisy",
         "//lib:fuser_mqubit",
diff --git a/tests/channel_test.cc b/tests/channel_test.cc
new file mode 100644
index 00000000..15b2307e
--- /dev/null
+++ b/tests/channel_test.cc
@@ -0,0 +1,256 @@
+// Copyright 2019 Google LLC. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include <cmath>
+#include <cstdint>
+#include <vector>
+
+#include "gtest/gtest.h"
+
+#include "../lib/channel.h"
+#include "../lib/formux.h"
+#include "../lib/gates_cirq.h"
+#include "../lib/matrix.h"
+#include "../lib/simmux.h"
+
+namespace qsim {
+
+namespace {
+
+template <typename KrausOperator>
+void TestUnitaryKrausOparator(const KrausOperator& kop) {
+  // Should be an identity matrix.
+
+  unsigned m = 1 << kop.qubits.size();
+
+  for (unsigned i = 0; i < m; ++i) {
+    for (unsigned j = 0; j < m; ++j) {
+      auto re = kop.kd_k.data()[2 * m * i + 2 * j];
+      auto im = kop.kd_k.data()[2 * m * i + 2 * j + 1];
+
+      if (i == j) {
+        EXPECT_NEAR(re, 1, 1e-6);
+        EXPECT_NEAR(im, 0, 1e-7);
+      } else {
+        EXPECT_NEAR(re, 0, 1e-7);
+        EXPECT_NEAR(im, 0, 1e-7);
+      }
+    }
+  }
+}
+
+template <typename KrausOperator, typename StateSpace, typename Simulator,
+          typename State>
+void TestNonUnitaryKrausOparator(const KrausOperator& kop,
+                                 const StateSpace& state_space,
+                                 const Simulator& simulator,
+                                 State& state0, State& state1) {
+  state_space.SetStateUniform(state0);
+  state_space.SetStateUniform(state1);
+
+  for (const auto&op : kop.ops) {
+    simulator.ApplyGate(op.qubits, op.matrix.data(), state0);
+  }
+
+  for (auto it = kop.ops.rbegin(); it != kop.ops.rend(); ++it) {
+    auto md = it->matrix;
+    MatrixDagger(1 << it->qubits.size(), md);
+    simulator.ApplyGate(it->qubits, md.data(), state0);
+  }
+
+  simulator.ApplyGate(kop.qubits, kop.kd_k.data(), state1);
+
+  unsigned size = unsigned{1} << (state0.num_qubits() + 1);
+
+  for (unsigned i = 0; i < size; ++i) {
+    EXPECT_NEAR(state0.get()[i], state1.get()[i], 1e-7);
+  }
+}
+
+}  // namespace
+
+TEST(ChannelTest, UnitaryKdKMatrix) {
+  using fp_type = Simulator<For>::fp_type;
+  using Gate = Cirq::GateCirq<fp_type>;
+
+  auto normal = KrausOperator<Gate>::kNormal;
+
+  Channel<Gate> channel = {
+    {
+      normal, 1, 0.2, {
+                        Cirq::FSimGate<fp_type>::Create(0, 3, 4, 0.1, 1.4),
+                      }
+    },
+    {
+      normal, 1, 0.2, {
+                        Cirq::rx<fp_type>::Create(0, 0, 0.1),
+                        Cirq::ry<fp_type>::Create(0, 1, 0.2),
+                        Cirq::FSimGate<fp_type>::Create(1, 0, 1, 0.2, 1.3),
+                      }
+    },
+    {
+      normal, 1, 0.2, {
+                        Cirq::rz<fp_type>::Create(0, 3, 0.3),
+                        Cirq::rx<fp_type>::Create(0, 1, 0.4),
+                        Cirq::ry<fp_type>::Create(0, 4, 0.5),
+                        Cirq::rz<fp_type>::Create(0, 0, 0.6),
+                      }
+    },
+    {
+      normal, 1, 0.2, {
+                        Cirq::rx<fp_type>::Create(0, 4, 0.7),
+                        Cirq::ry<fp_type>::Create(0, 3, 0.8),
+                        Cirq::rz<fp_type>::Create(0, 1, 0.9),
+                        Cirq::rx<fp_type>::Create(0, 0, 1.0),
+                        Cirq::FSimGate<fp_type>::Create(1, 1, 3, 0.3, 1.2),
+                        Cirq::FSimGate<fp_type>::Create(1, 0, 4, 0.4, 1.1),
+                      }
+    },
+    {
+      normal, 1, 0.2, {
+                        Cirq::ry<fp_type>::Create(0, 7, 1.1),
+                        Cirq::rz<fp_type>::Create(0, 5, 1.2),
+                        Cirq::rx<fp_type>::Create(0, 1, 1.3),
+                        Cirq::ry<fp_type>::Create(0, 3, 1.4),
+                        Cirq::rz<fp_type>::Create(0, 2, 1.5),
+                        Cirq::rx<fp_type>::Create(0, 4, 1.6),
+                        Cirq::FSimGate<fp_type>::Create(1, 4, 5, 0.5, 1.0),
+                        Cirq::FSimGate<fp_type>::Create(1, 1, 3, 0.6, 0.9),
+                        Cirq::FSimGate<fp_type>::Create(1, 2, 7, 0.7, 0.8),
+                      }
+    },
+  };
+
+  channel[0].CalculateKdKMatrix();
+  ASSERT_EQ(channel[0].kd_k.size(), 32);
+  ASSERT_EQ(channel[0].qubits.size(), 2);
+  EXPECT_EQ(channel[0].qubits[0], 3);
+  EXPECT_EQ(channel[0].qubits[1], 4);
+  TestUnitaryKrausOparator(channel[0]);
+
+  channel[1].CalculateKdKMatrix();
+  ASSERT_EQ(channel[1].kd_k.size(), 32);
+  ASSERT_EQ(channel[1].qubits.size(), 2);
+  EXPECT_EQ(channel[1].qubits[0], 0);
+  EXPECT_EQ(channel[1].qubits[1], 1);
+  TestUnitaryKrausOparator(channel[1]);
+
+  channel[2].CalculateKdKMatrix();
+  ASSERT_EQ(channel[2].kd_k.size(), 512);
+  ASSERT_EQ(channel[2].qubits.size(), 4);
+  EXPECT_EQ(channel[2].qubits[0], 0);
+  EXPECT_EQ(channel[2].qubits[1], 1);
+  EXPECT_EQ(channel[2].qubits[2], 3);
+  EXPECT_EQ(channel[2].qubits[3], 4);
+  TestUnitaryKrausOparator(channel[2]);
+
+  channel[3].CalculateKdKMatrix();
+  ASSERT_EQ(channel[3].kd_k.size(), 512);
+  ASSERT_EQ(channel[3].qubits.size(), 4);
+  EXPECT_EQ(channel[3].qubits[0], 0);
+  EXPECT_EQ(channel[3].qubits[1], 1);
+  EXPECT_EQ(channel[3].qubits[2], 3);
+  EXPECT_EQ(channel[3].qubits[3], 4);
+  TestUnitaryKrausOparator(channel[3]);
+
+  channel[4].CalculateKdKMatrix();
+  ASSERT_EQ(channel[4].kd_k.size(), 8192);
+  ASSERT_EQ(channel[4].qubits.size(), 6);
+  EXPECT_EQ(channel[4].qubits[0], 1);
+  EXPECT_EQ(channel[4].qubits[1], 2);
+  EXPECT_EQ(channel[4].qubits[2], 3);
+  EXPECT_EQ(channel[4].qubits[3], 4);
+  EXPECT_EQ(channel[4].qubits[4], 5);
+  EXPECT_EQ(channel[4].qubits[5], 7);
+  TestUnitaryKrausOparator(channel[4]);
+}
+
+TEST(ChannelTest, NonUnitaryKdKMatrix) {
+  using StateSpace = Simulator<For>::StateSpace;
+  using State = StateSpace::State;
+  using fp_type = StateSpace::fp_type;
+  using Gate = Cirq::GateCirq<fp_type>;
+  using M1 = Cirq::MatrixGate1<fp_type>;
+  using M2 = Cirq::MatrixGate2<fp_type>;
+
+  unsigned  num_qubits = 8;
+  auto normal = KrausOperator<Gate>::kNormal;
+
+  Channel<Gate> channel = {
+    {
+      normal, 0, 0, {
+                      M1::Create(0, 0,
+                                 {0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4}),
+                      M1::Create(0, 1,
+                                 {0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4, 0.1}),
+                      M2::Create(0, 0, 1,
+                                 {0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4,
+                                  0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4, 0.1,
+                                  0.3, 0.4, 0.1, 0.2, 0.3, 0.4, 0.1, 0.2,
+                                  0.4, 0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.3}),
+                    }
+    },
+    {
+      normal, 0, 0, {
+                      M1::Create(0, 4,
+                                 {0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4}),
+                      M1::Create(0, 3,
+                                 {0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4, 0.1}),
+                      M1::Create(0, 1,
+                                 {0.3, 0.4, 0.1, 0.2, 0.3, 0.4, 0.1, 0.2}),
+                      M1::Create(0, 0,
+                                 {0.4, 0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.3}),
+                      M2::Create(0, 0, 4,
+                                 {0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4,
+                                  0.2, 0.3, 0.4, 0.1, 0.2, 0.3, 0.4, 0.1,
+                                  0.3, 0.4, 0.1, 0.2, 0.3, 0.4, 0.1, 0.2,
+                                  0.4, 0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.3}),
+                    }
+    },
+  };
+
+  StateSpace state_space(1);
+  Simulator<For> simulator(1);
+
+  State state0 = state_space.Create(num_qubits);
+  ASSERT_FALSE(state_space.IsNull(state0));
+
+  State state1 = state_space.Create(num_qubits);
+  ASSERT_FALSE(state_space.IsNull(state1));
+
+  channel[0].CalculateKdKMatrix();
+  ASSERT_EQ(channel[0].kd_k.size(), 32);
+  ASSERT_EQ(channel[0].qubits.size(), 2);
+  EXPECT_EQ(channel[0].qubits[0], 0);
+  EXPECT_EQ(channel[0].qubits[1], 1);
+  TestNonUnitaryKrausOparator(
+      channel[0], state_space, simulator, state0, state1);
+
+  channel[1].CalculateKdKMatrix();
+  ASSERT_EQ(channel[1].kd_k.size(), 512);
+  ASSERT_EQ(channel[1].qubits.size(), 4);
+  EXPECT_EQ(channel[1].qubits[0], 0);
+  EXPECT_EQ(channel[1].qubits[1], 1);
+  EXPECT_EQ(channel[1].qubits[2], 3);
+  EXPECT_EQ(channel[1].qubits[3], 4);
+  TestNonUnitaryKrausOparator(
+      channel[1], state_space, simulator, state0, state1);
+}
+
+}  // namespace qsim
+
+int main(int argc, char** argv) {
+  testing::InitGoogleTest(&argc, argv);
+  return RUN_ALL_TESTS();
+}
diff --git a/tests/make.sh b/tests/make.sh
index 9ccb228d..fb3bbc8e 100755
--- a/tests/make.sh
+++ b/tests/make.sh
@@ -21,6 +21,7 @@ path_to_include=googletest/googletest/include
 path_to_lib=googletest/googletest/make/lib
 
 g++ -O3 -I$path_to_include -L$path_to_lib -o bitstring_test.x bitstring_test.cc -lgtest -lpthread
+g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o channel_test.x channel_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o channels_cirq_test.x channels_cirq_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -o circuit_qsim_parser_test.x circuit_qsim_parser_test.cc -lgtest -lpthread
 g++ -O3 -I$path_to_include -L$path_to_lib -mavx2 -mfma -fopenmp -o expect_nobmi2_test.x expect_test.cc -lgtest -lpthread
diff --git a/tests/qtrajectory_testfixture.h b/tests/qtrajectory_testfixture.h
index 80bd15a6..02588c1b 100644
--- a/tests/qtrajectory_testfixture.h
+++ b/tests/qtrajectory_testfixture.h
@@ -21,6 +21,7 @@
 
 #include "gtest/gtest.h"
 
+#include "../lib/channel.h"
 #include "../lib/channels_cirq.h"
 #include "../lib/circuit_noisy.h"
 #include "../lib/fuser_mqubit.h"
@@ -104,6 +105,10 @@ void AddGenAmplDumpNoise1(
        {normal, 0, p2, {M::Create(time, q, {r2, 0, 0, 0, 0, 0, t2, 0})}},
        {normal, 0, p3, {M::Create(time, q, {0, 0, s1, 0, 0, 0, 0, 0})}},
        {normal, 0, p3, {M::Create(time, q, {0, 0, 0, 0, s2, 0, 0, 0})}}});
+
+  for (auto& kop : ncircuit.channels.back()) {
+    kop.CalculateKdKMatrix();
+  }
 }
 
 template <typename Gate>
@@ -134,11 +139,103 @@ void AddGenAmplDumpNoise2(
        {normal, 0, p2, {M::Create(time, 0, {r2, 0, 0, 0, 0, 0, t2, 0})}},
        {normal, 0, p3, {M::Create(time, 0, {0, 0, s1, 0, 0, 0, 0, 0})}},
        {normal, 0, p3, {M::Create(time, 0, {0, 0, 0, 0, s2, 0, 0, 0})}}});
+
+  for (auto& kop : ncircuit.channels.back()) {
+    kop.CalculateKdKMatrix();
+  }
+
   ncircuit.channels.push_back(
       {{normal, 0, p1, {M::Create(time, 1, {t1, 0, 0, 0, 0, 0, r1, 0})}},
        {normal, 0, p2, {M::Create(time, 1, {r2, 0, 0, 0, 0, 0, t2, 0})}},
        {normal, 0, p3, {M::Create(time, 1, {0, 0, s1, 0, 0, 0, 0, 0})}},
        {normal, 0, p3, {M::Create(time, 1, {0, 0, 0, 0, s2, 0, 0, 0})}}});
+
+  for (auto& kop : ncircuit.channels.back()) {
+    kop.CalculateKdKMatrix();
+  }
+}
+
+// Adds the same channel as in AddGenAmplDumpNoise2 above.
+template <typename Gate>
+void AddGenAmplDumpNoise2Alt(
+    unsigned time, double g, NoisyCircuit<Gate>& ncircuit) {
+  using fp_type = typename Gate::fp_type;
+
+  // Probability of exchanging energy with the environment.
+  double p = 0.5;
+
+  double p1 = p * (1 - g);
+  double p2 = (1 - p) * (1 - g);
+  double p3 = 0;
+
+  fp_type t1 = std::sqrt(p);
+  fp_type r1 = std::sqrt(p * (1 - g));
+  fp_type s1 = std::sqrt(p * g);
+  fp_type t2 = std::sqrt(1 - p);
+  fp_type r2 = std::sqrt((1 - p) * (1 - g));
+  fp_type s2 = std::sqrt((1 - p) * g);
+
+  auto normal = KrausOperator<Gate>::kNormal;
+
+  using M = Cirq::MatrixGate1<fp_type>;
+
+  ncircuit.channels.push_back(
+      {{normal, 0, p1 * p1,
+        {M::Create(time, 0, {t1, 0, 0, 0, 0, 0, r1, 0}),
+         M::Create(time, 1, {t1, 0, 0, 0, 0, 0, r1, 0})}},
+       {normal, 0, p1 * p2,
+        {M::Create(time, 0, {t1, 0, 0, 0, 0, 0, r1, 0}),
+         M::Create(time, 1, {r2, 0, 0, 0, 0, 0, t2, 0})}},
+       {normal, 0, p1 * p3,
+        {M::Create(time, 0, {t1, 0, 0, 0, 0, 0, r1, 0}),
+         M::Create(time, 1, {0, 0, s1, 0, 0, 0, 0, 0})}},
+       {normal, 0, p1 * p3,
+        {M::Create(time, 0, {t1, 0, 0, 0, 0, 0, r1, 0}),
+         M::Create(time, 1, {0, 0, 0, 0, s2, 0, 0, 0})}},
+
+       {normal, 0, p2 * p1,
+        {M::Create(time, 0, {r2, 0, 0, 0, 0, 0, t2, 0}),
+         M::Create(time, 1, {t1, 0, 0, 0, 0, 0, r1, 0})}},
+       {normal, 0, p2 * p2,
+        {M::Create(time, 0, {r2, 0, 0, 0, 0, 0, t2, 0}),
+         M::Create(time, 1, {r2, 0, 0, 0, 0, 0, t2, 0})}},
+       {normal, 0, p2 * p3,
+        {M::Create(time, 0, {r2, 0, 0, 0, 0, 0, t2, 0}),
+         M::Create(time, 1, {0, 0, s1, 0, 0, 0, 0, 0})}},
+       {normal, 0, p2 * p3,
+        {M::Create(time, 0, {r2, 0, 0, 0, 0, 0, t2, 0}),
+         M::Create(time, 1, {0, 0, 0, 0, s2, 0, 0, 0})}},
+
+       {normal, 0, p3 * p1,
+        {M::Create(time, 0, {0, 0, s1, 0, 0, 0, 0, 0}),
+         M::Create(time, 1, {t1, 0, 0, 0, 0, 0, r1, 0})}},
+       {normal, 0, p3 * p2,
+        {M::Create(time, 0, {0, 0, s1, 0, 0, 0, 0, 0}),
+         M::Create(time, 1, {r2, 0, 0, 0, 0, 0, t2, 0})}},
+       {normal, 0, p3 * p3,
+        {M::Create(time, 0, {0, 0, s1, 0, 0, 0, 0, 0}),
+         M::Create(time, 1, {0, 0, s1, 0, 0, 0, 0, 0})}},
+       {normal, 0, p3 * p3,
+        {M::Create(time, 0, {0, 0, s1, 0, 0, 0, 0, 0}),
+         M::Create(time, 1, {0, 0, 0, 0, s2, 0, 0, 0})}},
+
+       {normal, 0, p3 * p1,
+        {M::Create(time, 0, {0, 0, 0, 0, s2, 0, 0, 0}),
+         M::Create(time, 1, {t1, 0, 0, 0, 0, 0, r1, 0})}},
+       {normal, 0, p3 * p2,
+        {M::Create(time, 0, {0, 0, 0, 0, s2, 0, 0, 0}),
+         M::Create(time, 1, {r2, 0, 0, 0, 0, 0, t2, 0})}},
+       {normal, 0, p3 * p3,
+        {M::Create(time, 0, {0, 0, 0, 0, s2, 0, 0, 0}),
+         M::Create(time, 1, {0, 0, s1, 0, 0, 0, 0, 0})}},
+       {normal, 0, p3 * p3,
+        {M::Create(time, 0, {0, 0, 0, 0, s2, 0, 0, 0}),
+         M::Create(time, 1, {0, 0, 0, 0, s2, 0, 0, 0})}},
+      });
+
+  for (auto& kop : ncircuit.channels.back()) {
+    kop.CalculateKdKMatrix();
+  }
 }
 
 template <typename Gate, typename AddNoise1, typename AddNoise2>
@@ -234,7 +331,6 @@ void RunOnceRepeatedly(const Factory& factory,
   Simulator simulator = factory.CreateSimulator();
   StateSpace state_space = factory.CreateStateSpace();
 
-  State scratch = state_space.Null();
   State state = state_space.Create(num_qubits);
   EXPECT_FALSE(state_space.IsNull(state));
 
@@ -251,7 +347,7 @@ void RunOnceRepeatedly(const Factory& factory,
     state_space.SetStateZero(state);
 
     EXPECT_TRUE(QTSimulator::RunOnce(
-        param, ncircuit, i, state_space, simulator, scratch, state, stat));
+        param, ncircuit, i, state_space, simulator, state, stat));
 
     EXPECT_EQ(state_pointer, state.get());
 
@@ -361,9 +457,17 @@ for key, val in sorted(res.histogram(key='m').items()):
 
   using Gate = Cirq::GateCirq<typename Factory::fp_type>;
 
-  auto ncircuit = GenerateNoisyCircuit<Gate>(0.1, AddGenAmplDumpNoise1<Gate>,
-                                             AddGenAmplDumpNoise2<Gate>);
-  RunOnceRepeatedly(factory, ncircuit, expected_results);
+  {
+    auto ncircuit = GenerateNoisyCircuit<Gate>(0.1, AddGenAmplDumpNoise1<Gate>,
+                                               AddGenAmplDumpNoise2<Gate>);
+    RunOnceRepeatedly(factory, ncircuit, expected_results);
+  }
+
+  {
+    auto ncircuit = GenerateNoisyCircuit<Gate>(0.1, AddGenAmplDumpNoise1<Gate>,
+                                               AddGenAmplDumpNoise2Alt<Gate>);
+    RunOnceRepeatedly(factory, ncircuit, expected_results);
+  }
 }
 
 template <typename Factory>
@@ -508,7 +612,6 @@ void TestCleanCircuit(const Factory& factory) {
     ApplyGate(simulator, gate, state);
   }
 
-  State scratch = state_space.Null();
   State nstate = state_space.Create(num_qubits);
 
   EXPECT_FALSE(state_space.IsNull(nstate));
@@ -522,7 +625,7 @@ void TestCleanCircuit(const Factory& factory) {
   // Run quantum trajectory simulator.
   EXPECT_TRUE(QTSimulator::RunOnce(param, num_qubits, ncircuit.channels.begin(),
                                    ncircuit.channels.end(), 0, state_space,
-                                   simulator, scratch, nstate, stat));
+                                   simulator, nstate, stat));
 
   EXPECT_EQ(stat.size(), 0);
 
@@ -565,7 +668,6 @@ void TestInitialState(const Factory& factory) {
   Simulator simulator = factory.CreateSimulator();
   StateSpace state_space = factory.CreateStateSpace();
 
-  State scratch = state_space.Null();
   State state = state_space.Create(num_qubits);
 
   EXPECT_FALSE(state_space.IsNull(state));
@@ -578,7 +680,7 @@ void TestInitialState(const Factory& factory) {
   }
 
   EXPECT_TRUE(QTSimulator::RunOnce(
-      param, ncircuit, 0, state_space, simulator, scratch, state, stat));
+      param, ncircuit, 0, state_space, simulator, state, stat));
 
   // Expect reversed order of amplitudes.
   for (unsigned i = 0; i < 8; ++i) {
@@ -625,7 +727,6 @@ void TestUncomputeFinalState(const Factory& factory) {
   Simulator simulator = factory.CreateSimulator();
   StateSpace state_space = factory.CreateStateSpace();
 
-  State scratch = state_space.Null();
   State state = state_space.Create(num_qubits);
 
   EXPECT_FALSE(state_space.IsNull(state));
@@ -638,8 +739,8 @@ void TestUncomputeFinalState(const Factory& factory) {
   std::vector<uint64_t> stat;
 
   // Run one trajectory.
-  EXPECT_TRUE(QTSimulator::RunOnce(param, ncircuit, 0, state_space, simulator,
-                                   scratch, state, stat));
+  EXPECT_TRUE(QTSimulator::RunOnce(
+      param, ncircuit, 0, state_space, simulator, state, stat));
 
   EXPECT_EQ(ncircuit.channels.size(), stat.size());
 

From bc9cd459a6e279c171512123e8f40a481d56a902 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Fri, 4 Feb 2022 18:44:18 +0100
Subject: [PATCH 200/246] Reuse quantum trajectory results.

---
 apps/qsim_qtrajectory_cuda.cu        |  26 ++-
 lib/qtrajectory.h                    |  84 +++++---
 pybind_interface/pybind_main.cpp     |  18 +-
 tests/BUILD                          |   1 +
 tests/channels_cirq_test.cc          |   6 +-
 tests/qtrajectory_avx_test.cc        |   4 +
 tests/qtrajectory_cuda_test.cu       |   8 +
 tests/qtrajectory_custatevec_test.cu |   4 +
 tests/qtrajectory_testfixture.h      | 300 +++++++++++++++++++++++++--
 9 files changed, 387 insertions(+), 64 deletions(-)

diff --git a/apps/qsim_qtrajectory_cuda.cu b/apps/qsim_qtrajectory_cuda.cu
index 223add5e..65fe1cd3 100644
--- a/apps/qsim_qtrajectory_cuda.cu
+++ b/apps/qsim_qtrajectory_cuda.cu
@@ -251,6 +251,7 @@ int main(int argc, char* argv[]) {
   typename QTSimulator::Parameter param3;
   param3.max_fused_size = opt.max_fused_size;
   param3.verbosity = opt.verbosity;
+  param3.apply_last_deferred_ops = true;
 
   auto channel1 = AmplitudeDampingChannel<fp_type>(opt.amplitude_damp_const);
   auto channel2 = PhaseDampingChannel<fp_type>(opt.phase_damp_const);
@@ -262,6 +263,11 @@ int main(int argc, char* argv[]) {
   std::vector<std::vector<std::vector<std::complex<double>>>> results;
   results.reserve(opt.num_trajectories);
 
+  QTSimulator::Stat stat;
+
+  using CleanResults = std::vector<std::vector<std::complex<double>>>;
+  CleanResults primary_results(noisy_circuits.size());
+
   for (unsigned i = 0; i < opt.num_trajectories; ++i) {
     results.push_back({});
     results[i].reserve(noisy_circuits.size());
@@ -271,7 +277,6 @@ int main(int argc, char* argv[]) {
     auto seed = noisy_circuits.size() * (i + opt.traj0);
 
     for (unsigned s = 0; s < noisy_circuits.size(); ++s) {
-      std::vector<uint64_t> stat;
       if (!QTSimulator::RunOnce(param3, noisy_circuits[s], seed++,
                                 state_space, simulator, state, stat)) {
         return 1;
@@ -280,9 +285,22 @@ int main(int argc, char* argv[]) {
       results[i].push_back({});
       results[i][s].reserve(observables.size());
 
-      for (const auto& obs : observables) {
-        results[i][s].push_back(
-            ExpectationValue<IO, Fuser>(obs, simulator, state));
+      primary_results[s].reserve(observables.size());
+
+      if (stat.primary && !primary_results[s].empty()) {
+        for (std::size_t k = 0; k < observables.size(); ++k) {
+          results[i][s].push_back(primary_results[s][k]);
+        }
+      } else {
+        for (const auto& obs : observables) {
+          auto result = ExpectationValue<IO, Fuser>(obs, simulator, state);
+          results[i][s].push_back(result);
+
+          if (stat.primary) {
+            primary_results[s].push_back(result);
+            param3.apply_last_deferred_ops = false;
+          }
+        }
       }
     }
   }
diff --git a/lib/qtrajectory.h b/lib/qtrajectory.h
index 1b5c7555..bf70d630 100644
--- a/lib/qtrajectory.h
+++ b/lib/qtrajectory.h
@@ -55,6 +55,29 @@ class QuantumTrajectorySimulator {
      * If true, normalize the state vector before performing measurements.
      */
     bool normalize_before_mea_gates = true;
+    /**
+     * If false, do not apply deferred operators after the main loop.
+     * This can be used to speed up simulations of circuits with weak noise
+     * and without measurements by reusing the results for the "primary" noise
+     * realization, that is the noise realization in which the  "primary"
+     * (highest probability) Kraus operators are sampled in each channel.
+     * The primary Kraus operators should be first in their respective channels.
+     */
+    bool apply_last_deferred_ops = true;
+  };
+
+  /**
+   * Struct with statistics to populate by RunBatch and RunOnce methods.
+   */
+  struct Stat {
+    /**
+     * Indices of sampled Kraus operator indices and/or measured bitstrings.
+     */
+    std::vector<uint64_t> samples;
+    /**
+     * True if the "primary" noise realization is sampled, false otherwise.
+     */
+    bool primary;
   };
 
   /**
@@ -70,8 +93,7 @@ class QuantumTrajectorySimulator {
    *   computing expectation values, etc). This function should have three
    *   required parameters [repetition ID (uint64_t), final state vector
    *   (const State&), statistics of sampled Kraus operator indices and/or
-   *   measured bitstrings (const std::vector<uint64_t>&)] and any number of
-   *   optional parameters.
+   *   measured bitstrings (const Stat&)] and any number of optional parameters.
    * @param args Optional arguments for the 'measure' function.
    * @return True if the simulation completed successfully; false otherwise.
    */
@@ -100,8 +122,7 @@ class QuantumTrajectorySimulator {
    *   computing expectation values, etc). This function should have three
    *   required parameters [repetition ID (uint64_t), final state vector
    *   (const State&), statistics of sampled Kraus operator indices and/or
-   *   measured bitstrings (const std::vector<uint64_t>&)] and any number of
-   *   optional parameters.
+   *   measured bitstrings (const Stat&)] and any number of optional parameters.
    * @param args Optional arguments for the 'measure' function.
    * @return True if the simulation completed successfully; false otherwise.
    */
@@ -117,18 +138,26 @@ class QuantumTrajectorySimulator {
 
     State state = state_space.Null();
 
-    std::vector<uint64_t> stat;
+    Stat stat;
+    bool had_primary_realization = false;
 
     for (uint64_t r = r0; r < r1; ++r) {
       if (!state_space.IsNull(state)) {
         state_space.SetStateZero(state);
       }
 
-      if (!RunIteration(param, num_qubits, cbeg, cend, r,
-                        state_space, simulator, gates, state, stat)) {
+      bool apply_last_deferred_ops =
+          param.apply_last_deferred_ops || !had_primary_realization;
+
+      if (!RunIteration(param, apply_last_deferred_ops, num_qubits, cbeg, cend,
+                        r, state_space, simulator, gates, state, stat)) {
         return false;
       }
 
+      if (stat.primary && !had_primary_realization) {
+        had_primary_realization = true;
+      }
+
       measure(r, state, stat, args...);
     }
 
@@ -151,7 +180,7 @@ class QuantumTrajectorySimulator {
   static bool RunOnce(const Parameter& param,
                       const NoisyCircuit<Gate>& circuit, uint64_t r,
                       const StateSpace& state_space, const Simulator& simulator,
-                      State& state, std::vector<uint64_t>& stat) {
+                      State& state, Stat& stat) {
     return RunOnce(param, circuit.num_qubits, circuit.channels.begin(),
                    circuit.channels.end(), r, state_space, simulator,
                    state, stat);
@@ -176,13 +205,12 @@ class QuantumTrajectorySimulator {
                       ncircuit_iterator<Gate> cbeg,
                       ncircuit_iterator<Gate> cend,
                       uint64_t r, const StateSpace& state_space,
-                      const Simulator& simulator, State& state,
-                      std::vector<uint64_t>& stat) {
+                      const Simulator& simulator, State& state, Stat& stat) {
     std::vector<const Gate*> gates;
     gates.reserve(4 * std::size_t(cend - cbeg));
 
-    if (!RunIteration(param, num_qubits, cbeg, cend, r,
-                      state_space, simulator, gates, state, stat)) {
+    if (!RunIteration(param, param.apply_last_deferred_ops, num_qubits, cbeg,
+                      cend, r, state_space, simulator, gates, state, stat)) {
       return false;
     }
 
@@ -190,16 +218,17 @@ class QuantumTrajectorySimulator {
   }
 
  private:
-  static bool RunIteration(const Parameter& param, unsigned num_qubits,
+  static bool RunIteration(const Parameter& param,
+                           bool apply_last_deferred_ops, unsigned num_qubits,
                            ncircuit_iterator<Gate> cbeg,
                            ncircuit_iterator<Gate> cend,
                            uint64_t rep, const StateSpace& state_space,
                            const Simulator& simulator,
                            std::vector<const Gate*>& gates,
-                           State& state, std::vector<uint64_t>& stat) {
+                           State& state, Stat& stat) {
     if (param.collect_kop_stat || param.collect_mea_stat) {
-      stat.reserve(std::size_t(cend - cbeg));
-      stat.resize(0);
+      stat.samples.reserve(std::size_t(cend - cbeg));
+      stat.samples.resize(0);
     }
 
     if (state_space.IsNull(state)) {
@@ -212,12 +241,12 @@ class QuantumTrajectorySimulator {
     }
 
     gates.resize(0);
-    stat.resize(0);
 
     RGen rgen(rep);
     std::uniform_real_distribution<double> distr(0.0, 1.0);
 
     bool unitary = true;
+    stat.primary = true;
 
     for (auto it = cbeg; it != cend; ++it) {
       const auto& channel = *it;
@@ -243,6 +272,8 @@ class QuantumTrajectorySimulator {
 
         CollectStat(param.collect_mea_stat, mresult.bits, stat);
 
+        stat.primary = false;
+
         continue;
       }
 
@@ -310,11 +341,13 @@ class QuantumTrajectorySimulator {
       }
     }
 
-    if (!ApplyDeferredOps(param, num_qubits, simulator, gates, state)) {
-      return false;
-    }
+    if (apply_last_deferred_ops || !stat.primary) {
+      if (!ApplyDeferredOps(param, num_qubits, simulator, gates, state)) {
+        return false;
+      }
 
-    NormalizeState(!unitary, state_space, unitary, state);
+      NormalizeState(!unitary, state_space, unitary, state);
+    }
 
     return true;
   }
@@ -368,10 +401,13 @@ class QuantumTrajectorySimulator {
     }
   }
 
-  static void CollectStat(bool collect_stat, uint64_t i,
-                          std::vector<uint64_t>& stat) {
+  static void CollectStat(bool collect_stat, uint64_t i, Stat& stat) {
     if (collect_stat) {
-      stat.push_back(i);
+      stat.samples.push_back(i);
+    }
+
+    if (i != 0) {
+      stat.primary = false;
     }
   }
 
diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index e6788088..a6cfb812 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -481,8 +481,7 @@ std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options) {
   StateSpace state_space = factory.CreateStateSpace();
 
   auto measure = [&bitstrings, &ncircuit, &amplitudes, &state_space](
-                  unsigned k, const State &state,
-                  std::vector<uint64_t>& stat) {
+                  unsigned k, const State &state, Runner::Stat& stat) {
     for (const auto &b : bitstrings) {
       amplitudes.push_back(state_space.GetAmpl(state, b));
     }
@@ -711,7 +710,7 @@ class SimulatorHelper {
     bool result = false;
 
     if (is_noisy) {
-      std::vector<uint64_t> stat;
+      NoisyRunner::Stat stat;
       auto params = get_noisy_params();
 
       Simulator simulator = factory.CreateSimulator();
@@ -730,7 +729,7 @@ class SimulatorHelper {
     bool result = false;
 
     if (is_noisy) {
-      std::vector<uint64_t> stat;
+      NoisyRunner::Stat stat;
       auto params = get_noisy_params();
       Simulator simulator = factory.CreateSimulator();
       StateSpace state_space = factory.CreateStateSpace();
@@ -1051,24 +1050,23 @@ std::vector<unsigned> qtrajectory_sample(const py::dict &options) {
   std::vector<std::vector<unsigned>> results;
 
   auto measure = [&results, &ncircuit, &state_space](
-                  unsigned k, const State &state,
-                  std::vector<uint64_t>& stat) {
+                  unsigned k, const State& state, Runner::Stat& stat) {
     // Converts stat (which matches the MeasurementResult 'bits' field) into
     // bitstrings matching the MeasurementResult 'bitstring' field.
     unsigned idx = 0;
     for (const auto& channel : ncircuit.channels) {
       if (channel[0].kind != gate::kMeasurement)
         continue;
-      for (const auto &op : channel[0].ops) {
+      for (const auto& op : channel[0].ops) {
         std::vector<unsigned> bitstring;
-        uint64_t val = stat[idx];
-        for (const auto &q : op.qubits) {
+        uint64_t val = stat.samples[idx];
+        for (const auto& q : op.qubits) {
           bitstring.push_back((val >> q) & 1);
         }
         results.push_back(bitstring);
 
         idx += 1;
-        if (idx >= stat.size())
+        if (idx >= stat.samples.size())
           return;
       }
     }
diff --git a/tests/BUILD b/tests/BUILD
index dadd7751..a6c05c96 100644
--- a/tests/BUILD
+++ b/tests/BUILD
@@ -217,6 +217,7 @@ cc_library(
         "//lib:channel",
         "//lib:channels_cirq",
         "//lib:circuit_noisy",
+        "//lib:expect",
         "//lib:fuser_mqubit",
         "//lib:gate_appl",
         "//lib:gates_cirq",
diff --git a/tests/channels_cirq_test.cc b/tests/channels_cirq_test.cc
index b7bdade5..dedb922e 100644
--- a/tests/channels_cirq_test.cc
+++ b/tests/channels_cirq_test.cc
@@ -68,10 +68,10 @@ void RunBatch(const NoisyCircuit<Gate>& ncircuit,
   unsigned num_threads = 1;
 
   auto measure = [](uint64_t r, const State& state,
-                    const std::vector<uint64_t>& stat,
+                    const QTSimulator::Stat& stat,
                     std::vector<unsigned>& histogram) {
-    ASSERT_EQ(stat.size(), 1);
-    ++histogram[stat[0]];
+    ASSERT_EQ(stat.samples.size(), 1);
+    ++histogram[stat.samples[0]];
   };
 
   std::vector<unsigned> histogram(1 << num_qubits, 0);
diff --git a/tests/qtrajectory_avx_test.cc b/tests/qtrajectory_avx_test.cc
index b4a31baa..2dc126d3 100644
--- a/tests/qtrajectory_avx_test.cc
+++ b/tests/qtrajectory_avx_test.cc
@@ -44,6 +44,10 @@ TEST(QTrajectoryAVXTest, GenDump) {
   TestGenDump(qsim::Factory<SequentialFor>());
 }
 
+TEST(QTrajectoryAVXTest, ReusingResults) {
+  TestReusingResults(qsim::Factory<SequentialFor>());
+}
+
 TEST(QTrajectoryAVXTest, CollectKopStat) {
   TestCollectKopStat(qsim::Factory<SequentialFor>());
 }
diff --git a/tests/qtrajectory_cuda_test.cu b/tests/qtrajectory_cuda_test.cu
index 66c31acb..730ff7ed 100644
--- a/tests/qtrajectory_cuda_test.cu
+++ b/tests/qtrajectory_cuda_test.cu
@@ -58,6 +58,14 @@ TEST(QTrajectoryCUDATest, GenDump) {
   TestGenDump(factory);
 }
 
+TEST(QTrajectoryCUDATest, ReusingResults) {
+  using Factory = qsim::Factory<float>;
+  Factory::StateSpace::Parameter param1;
+  Factory::Simulator::Parameter param2;
+  Factory factory(param1, param2);
+  TestReusingResults(factory);
+}
+
 TEST(QTrajectoryCUDATest, CollectKopStat) {
   using Factory = qsim::Factory<float>;
   Factory::StateSpace::Parameter param1;
diff --git a/tests/qtrajectory_custatevec_test.cu b/tests/qtrajectory_custatevec_test.cu
index c8a2958d..ca7e823b 100644
--- a/tests/qtrajectory_custatevec_test.cu
+++ b/tests/qtrajectory_custatevec_test.cu
@@ -59,6 +59,10 @@ TEST(QTrajectoryCuStateVecTest, GenDump) {
   TestGenDump(qsim::Factory<float>());
 }
 
+TEST(QTrajectoryCuStateVecTest, ReusingResults) {
+  TestReusingResults(qsim::Factory<float>());
+}
+
 TEST(QTrajectoryCuStateVecTest, CollectKopStat) {
   TestCollectKopStat(qsim::Factory<float>());
 }
diff --git a/tests/qtrajectory_testfixture.h b/tests/qtrajectory_testfixture.h
index 02588c1b..786d997c 100644
--- a/tests/qtrajectory_testfixture.h
+++ b/tests/qtrajectory_testfixture.h
@@ -24,6 +24,7 @@
 #include "../lib/channel.h"
 #include "../lib/channels_cirq.h"
 #include "../lib/circuit_noisy.h"
+#include "../lib/expect.h"
 #include "../lib/fuser_mqubit.h"
 #include "../lib/gate_appl.h"
 #include "../lib/gates_cirq.h"
@@ -238,9 +239,66 @@ void AddGenAmplDumpNoise2Alt(
   }
 }
 
+template <typename Gate>
+void AddAmplDumpNoise1(
+    unsigned time, unsigned q, double g, NoisyCircuit<Gate>& ncircuit) {
+  using fp_type = typename Gate::fp_type;
+
+  double p1 = 1 - g;
+  double p2 = 0;
+
+  fp_type r = std::sqrt(p1);
+  fp_type s = std::sqrt(g);
+
+  auto normal = KrausOperator<Gate>::kNormal;
+
+  using M = Cirq::MatrixGate1<fp_type>;
+
+  ncircuit.channels.push_back(
+      {{normal, 0, p1, {M::Create(time, q, {1, 0, 0, 0, 0, 0, r, 0})}},
+       {normal, 0, p2, {M::Create(time, q, {0, 0, s, 0, 0, 0, 0, 0})}}});
+
+  for (auto& kop : ncircuit.channels.back()) {
+    kop.CalculateKdKMatrix();
+  }
+}
+
+template <typename Gate>
+void AddAmplDumpNoise2(
+    unsigned time, double g, NoisyCircuit<Gate>& ncircuit) {
+  using fp_type = typename Gate::fp_type;
+
+  double p1 = 1 - g;
+  double p2 = 0;
+
+  fp_type r = std::sqrt(p1);
+  fp_type s = std::sqrt(g);
+
+  auto normal = KrausOperator<Gate>::kNormal;
+
+  using M = Cirq::MatrixGate1<fp_type>;
+
+  ncircuit.channels.push_back(
+      {{normal, 0, p1, {M::Create(time, 0, {1, 0, 0, 0, 0, 0, r, 0})}},
+       {normal, 0, p2, {M::Create(time, 0, {0, 0, s, 0, 0, 0, 0, 0})}}});
+
+  for (auto& kop : ncircuit.channels.back()) {
+    kop.CalculateKdKMatrix();
+  }
+
+  ncircuit.channels.push_back(
+      {{normal, 0, p1, {M::Create(time, 1, {1, 0, 0, 0, 0, 0, r, 0})}},
+       {normal, 0, p2, {M::Create(time, 1, {0, 0, s, 0, 0, 0, 0, 0})}}});
+
+  for (auto& kop : ncircuit.channels.back()) {
+    kop.CalculateKdKMatrix();
+  }
+}
+
 template <typename Gate, typename AddNoise1, typename AddNoise2>
 NoisyCircuit<Gate> GenerateNoisyCircuit(
-    double p, AddNoise1&& add_noise1, AddNoise2&& add_noise2) {
+    double p, AddNoise1&& add_noise1, AddNoise2&& add_noise2,
+    bool add_measurement = true) {
   using fp_type = typename Gate::fp_type;
 
   NoisyCircuit<Gate> ncircuit;
@@ -273,9 +331,12 @@ NoisyCircuit<Gate> GenerateNoisyCircuit(
   add_noise1(9, 1, p, ncircuit);
   ncircuit.channels.push_back({{normal, 1, 1.0, {IS::Create(10, 0, 1)}}});
   add_noise2(11, p, ncircuit);
-  ncircuit.channels.push_back({{KrausOperator<Gate>::kMeasurement, 1, 1.0,
-                              {gate::Measurement<Gate>::Create(12, {0, 1})}}});
-  add_noise2(13, p, ncircuit);
+  if (add_measurement) {
+    ncircuit.channels.push_back(
+        {{KrausOperator<Gate>::kMeasurement, 1, 1.0,
+          {gate::Measurement<Gate>::Create(12, {0, 1})}}});
+    add_noise2(13, p, ncircuit);
+  }
 
   return ncircuit;
 }
@@ -293,10 +354,10 @@ void RunBatch(const Factory& factory, const NoisyCircuit<Gate>& ncircuit,
   unsigned num_reps = 25000;
 
   auto measure = [](uint64_t r, const State& state,
-                    const std::vector<uint64_t>& stat,
+                    const typename QTSimulator::Stat& stat,
                     std::vector<unsigned>& histogram) {
-    ASSERT_EQ(stat.size(), 1);
-    ++histogram[stat[0]];
+    ASSERT_EQ(stat.samples.size(), 1);
+    ++histogram[stat.samples[0]];
   };
 
   std::vector<unsigned> histogram(1 << num_qubits, 0);
@@ -334,9 +395,7 @@ void RunOnceRepeatedly(const Factory& factory,
   State state = state_space.Create(num_qubits);
   EXPECT_FALSE(state_space.IsNull(state));
 
-  auto state_pointer = state.get();
-
-  std::vector<uint64_t> stat;
+  typename QTSimulator::Stat stat;
 
   std::vector<unsigned> histogram(1 << num_qubits, 0);
 
@@ -349,10 +408,8 @@ void RunOnceRepeatedly(const Factory& factory,
     EXPECT_TRUE(QTSimulator::RunOnce(
         param, ncircuit, i, state_space, simulator, state, stat));
 
-    EXPECT_EQ(state_pointer, state.get());
-
-    ASSERT_EQ(stat.size(), 1);
-    ++histogram[stat[0]];
+    ASSERT_EQ(stat.samples.size(), 1);
+    ++histogram[stat.samples[0]];
   }
 
   for (std::size_t i = 0; i < histogram.size(); ++i) {
@@ -360,6 +417,181 @@ void RunOnceRepeatedly(const Factory& factory,
   }
 }
 
+template <typename Factory, typename Gate>
+std::vector<std::complex<double>> ExpValsRunBatch(
+    const Factory& factory, const NoisyCircuit<Gate>& ncircuit,
+    bool reuse_results) {
+  using Simulator = typename Factory::Simulator;
+  using StateSpace = typename Factory::StateSpace;
+  using State = typename StateSpace::State;
+  using Fuser = MultiQubitGateFuser<IO, Gate>;
+  using QTSimulator = QuantumTrajectorySimulator<IO, Gate, MultiQubitGateFuser,
+                                                 Simulator>;
+
+  unsigned num_qubits = 2;
+  unsigned num_reps = 25000;
+
+  Simulator simulator = factory.CreateSimulator();
+  StateSpace state_space = factory.CreateStateSpace();
+
+  State state = state_space.Create(num_qubits);
+  EXPECT_FALSE(state_space.IsNull(state));
+
+  typename QTSimulator::Stat stat;
+
+  typename QTSimulator::Parameter param;
+  param.apply_last_deferred_ops = !reuse_results;
+
+  using Observables = std::vector<std::vector<qsim::OpString<Gate>>>;
+  Observables observables;
+  observables.reserve(num_qubits);
+
+  using rx = qsim::Cirq::rx<typename Gate::fp_type>;
+
+  for (unsigned q = 0; q < num_qubits; ++q) {
+    observables.push_back({{{1.0, 0.0}, {rx::Create(0, q, 1.7 + 0.6 * q)}}});
+  }
+
+  using TrajResults = std::vector<std::vector<std::complex<double>>>;
+  TrajResults traj_results(observables.size());
+
+  for (std::size_t k = 0; k < observables.size(); ++k) {
+    traj_results[k].reserve(num_reps);
+  }
+
+  std::vector<std::complex<double>> primary_results;
+  primary_results.reserve(observables.size());
+
+  auto measure = [](uint64_t r, const State& state,
+                    const typename QTSimulator::Stat& stat,
+                    const Simulator& simulator, bool reuse_results,
+                    const Observables& observables,
+                    std::vector<std::complex<double>>& primary_results,
+                    TrajResults& traj_results) {
+    if (reuse_results && stat.primary && !primary_results.empty()) {
+      for (std::size_t k = 0; k < observables.size(); ++k) {
+        traj_results[k].push_back(primary_results[k]);
+      }
+    } else {
+      for (std::size_t k = 0; k < observables.size(); ++k) {
+        const auto& obs = observables[k];
+        auto result = ExpectationValue<IO, Fuser>(obs, simulator, state);
+        traj_results[k].push_back(result);
+
+        if (reuse_results && stat.primary) {
+          primary_results.push_back(result);
+        }
+      }
+    }
+  };
+
+  EXPECT_TRUE(QTSimulator::RunBatch(param, ncircuit, 0, num_reps, state_space,
+                                    simulator, measure, simulator,
+                                    reuse_results, observables, primary_results,
+                                    traj_results));
+
+  std::vector<std::complex<double>> results;
+  results.reserve(observables.size());
+
+  double inverse_num_reps = 1.0 / num_reps;
+
+  for (std::size_t k = 0; k < observables.size(); ++k) {
+    std::complex<double> sum = 0;
+    for (unsigned i = 0; i < num_reps; ++i) {
+      sum += traj_results[k][i];
+    }
+
+    results.push_back(inverse_num_reps * sum);
+  }
+
+  return results;
+}
+
+template <typename Factory, typename Gate>
+std::vector<std::complex<double>> ExpValsRunOnceRepeatedly(
+    const Factory& factory, const NoisyCircuit<Gate>& ncircuit,
+    bool reuse_results) {
+  using Simulator = typename Factory::Simulator;
+  using StateSpace = typename Factory::StateSpace;
+  using State = typename StateSpace::State;
+  using Fuser = MultiQubitGateFuser<IO, Gate>;
+  using QTSimulator = QuantumTrajectorySimulator<IO, Gate, MultiQubitGateFuser,
+                                                 Simulator>;
+
+  unsigned num_qubits = 2;
+  unsigned num_reps = 25000;
+
+  Simulator simulator = factory.CreateSimulator();
+  StateSpace state_space = factory.CreateStateSpace();
+
+  State state = state_space.Create(num_qubits);
+  EXPECT_FALSE(state_space.IsNull(state));
+
+  typename QTSimulator::Stat stat;
+
+  typename QTSimulator::Parameter param;
+  param.apply_last_deferred_ops = true;
+
+  std::vector<std::vector<qsim::OpString<Gate>>> observables;
+  observables.reserve(num_qubits);
+
+  using rx = qsim::Cirq::rx<typename Gate::fp_type>;
+
+  for (unsigned q = 0; q < num_qubits; ++q) {
+    observables.push_back({{{1.0, 0.0}, {rx::Create(0, q, 1.7 + 0.6 * q)}}});
+  }
+
+  using TrajResults = std::vector<std::vector<std::complex<double>>>;
+  TrajResults traj_results(observables.size());
+
+  for (std::size_t k = 0; k < observables.size(); ++k) {
+    traj_results[k].reserve(num_reps);
+  }
+
+  std::vector<std::complex<double>> primary_results;
+  primary_results.reserve(observables.size());
+
+  for (unsigned i = 0; i < num_reps; ++i) {
+    state_space.SetStateZero(state);
+
+    EXPECT_TRUE(QTSimulator::RunOnce(
+        param, ncircuit, i, state_space, simulator, state, stat));
+
+    if (reuse_results && stat.primary && !primary_results.empty()) {
+      for (std::size_t k = 0; k < observables.size(); ++k) {
+        traj_results[k].push_back(primary_results[k]);
+      }
+    } else {
+      for (std::size_t k = 0; k < observables.size(); ++k) {
+        const auto& obs = observables[k];
+        auto result = ExpectationValue<IO, Fuser>(obs, simulator, state);
+        traj_results[k].push_back(result);
+
+        if (reuse_results && stat.primary) {
+          primary_results.push_back(result);
+          param.apply_last_deferred_ops = false;
+        }
+      }
+    }
+  }
+
+  std::vector<std::complex<double>> results;
+  results.reserve(observables.size());
+
+  double inverse_num_reps = 1.0 / num_reps;
+
+  for (std::size_t k = 0; k < observables.size(); ++k) {
+    std::complex<double> sum = 0;
+    for (unsigned i = 0; i < num_reps; ++i) {
+      sum += traj_results[k][i];
+    }
+
+    results.push_back(inverse_num_reps * sum);
+  }
+
+  return results;
+}
+
 template <typename Factory>
 void TestBitFlip(const Factory& factory) {
 /* The expected results are obtained with the following Cirq code.
@@ -470,6 +702,28 @@ for key, val in sorted(res.histogram(key='m').items()):
   }
 }
 
+template <typename Factory>
+void TestReusingResults(const Factory& factory) {
+  using Gate = Cirq::GateCirq<typename Factory::fp_type>;
+
+  auto ncircuit = GenerateNoisyCircuit<Gate>(0.02, AddAmplDumpNoise1<Gate>,
+                                             AddAmplDumpNoise2<Gate>, false);
+
+  auto results1 = ExpValsRunOnceRepeatedly(factory, ncircuit, false);
+  auto results2 = ExpValsRunOnceRepeatedly(factory, ncircuit, true);
+  auto results3 = ExpValsRunBatch(factory, ncircuit, false);
+  auto results4 = ExpValsRunBatch(factory, ncircuit, true);
+
+  for (std::size_t k = 0; k < results1.size(); ++k) {
+    EXPECT_NEAR(std::real(results1[k]), std::real(results2[k]), 1e-8);
+    EXPECT_NEAR(std::imag(results1[k]), std::imag(results2[k]), 1e-8);
+    EXPECT_NEAR(std::real(results1[k]), std::real(results3[k]), 1e-8);
+    EXPECT_NEAR(std::imag(results1[k]), std::imag(results3[k]), 1e-8);
+    EXPECT_NEAR(std::real(results1[k]), std::real(results4[k]), 1e-8);
+    EXPECT_NEAR(std::imag(results1[k]), std::imag(results4[k]), 1e-8);
+  }
+}
+
 template <typename Factory>
 void TestCollectKopStat(const Factory& factory) {
   using Simulator = typename Factory::Simulator;
@@ -515,11 +769,11 @@ void TestCollectKopStat(const Factory& factory) {
                       {normal, 1, p2, {X::Create(1, 3)}}});
 
   auto measure = [](uint64_t r, const State& state,
-                    const std::vector<uint64_t>& stat,
+                    const typename QTSimulator::Stat& stat,
                     std::vector<std::vector<unsigned>>& histogram) {
-    ASSERT_EQ(stat.size(), histogram.size());
+    ASSERT_EQ(stat.samples.size(), histogram.size());
     for (std::size_t i = 0; i < histogram.size(); ++i) {
-      ++histogram[i][stat[i]];
+      ++histogram[i][stat.samples[i]];
     }
   };
 
@@ -616,7 +870,7 @@ void TestCleanCircuit(const Factory& factory) {
 
   EXPECT_FALSE(state_space.IsNull(nstate));
 
-  std::vector<uint64_t> stat;
+  typename QTSimulator::Stat stat;
 
   typename QTSimulator::Parameter param;
 
@@ -627,7 +881,7 @@ void TestCleanCircuit(const Factory& factory) {
                                    ncircuit.channels.end(), 0, state_space,
                                    simulator, nstate, stat));
 
-  EXPECT_EQ(stat.size(), 0);
+  EXPECT_EQ(stat.samples.size(), 0);
 
   for (uint64_t i = 0; i < size; ++i) {
     auto a1 = state_space.GetAmpl(state, i);
@@ -673,7 +927,7 @@ void TestInitialState(const Factory& factory) {
   EXPECT_FALSE(state_space.IsNull(state));
 
   typename QTSimulator::Parameter param;
-  std::vector<uint64_t> stat;
+  typename QTSimulator::Stat stat;
 
   for (unsigned i = 0; i < 8; ++i) {
     state_space.SetAmpl(state, i, 1 + i, 0);
@@ -736,19 +990,19 @@ void TestUncomputeFinalState(const Factory& factory) {
   typename QTSimulator::Parameter param;
   param.collect_kop_stat = true;
 
-  std::vector<uint64_t> stat;
+  typename QTSimulator::Stat stat;
 
   // Run one trajectory.
   EXPECT_TRUE(QTSimulator::RunOnce(
       param, ncircuit, 0, state_space, simulator, state, stat));
 
-  EXPECT_EQ(ncircuit.channels.size(), stat.size());
+  EXPECT_EQ(ncircuit.channels.size(), stat.samples.size());
 
   // Uncompute the final state back to |0000> (up to round-off errors).
   for (std::size_t i = 0; i < ncircuit.channels.size(); ++i) {
     auto k = ncircuit.channels.size() - 1 - i;
 
-    const auto& ops = ncircuit.channels[k][stat[k]].ops;
+    const auto& ops = ncircuit.channels[k][stat.samples[k]].ops;
 
     for (auto it = ops.rbegin(); it != ops.rend(); ++it) {
       ApplyGateDagger(simulator, *it, state);

From 83d076d7c5363f0b53e7ed35a066bfb3ad54a744 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 4 Feb 2022 10:46:22 -0800
Subject: [PATCH 201/246] Avoid numpy size limits.

---
 qsimcirq/qsim_simulator.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index c52b8474..77e6775f 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -99,7 +99,7 @@ def _needs_trajectories(circuit: cirq.Circuit) -> bool:
                 op, {param: 1 for param in cirq.parameter_names(op)}
             )
         )
-        if not (cirq.has_unitary(test_op) or cirq.is_measurement(test_op)):
+        if not (cirq.is_measurement(test_op) or cirq.has_unitary(test_op)):
             return True
     return False
 
@@ -356,7 +356,12 @@ def _sample_measure_results(
             translator_fn_name = "translate_cirq_to_qsim"
             sampler_fn = self._sim_module.qsim_sample
 
-        if not noisy and program.are_all_measurements_terminal() and repetitions > 1:
+        if (
+            not noisy and
+            program.are_all_measurements_terminal() and
+            repetitions > 1 and
+            num_qubits <= 32  # max length of ndarray.shape
+        ):
             # Measurements must be replaced with identity gates to sample properly.
             # Simply removing them may omit qubits from the circuit.
             for i in range(len(program.moments)):

From e4c988177261ffefdbeb3644b80d09b69ee3512c Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 4 Feb 2022 11:09:29 -0800
Subject: [PATCH 202/246] format

---
 qsimcirq/qsim_simulator.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 77e6775f..a3feaf27 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -357,10 +357,10 @@ def _sample_measure_results(
             sampler_fn = self._sim_module.qsim_sample
 
         if (
-            not noisy and
-            program.are_all_measurements_terminal() and
-            repetitions > 1 and
-            num_qubits <= 32  # max length of ndarray.shape
+            not noisy
+            and program.are_all_measurements_terminal()
+            and repetitions > 1
+            and num_qubits <= 32  # max length of ndarray.shape
         ):
             # Measurements must be replaced with identity gates to sample properly.
             # Simply removing them may omit qubits from the circuit.

From 96bcb3fde71e78b7abfcde25a4098d2528bdf4af Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Tue, 8 Feb 2022 17:00:06 +0100
Subject: [PATCH 203/246] Add clarifications.

---
 lib/qtrajectory.h | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/lib/qtrajectory.h b/lib/qtrajectory.h
index bf70d630..c16970c3 100644
--- a/lib/qtrajectory.h
+++ b/lib/qtrajectory.h
@@ -56,12 +56,18 @@ class QuantumTrajectorySimulator {
      */
     bool normalize_before_mea_gates = true;
     /**
-     * If false, do not apply deferred operators after the main loop.
-     * This can be used to speed up simulations of circuits with weak noise
-     * and without measurements by reusing the results for the "primary" noise
-     * realization, that is the noise realization in which the  "primary"
-     * (highest probability) Kraus operators are sampled in each channel.
-     * The primary Kraus operators should be first in their respective channels.
+     * If false, do not apply deferred operators after the main loop for
+     * the "primary" noise trajectory, that is the trajectory in which
+     * the primary (the first operators in their respective channels) Kraus
+     * operators are sampled for each channel and there are no measurements
+     * in the computational basis. This can be used to speed up simulations
+     * of circuits with weak noise and without measurements by reusing
+     * the primary trajectory results. It is the client's responsibility
+     * to collect the primary trajectory results and to reuse them. There is
+     * an additional condition for RunBatch. In this case, the deferred
+     * operators after the main loop are still applied for the first occurence
+     * of the primary trajectory. The primary Kraus operators should have
+     * the highest sampling probabilities to achieve the highest speedup.
      */
     bool apply_last_deferred_ops = true;
   };
@@ -75,7 +81,7 @@ class QuantumTrajectorySimulator {
      */
     std::vector<uint64_t> samples;
     /**
-     * True if the "primary" noise realization is sampled, false otherwise.
+     * True if the "primary" noise trajectory is sampled, false otherwise.
      */
     bool primary;
   };

From 51af09d18dae1a77debae731cbc7cf8ce3e4e15d Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Tue, 8 Feb 2022 20:55:02 +0100
Subject: [PATCH 204/246] Recommended fixes.

---
 lib/qtrajectory.h | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/lib/qtrajectory.h b/lib/qtrajectory.h
index c16970c3..17cd83fb 100644
--- a/lib/qtrajectory.h
+++ b/lib/qtrajectory.h
@@ -62,12 +62,14 @@ class QuantumTrajectorySimulator {
      * operators are sampled for each channel and there are no measurements
      * in the computational basis. This can be used to speed up simulations
      * of circuits with weak noise and without measurements by reusing
-     * the primary trajectory results. It is the client's responsibility
-     * to collect the primary trajectory results and to reuse them. There is
-     * an additional condition for RunBatch. In this case, the deferred
-     * operators after the main loop are still applied for the first occurence
-     * of the primary trajectory. The primary Kraus operators should have
-     * the highest sampling probabilities to achieve the highest speedup.
+     * the primary trajectory results. There is an additional condition for
+     * RunBatch. In this case, the deferred operators after the main loop are
+     * still applied for the first occurence of the primary trajectory.
+     * The primary Kraus operators should have the highest sampling
+     * probabilities to achieve the highest speedup.
+     *
+     * It is the client's responsibility to collect the primary trajectory
+     * results and to reuse them.
      */
     bool apply_last_deferred_ops = true;
   };

From c3e549f66d93e3d9c55333e8e288de140ea8d3ff Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 9 Feb 2022 15:13:28 -0800
Subject: [PATCH 205/246] Use qsim for repeated sampling.

---
 pybind_interface/pybind_main.cpp | 24 +++++++++++++++++++++++
 pybind_interface/pybind_main.h   | 12 ++++++++++++
 qsimcirq/qsim_simulator.py       | 33 ++++++++++++++------------------
 3 files changed, 50 insertions(+), 19 deletions(-)

diff --git a/pybind_interface/pybind_main.cpp b/pybind_interface/pybind_main.cpp
index e6788088..51423be0 100644
--- a/pybind_interface/pybind_main.cpp
+++ b/pybind_interface/pybind_main.cpp
@@ -526,6 +526,15 @@ class SimulatorHelper {
     return helper.release_state_to_python();
   }
 
+  static std::vector<uint64_t> sample_final_state(
+      const py::dict &options, bool is_noisy, uint64_t num_samples) {
+    auto helper = SimulatorHelper(options, is_noisy);
+    if (!helper.is_valid || !helper.simulate(0)) {
+      return {};
+    }
+    return helper.sample(num_samples);
+  }
+
   template <typename StateType>
   static std::vector<std::complex<double>> simulate_expectation_values(
       const py::dict &options,
@@ -754,6 +763,11 @@ class SimulatorHelper {
     return result;
   }
 
+  std::vector<uint64_t> sample(uint64_t num_samples) {
+    StateSpace state_space = factory.CreateStateSpace();
+    return state_space.Sample(state, num_samples, seed);
+  }
+
   py::array_t<float> release_state_to_python() {
     StateSpace state_space = factory.CreateStateSpace();
     state_space.InternalToNormalOrder(state);
@@ -932,6 +946,16 @@ qtrajectory_simulate_moment_expectation_values(
 
 // Methods for sampling.
 
+std::vector<uint64_t> qsim_sample_final(
+    const py::dict &options, uint64_t num_samples) {
+  return SimulatorHelper::sample_final_state(options, false, num_samples);
+}
+
+std::vector<uint64_t> qtrajectory_sample_final(
+    const py::dict &options, uint64_t num_samples) {
+  return SimulatorHelper::sample_final_state(options, true, num_samples);
+}
+
 std::vector<unsigned> qsim_sample(const py::dict &options) {
   Circuit<Cirq::GateCirq<float>> circuit;
   try {
diff --git a/pybind_interface/pybind_main.h b/pybind_interface/pybind_main.h
index aed6b615..3263fdd8 100644
--- a/pybind_interface/pybind_main.h
+++ b/pybind_interface/pybind_main.h
@@ -90,6 +90,8 @@ py::array_t<float> qsim_simulate_fullstate(
       const py::dict &options, const py::array_t<float> &input_vector);
 
 std::vector<unsigned> qsim_sample(const py::dict &options);
+std::vector<uint64_t> qsim_sample_final(
+  const py::dict &options, uint64_t num_samples);
 
 // Methods for simulating noisy circuits.
 std::vector<std::complex<float>> qtrajectory_simulate(const py::dict &options);
@@ -100,6 +102,8 @@ py::array_t<float> qtrajectory_simulate_fullstate(
       const py::dict &options, const py::array_t<float> &input_vector);
 
 std::vector<unsigned> qtrajectory_sample(const py::dict &options);
+std::vector<uint64_t> qtrajectory_sample_final(
+  const py::dict &options, uint64_t num_samples);
 
 // As above, but returning expectation values instead.
 std::vector<std::complex<double>> qsim_simulate_expectation_values(
@@ -200,8 +204,12 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
                                                                                       \
       /* Methods for returning samples */                                             \
       m.def("qsim_sample", &qsim_sample, "Call the qsim sampler");                    \
+      m.def("qsim_sample_final", &qsim_sample_final,                                  \
+            "Call the qsim final-state sampler");                                     \
       m.def("qtrajectory_sample", &qtrajectory_sample,                                \
             "Call the qtrajectory sampler");                                          \
+      m.def("qtrajectory_sample_final", &qtrajectory_sample_final,                    \
+            "Call the qtrajectory final-state sampler");                              \
                                                                                       \
       using GateCirq = qsim::Cirq::GateCirq<float>;                                   \
       using OpString = qsim::OpString<GateCirq>;                                      \
@@ -400,8 +408,12 @@ std::vector<std::complex<float>> qsimh_simulate(const py::dict &options);
                                                                                       \
       /* Methods for returning samples */                                             \
       m.def("qsim_sample", &qsim_sample, "Call the qsim sampler");                    \
+      m.def("qsim_sample_final", &qsim_sample_final,                                  \
+            "Call the qsim final-state sampler");                                     \
       m.def("qtrajectory_sample", &qtrajectory_sample,                                \
             "Call the qtrajectory sampler");                                          \
+      m.def("qtrajectory_sample_final", &qtrajectory_sample_final,                    \
+            "Call the qtrajectory final-state sampler");                              \
                                                                                       \
       using GateCirq = qsim::Cirq::GateCirq<float>;                                   \
       using OpString = qsim::OpString<GateCirq>;                                      \
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index a3feaf27..935cfd75 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -349,19 +349,7 @@ def _sample_measure_results(
             )
 
         noisy = _needs_trajectories(program)
-        if noisy:
-            translator_fn_name = "translate_cirq_to_qtrajectory"
-            sampler_fn = self._sim_module.qtrajectory_sample
-        else:
-            translator_fn_name = "translate_cirq_to_qsim"
-            sampler_fn = self._sim_module.qsim_sample
-
-        if (
-            not noisy
-            and program.are_all_measurements_terminal()
-            and repetitions > 1
-            and num_qubits <= 32  # max length of ndarray.shape
-        ):
+        if not noisy and program.are_all_measurements_terminal() and repetitions > 1:
             # Measurements must be replaced with identity gates to sample properly.
             # Simply removing them may omit qubits from the circuit.
             for i in range(len(program.moments)):
@@ -378,12 +366,12 @@ def _sample_measure_results(
                 cirq.QubitOrder.DEFAULT,
             )
             options["s"] = self.get_seed()
-            final_state = self._sim_module.qsim_simulate_fullstate(options, 0)
-            full_results = cirq.sample_state_vector(
-                final_state.view(np.complex64),
-                range(num_qubits),
-                repetitions=repetitions,
-                seed=self._prng,
+            raw_results = self._sim_module.qsim_sample_final(options, repetitions)
+            full_results = np.array(
+                [
+                    [bool(result & (1 << q)) for q in reversed(range(num_qubits))]
+                    for result in raw_results
+                ]
             )
 
             for key, op in meas_ops.items():
@@ -393,6 +381,13 @@ def _sample_measure_results(
                 results[key] = full_results[:, meas_indices] ^ invert_mask
 
         else:
+            if noisy:
+                translator_fn_name = "translate_cirq_to_qtrajectory"
+                sampler_fn = self._sim_module.qtrajectory_sample
+            else:
+                translator_fn_name = "translate_cirq_to_qsim"
+                sampler_fn = self._sim_module.qsim_sample
+
             options["c"], _ = self._translate_circuit(
                 program,
                 translator_fn_name,

From 90a88e77c8dafa0ffc762c3696770dbee4fe3cca Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 16 Feb 2022 09:55:18 -0800
Subject: [PATCH 206/246] Update version to v0.12.0

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index c95999d5..4016bd7b 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.11.2.dev20220104"
+__version__ = "0.12.0"

From b4d77b1dc9af2a483b02f43bb87ca26d633e1093 Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Fri, 18 Feb 2022 16:22:55 +0100
Subject: [PATCH 207/246] cuQuantum lib directory.

---
 Makefile                                   | 2 +-
 apps/make.sh                               | 2 +-
 pybind_interface/custatevec/CMakeLists.txt | 2 +-
 tests/make.sh                              | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Makefile b/Makefile
index 706ffab6..7cdaa414 100644
--- a/Makefile
+++ b/Makefile
@@ -12,7 +12,7 @@ ARCHFLAGS = -march=native
 NVCCFLAGS = -O3
 
 # CUQUANTUM_DIR should be set.
-CUSTATEVECFLAGS = -I$(CUQUANTUM_DIR)/include -L$(CUQUANTUM_DIR)/lib64 -lcustatevec -lcublas
+CUSTATEVECFLAGS = -I$(CUQUANTUM_DIR)/include -L${CUQUANTUM_DIR}/lib -L$(CUQUANTUM_DIR)/lib64 -lcustatevec -lcublas
 
 PYBIND11 = true
 
diff --git a/apps/make.sh b/apps/make.sh
index 7b2db2c8..c742e192 100755
--- a/apps/make.sh
+++ b/apps/make.sh
@@ -27,5 +27,5 @@ nvcc -O3 -o qsim_base_cuda.x qsim_base_cuda.cu
 nvcc -O3 -o qsim_qtrajectory_cuda.x qsim_qtrajectory_cuda.cu
 
 # CUQUANTUM_DIR should be set.
-CUSTATEVECFLAGS="-I${CUQUANTUM_DIR}/include -L${CUQUANTUM_DIR}/lib64 -lcustatevec -lcublas"
+CUSTATEVECFLAGS="-I${CUQUANTUM_DIR}/include -L${CUQUANTUM_DIR}/lib -L${CUQUANTUM_DIR}/lib64 -lcustatevec -lcublas"
 nvcc -O3 $CUSTATEVECFLAGS -o qsim_base_custatevec.x qsim_base_custatevec.cu
diff --git a/pybind_interface/custatevec/CMakeLists.txt b/pybind_interface/custatevec/CMakeLists.txt
index 0d9a05fb..912f531c 100644
--- a/pybind_interface/custatevec/CMakeLists.txt
+++ b/pybind_interface/custatevec/CMakeLists.txt
@@ -46,7 +46,7 @@ find_package(CUDA REQUIRED)
 include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
 
 include_directories($ENV{CUQUANTUM_DIR}/include)
-link_directories($ENV{CUQUANTUM_DIR}/lib64)
+link_directories($ENV{CUQUANTUM_DIR}/lib $ENV{CUQUANTUM_DIR}/lib64)
 
 cuda_add_library(qsim_custatevec MODULE pybind_main_custatevec.cpp)
 target_link_libraries(qsim_custatevec -lcustatevec -lcublas)
diff --git a/tests/make.sh b/tests/make.sh
index fb3bbc8e..f379a102 100755
--- a/tests/make.sh
+++ b/tests/make.sh
@@ -61,7 +61,7 @@ nvcc -O3 -I$path_to_include -L$path_to_lib -o simulator_cuda_test.x simulator_cu
 nvcc -O3 -I$path_to_include -L$path_to_lib -o statespace_cuda_test.x statespace_cuda_test.cu -lgtest -lpthread
 
 # CUQUANTUM_DIR should be set.
-CUSTATEVECFLAGS="-I${CUQUANTUM_DIR}/include -L${CUQUANTUM_DIR}/lib64 -lcustatevec -lcublas"
+CUSTATEVECFLAGS="-I${CUQUANTUM_DIR}/include -L${CUQUANTUM_DIR}/lib -L${CUQUANTUM_DIR}/lib64 -lcustatevec -lcublas"
 nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o hybrid_custatevec_test.x hybrid_custatevec_test.cu -lgtest -lpthread
 nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o qtrajectory_custatevec_test.x qtrajectory_custatevec_test.cu -lgtest -lpthread
 nvcc -O3 $CUSTATEVECFLAGS -I$path_to_include -L$path_to_lib -o simulator_custatevec_test.x simulator_custatevec_test.cu -lgtest -lpthread

From a030893f2b773cb5b9b6b19a15358b4cdd31729f Mon Sep 17 00:00:00 2001
From: Jan Hosang <hosang@users.noreply.github.com>
Date: Tue, 22 Feb 2022 16:37:53 +0100
Subject: [PATCH 208/246] Fix comparator bug which are not compliant to the
 strict weak ordering

std::sort requries a strict weak ordering, but the comparator was reflexive (x < x).
---
 lib/fuser_mqubit.h | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index 4ab4f100..e08a5b84 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -954,8 +954,11 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
                   if (ln != nullptr && rn != nullptr) {
                     return R()(ln->val->parent->time, rn->val->parent->time);
-                  } else {
+                  } else if (ln != rn) {
                     return ln != nullptr || rn == nullptr;
+                  } else {
+                    // Comparator needs to be irreflexive to get a strict weak ordering.
+                    return false;
                   }
                 });
 

From c73c1d97771eee6f5bc5548a0f144da71404ab32 Mon Sep 17 00:00:00 2001
From: Jan Hosang <hosang@users.noreply.github.com>
Date: Wed, 23 Feb 2022 19:15:58 +0100
Subject: [PATCH 209/246] Codegolf

---
 lib/fuser_mqubit.h | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index e08a5b84..7f8d8cbf 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -954,12 +954,10 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
 
                   if (ln != nullptr && rn != nullptr) {
                     return R()(ln->val->parent->time, rn->val->parent->time);
-                  } else if (ln != rn) {
-                    return ln != nullptr || rn == nullptr;
                   } else {
                     // Comparator needs to be irreflexive to get a strict weak ordering.
-                    return false;
-                  }
+                    return ln != nullptr && rn == nullptr;
+                  } else {
                 });
 
       for (auto link : links) {

From 1e370d1c1c4f8978b0e47ca4caff220fec9bc373 Mon Sep 17 00:00:00 2001
From: Jan Hosang <hosang@users.noreply.github.com>
Date: Wed, 23 Feb 2022 19:17:02 +0100
Subject: [PATCH 210/246] Update fuser_mqubit.h

---
 lib/fuser_mqubit.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index 7f8d8cbf..d3b2bee2 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -957,7 +957,7 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
                   } else {
                     // Comparator needs to be irreflexive to get a strict weak ordering.
                     return ln != nullptr && rn == nullptr;
-                  } else {
+                  }
                 });
 
       for (auto link : links) {

From 5ba900a818945a7b9bd6a4759564335c80ed12c8 Mon Sep 17 00:00:00 2001
From: Jan Hosang <hosang@users.noreply.github.com>
Date: Fri, 25 Feb 2022 17:08:08 +0100
Subject: [PATCH 211/246] Simplify and add comment.

---
 lib/fuser_mqubit.h | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/fuser_mqubit.h b/lib/fuser_mqubit.h
index d3b2bee2..8ddb029e 100644
--- a/lib/fuser_mqubit.h
+++ b/lib/fuser_mqubit.h
@@ -955,8 +955,9 @@ class MultiQubitGateFuser final : public Fuser<IO, Gate> {
                   if (ln != nullptr && rn != nullptr) {
                     return R()(ln->val->parent->time, rn->val->parent->time);
                   } else {
-                    // Comparator needs to be irreflexive to get a strict weak ordering.
-                    return ln != nullptr && rn == nullptr;
+                    // nullptrs are larger than everything else and
+                    // equivalent among each other.
+                    return ln != nullptr;
                   }
                 });
 

From 5954623bbb528551a5ef1b19d70db3f038facfec Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Thu, 3 Mar 2022 08:48:06 -0800
Subject: [PATCH 212/246] Patch for internal tests

---
 lib/qtrajectory.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/qtrajectory.h b/lib/qtrajectory.h
index 17cd83fb..1da6692f 100644
--- a/lib/qtrajectory.h
+++ b/lib/qtrajectory.h
@@ -16,6 +16,7 @@
 #define QTRAJECTORY_H_
 
 #include <cmath>
+#include <complex>
 #include <cstdint>
 #include <random>
 #include <vector>

From 93f394ba285472fdfd50e28c39b58cad50050074 Mon Sep 17 00:00:00 2001
From: Drew Risinger <drewrisinger@users.noreply.github.com>
Date: Thu, 3 Mar 2022 11:16:49 -0500
Subject: [PATCH 213/246] cmake: allow using system pybind11

Defaults to pre-installed version of pybind11. The search was refactored to a cmake module.

Will default to using the system pybind11, and fetch pybind11 via git if it is not installed
---
 pybind_interface/GetPybind11.cmake         | 13 +++++++++++++
 pybind_interface/avx2/CMakeLists.txt       | 14 +-------------
 pybind_interface/avx512/CMakeLists.txt     | 13 +------------
 pybind_interface/basic/CMakeLists.txt      | 13 +------------
 pybind_interface/cuda/CMakeLists.txt       | 14 +-------------
 pybind_interface/custatevec/CMakeLists.txt | 16 ++--------------
 pybind_interface/decide/CMakeLists.txt     | 13 +------------
 pybind_interface/sse/CMakeLists.txt        | 13 +------------
 8 files changed, 21 insertions(+), 88 deletions(-)
 create mode 100644 pybind_interface/GetPybind11.cmake

diff --git a/pybind_interface/GetPybind11.cmake b/pybind_interface/GetPybind11.cmake
new file mode 100644
index 00000000..ffeada3b
--- /dev/null
+++ b/pybind_interface/GetPybind11.cmake
@@ -0,0 +1,13 @@
+include(FetchContent)
+
+FetchContent_Declare(
+  pybind11
+  GIT_REPOSITORY https://github.com/pybind/pybind11
+  GIT_TAG v2.2.4
+)
+FetchContent_GetProperties(pybind11)
+find_package(pybind11 CONFIG)
+if((NOT pybind11_FOUND) AND (NOT pybind11_POPULATED)) # check first on system path, then attempt git fetch
+  FetchContent_Populate(pybind11)
+  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
+endif()
diff --git a/pybind_interface/avx2/CMakeLists.txt b/pybind_interface/avx2/CMakeLists.txt
index 4382de95..eebba584 100644
--- a/pybind_interface/avx2/CMakeLists.txt
+++ b/pybind_interface/avx2/CMakeLists.txt
@@ -12,17 +12,5 @@ if(APPLE)
     include_directories("/usr/local/include" "/usr/local/opt/llvm/include")
     link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
 endif()
-
-include(FetchContent)
-
-FetchContent_Declare(
-  pybind11
-  GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
-)
-FetchContent_GetProperties(pybind11)
-if(NOT pybind11_POPULATED)
-  FetchContent_Populate(pybind11)
-  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
-endif()
+INCLUDE(../GetPybind11.cmake)
 pybind11_add_module(qsim_avx2 pybind_main_avx2.cpp)
diff --git a/pybind_interface/avx512/CMakeLists.txt b/pybind_interface/avx512/CMakeLists.txt
index 705d39db..86cfdfa8 100644
--- a/pybind_interface/avx512/CMakeLists.txt
+++ b/pybind_interface/avx512/CMakeLists.txt
@@ -14,16 +14,5 @@ if(APPLE)
     link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
 endif()
 
-include(FetchContent)
-
-FetchContent_Declare(
-  pybind11
-  GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
-)
-FetchContent_GetProperties(pybind11)
-if(NOT pybind11_POPULATED)
-  FetchContent_Populate(pybind11)
-  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
-endif()
+INCLUDE(../GetPybind11.cmake)
 pybind11_add_module(qsim_avx512 pybind_main_avx512.cpp)
diff --git a/pybind_interface/basic/CMakeLists.txt b/pybind_interface/basic/CMakeLists.txt
index 9380f02d..35347211 100644
--- a/pybind_interface/basic/CMakeLists.txt
+++ b/pybind_interface/basic/CMakeLists.txt
@@ -14,16 +14,5 @@ if(APPLE)
     link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
 endif()
 
-include(FetchContent)
-
-FetchContent_Declare(
-  pybind11
-  GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
-)
-FetchContent_GetProperties(pybind11)
-if(NOT pybind11_POPULATED)
-  FetchContent_Populate(pybind11)
-  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
-endif()
+INCLUDE(../GetPybind11.cmake)
 pybind11_add_module(qsim_basic pybind_main_basic.cpp)
diff --git a/pybind_interface/cuda/CMakeLists.txt b/pybind_interface/cuda/CMakeLists.txt
index d7f5b836..7da45dac 100644
--- a/pybind_interface/cuda/CMakeLists.txt
+++ b/pybind_interface/cuda/CMakeLists.txt
@@ -14,19 +14,7 @@ if(APPLE)
     link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
 endif()
 
-include(FetchContent)
-
-FetchContent_Declare(
-  pybind11
-  GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
-)
-FetchContent_GetProperties(pybind11)
-if(NOT pybind11_POPULATED)
-  FetchContent_Populate(pybind11)
-  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
-endif()
-
+INCLUDE(../GetPybind11.cmake)
 find_package(PythonLibs 3.6 REQUIRED)
 find_package(CUDA REQUIRED)
 
diff --git a/pybind_interface/custatevec/CMakeLists.txt b/pybind_interface/custatevec/CMakeLists.txt
index 912f531c..687ac2be 100644
--- a/pybind_interface/custatevec/CMakeLists.txt
+++ b/pybind_interface/custatevec/CMakeLists.txt
@@ -27,23 +27,11 @@ if(APPLE)
     link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
 endif()
 
-include(FetchContent)
-
-FetchContent_Declare(
-  pybind11
-  GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
-)
-FetchContent_GetProperties(pybind11)
-if(NOT pybind11_POPULATED)
-  FetchContent_Populate(pybind11)
-  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
-endif()
-
+INCLUDE(../GetPybind11.cmake)
 find_package(PythonLibs 3.6 REQUIRED)
 find_package(CUDA REQUIRED)
 
-include_directories(${PYTHON_INCLUDE_DIRS} ${pybind11_SOURCE_DIR}/include)
+include_directories(${pybind11_INCLUDE_DIRS})
 
 include_directories($ENV{CUQUANTUM_DIR}/include)
 link_directories($ENV{CUQUANTUM_DIR}/lib $ENV{CUQUANTUM_DIR}/lib64)
diff --git a/pybind_interface/decide/CMakeLists.txt b/pybind_interface/decide/CMakeLists.txt
index 643ca9ad..0808ccf6 100644
--- a/pybind_interface/decide/CMakeLists.txt
+++ b/pybind_interface/decide/CMakeLists.txt
@@ -19,18 +19,7 @@ if(APPLE)
     link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
 endif()
 
-include(FetchContent)
-
-FetchContent_Declare(
-  pybind11
-  GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
-)
-FetchContent_GetProperties(pybind11)
-if(NOT pybind11_POPULATED)
-  FetchContent_Populate(pybind11)
-  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
-endif()
+INCLUDE(../GetPybind11.cmake)
 
 if(has_nvcc STREQUAL "")
   pybind11_add_module(qsim_decide decide.cpp)
diff --git a/pybind_interface/sse/CMakeLists.txt b/pybind_interface/sse/CMakeLists.txt
index 6fa7201f..fe9b218e 100644
--- a/pybind_interface/sse/CMakeLists.txt
+++ b/pybind_interface/sse/CMakeLists.txt
@@ -14,16 +14,5 @@ if(APPLE)
     link_directories("/usr/local/lib" "/usr/local/opt/llvm/lib")
 endif()
 
-include(FetchContent)
-
-FetchContent_Declare(
-  pybind11
-  GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
-)
-FetchContent_GetProperties(pybind11)
-if(NOT pybind11_POPULATED)
-  FetchContent_Populate(pybind11)
-  add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
-endif()
+INCLUDE(../GetPybind11.cmake)
 pybind11_add_module(qsim_sse pybind_main_sse.cpp)

From 1c54e70acb260e6caad9bb9ad160762222d7230c Mon Sep 17 00:00:00 2001
From: Drew Risinger <drewrisinger@users.noreply.github.com>
Date: Thu, 3 Mar 2022 12:23:49 -0500
Subject: [PATCH 214/246] cmake: set minimum pybind11 version

---
 pybind_interface/GetPybind11.cmake | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/pybind_interface/GetPybind11.cmake b/pybind_interface/GetPybind11.cmake
index ffeada3b..f93c2bf6 100644
--- a/pybind_interface/GetPybind11.cmake
+++ b/pybind_interface/GetPybind11.cmake
@@ -1,12 +1,13 @@
 include(FetchContent)
 
+set(MIN_PYBIND_VERSION "2.2.4")
 FetchContent_Declare(
   pybind11
   GIT_REPOSITORY https://github.com/pybind/pybind11
-  GIT_TAG v2.2.4
+  GIT_TAG "v${MIN_PYBIND_VERSION}"
 )
 FetchContent_GetProperties(pybind11)
-find_package(pybind11 CONFIG)
+find_package(pybind11 "${MIN_PYBIND_VERSION}" CONFIG)
 if((NOT pybind11_FOUND) AND (NOT pybind11_POPULATED)) # check first on system path, then attempt git fetch
   FetchContent_Populate(pybind11)
   add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})

From 74620d996e827f63d27823388434bb1226960d8b Mon Sep 17 00:00:00 2001
From: Bernardo Meurer <bernardo@meurer.org>
Date: Thu, 10 Mar 2022 16:59:45 -0800
Subject: [PATCH 215/246] Revert "Revert "refactor: split dev requirements out
 of main requirements.txt""

This reverts commit 05761621217604abb9f050485ee78a1a40b854ef.
---
 .github/workflows/python_format.yml  |  6 ++----
 .github/workflows/testing_wheels.yml |  1 +
 MANIFEST.in                          |  1 +
 dev-requirements.txt                 |  3 +++
 docs/install_qsimcirq.md             |  6 ++++++
 requirements.txt                     | 12 ++----------
 setup.py                             |  4 ++++
 7 files changed, 19 insertions(+), 14 deletions(-)
 create mode 100644 dev-requirements.txt

diff --git a/.github/workflows/python_format.yml b/.github/workflows/python_format.yml
index adb5f56f..213abf2e 100644
--- a/.github/workflows/python_format.yml
+++ b/.github/workflows/python_format.yml
@@ -24,9 +24,7 @@ jobs:
         with:
           python-version: '3.7'
           architecture: 'x64'
-      - name: Install flynt
-        run: cat requirements.txt | grep flynt | xargs pip install
-      - name: Install black
-        run: cat requirements.txt | grep black | xargs pip install
+      - name: Install dev requirements
+        run: pip install -r dev-requirements.txt
       - name: Format
         run: check/format-incremental
diff --git a/.github/workflows/testing_wheels.yml b/.github/workflows/testing_wheels.yml
index eeb4d741..55dd237a 100644
--- a/.github/workflows/testing_wheels.yml
+++ b/.github/workflows/testing_wheels.yml
@@ -45,6 +45,7 @@ jobs:
       CIBW_REPAIR_WHEEL_COMMAND_MACOS: ""
       # due to package and module name conflict have to temporarily move it away to run tests
       CIBW_BEFORE_TEST: "mv {package}/qsimcirq /tmp"
+      CIBW_TEST_EXTRAS: "dev"
       CIBW_TEST_COMMAND: "pytest {package}/qsimcirq_tests/qsimcirq_test.py && mv /tmp/qsimcirq {package}"
     steps:
       - uses: actions/checkout@v2
diff --git a/MANIFEST.in b/MANIFEST.in
index 2968589b..4b487267 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,4 +1,5 @@
 include requirements.txt
+include dev-requirements.txt
 include CMakeLists.txt
 
 graft pybind_interface
diff --git a/dev-requirements.txt b/dev-requirements.txt
new file mode 100644
index 00000000..4cb3afc0
--- /dev/null
+++ b/dev-requirements.txt
@@ -0,0 +1,3 @@
+black==20.8b1
+flynt~=0.60
+pytest
diff --git a/docs/install_qsimcirq.md b/docs/install_qsimcirq.md
index 9ae35d21..0a0f3182 100644
--- a/docs/install_qsimcirq.md
+++ b/docs/install_qsimcirq.md
@@ -17,6 +17,12 @@ Prerequisites are included in the
 [`requirements.txt`](https://github.com/quantumlib/qsim/blob/master/requirements.txt)
 file, and will be automatically installed along with qsimcirq.
 
+If you'd like to develop qsimcirq, a separate set of dependencies are includes
+in the
+[`dev-requirements.txt`](https://github.com/quantumlib/qsim/blob/master/dev-requirements.txt)
+file. You can install them with `pip3 install -r dev-requirements.txt` or
+`pip3 install qsimcirq[dev]`.
+
 ## Linux installation
 
 We provide `qsimcirq` Python wheels on 64-bit `x86` architectures with `Python 3.{6,7,8,9}`.
diff --git a/requirements.txt b/requirements.txt
index 01d20cd5..0a95d64c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,13 +1,5 @@
-# Runtime requirements for the python 3 version of cirq.
-
+absl-py
 cirq-core
 numpy~=1.16
-typing_extensions
-absl-py
-
-# Build and test requirements
-
-black==20.8b1
-flynt~=0.60
 pybind11
-pytest
+typing_extensions
diff --git a/setup.py b/setup.py
index 121b4dad..a7b002c3 100644
--- a/setup.py
+++ b/setup.py
@@ -78,6 +78,7 @@ def build_extension(self, ext):
 
 
 requirements = open("requirements.txt").readlines()
+dev_requirements = open("dev-requirements.txt").readlines()
 
 description = "Schrödinger and Schrödinger-Feynman simulators for quantum circuits."
 
@@ -95,6 +96,9 @@ def build_extension(self, ext):
     author_email="devabathini92@gmail.com",
     python_requires=">=3.3.0",
     install_requires=requirements,
+    extras_require={
+        "dev": dev_requirements,
+    },
     license="Apache 2",
     description=description,
     long_description=long_description,

From 9ebb5c909bb6f39ba0a350b9c3c34f558bb20e66 Mon Sep 17 00:00:00 2001
From: Bernardo Meurer <bernardo@meurer.org>
Date: Thu, 10 Mar 2022 17:00:05 -0800
Subject: [PATCH 216/246] Revert "Revert #469"

This reverts commit 51ba016984d63f2594a57bbbc1b368f28e746f8d.
---
 .github/workflows/cirq_compatibility.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/cirq_compatibility.yml b/.github/workflows/cirq_compatibility.yml
index 04e13559..f4fd7473 100644
--- a/.github/workflows/cirq_compatibility.yml
+++ b/.github/workflows/cirq_compatibility.yml
@@ -18,5 +18,7 @@ jobs:
         run: pip3 install -U cirq --pre
       - name: Install qsim requirements
         run: pip3 install -r requirements.txt
+      - name: Install test requirements
+        run: pip3 install -r dev-requirements.txt
       - name: Run python tests
         run: make run-py-tests

From 8503958570b2744c4f01f0dddfae4951b25d3b10 Mon Sep 17 00:00:00 2001
From: Bernardo Meurer <bernardo@meurer.org>
Date: Thu, 10 Mar 2022 17:05:23 -0800
Subject: [PATCH 217/246] ci(release_wheels): install dev requirements in
 CIBW_TEST_EXTRAS

---
 .github/workflows/release_wheels.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/release_wheels.yml b/.github/workflows/release_wheels.yml
index 1550d20e..abf5c7a1 100644
--- a/.github/workflows/release_wheels.yml
+++ b/.github/workflows/release_wheels.yml
@@ -39,7 +39,8 @@ jobs:
       CIBW_BEFORE_BUILD_MACOS: "brew install libomp"
       CIBW_REPAIR_WHEEL_COMMAND_MACOS: ""
       # due to package and module name conflict have to temporarily move it away to run tests
-      CIBW_BEFORE_TEST: "mv {package}/qsimcirq /tmp"
+      CIBW_BEFORE_TEST: mv {package}/qsimcirq /tmp
+      CIBW_TEST_EXTRAS: "dev"
       CIBW_TEST_COMMAND: "pytest {package}/qsimcirq_tests/qsimcirq_test.py && mv /tmp/qsimcirq {package}"
     steps:
       - uses: actions/checkout@v2

From 33f6b4ec099dde918b6c942105554883b54624e0 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 14 Mar 2022 12:52:19 -0700
Subject: [PATCH 218/246] Update version to 0.12.1

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index 4016bd7b..1315a776 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.12.0"
+__version__ = "0.12.1"

From 823d316458210a3fd18b7108bf95270d3db9896a Mon Sep 17 00:00:00 2001
From: Bernardo Meurer <bernardo@meurer.org>
Date: Tue, 15 Mar 2022 09:24:06 -0700
Subject: [PATCH 219/246] refactor(dev-requirements): use stable black

---
 dev-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-requirements.txt b/dev-requirements.txt
index 4cb3afc0..9c4745bb 100644
--- a/dev-requirements.txt
+++ b/dev-requirements.txt
@@ -1,3 +1,3 @@
-black==20.8b1
+black~=22.1.0
 flynt~=0.60
 pytest

From e4e26cae41d683bc00da2040e5b3cd9c7f5080b2 Mon Sep 17 00:00:00 2001
From: Bernardo Meurer <bernardo@meurer.org>
Date: Tue, 15 Mar 2022 09:24:15 -0700
Subject: [PATCH 220/246] style: format with black 22.1.0

---
 dev-requirements.txt            |  2 +-
 qsimcirq/qsim_simulator.py      |  8 ++++----
 qsimcirq_tests/qsimcirq_test.py | 13 +++++--------
 setup.py                        |  2 +-
 4 files changed, 11 insertions(+), 14 deletions(-)

diff --git a/dev-requirements.txt b/dev-requirements.txt
index 9c4745bb..858ac6bc 100644
--- a/dev-requirements.txt
+++ b/dev-requirements.txt
@@ -1,3 +1,3 @@
-black~=22.1.0
+black~=22.0
 flynt~=0.60
 pytest
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 935cfd75..017dcbfb 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -250,7 +250,7 @@ def __init__(
 
     def get_seed(self):
         # Limit seed size to 32-bit integer for C++ conversion.
-        return self._prng.randint(2 ** 31 - 1)
+        return self._prng.randint(2**31 - 1)
 
     def _run(
         self,
@@ -540,7 +540,7 @@ def simulate_sweep(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2 ** num_qubits * 2:
+            if len(input_vector) != 2**num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
@@ -672,7 +672,7 @@ def simulate_expectation_values_sweep(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2 ** num_qubits * 2:
+            if len(input_vector) != 2**num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
@@ -807,7 +807,7 @@ def simulate_moment_expectation_values(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2 ** num_qubits * 2:
+            if len(input_vector) != 2**num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index ac855a87..0af3ed0d 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -286,14 +286,11 @@ def test_iterable_qubit_order():
     )
     qsim_simulator = qsimcirq.QSimSimulator()
 
-    assert (
-        qsim_simulator.compute_amplitudes(
-            circuit,
-            bitstrings=[0b00, 0b01],
-            qubit_order=reversed([q1, q0]),
-        )
-        == qsim_simulator.compute_amplitudes(circuit, bitstrings=[0b00, 0b01])
-    )
+    assert qsim_simulator.compute_amplitudes(
+        circuit,
+        bitstrings=[0b00, 0b01],
+        qubit_order=reversed([q1, q0]),
+    ) == qsim_simulator.compute_amplitudes(circuit, bitstrings=[0b00, 0b01])
 
     assert qsim_simulator.simulate(
         circuit, qubit_order=reversed([q1, q0])
diff --git a/setup.py b/setup.py
index a7b002c3..10c7aa15 100644
--- a/setup.py
+++ b/setup.py
@@ -50,7 +50,7 @@ def build_extension(self, ext):
             cmake_args += [
                 "-DCMAKE_LIBRARY_OUTPUT_DIRECTORY_{}={}".format(cfg.upper(), extdir)
             ]
-            if sys.maxsize > 2 ** 32:
+            if sys.maxsize > 2**32:
                 cmake_args += ["-A", "x64"]
             build_args += ["--", "/m"]
         else:

From 1bec1eda261beecd531c93cbcc6d2c0d15735269 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 16 Mar 2022 13:59:26 -0700
Subject: [PATCH 221/246] Workaround Centos 8 EOL

---
 jupyter/Dockerfile | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/jupyter/Dockerfile b/jupyter/Dockerfile
index 2019390c..43e12544 100644
--- a/jupyter/Dockerfile
+++ b/jupyter/Dockerfile
@@ -3,6 +3,11 @@ FROM centos:8
 USER root
 # Install baseline
 
+RUN pushd /etc/yum.repos.d/
+RUN sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
+RUN sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
+RUN popd
+
 RUN yum -y update && \
 	yum install -y epel-release && \
 	yum group install -y "Development Tools" && \

From a9691e3710ff3661183a4d7ed4ff1d6873dbbaeb Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 18 Mar 2022 09:10:19 -0700
Subject: [PATCH 222/246] Document EOL changes.

---
 jupyter/Dockerfile | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/jupyter/Dockerfile b/jupyter/Dockerfile
index 43e12544..a1ddb8ff 100644
--- a/jupyter/Dockerfile
+++ b/jupyter/Dockerfile
@@ -1,13 +1,15 @@
 # Base OS
 FROM centos:8
 USER root
-# Install baseline
 
+# Centos 8 has reach end of life: https://www.centos.org/centos-linux-eol/
+# Configuration must be loaded from the vault.
 RUN pushd /etc/yum.repos.d/
 RUN sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
 RUN sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
 RUN popd
 
+# Install baseline
 RUN yum -y update && \
 	yum install -y epel-release && \
 	yum group install -y "Development Tools" && \

From 5c7ea933cde433b685edd777f05b1aea5cb73cae Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 18 Mar 2022 10:34:27 -0700
Subject: [PATCH 223/246] Contain pushd-popd in single RUN

---
 jupyter/Dockerfile | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/jupyter/Dockerfile b/jupyter/Dockerfile
index a1ddb8ff..35610cd9 100644
--- a/jupyter/Dockerfile
+++ b/jupyter/Dockerfile
@@ -4,10 +4,10 @@ USER root
 
 # Centos 8 has reach end of life: https://www.centos.org/centos-linux-eol/
 # Configuration must be loaded from the vault.
-RUN pushd /etc/yum.repos.d/
-RUN sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
-RUN sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
-RUN popd
+RUN pushd /etc/yum.repos.d/ && \
+	sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && \
+	sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-* && \
+	popd
 
 # Install baseline
 RUN yum -y update && \

From 9d4c647fab0c16aee57b5afbfb7a780854bc081c Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 28 Mar 2022 11:45:36 -0700
Subject: [PATCH 224/246] Remove deprecated elements for Cirq v0.14

---
 qsimcirq/qsim_circuit.py        | 10 +++-------
 qsimcirq/qsim_simulator.py      | 34 ++++++++++++++++-----------------
 qsimcirq/qsimh_simulator.py     |  2 +-
 qsimcirq_tests/qsimcirq_test.py | 11 ++++++-----
 4 files changed, 26 insertions(+), 31 deletions(-)

diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index 912f8fd7..21a2094e 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -252,18 +252,17 @@ class QSimCircuit(cirq.Circuit):
     def __init__(
         self,
         cirq_circuit: cirq.Circuit,
-        device: cirq.devices = cirq.devices.UNCONSTRAINED_DEVICE,
         allow_decomposition: bool = False,
     ):
 
         if allow_decomposition:
-            super().__init__([], device=device)
+            super().__init__()
             for moment in cirq_circuit:
                 for op in moment:
                     # This should call decompose on the gates
                     self.append(op)
         else:
-            super().__init__(cirq_circuit, device=device)
+            super().__init__(cirq_circuit)
 
     def __eq__(self, other):
         if not isinstance(other, QSimCircuit):
@@ -274,10 +273,7 @@ def __eq__(self, other):
     def _resolve_parameters_(
         self, param_resolver: cirq.study.ParamResolver, recursive: bool = True
     ):
-        return QSimCircuit(
-            cirq.resolve_parameters(super(), param_resolver, recursive),
-            device=self.device,
-        )
+        return QSimCircuit(cirq.resolve_parameters(super(), param_resolver, recursive))
 
     def translate_cirq_to_qsim(
         self, qubit_order: cirq.ops.QubitOrderOrList = cirq.ops.QubitOrder.DEFAULT
diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 017dcbfb..ab234f1c 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -305,7 +305,6 @@ def _sample_measure_results(
             self.noise.noisy_moments(program, sorted(all_qubits))
             if self.noise is not cirq.NO_NOISE
             else program,
-            device=program.device,
         )
 
         # Compute indices of measured qubits
@@ -324,14 +323,15 @@ def _sample_measure_results(
                 cirq.MeasurementGate
             )
         ]
-        measured_qubits = []  # type: List[cirq.Qid]
-        bounds = {}  # type: Dict[str, Tuple]
-        meas_ops = {}  # type: Dict[str, cirq.GateOperation]
+        measured_qubits: List[cirq.Qid] = []
+        bounds: Dict[str, Tuple] = {}
+        meas_ops: Dict[str, List[cirq.GateOperation]] = {}
         current_index = 0
         for op in measurement_ops:
             gate = op.gate
             key = cirq.measurement_key_name(gate)
-            meas_ops[key] = op
+            meas_ops.setdefault(key, [])
+            meas_ops[key].append(op)
             if key in bounds:
                 raise ValueError(f"Duplicate MeasurementGate with key {key}")
             bounds[key] = (current_index, current_index + len(op.qubits))
@@ -345,7 +345,7 @@ def _sample_measure_results(
         results = {}
         for key, bound in bounds.items():
             results[key] = np.ndarray(
-                shape=(repetitions, bound[1] - bound[0]), dtype=int
+                shape=(repetitions, len(meas_ops[key]), bound[1] - bound[0]), dtype=int
             )
 
         noisy = _needs_trajectories(program)
@@ -374,11 +374,12 @@ def _sample_measure_results(
                 ]
             )
 
-            for key, op in meas_ops.items():
-                meas_indices = [qubit_map[qubit] for qubit in op.qubits]
-                invert_mask = op.gate.full_invert_mask()
-                # Apply invert mask to re-ordered results
-                results[key] = full_results[:, meas_indices] ^ invert_mask
+            for key, oplist in meas_ops.items():
+                for i, op in enumerate(oplist):
+                    meas_indices = [qubit_map[qubit] for qubit in op.qubits]
+                    invert_mask = op.gate.full_invert_mask()
+                    # Apply invert mask to re-ordered results
+                    results[key][:, i, :] = full_results[:, meas_indices] ^ invert_mask
 
         else:
             if noisy:
@@ -396,7 +397,7 @@ def _sample_measure_results(
             measurements = np.empty(
                 shape=(
                     repetitions,
-                    sum(cirq.num_qubits(op) for op in meas_ops.values()),
+                    sum(cirq.num_qubits(op) for oplist in meas_ops.values() for op in oplist),
                 ),
                 dtype=int,
             )
@@ -405,8 +406,9 @@ def _sample_measure_results(
                 measurements[i] = sampler_fn(options)
 
             for key, (start, end) in bounds.items():
-                invert_mask = meas_ops[key].gate.full_invert_mask()
-                results[key] = measurements[:, start:end] ^ invert_mask
+                for i, op in enumerate(meas_ops[key]):
+                    invert_mask = op.gate.full_invert_mask()
+                    results[key][:, i, :] = measurements[:, start:end] ^ invert_mask
 
         return results
 
@@ -442,7 +444,6 @@ def compute_amplitudes_sweep(
             self.noise.noisy_moments(program, sorted(all_qubits))
             if self.noise is not cirq.NO_NOISE
             else program,
-            device=program.device,
         )
 
         # qsim numbers qubits in reverse order from cirq
@@ -525,7 +526,6 @@ def simulate_sweep(
             self.noise.noisy_moments(program, sorted(all_qubits))
             if self.noise is not cirq.NO_NOISE
             else program,
-            device=program.device,
         )
 
         options = {}
@@ -661,7 +661,6 @@ def simulate_expectation_values_sweep(
             self.noise.noisy_moments(program, sorted(all_qubits))
             if self.noise is not cirq.NO_NOISE
             else program,
-            device=program.device,
         )
 
         options = {}
@@ -796,7 +795,6 @@ def simulate_moment_expectation_values(
             self.noise.noisy_moments(program, sorted(all_qubits))
             if self.noise is not cirq.NO_NOISE
             else program,
-            device=program.device,
         )
 
         options = {}
diff --git a/qsimcirq/qsimh_simulator.py b/qsimcirq/qsimh_simulator.py
index 6a060c42..3077a935 100644
--- a/qsimcirq/qsimh_simulator.py
+++ b/qsimcirq/qsimh_simulator.py
@@ -48,7 +48,7 @@ def compute_amplitudes_sweep(
     ) -> Sequence[Sequence[complex]]:
 
         if not isinstance(program, qsimc.QSimCircuit):
-            program = qsimc.QSimCircuit(program, device=program.device)
+            program = qsimc.QSimCircuit(program)
 
         n_qubits = len(program.all_qubits())
         # qsim numbers qubits in reverse order from cirq
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 0af3ed0d..f14fc44f 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -271,10 +271,11 @@ def test_invalid_params():
     x, y = sympy.Symbol("x"), sympy.Symbol("y")
     circuit = cirq.Circuit(cirq.X(q0) ** x, cirq.H(q0) ** y)
     prs = [{x: np.int64(0), y: np.int64(1)}, {x: np.int64(1), y: "z"}]
+    sweep = cirq.ListSweep(prs)
 
     qsim_simulator = qsimcirq.QSimSimulator()
     with pytest.raises(ValueError, match="Parameters must be numeric"):
-        _ = qsim_simulator.simulate_sweep(circuit, params=prs)
+        _ = qsim_simulator.simulate_sweep(circuit, params=sweep)
 
 
 def test_iterable_qubit_order():
@@ -1154,10 +1155,10 @@ def test_cirq_qsim_simulate_random_unitary(mode: str):
             qubits=[q0, q1], n_moments=8, op_density=0.99, random_state=iter
         )
 
-        cirq.ConvertToCzAndSingleGates().optimize_circuit(
-            random_circuit
-        )  # cannot work with params
-        cirq.ExpandComposite().optimize_circuit(random_circuit)
+        random_circuit = cirq.optimize_for_target_gateset(
+            random_circuit, gateset=cirq.CZTargetGateset()
+        )
+        random_circuit = cirq.expand_composite(random_circuit)
         if mode == "noisy":
             random_circuit.append(NoiseTrigger().on(q0))
 

From 0c855d7ca50719dd7197ea7d682bd8cfcb6f5c6d Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 28 Mar 2022 11:49:38 -0700
Subject: [PATCH 225/246] Format

---
 qsimcirq/qsim_simulator.py      | 14 +++++++++-----
 qsimcirq_tests/qsimcirq_test.py | 13 ++++++++-----
 2 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index ab234f1c..868bff3b 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -250,7 +250,7 @@ def __init__(
 
     def get_seed(self):
         # Limit seed size to 32-bit integer for C++ conversion.
-        return self._prng.randint(2**31 - 1)
+        return self._prng.randint(2 ** 31 - 1)
 
     def _run(
         self,
@@ -397,7 +397,11 @@ def _sample_measure_results(
             measurements = np.empty(
                 shape=(
                     repetitions,
-                    sum(cirq.num_qubits(op) for oplist in meas_ops.values() for op in oplist),
+                    sum(
+                        cirq.num_qubits(op)
+                        for oplist in meas_ops.values()
+                        for op in oplist
+                    ),
                 ),
                 dtype=int,
             )
@@ -540,7 +544,7 @@ def simulate_sweep(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2**num_qubits * 2:
+            if len(input_vector) != 2 ** num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
@@ -671,7 +675,7 @@ def simulate_expectation_values_sweep(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2**num_qubits * 2:
+            if len(input_vector) != 2 ** num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
@@ -805,7 +809,7 @@ def simulate_moment_expectation_values(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2**num_qubits * 2:
+            if len(input_vector) != 2 ** num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index f14fc44f..9b7cf416 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -287,11 +287,14 @@ def test_iterable_qubit_order():
     )
     qsim_simulator = qsimcirq.QSimSimulator()
 
-    assert qsim_simulator.compute_amplitudes(
-        circuit,
-        bitstrings=[0b00, 0b01],
-        qubit_order=reversed([q1, q0]),
-    ) == qsim_simulator.compute_amplitudes(circuit, bitstrings=[0b00, 0b01])
+    assert (
+        qsim_simulator.compute_amplitudes(
+            circuit,
+            bitstrings=[0b00, 0b01],
+            qubit_order=reversed([q1, q0]),
+        )
+        == qsim_simulator.compute_amplitudes(circuit, bitstrings=[0b00, 0b01])
+    )
 
     assert qsim_simulator.simulate(
         circuit, qubit_order=reversed([q1, q0])

From 8ad72e972d1c80b5d545c817f706d595496fecfe Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 28 Mar 2022 11:52:03 -0700
Subject: [PATCH 226/246] Pin click version

---
 dev-requirements.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-requirements.txt b/dev-requirements.txt
index 858ac6bc..25489459 100644
--- a/dev-requirements.txt
+++ b/dev-requirements.txt
@@ -1,3 +1,4 @@
 black~=22.0
+click<=8.0.4
 flynt~=0.60
 pytest

From 6df09448df81f4901e549e15ccd4aa71608857f1 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 28 Mar 2022 14:44:55 -0700
Subject: [PATCH 227/246] Update `black` version, unpin `click`

---
 dev-requirements.txt | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/dev-requirements.txt b/dev-requirements.txt
index 25489459..2d2638bc 100644
--- a/dev-requirements.txt
+++ b/dev-requirements.txt
@@ -1,4 +1,3 @@
-black~=22.0
-click<=8.0.4
+black~=22.3.0
 flynt~=0.60
 pytest

From dd5b2d0d16f349bd37dd7284d191818b35675772 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 30 Mar 2022 11:48:05 -0700
Subject: [PATCH 228/246] Format

---
 qsimcirq/qsim_simulator.py      |  8 ++++----
 qsimcirq_tests/qsimcirq_test.py | 13 +++++--------
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 868bff3b..ee34d67f 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -250,7 +250,7 @@ def __init__(
 
     def get_seed(self):
         # Limit seed size to 32-bit integer for C++ conversion.
-        return self._prng.randint(2 ** 31 - 1)
+        return self._prng.randint(2**31 - 1)
 
     def _run(
         self,
@@ -544,7 +544,7 @@ def simulate_sweep(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2 ** num_qubits * 2:
+            if len(input_vector) != 2**num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
@@ -675,7 +675,7 @@ def simulate_expectation_values_sweep(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2 ** num_qubits * 2:
+            if len(input_vector) != 2**num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
@@ -809,7 +809,7 @@ def simulate_moment_expectation_values(
             if initial_state.dtype != np.complex64:
                 raise TypeError(f"initial_state vector must have dtype np.complex64.")
             input_vector = initial_state.view(np.float32)
-            if len(input_vector) != 2 ** num_qubits * 2:
+            if len(input_vector) != 2**num_qubits * 2:
                 raise ValueError(
                     f"initial_state vector size must match number of qubits."
                     f"Expected: {2**num_qubits * 2} Received: {len(input_vector)}"
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 9b7cf416..f14fc44f 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -287,14 +287,11 @@ def test_iterable_qubit_order():
     )
     qsim_simulator = qsimcirq.QSimSimulator()
 
-    assert (
-        qsim_simulator.compute_amplitudes(
-            circuit,
-            bitstrings=[0b00, 0b01],
-            qubit_order=reversed([q1, q0]),
-        )
-        == qsim_simulator.compute_amplitudes(circuit, bitstrings=[0b00, 0b01])
-    )
+    assert qsim_simulator.compute_amplitudes(
+        circuit,
+        bitstrings=[0b00, 0b01],
+        qubit_order=reversed([q1, q0]),
+    ) == qsim_simulator.compute_amplitudes(circuit, bitstrings=[0b00, 0b01])
 
     assert qsim_simulator.simulate(
         circuit, qubit_order=reversed([q1, q0])

From 2328827af9e6b90ba3fdae9fad229b9f12ff7d6e Mon Sep 17 00:00:00 2001
From: Sergei Isakov <iserge@google.com>
Date: Fri, 1 Apr 2022 17:12:08 +0200
Subject: [PATCH 229/246] Switch to cuStateVec v1.0.0 or higher.

---
 docs/cirq_interface.md              |  5 +++--
 docs/tutorials/gcp_gpu.md           |  3 ++-
 lib/simulator_custatevec.h          | 10 +++++-----
 lib/statespace_custatevec.h         | 10 +++++-----
 tests/statespace_custatevec_test.cu |  1 -
 5 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/docs/cirq_interface.md b/docs/cirq_interface.md
index 321c985c..24149708 100644
--- a/docs/cirq_interface.md
+++ b/docs/cirq_interface.md
@@ -179,8 +179,9 @@ and run on a device with available NVIDIA GPUs.
 
 Compilation for GPU follows the same steps outlined in the
 [Compiling qsimcirq](./cirq_interface.md#compiling-qsimcirq) section.
-To compile with the NVIDIA cuStateVec library, set the environmment variable
-`CUQUANTUM_DIR` to the path to the cuStateVec library.
+To compile with the NVIDIA cuStateVec library (v1.0.0 or higher is required),
+set the environmment variable `CUQUANTUM_DIR` to the path to the cuStateVec
+library.
 
 `QSimOptions` provides five parameters to configure GPU execution. `use_gpu`
 is required to enable GPU execution:
diff --git a/docs/tutorials/gcp_gpu.md b/docs/tutorials/gcp_gpu.md
index e352cfe9..cf57e48d 100644
--- a/docs/tutorials/gcp_gpu.md
+++ b/docs/tutorials/gcp_gpu.md
@@ -179,7 +179,8 @@ After a moment, you should see a result that looks similar to the following.
 
 If you have the [NVIDIA cuQuantum SDK](https://developer.nvidia.com/cuquantum-sdk)
 installed (instructions are provided
-[here](https://docs.nvidia.com/cuda/cuquantum/custatevec/html/getting_started.html#installation-and-compilation)),
+[here](https://docs.nvidia.com/cuda/cuquantum/custatevec/html/getting_started.html#installation-and-compilation),
+cuStateVec v1.0.0 or higher is required),
 you can use it with this tutorial. Before building qsim in step 5,
 set the `CUQUANTUM_DIR` environment variable from the command line:
 
diff --git a/lib/simulator_custatevec.h b/lib/simulator_custatevec.h
index 05e91e16..df01d974 100644
--- a/lib/simulator_custatevec.h
+++ b/lib/simulator_custatevec.h
@@ -65,7 +65,7 @@ class SimulatorCuStateVec final {
     ErrorCheck(custatevecApplyMatrix(
                    handle_, state.get(), kStateType, state.num_qubits(),
                    matrix, kMatrixType, kMatrixLayout, 0,
-                   (int32_t*) qs.data(), qs.size(), nullptr, 0, nullptr,
+                   (int32_t*) qs.data(), qs.size(), nullptr, nullptr, 0,
                    kComputeType, workspace_, workspace_size));
   }
 
@@ -95,7 +95,7 @@ class SimulatorCuStateVec final {
                    handle_, state.get(), kStateType, state.num_qubits(),
                    matrix, kMatrixType, kMatrixLayout, 0,
                    (int32_t*) qs.data(), qs.size(),
-                   (int32_t*) cqs.data(), cqs.size(), control_bits.data(),
+                   (int32_t*) cqs.data(), control_bits.data(), cqs.size(),
                    kComputeType, workspace_, workspace_size));
   }
 
@@ -116,7 +116,7 @@ class SimulatorCuStateVec final {
 
     cuDoubleComplex eval;
 
-    ErrorCheck(custatevecExpectation(
+    ErrorCheck(custatevecComputeExpectation(
                    handle_, state.get(), kStateType, state.num_qubits(),
                    &eval, kExpectType, nullptr, matrix, kMatrixType,
                    kMatrixLayout, (int32_t*) qs.data(), qs.size(),
@@ -138,7 +138,7 @@ class SimulatorCuStateVec final {
       const fp_type* matrix) const {
     size_t size;
 
-    ErrorCheck(custatevecApplyMatrix_bufferSize(
+    ErrorCheck(custatevecApplyMatrixGetWorkspaceSize(
                    handle_, kStateType, num_qubits, matrix, kMatrixType,
                    kMatrixLayout, 0, num_targets, num_controls, kComputeType,
                    &size));
@@ -150,7 +150,7 @@ class SimulatorCuStateVec final {
       unsigned num_qubits, unsigned num_targets, const fp_type* matrix) const {
     size_t size;
 
-    ErrorCheck(custatevecExpectation_bufferSize(
+    ErrorCheck(custatevecComputeExpectationGetWorkspaceSize(
                    handle_, kStateType, num_qubits, matrix, kMatrixType,
                    kMatrixLayout, num_targets, kComputeType, &size));
 
diff --git a/lib/statespace_custatevec.h b/lib/statespace_custatevec.h
index dd2b4599..12d8db55 100644
--- a/lib/statespace_custatevec.h
+++ b/lib/statespace_custatevec.h
@@ -247,15 +247,15 @@ class StateSpaceCuStateVec :
       size_t workspace_size;
       custatevecSamplerDescriptor_t sampler;
 
-      ErrorCheck(custatevecSampler_create(
+      ErrorCheck(custatevecSamplerCreate(
                      custatevec_handle_, state.get(), kStateType,
                      state.num_qubits(), &sampler, num_samples,
                      &workspace_size));
 
       AllocWorkSpace(workspace_size);
 
-      ErrorCheck(custatevecSampler_preprocess(
-                     custatevec_handle_, &sampler, workspace_, workspace_size));
+      ErrorCheck(custatevecSamplerPreprocess(
+                     custatevec_handle_, sampler, workspace_, workspace_size));
 
       std::vector<custatevecIndex_t> bitstrings0(num_samples);
       std::vector<int32_t> bitordering;
@@ -265,8 +265,8 @@ class StateSpaceCuStateVec :
         bitordering.push_back(i);
       }
 
-      ErrorCheck(custatevecSampler_sample(
-                     custatevec_handle_, &sampler, bitstrings0.data(),
+      ErrorCheck(custatevecSamplerSample(
+                     custatevec_handle_, sampler, bitstrings0.data(),
                      bitordering.data(), state.num_qubits(), rs.data(),
                      num_samples, CUSTATEVEC_SAMPLER_OUTPUT_RANDNUM_ORDER));
 
diff --git a/tests/statespace_custatevec_test.cu b/tests/statespace_custatevec_test.cu
index 833bbee0..841be8ee 100644
--- a/tests/statespace_custatevec_test.cu
+++ b/tests/statespace_custatevec_test.cu
@@ -96,7 +96,6 @@ TYPED_TEST(StateSpaceCuStateVecTest, MeasurementLarge) {
 }
 
 TYPED_TEST(StateSpaceCuStateVecTest, Collapse) {
-//  This test fails.
   TestCollapse(qsim::Factory<TypeParam>());
 }
 

From c44a31089cffa818561499796f0c7069acf84cd4 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 8 Apr 2022 10:19:28 -0700
Subject: [PATCH 230/246] Reduce isinstance calls

---
 qsimcirq/qsim_circuit.py | 254 ++++++++++++++++++++++-----------------
 1 file changed, 142 insertions(+), 112 deletions(-)

diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index 912f8fd7..689df881 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -33,104 +33,140 @@
     "theta",
 ]
 
-
-def _cirq_gate_kind(gate: cirq.ops.Gate):
-    if isinstance(gate, cirq.ops.ControlledGate):
-        return _cirq_gate_kind(gate.sub_gate)
-    if isinstance(gate, cirq.ops.identity.IdentityGate):
-        # Identity gates will decompose to no-ops.
-        pass
-    if isinstance(gate, cirq.ops.XPowGate):
-        # cirq.rx also uses this path.
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kX
-        return qsim.kXPowGate
-    if isinstance(gate, cirq.ops.YPowGate):
-        # cirq.ry also uses this path.
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kY
-        return qsim.kYPowGate
-    if isinstance(gate, cirq.ops.ZPowGate):
-        # cirq.rz also uses this path.
-        if gate.global_shift == 0:
-            if gate.exponent == 1:
-                return qsim.kZ
-            if gate.exponent == 0.5:
-                return qsim.kS
-            if gate.exponent == 0.25:
-                return qsim.kT
-        return qsim.kZPowGate
-    if isinstance(gate, cirq.ops.HPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kH
-        return qsim.kHPowGate
-    if isinstance(gate, cirq.ops.CZPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kCZ
-        return qsim.kCZPowGate
-    if isinstance(gate, cirq.ops.CXPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kCX
-        return qsim.kCXPowGate
-    if isinstance(gate, cirq.ops.PhasedXPowGate):
-        return qsim.kPhasedXPowGate
-    if isinstance(gate, cirq.ops.PhasedXZGate):
-        return qsim.kPhasedXZGate
-    if isinstance(gate, cirq.ops.XXPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kXX
-        return qsim.kXXPowGate
-    if isinstance(gate, cirq.ops.YYPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kYY
-        return qsim.kYYPowGate
-    if isinstance(gate, cirq.ops.ZZPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kZZ
-        return qsim.kZZPowGate
-    if isinstance(gate, cirq.ops.SwapPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kSWAP
-        return qsim.kSwapPowGate
-    if isinstance(gate, cirq.ops.ISwapPowGate):
-        # cirq.riswap also uses this path.
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kISWAP
-        return qsim.kISwapPowGate
-    if isinstance(gate, cirq.ops.PhasedISwapPowGate):
-        # cirq.givens also uses this path.
-        return qsim.kPhasedISwapPowGate
-    if isinstance(gate, cirq.ops.FSimGate):
-        return qsim.kFSimGate
-    if isinstance(gate, cirq.ops.TwoQubitDiagonalGate):
-        return qsim.kTwoQubitDiagonalGate
-    if isinstance(gate, cirq.ops.ThreeQubitDiagonalGate):
-        return qsim.kThreeQubitDiagonalGate
-    if isinstance(gate, cirq.ops.CCZPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kCCZ
-        return qsim.kCCZPowGate
-    if isinstance(gate, cirq.ops.CCXPowGate):
-        if gate.exponent == 1 and gate.global_shift == 0:
-            return qsim.kCCX
-        return qsim.kCCXPowGate
-    if isinstance(gate, cirq.ops.CSwapGate):
-        return qsim.kCSwapGate
-    if isinstance(gate, cirq.ops.MatrixGate):
-        if gate.num_qubits() <= 6:
-            return qsim.kMatrixGate
-        raise NotImplementedError(
-            f"Received matrix on {gate.num_qubits()} qubits; "
-            + "only up to 6-qubit gates are supported."
-        )
-    if isinstance(gate, cirq.ops.MeasurementGate):
-        # needed to inherit SimulatesSamples in sims
-        return qsim.kMeasurement
+def _translate_ControlledGate(gate: cirq.ControlledGate):
+    return _cirq_gate_kind(gate.sub_gate)
+def _translate_IdentityGate(gate: cirq.IdentityGate):
+    # Identity gates will decompose to no-ops.
+    pass
+def _translate_XPowGate(gate: cirq.XPowGate):
+    # cirq.rx also uses this path.
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kX
+    return qsim.kXPowGate
+def _translate_YPowGate(gate: cirq.YPowGate):
+    # cirq.ry also uses this path.
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kY
+    return qsim.kYPowGate
+def _translate_ZPowGate(gate: cirq.ZPowGate):
+    # cirq.rz also uses this path.
+    if gate.global_shift == 0:
+        if gate.exponent == 1:
+            return qsim.kZ
+        if gate.exponent == 0.5:
+            return qsim.kS
+        if gate.exponent == 0.25:
+            return qsim.kT
+    return qsim.kZPowGate
+def _translate_HPowGate(gate: cirq.HPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kH
+    return qsim.kHPowGate
+def _translate(gate: cirq.CZPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kCZ
+    return qsim.kCZPowGate
+def _translate_CXPowGate(gate: cirq.CXPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kCX
+    return qsim.kCXPowGate
+def _translate_PhasedXPowGate(gate: cirq.PhasedXPowGate):
+    return qsim.kPhasedXPowGate
+def _translate_PhasedXZGate(gate: cirq.PhasedXZGate):
+    return qsim.kPhasedXZGate
+def _translate_XXPowGate(gate: cirq.XXPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kXX
+    return qsim.kXXPowGate
+def _translate_YYPowGate(gate: cirq.YYPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kYY
+    return qsim.kYYPowGate
+def _translate_ZZPowGate(gate: cirq.ZZPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kZZ
+    return qsim.kZZPowGate
+def _translate_SwapPowGate(gate: cirq.SwapPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kSWAP
+    return qsim.kSwapPowGate
+def _translate_ISwapPowGate(gate: cirq.ISwapPowGate):
+    # cirq.riswap also uses this path.
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kISWAP
+    return qsim.kISwapPowGate
+def _translate_PhasedISwapPowGate(gate: cirq.PhasedISwapPowGate):
+    # cirq.givens also uses this path.
+    return qsim.kPhasedISwapPowGate
+def _translate_FSimGate(gate: cirq.FSimGate):
+    return qsim.kFSimGate
+def _translate_TwoQubitDiagonalGate(gate: cirq.TwoQubitDiagonalGate):
+    return qsim.kTwoQubitDiagonalGate
+def _translate_ThreeQubitDiagonalGate(gate: cirq.ThreeQubitDiagonalGate):
+    return qsim.kThreeQubitDiagonalGate
+def _translate_CCZPowGate(gate: cirq.CCZPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kCCZ
+    return qsim.kCCZPowGate
+def _translate_CCXPowGate(gate: cirq.CCXPowGate):
+    if gate.exponent == 1 and gate.global_shift == 0:
+        return qsim.kCCX
+    return qsim.kCCXPowGate
+def _translate_CSwapGate(gate: cirq.CSwapGate):
+    return qsim.kCSwapGate
+def _translate_MatrixGate(gate: cirq.MatrixGate):
+    if gate.num_qubits() <= 6:
+        return qsim.kMatrixGate
+    raise NotImplementedError(
+        f"Received matrix on {gate.num_qubits()} qubits; "
+        + "only up to 6-qubit gates are supported."
+    )
+def _translate_MeasurementGate(gate: cirq.MeasurementGate):
+    # needed to inherit SimulatesSamples in sims
+    return qsim.kMeasurement
+
+
+TYPE_TRANSLATOR = {
+    cirq.ControlledGate: _translate_ControlledGate,
+    cirq.IdentityGate: _translate_IdentityGate,
+    cirq.XPowGate: _translate_XPowGate,
+    cirq.YPowGate: _translate_YPowGate,
+    cirq.ZPowGate: _translate_ZPowGate,
+    cirq.HPowGate: _translate_HPowGate,
+    cirq.CXPowGate: _translate_CXPowGate,
+    cirq.PhasedXPowGate: _translate_PhasedXPowGate,
+    cirq.PhasedXZGate: _translate_PhasedXZGate,
+    cirq.XXPowGate: _translate_XXPowGate,
+    cirq.YYPowGate: _translate_YYPowGate,
+    cirq.ZZPowGate: _translate_ZZPowGate,
+    cirq.SwapPowGate: _translate_SwapPowGate,
+    cirq.ISwapPowGate: _translate_ISwapPowGate,
+    cirq.PhasedISwapPowGate: _translate_PhasedISwapPowGate,
+    cirq.FSimGate: _translate_FSimGate,
+    cirq.TwoQubitDiagonalGate: _translate_TwoQubitDiagonalGate,
+    cirq.ThreeQubitDiagonalGate: _translate_ThreeQubitDiagonalGate,
+    cirq.CCZPowGate: _translate_CCZPowGate,
+    cirq.CCXPowGate: _translate_CCXPowGate,
+    cirq.CSwapGate: _translate_CSwapGate,
+    cirq.MatrixGate: _translate_MatrixGate,
+    cirq.MeasurementGate: _translate_MeasurementGate,
+}
+
+
+def _cirq_gate_kind(gate: cirq.Gate):
+    for gate_type in type(gate).mro():
+        translator = TYPE_TRANSLATOR.get(gate_type, None)
+        if translator is not None:
+            return translator(gate)
     # Unrecognized gates will be decomposed.
     return None
 
 
-def _control_details(gate: cirq.ops.ControlledGate, qubits):
+def _has_cirq_gate_kind(op: cirq.Operation):
+    return any(t in TYPE_TRANSLATOR for t in type(op.gate).mro())
+
+
+def _control_details(gate: cirq.ControlledGate, qubits):
     control_qubits = []
     control_values = []
     # TODO: support qudit control
@@ -169,7 +205,7 @@ def add_op_to_opstring(
     if len(qsim_op.qubits) != 1:
         raise ValueError(f"OpString ops should have 1 qubit; got {len(qsim_op.qubits)}")
 
-    is_controlled = isinstance(qsim_gate, cirq.ops.ControlledGate)
+    is_controlled = isinstance(qsim_gate, cirq.ControlledGate)
     if is_controlled:
         raise ValueError(f"OpString ops should not be controlled.")
 
@@ -189,7 +225,7 @@ def add_op_to_circuit(
     qubits = [qubit_to_index_dict[q] for q in qsim_op.qubits]
 
     qsim_qubits = qubits
-    is_controlled = isinstance(qsim_gate, cirq.ops.ControlledGate)
+    is_controlled = isinstance(qsim_gate, cirq.ControlledGate)
     if is_controlled:
         control_qubits, control_values = _control_details(qsim_gate, qubits)
         if control_qubits is None:
@@ -280,7 +316,7 @@ def _resolve_parameters_(
         )
 
     def translate_cirq_to_qsim(
-        self, qubit_order: cirq.ops.QubitOrderOrList = cirq.ops.QubitOrder.DEFAULT
+        self, qubit_order: cirq.QubitOrderOrList = cirq.QubitOrder.DEFAULT
     ) -> qsim.Circuit:
         """
         Translates this Cirq circuit to the qsim representation.
@@ -290,7 +326,7 @@ def translate_cirq_to_qsim(
         """
 
         qsim_circuit = qsim.Circuit()
-        ordered_qubits = cirq.ops.QubitOrder.as_qubit_order(qubit_order).order_for(
+        ordered_qubits = cirq.QubitOrder.as_qubit_order(qubit_order).order_for(
             self.all_qubits()
         )
         qsim_circuit.num_qubits = len(ordered_qubits)
@@ -298,15 +334,12 @@ def translate_cirq_to_qsim(
         # qsim numbers qubits in reverse order from cirq
         ordered_qubits = list(reversed(ordered_qubits))
 
-        def has_qsim_kind(op: cirq.ops.GateOperation):
-            return _cirq_gate_kind(op.gate) != None
-
-        def to_matrix(op: cirq.ops.GateOperation):
+        def to_matrix(op: cirq.GateOperation):
             mat = cirq.unitary(op.gate, None)
             if mat is None:
                 return NotImplemented
 
-            return cirq.ops.MatrixGate(mat).on(*op.qubits)
+            return cirq.MatrixGate(mat).on(*op.qubits)
 
         qubit_to_index_dict = {q: i for i, q in enumerate(ordered_qubits)}
         time_offset = 0
@@ -314,7 +347,7 @@ def to_matrix(op: cirq.ops.GateOperation):
         moment_indices = []
         for moment in self:
             ops_by_gate = [
-                cirq.decompose(op, fallback_decomposer=to_matrix, keep=has_qsim_kind)
+                cirq.decompose(op, fallback_decomposer=to_matrix, keep=_has_cirq_gate_kind)
                 for op in moment
             ]
             moment_length = max((len(gate_ops) for gate_ops in ops_by_gate), default=0)
@@ -334,7 +367,7 @@ def to_matrix(op: cirq.ops.GateOperation):
         return qsim_circuit, moment_indices
 
     def translate_cirq_to_qtrajectory(
-        self, qubit_order: cirq.ops.QubitOrderOrList = cirq.ops.QubitOrder.DEFAULT
+        self, qubit_order: cirq.QubitOrderOrList = cirq.QubitOrder.DEFAULT
     ) -> qsim.NoisyCircuit:
         """
         Translates this noisy Cirq circuit to the qsim representation.
@@ -343,7 +376,7 @@ def translate_cirq_to_qtrajectory(
             gate indices)
         """
         qsim_ncircuit = qsim.NoisyCircuit()
-        ordered_qubits = cirq.ops.QubitOrder.as_qubit_order(qubit_order).order_for(
+        ordered_qubits = cirq.QubitOrder.as_qubit_order(qubit_order).order_for(
             self.all_qubits()
         )
 
@@ -352,15 +385,12 @@ def translate_cirq_to_qtrajectory(
 
         qsim_ncircuit.num_qubits = len(ordered_qubits)
 
-        def has_qsim_kind(op: cirq.ops.GateOperation):
-            return _cirq_gate_kind(op.gate) != None
-
-        def to_matrix(op: cirq.ops.GateOperation):
+        def to_matrix(op: cirq.GateOperation):
             mat = cirq.unitary(op.gate, None)
             if mat is None:
                 return NotImplemented
 
-            return cirq.ops.MatrixGate(mat).on(*op.qubits)
+            return cirq.MatrixGate(mat).on(*op.qubits)
 
         qubit_to_index_dict = {q: i for i, q in enumerate(ordered_qubits)}
         time_offset = 0
@@ -375,7 +405,7 @@ def to_matrix(op: cirq.ops.GateOperation):
             for qsim_op in moment:
                 if cirq.has_unitary(qsim_op) or cirq.is_measurement(qsim_op):
                     oplist = cirq.decompose(
-                        qsim_op, fallback_decomposer=to_matrix, keep=has_qsim_kind
+                        qsim_op, fallback_decomposer=to_matrix, keep=_has_cirq_gate_kind
                     )
                     ops_by_gate.append(oplist)
                     moment_length = max(moment_length, len(oplist))

From e4bcadc6a05e9fd14c0ca551ef323b87cdb9df0a Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 8 Apr 2022 12:30:06 -0700
Subject: [PATCH 231/246] format

---
 qsimcirq/qsim_circuit.py | 51 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index 689df881..67324a75 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -33,21 +33,30 @@
     "theta",
 ]
 
+
 def _translate_ControlledGate(gate: cirq.ControlledGate):
     return _cirq_gate_kind(gate.sub_gate)
+
+
 def _translate_IdentityGate(gate: cirq.IdentityGate):
     # Identity gates will decompose to no-ops.
     pass
+
+
 def _translate_XPowGate(gate: cirq.XPowGate):
     # cirq.rx also uses this path.
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kX
     return qsim.kXPowGate
+
+
 def _translate_YPowGate(gate: cirq.YPowGate):
     # cirq.ry also uses this path.
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kY
     return qsim.kYPowGate
+
+
 def _translate_ZPowGate(gate: cirq.ZPowGate):
     # cirq.rz also uses this path.
     if gate.global_shift == 0:
@@ -58,62 +67,98 @@ def _translate_ZPowGate(gate: cirq.ZPowGate):
         if gate.exponent == 0.25:
             return qsim.kT
     return qsim.kZPowGate
+
+
 def _translate_HPowGate(gate: cirq.HPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kH
     return qsim.kHPowGate
+
+
 def _translate(gate: cirq.CZPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kCZ
     return qsim.kCZPowGate
+
+
 def _translate_CXPowGate(gate: cirq.CXPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kCX
     return qsim.kCXPowGate
+
+
 def _translate_PhasedXPowGate(gate: cirq.PhasedXPowGate):
     return qsim.kPhasedXPowGate
+
+
 def _translate_PhasedXZGate(gate: cirq.PhasedXZGate):
     return qsim.kPhasedXZGate
+
+
 def _translate_XXPowGate(gate: cirq.XXPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kXX
     return qsim.kXXPowGate
+
+
 def _translate_YYPowGate(gate: cirq.YYPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kYY
     return qsim.kYYPowGate
+
+
 def _translate_ZZPowGate(gate: cirq.ZZPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kZZ
     return qsim.kZZPowGate
+
+
 def _translate_SwapPowGate(gate: cirq.SwapPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kSWAP
     return qsim.kSwapPowGate
+
+
 def _translate_ISwapPowGate(gate: cirq.ISwapPowGate):
     # cirq.riswap also uses this path.
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kISWAP
     return qsim.kISwapPowGate
+
+
 def _translate_PhasedISwapPowGate(gate: cirq.PhasedISwapPowGate):
     # cirq.givens also uses this path.
     return qsim.kPhasedISwapPowGate
+
+
 def _translate_FSimGate(gate: cirq.FSimGate):
     return qsim.kFSimGate
+
+
 def _translate_TwoQubitDiagonalGate(gate: cirq.TwoQubitDiagonalGate):
     return qsim.kTwoQubitDiagonalGate
+
+
 def _translate_ThreeQubitDiagonalGate(gate: cirq.ThreeQubitDiagonalGate):
     return qsim.kThreeQubitDiagonalGate
+
+
 def _translate_CCZPowGate(gate: cirq.CCZPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kCCZ
     return qsim.kCCZPowGate
+
+
 def _translate_CCXPowGate(gate: cirq.CCXPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kCCX
     return qsim.kCCXPowGate
+
+
 def _translate_CSwapGate(gate: cirq.CSwapGate):
     return qsim.kCSwapGate
+
+
 def _translate_MatrixGate(gate: cirq.MatrixGate):
     if gate.num_qubits() <= 6:
         return qsim.kMatrixGate
@@ -121,6 +166,8 @@ def _translate_MatrixGate(gate: cirq.MatrixGate):
         f"Received matrix on {gate.num_qubits()} qubits; "
         + "only up to 6-qubit gates are supported."
     )
+
+
 def _translate_MeasurementGate(gate: cirq.MeasurementGate):
     # needed to inherit SimulatesSamples in sims
     return qsim.kMeasurement
@@ -347,7 +394,9 @@ def to_matrix(op: cirq.GateOperation):
         moment_indices = []
         for moment in self:
             ops_by_gate = [
-                cirq.decompose(op, fallback_decomposer=to_matrix, keep=_has_cirq_gate_kind)
+                cirq.decompose(
+                    op, fallback_decomposer=to_matrix, keep=_has_cirq_gate_kind
+                )
                 for op in moment
             ]
             moment_length = max((len(gate_ops) for gate_ops in ops_by_gate), default=0)

From f6d281de923309883aadb3066a4ee35dfb2706b2 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 8 Apr 2022 12:50:47 -0700
Subject: [PATCH 232/246] Repair tests

---
 qsimcirq/qsim_circuit.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index 67324a75..df9572a0 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -38,11 +38,6 @@ def _translate_ControlledGate(gate: cirq.ControlledGate):
     return _cirq_gate_kind(gate.sub_gate)
 
 
-def _translate_IdentityGate(gate: cirq.IdentityGate):
-    # Identity gates will decompose to no-ops.
-    pass
-
-
 def _translate_XPowGate(gate: cirq.XPowGate):
     # cirq.rx also uses this path.
     if gate.exponent == 1 and gate.global_shift == 0:
@@ -175,7 +170,6 @@ def _translate_MeasurementGate(gate: cirq.MeasurementGate):
 
 TYPE_TRANSLATOR = {
     cirq.ControlledGate: _translate_ControlledGate,
-    cirq.IdentityGate: _translate_IdentityGate,
     cirq.XPowGate: _translate_XPowGate,
     cirq.YPowGate: _translate_YPowGate,
     cirq.ZPowGate: _translate_ZPowGate,
@@ -210,6 +204,8 @@ def _cirq_gate_kind(gate: cirq.Gate):
 
 
 def _has_cirq_gate_kind(op: cirq.Operation):
+    if isinstance(op, cirq.ControlledOperation):
+        return _has_cirq_gate_kind(op.sub_operation)
     return any(t in TYPE_TRANSLATOR for t in type(op.gate).mro())
 
 

From 04065804ccd1950a685c755ada6e50b3f39fd111 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Mon, 11 Apr 2022 11:46:53 -0700
Subject: [PATCH 233/246] Include CZ

---
 qsimcirq/qsim_circuit.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/qsimcirq/qsim_circuit.py b/qsimcirq/qsim_circuit.py
index df9572a0..3b23d945 100644
--- a/qsimcirq/qsim_circuit.py
+++ b/qsimcirq/qsim_circuit.py
@@ -70,7 +70,7 @@ def _translate_HPowGate(gate: cirq.HPowGate):
     return qsim.kHPowGate
 
 
-def _translate(gate: cirq.CZPowGate):
+def _translate_CZPowGate(gate: cirq.CZPowGate):
     if gate.exponent == 1 and gate.global_shift == 0:
         return qsim.kCZ
     return qsim.kCZPowGate
@@ -174,6 +174,7 @@ def _translate_MeasurementGate(gate: cirq.MeasurementGate):
     cirq.YPowGate: _translate_YPowGate,
     cirq.ZPowGate: _translate_ZPowGate,
     cirq.HPowGate: _translate_HPowGate,
+    cirq.CZPowGate: _translate_CZPowGate,
     cirq.CXPowGate: _translate_CXPowGate,
     cirq.PhasedXPowGate: _translate_PhasedXPowGate,
     cirq.PhasedXZGate: _translate_PhasedXZGate,

From 53025df032e1b9296713f3d8f7866e9936ed1af7 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 22 Apr 2022 09:51:16 -0700
Subject: [PATCH 234/246] Update to dev version 2022-04-22

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index 1315a776..a2c2c9c2 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.12.1"
+__version__ = "0.12.2.dev20220422"

From 68df71712ff607b9e0f7eff293923773cf07bda9 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Tue, 3 May 2022 13:49:17 -0700
Subject: [PATCH 235/246] Remove usage of deprecated `cirq.SingleQubitGate`

---
 qsimcirq_tests/qsimcirq_test.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index f14fc44f..6e516676 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -19,7 +19,7 @@
 import qsimcirq
 
 
-class NoiseTrigger(cirq.SingleQubitGate):
+class NoiseTrigger(cirq.Gate):
     """A no-op gate with no _unitary_ method defined.
 
     Appending this gate to a circuit will force it to use qtrajectory, but the
@@ -29,6 +29,9 @@ class NoiseTrigger(cirq.SingleQubitGate):
     # def _mixture_(self):
     #   return ((1.0, np.asarray([1, 0, 0, 1])),)
 
+    def _num_qubits_(self) -> int:
+        return 1
+
     def _kraus_(self):
         return (np.asarray([1, 0, 0, 1]),)
 

From a5944a8cec8bcc2c6a19b76165ac55ccc833b1e3 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 May 2022 12:52:26 -0700
Subject: [PATCH 236/246] Remove mac-arm build from release

---
 .github/workflows/release_wheels.yml | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/.github/workflows/release_wheels.yml b/.github/workflows/release_wheels.yml
index abf5c7a1..33550cb7 100644
--- a/.github/workflows/release_wheels.yml
+++ b/.github/workflows/release_wheels.yml
@@ -15,12 +15,7 @@ jobs:
           - os: macos-10.15
             name: mac
             cibw:
-              build: "cp36* cp37* cp38*"
-          - os: macos-10.15
-            name: mac-arm
-            cibw:
-              arch: universal2
-              build: "cp39*"
+              build: "cp36* cp37* cp38* cp39*"
           - os: ubuntu-20.04
             name: manylinux2014
             cibw:

From 963efd8241c80eec796f8bef3f88419b883bd138 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Fri, 13 May 2022 12:53:11 -0700
Subject: [PATCH 237/246] Remove mac-arm from wheel tests

---
 .github/workflows/testing_wheels.yml | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/.github/workflows/testing_wheels.yml b/.github/workflows/testing_wheels.yml
index 55dd237a..916f728b 100644
--- a/.github/workflows/testing_wheels.yml
+++ b/.github/workflows/testing_wheels.yml
@@ -20,12 +20,7 @@ jobs:
           - os: macos-10.15
             name: mac
             cibw:
-              build: "cp36* cp37* cp38*"
-          - os: macos-10.15
-            name: mac-arm
-            cibw:
-              arch: universal2
-              build: "cp39*"
+              build: "cp36* cp37* cp38* cp39*"
           - os: ubuntu-20.04
             name: manylinux2014
             cibw:

From ec74f20a9072ddeb7f31175de30b3cf7fcdeca99 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Fri, 27 May 2022 16:11:15 -0700
Subject: [PATCH 238/246] Add support for repeated keys in QSimSimulator

---
 qsimcirq/qsim_simulator.py      | 33 +++++++++++++++++++--------------
 qsimcirq_tests/qsimcirq_test.py | 16 ++++++++++++++++
 2 files changed, 35 insertions(+), 14 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index ee34d67f..3353f959 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -323,8 +323,8 @@ def _sample_measure_results(
                 cirq.MeasurementGate
             )
         ]
-        measured_qubits: List[cirq.Qid] = []
-        bounds: Dict[str, Tuple] = {}
+        num_qubits_by_key: Dict[str, int] = {}
+        bounds: Dict[str, Tuple[int, int]] = {}
         meas_ops: Dict[str, List[cirq.GateOperation]] = {}
         current_index = 0
         for op in measurement_ops:
@@ -332,21 +332,26 @@ def _sample_measure_results(
             key = cirq.measurement_key_name(gate)
             meas_ops.setdefault(key, [])
             meas_ops[key].append(op)
-            if key in bounds:
-                raise ValueError(f"Duplicate MeasurementGate with key {key}")
-            bounds[key] = (current_index, current_index + len(op.qubits))
-            measured_qubits.extend(op.qubits)
-            current_index += len(op.qubits)
+            n = len(op.qubits)
+            if key in num_qubits_by_key:
+                if n != num_qubits_by_key[key]:
+                    raise ValueError(
+                        f'repeated key {key!r} with different numbers of qubits: '
+                        f'{num_qubits_by_key[key]} != {n}'
+                    )
+            else:
+                num_qubits_by_key[key] = n
+            if key not in bounds:
+                bounds[key] = (current_index, current_index + n)
+            current_index += n
 
         # Set qsim options
-        options = {}
-        options.update(self.qsim_options)
+        options = {**self.qsim_options}
 
-        results = {}
-        for key, bound in bounds.items():
-            results[key] = np.ndarray(
-                shape=(repetitions, len(meas_ops[key]), bound[1] - bound[0]), dtype=int
-            )
+        results = {
+            key: np.ndarray(shape=(repetitions, len(meas_ops[key]), n), dtype=int)
+            for key, n in num_qubits_by_key.items()
+        }
 
         noisy = _needs_trajectories(program)
         if not noisy and program.are_all_measurements_terminal() and repetitions > 1:
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 6e516676..e0d84bad 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -57,6 +57,22 @@ def test_empty_moment(mode: str):
     assert result.final_state_vector.shape == (4,)
 
 
+def test_repeated_keys():
+    q = cirq.LineQubit(0)
+    circuit = cirq.Circuit(
+        cirq.measure(q, key='m'),
+        cirq.X(q),
+        cirq.measure(q, key='m'),
+        cirq.X(q),
+        cirq.measure(q, key='m'),
+    )
+    result = qsimcirq.QSimSimulator().simulate(circuit, repetitions=10)
+    assert result.records['m'] == (10, 3, 1)
+    assert np.all(result.records['m'][:, 0, :] == 0)
+    assert np.all(result.records['m'][:, 1, :] == 1)
+    assert np.all(result.records['m'][:, 2, :] == 0)
+
+
 def test_cirq_too_big_gate():
     # Pick qubits.
     a, b, c, d, e, f, g = [

From e3068c49a80506c6fd72c00e74e148e7868a5e3b Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Fri, 27 May 2022 16:23:48 -0700
Subject: [PATCH 239/246] Format

---
 qsimcirq/qsim_simulator.py      |  4 ++--
 qsimcirq_tests/qsimcirq_test.py | 14 +++++++-------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 3353f959..d6b3c1e5 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -336,8 +336,8 @@ def _sample_measure_results(
             if key in num_qubits_by_key:
                 if n != num_qubits_by_key[key]:
                     raise ValueError(
-                        f'repeated key {key!r} with different numbers of qubits: '
-                        f'{num_qubits_by_key[key]} != {n}'
+                        f"repeated key {key!r} with different numbers of qubits: "
+                        f"{num_qubits_by_key[key]} != {n}"
                     )
             else:
                 num_qubits_by_key[key] = n
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index e0d84bad..5320865b 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -60,17 +60,17 @@ def test_empty_moment(mode: str):
 def test_repeated_keys():
     q = cirq.LineQubit(0)
     circuit = cirq.Circuit(
-        cirq.measure(q, key='m'),
+        cirq.measure(q, key="m"),
         cirq.X(q),
-        cirq.measure(q, key='m'),
+        cirq.measure(q, key="m"),
         cirq.X(q),
-        cirq.measure(q, key='m'),
+        cirq.measure(q, key="m"),
     )
     result = qsimcirq.QSimSimulator().simulate(circuit, repetitions=10)
-    assert result.records['m'] == (10, 3, 1)
-    assert np.all(result.records['m'][:, 0, :] == 0)
-    assert np.all(result.records['m'][:, 1, :] == 1)
-    assert np.all(result.records['m'][:, 2, :] == 0)
+    assert result.records["m"] == (10, 3, 1)
+    assert np.all(result.records["m"][:, 0, :] == 0)
+    assert np.all(result.records["m"][:, 1, :] == 1)
+    assert np.all(result.records["m"][:, 2, :] == 0)
 
 
 def test_cirq_too_big_gate():

From 6d0397993ec36b77519166d46d2c32dc12705b9b Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Fri, 27 May 2022 16:25:43 -0700
Subject: [PATCH 240/246] s/simulate/run/

---
 qsimcirq_tests/qsimcirq_test.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 5320865b..82651df7 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -66,7 +66,7 @@ def test_repeated_keys():
         cirq.X(q),
         cirq.measure(q, key="m"),
     )
-    result = qsimcirq.QSimSimulator().simulate(circuit, repetitions=10)
+    result = qsimcirq.QSimSimulator().run(circuit, repetitions=10)
     assert result.records["m"] == (10, 3, 1)
     assert np.all(result.records["m"][:, 0, :] == 0)
     assert np.all(result.records["m"][:, 1, :] == 1)

From 99d4ce9e8e19749e6c19214557ecde3d9aa26b9f Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Tue, 31 May 2022 09:26:30 -0700
Subject: [PATCH 241/246] Store bounds for each instance of a measurement key

---
 qsimcirq/qsim_simulator.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index d6b3c1e5..06df3f8f 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -324,7 +324,7 @@ def _sample_measure_results(
             )
         ]
         num_qubits_by_key: Dict[str, int] = {}
-        bounds: Dict[str, Tuple[int, int]] = {}
+        bounds: List[Tuple[str, int, int]] = []
         meas_ops: Dict[str, List[cirq.GateOperation]] = {}
         current_index = 0
         for op in measurement_ops:
@@ -341,8 +341,7 @@ def _sample_measure_results(
                     )
             else:
                 num_qubits_by_key[key] = n
-            if key not in bounds:
-                bounds[key] = (current_index, current_index + n)
+            bounds.append((key, current_index, current_index + n))
             current_index += n
 
         # Set qsim options
@@ -414,7 +413,7 @@ def _sample_measure_results(
                 options["s"] = self.get_seed()
                 measurements[i] = sampler_fn(options)
 
-            for key, (start, end) in bounds.items():
+            for key, start, end in bounds:
                 for i, op in enumerate(meas_ops[key]):
                     invert_mask = op.gate.full_invert_mask()
                     results[key][:, i, :] = measurements[:, start:end] ^ invert_mask

From 4b828c38ab78c02fc889a16a0f1f64a7d3db06bd Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Tue, 31 May 2022 10:03:32 -0700
Subject: [PATCH 242/246] Fix bounds calculation

---
 qsimcirq/qsim_simulator.py      | 38 +++++++++++++--------------------
 qsimcirq_tests/qsimcirq_test.py |  2 +-
 2 files changed, 16 insertions(+), 24 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 06df3f8f..78a85e92 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -313,10 +313,13 @@ def _sample_measure_results(
 
         qubit_map = {qubit: index for index, qubit in enumerate(ordered_qubits)}
 
-        # Computes
-        # - the list of qubits to be measured
-        # - the start (inclusive) and end (exclusive) indices of each measurement
-        # - a mapping from measurement key to measurement gate
+        # Compute:
+        # - number of qubits for each measurement key.
+        # - measurement ops for each measurement key.
+        # - info about each measurement, including the key, instance (for repeated keys),
+        #   start (inclusive) and end (exclusive) indices in the qsim output, and
+        #   invert mask.
+        # - total number of measured bits.
         measurement_ops = [
             op
             for _, op, _ in program.findall_operations_with_gate_type(
@@ -324,13 +327,14 @@ def _sample_measure_results(
             )
         ]
         num_qubits_by_key: Dict[str, int] = {}
-        bounds: List[Tuple[str, int, int]] = []
         meas_ops: Dict[str, List[cirq.GateOperation]] = {}
-        current_index = 0
+        info: List[Tuple[str, int, Tuple[bool, ...], int, int]] = []
+        num_bits = 0
         for op in measurement_ops:
             gate = op.gate
             key = cirq.measurement_key_name(gate)
             meas_ops.setdefault(key, [])
+            i = len(meas_ops[key])
             meas_ops[key].append(op)
             n = len(op.qubits)
             if key in num_qubits_by_key:
@@ -341,8 +345,8 @@ def _sample_measure_results(
                     )
             else:
                 num_qubits_by_key[key] = n
-            bounds.append((key, current_index, current_index + n))
-            current_index += n
+            info.append((key, i, gate.full_invert_mask(), num_bits, num_bits + n))
+            num_bits += n
 
         # Set qsim options
         options = {**self.qsim_options}
@@ -398,25 +402,13 @@ def _sample_measure_results(
                 translator_fn_name,
                 cirq.QubitOrder.DEFAULT,
             )
-            measurements = np.empty(
-                shape=(
-                    repetitions,
-                    sum(
-                        cirq.num_qubits(op)
-                        for oplist in meas_ops.values()
-                        for op in oplist
-                    ),
-                ),
-                dtype=int,
-            )
+            measurements = np.empty(shape=(repetitions, num_bits), dtype=int)
             for i in range(repetitions):
                 options["s"] = self.get_seed()
                 measurements[i] = sampler_fn(options)
 
-            for key, start, end in bounds:
-                for i, op in enumerate(meas_ops[key]):
-                    invert_mask = op.gate.full_invert_mask()
-                    results[key][:, i, :] = measurements[:, start:end] ^ invert_mask
+            for key, i, invert_mask, start, end in info:
+                results[key][:, i, :] = measurements[:, start:end] ^ invert_mask
 
         return results
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index 82651df7..ec8c4a23 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -67,7 +67,7 @@ def test_repeated_keys():
         cirq.measure(q, key="m"),
     )
     result = qsimcirq.QSimSimulator().run(circuit, repetitions=10)
-    assert result.records["m"] == (10, 3, 1)
+    assert result.records["m"].shape == (10, 3, 1)
     assert np.all(result.records["m"][:, 0, :] == 0)
     assert np.all(result.records["m"][:, 1, :] == 1)
     assert np.all(result.records["m"][:, 2, :] == 0)

From 8cdd0bfbc8915f41595150b210cdb489265d299d Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Tue, 31 May 2022 11:21:15 -0700
Subject: [PATCH 243/246] Remove unused imports

---
 qsimcirq/qsim_simulator.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index 78a85e92..b15bee0a 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -14,8 +14,7 @@
 
 from collections import deque
 from dataclasses import dataclass
-from typing import Any, Dict, Iterator, List, Optional, Sequence, Tuple, Union
-from xml.etree.ElementPath import ops
+from typing import Any, Dict, List, Optional, Sequence, Tuple, Union
 
 import cirq
 

From 4ca3c883c6103f2c6d26982b845218940d01c5f4 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Tue, 31 May 2022 12:38:45 -0700
Subject: [PATCH 244/246] Update testing instructions in README (#532)

Review: @95-martin-orion
---
 README.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index b5e5f6f9..767e4c2c 100644
--- a/README.md
+++ b/README.md
@@ -85,12 +85,14 @@ located in [tests](https://github.com/quantumlib/qsim/tree/master/tests).
 Python tests use pytest, and are located in
 [qsimcirq_tests](https://github.com/quantumlib/qsim/tree/master/qsimcirq_tests).
 
-To build and run all tests, navigate to the test directory and run:
+To build and run all tests, run:
 ```
-make run-all
+make run-tests
 ```
 This will compile all test binaries to files with `.x` extensions, and run each
-test in series. Testing will stop early if a test fails.
+test in series. Testing will stop early if a test fails. It will also run tests
+of the `qsimcirq` python interface. To run C++ or python tests only, run
+`make run-cxx-tests` or `make run-py-tests`, respectively.
 
 To clean up generated test files, run `make clean` from the test directory.
 
@@ -125,4 +127,4 @@ An equivalent BibTex format reference is below for all the versions:
   doi          = {10.5281/zenodo.4023103},
   url          = {https://doi.org/10.5281/zenodo.4023103}
 }
-```
\ No newline at end of file
+```

From ece373cb718bd7bae04607031a298c299d73f519 Mon Sep 17 00:00:00 2001
From: Matthew Neeley <maffoo@google.com>
Date: Thu, 2 Jun 2022 14:38:54 -0700
Subject: [PATCH 245/246] Fixes from review

---
 qsimcirq/qsim_simulator.py      | 41 +++++++++++++++++++++++++------
 qsimcirq_tests/qsimcirq_test.py | 43 +++++++++++++++++++++++++++------
 2 files changed, 69 insertions(+), 15 deletions(-)

diff --git a/qsimcirq/qsim_simulator.py b/qsimcirq/qsim_simulator.py
index b15bee0a..5835c574 100644
--- a/qsimcirq/qsim_simulator.py
+++ b/qsimcirq/qsim_simulator.py
@@ -167,6 +167,25 @@ def as_dict(self):
         }
 
 
+@dataclass
+class MeasInfo:
+    """Info about each measure operation in the circuit being simulated.
+
+    Attributes:
+        key: The measurement key.
+        idx: The "instance" of a possibly-repeated measurement key.
+        invert_mask: True for any measurement bits that should be inverted.
+        start: Start index in qsim's output array for this measurement.
+        end: End index (non-inclusive) in qsim's output array.
+    """
+
+    key: str
+    idx: int
+    invert_mask: Tuple[bool, ...]
+    start: int
+    end: int
+
+
 class QSimSimulator(
     cirq.SimulatesSamples,
     cirq.SimulatesAmplitudes,
@@ -315,9 +334,7 @@ def _sample_measure_results(
         # Compute:
         # - number of qubits for each measurement key.
         # - measurement ops for each measurement key.
-        # - info about each measurement, including the key, instance (for repeated keys),
-        #   start (inclusive) and end (exclusive) indices in the qsim output, and
-        #   invert mask.
+        # - measurement info for each measurement.
         # - total number of measured bits.
         measurement_ops = [
             op
@@ -327,7 +344,7 @@ def _sample_measure_results(
         ]
         num_qubits_by_key: Dict[str, int] = {}
         meas_ops: Dict[str, List[cirq.GateOperation]] = {}
-        info: List[Tuple[str, int, Tuple[bool, ...], int, int]] = []
+        meas_infos: List[MeasInfo] = []
         num_bits = 0
         for op in measurement_ops:
             gate = op.gate
@@ -344,7 +361,15 @@ def _sample_measure_results(
                     )
             else:
                 num_qubits_by_key[key] = n
-            info.append((key, i, gate.full_invert_mask(), num_bits, num_bits + n))
+            meas_infos.append(
+                MeasInfo(
+                    key=key,
+                    idx=i,
+                    invert_mask=gate.full_invert_mask(),
+                    start=num_bits,
+                    end=num_bits + n,
+                )
+            )
             num_bits += n
 
         # Set qsim options
@@ -406,8 +431,10 @@ def _sample_measure_results(
                 options["s"] = self.get_seed()
                 measurements[i] = sampler_fn(options)
 
-            for key, i, invert_mask, start, end in info:
-                results[key][:, i, :] = measurements[:, start:end] ^ invert_mask
+            for m in meas_infos:
+                results[m.key][:, m.idx, :] = (
+                    measurements[:, m.start : m.end] ^ m.invert_mask
+                )
 
         return results
 
diff --git a/qsimcirq_tests/qsimcirq_test.py b/qsimcirq_tests/qsimcirq_test.py
index ec8c4a23..ce439f29 100644
--- a/qsimcirq_tests/qsimcirq_test.py
+++ b/qsimcirq_tests/qsimcirq_test.py
@@ -58,19 +58,46 @@ def test_empty_moment(mode: str):
 
 
 def test_repeated_keys():
-    q = cirq.LineQubit(0)
+    q0, q1 = cirq.LineQubit.range(2)
     circuit = cirq.Circuit(
-        cirq.measure(q, key="m"),
-        cirq.X(q),
-        cirq.measure(q, key="m"),
-        cirq.X(q),
-        cirq.measure(q, key="m"),
+        cirq.Moment(cirq.measure(q0, key="m")),
+        cirq.Moment(cirq.X(q1)),
+        cirq.Moment(cirq.measure(q1, key="m")),
+        cirq.Moment(cirq.X(q0)),
+        cirq.Moment(cirq.measure(q0, key="m")),
+        cirq.Moment(cirq.X(q1)),
+        cirq.Moment(cirq.measure(q1, key="m")),
     )
     result = qsimcirq.QSimSimulator().run(circuit, repetitions=10)
-    assert result.records["m"].shape == (10, 3, 1)
+    assert result.records["m"].shape == (10, 4, 1)
     assert np.all(result.records["m"][:, 0, :] == 0)
     assert np.all(result.records["m"][:, 1, :] == 1)
-    assert np.all(result.records["m"][:, 2, :] == 0)
+    assert np.all(result.records["m"][:, 2, :] == 1)
+    assert np.all(result.records["m"][:, 3, :] == 0)
+
+
+def test_repeated_keys_same_moment():
+    q0, q1 = cirq.LineQubit.range(2)
+    circuit = cirq.Circuit(
+        cirq.Moment(cirq.X(q1)),
+        cirq.Moment(cirq.measure(q0, key="m"), cirq.measure(q1, key="m")),
+    )
+    result = qsimcirq.QSimSimulator().run(circuit, repetitions=10)
+    assert result.records["m"].shape == (10, 2, 1)
+    assert np.all(result.records["m"][:, 0, :] == 0)
+    assert np.all(result.records["m"][:, 1, :] == 1)
+
+
+def test_repeated_keys_different_numbers_of_qubits():
+    q0, q1 = cirq.LineQubit.range(2)
+    circuit = cirq.Circuit(
+        cirq.measure(q0, key="m"),
+        cirq.measure(q0, q1, key="m"),
+    )
+    with pytest.raises(
+        ValueError, match="repeated key 'm' with different numbers of qubits"
+    ):
+        _ = qsimcirq.QSimSimulator().run(circuit, repetitions=10)
 
 
 def test_cirq_too_big_gate():

From 9988d43d2ff0720969c9d0226b1e406f664123c8 Mon Sep 17 00:00:00 2001
From: Orion Martin <40585662+95-martin-orion@users.noreply.github.com>
Date: Wed, 29 Jun 2022 20:24:38 -0700
Subject: [PATCH 246/246] Update version to 0.13.0

---
 qsimcirq/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qsimcirq/_version.py b/qsimcirq/_version.py
index a2c2c9c2..837c5a31 100644
--- a/qsimcirq/_version.py
+++ b/qsimcirq/_version.py
@@ -1,3 +1,3 @@
 """The version number defined here is read automatically in setup.py."""
 
-__version__ = "0.12.2.dev20220422"
+__version__ = "0.13.0"