From d1bb2c1226daf59377088bd53a0bbf4c476eadbb Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 17 Aug 2022 13:24:37 +0200
Subject: [PATCH 01/22] add draft

---
 qiskit/visualization/__init__.py | 61 ++++++++++++++++++++++----------
 1 file changed, 42 insertions(+), 19 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 0ea3e9143828..7b88b4185432 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -20,16 +20,46 @@
 Counts and State Visualizations
 ===============================
 
+Install visualization optionals
+-------------------------------
+`pip install qiskit[visualization]`
+
+Common parameters
+-----------------
+
+The figures created by counts and state visulizations functions (listed in the table below) are
+genereted by `Matplotlib`. Some of the common parameters are listed here:
+
+- title (str): a text string to use for the plot title
+- legend (list): a list of strings to use for labels of the data.
+- figsize (tuple): figure size in inches 
+- color (str or list): string or lists of strings for plotting
+- ax (Matplotlib.axes.Axes): An optional Axes object to be used for the visualization output. If
+  none is specified a new matplotlib Figure will be created and used. Additionally, if specified
+  there will be no returned Figure since it is redundant.
+- filename (str) – file path to save image to.
+
+Use title and legend
+--------------------
+
+Change fig size
+---------------
+
+Change color
+------------
+
+Reuse axes
+----------
+
+Save figure to file
+-------------------
+
+
 .. autosummary::
    :toctree: ../stubs/
 
-   plot_histogram
-   plot_bloch_vector
-   plot_bloch_multivector
-   plot_state_city
-   plot_state_hinton
-   plot_state_paulivec
-   plot_state_qsphere
+   plot_histogram plot_bloch_vector plot_bloch_multivector plot_state_city plot_state_hinton
+   plot_state_paulivec plot_state_qsphere
 
 Device Visualizations
 =====================
@@ -37,10 +67,7 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   plot_gate_map
-   plot_error_map
-   plot_circuit_layout
-   plot_coupling_map
+   plot_gate_map plot_error_map plot_circuit_layout plot_coupling_map
 
 Circuit Visualizations
 ======================
@@ -48,8 +75,7 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   circuit_drawer
-   ~qiskit.visualization.qcstyle.DefaultStyle
+   circuit_drawer ~qiskit.visualization.qcstyle.DefaultStyle
 
 DAG Visualizations
 ==================
@@ -73,10 +99,8 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   ~qiskit.visualization.pulse_v2.draw
-   ~qiskit.visualization.pulse_v2.IQXStandard
-   ~qiskit.visualization.pulse_v2.IQXSimple
-   ~qiskit.visualization.pulse_v2.IQXDebugging
+   ~qiskit.visualization.pulse_v2.draw ~qiskit.visualization.pulse_v2.IQXStandard
+   ~qiskit.visualization.pulse_v2.IQXSimple ~qiskit.visualization.pulse_v2.IQXDebugging
 
 Timeline Visualizations
 =======================
@@ -84,8 +108,7 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   timeline_drawer
-   ~qiskit.visualization.timeline.draw
+   timeline_drawer ~qiskit.visualization.timeline.draw
 
 Single Qubit State Transition Visualizations
 ============================================

From 366534ad78866f66add3c94db825e9718d63c5a8 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Thu, 18 Aug 2022 13:48:35 +0200
Subject: [PATCH 02/22] revert unintended changes

---
 qiskit/visualization/__init__.py | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 7b88b4185432..dadd2372b1b7 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -58,8 +58,13 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   plot_histogram plot_bloch_vector plot_bloch_multivector plot_state_city plot_state_hinton
-   plot_state_paulivec plot_state_qsphere
+   plot_histogram
+   plot_bloch_vector
+   plot_bloch_multivector
+   plot_state_city
+   plot_state_hinton
+   plot_state_paulivec
+   plot_state_qsphere
 
 Device Visualizations
 =====================
@@ -67,7 +72,10 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   plot_gate_map plot_error_map plot_circuit_layout plot_coupling_map
+   plot_gate_map
+   plot_error_map
+   plot_circuit_layout
+   plot_coupling_map
 
 Circuit Visualizations
 ======================
@@ -99,8 +107,10 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   ~qiskit.visualization.pulse_v2.draw ~qiskit.visualization.pulse_v2.IQXStandard
-   ~qiskit.visualization.pulse_v2.IQXSimple ~qiskit.visualization.pulse_v2.IQXDebugging
+   ~qiskit.visualization.pulse_v2.draw
+   ~qiskit.visualization.pulse_v2.IQXStandard
+   ~qiskit.visualization.pulse_v2.IQXSimple
+   ~qiskit.visualization.pulse_v2.IQXDebugging
 
 Timeline Visualizations
 =======================
@@ -108,7 +118,8 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   timeline_drawer ~qiskit.visualization.timeline.draw
+   timeline_drawer
+   ~qiskit.visualization.timeline.draw
 
 Single Qubit State Transition Visualizations
 ============================================

From ac0a9965f7bf21e63c793f5b154487df2e374599 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Thu, 18 Aug 2022 13:48:48 +0200
Subject: [PATCH 03/22] revert unintended changes

---
 qiskit/visualization/__init__.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index dadd2372b1b7..24396be85498 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -83,7 +83,8 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   circuit_drawer ~qiskit.visualization.qcstyle.DefaultStyle
+   circuit_drawer
+   ~qiskit.visualization.qcstyle.DefaultStyle
 
 DAG Visualizations
 ==================

From fe1918c1825240ed919973cf3f384de0f1819dfc Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 24 Aug 2022 12:34:07 +0200
Subject: [PATCH 04/22] add example usage

---
 qiskit/visualization/__init__.py | 134 +++++++++++++++++++++++++------
 1 file changed, 108 insertions(+), 26 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 24396be85498..cf08ef7dfd25 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017, 2018.
+# (C) Copyright IBM 2017, 2022.
 #
 # This code is licensed under the Apache License, Version 2.0. You may
 # obtain a copy of this license in the LICENSE.txt file in the root directory
@@ -17,42 +17,124 @@
 
 .. currentmodule:: qiskit.visualization
 
+
+Overview
+========
+
+The visualization module contain functions that visualizes measurement outcome counts, quantum
+states, circuits, pulses, devices and more. 
+
+Prerequisites
+=============
+
+To use visualization functions, you are required to install visualization optionals to your
+development environment:
+
+.. code-block:: bash
+
+   pip install 'qiskit[visualization]'
+
 Counts and State Visualizations
 ===============================
 
-Install visualization optionals
--------------------------------
-`pip install qiskit[visualization]`
+This section contains functions that visualize measurement outcome counts and quantum states.
+
+Example Usage
+-------------
+
+Here is an example of using :func:`plot_histogram` to visualize measurement outcome counts
+
+.. jupyter-execute::
+
+   from qiskit.tools.visualization import plot_histogram
+
+   counts = {"00": 501, "11": 499}
+   plot_histogram(counts)
+
+The data can be a dictionary of bit string as key and counts as value or more commonly a
+:class:`~qiskit.result.Counts` object obtained from :meth:`~qiskit.result.Result.get_counts`.
+
+Here is an example of using :func:`plot_state_city` to visualize a quantum state.
+
+.. jupyter-execute::
+
+   from qiskit.tools.visualization import plot_state_city
+
+   state = [[0+1.0j, 0-1.0j],
+            [1-0.5j, 1+0.5j]]
+   plot_state_city(state)
+
+The state can be array-like list of list, numpy.array or more commonly
+:class:`~qiskit.quantum_info.Statevector` or ~qiskit.quantum_info.DensityMatrix` objects obtained
+from a circuit.
+
+.. jupyter-execute::
+
+   from qiskit import QuantumCircuit
+   from qiskit.quantum_info import Statevector, DensityMatrix
+
+   qc = QuantumCircuit(2)
+   qc.h(0)
+   qc.cx(0,1)
+
+   # plot using a Statevector
+   state = Statevector(qc)
+   plot_state_city(state)
+
+.. jupyter-execute::
+
+   # plot using a DensityMatrix
+   state = DensityMatrix(qc)
+   plot_state_city(state)
+
+.. 
+   Common parameters
+   -----------------
+
+   The figures created by counts and state visulizations functions (listed in the table below) are
+   genereted by `Matplotlib`. Some of the common parameters are listed here:
+
+   - title (str): a text string to use for the plot title
+   - legend (list): a list of strings to use for labels of the data.
+   - figsize (tuple): figure size in inches 
+   - color (str or list): string or lists of strings for plotting
+   - ax (Matplotlib.axes.Axes): An optional Axes object to be used for the visualization output. If
+   none is specified a new matplotlib Figure will be created and used. Additionally, if specified
+   there will be no returned Figure since it is redundant.
+   - filename (str): file path to save image to.
+
+   Use title and legend
+   --------------------
+
+   .. jupyter-execute::
+
+      from qiskit.tools.visualization import plot_histogram
+
+      counts1 = {'00': 525, '11': 499}
+      counts2 = {'00': 511, '11': 514}
 
-Common parameters
------------------
+      data = [counts1, counts2]
+      plot_histogram(data)
 
-The figures created by counts and state visulizations functions (listed in the table below) are
-genereted by `Matplotlib`. Some of the common parameters are listed here:
+   You can specify `legend`, `title`, `figsize` and `color` by passing to the kwargs.
 
-- title (str): a text string to use for the plot title
-- legend (list): a list of strings to use for labels of the data.
-- figsize (tuple): figure size in inches 
-- color (str or list): string or lists of strings for plotting
-- ax (Matplotlib.axes.Axes): An optional Axes object to be used for the visualization output. If
-  none is specified a new matplotlib Figure will be created and used. Additionally, if specified
-  there will be no returned Figure since it is redundant.
-- filename (str) – file path to save image to.
+   .. jupyter-execute::
 
-Use title and legend
---------------------
+      legend = ['First execution', 'Second execution']
+      title = 'New histogram'
+      figsize = (10,10)
+      color=['crimson','midnightblue']
+      plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
 
-Change fig size
----------------
+   You can save the figure to file either by passing the file name to `filename` kwarg or use
+   `Matplotlib.Figure.savefig()` method.
 
-Change color
-------------
+   .. jupyter-execute::
 
-Reuse axes
-----------
+      plot_histogram(data, filename='new_hist.png')
 
-Save figure to file
--------------------
+   hist = plot_histogram(data)
+   hist.savefig('new_hist.png')
 
 
 .. autosummary::

From 34c832a636df1960a4f1e0153154d12981792db8 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 24 Aug 2022 18:39:02 +0200
Subject: [PATCH 05/22] add common keyword arguments section

---
 new_hist.png                     | Bin 0 -> 9830 bytes
 qiskit/visualization/__init__.py | 105 ++++++++++++++++---------------
 2 files changed, 56 insertions(+), 49 deletions(-)
 create mode 100644 new_hist.png

diff --git a/new_hist.png b/new_hist.png
new file mode 100644
index 0000000000000000000000000000000000000000..286c0bbc8fe69c03cfe646b520f2294c7556f03a
GIT binary patch
literal 9830
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
EFCSZxm;e9(

literal 0
HcmV?d00001

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index cf08ef7dfd25..bfe24d371641 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -39,10 +39,28 @@
 
 This section contains functions that visualize measurement outcome counts and quantum states.
 
+APIs
+----
+
+.. autosummary::
+   :toctree: ../stubs/
+
+   plot_histogram
+   plot_bloch_vector
+   plot_bloch_multivector
+   plot_state_city
+   plot_state_hinton
+   plot_state_paulivec
+   plot_state_qsphere
+
+
 Example Usage
 -------------
 
-Here is an example of using :func:`plot_histogram` to visualize measurement outcome counts
+Counts Visualization
+~~~~~~~~~~~~~~~~~~~~
+
+Here is an example of using :func:`plot_histogram` to visualize measurement outcome counts:
 
 .. jupyter-execute::
 
@@ -54,7 +72,10 @@
 The data can be a dictionary of bit string as key and counts as value or more commonly a
 :class:`~qiskit.result.Counts` object obtained from :meth:`~qiskit.result.Result.get_counts`.
 
-Here is an example of using :func:`plot_state_city` to visualize a quantum state.
+State Visualization
+~~~~~~~~~~~~~~~~~~~
+
+Here is an example of using :func:`plot_state_city` to visualize a quantum state:
 
 .. jupyter-execute::
 
@@ -64,9 +85,9 @@
             [1-0.5j, 1+0.5j]]
    plot_state_city(state)
 
-The state can be array-like list of list, numpy.array or more commonly
-:class:`~qiskit.quantum_info.Statevector` or ~qiskit.quantum_info.DensityMatrix` objects obtained
-from a circuit.
+The state can be array-like list of lists, `numpy.array` or more commonly
+:class:`~qiskit.quantum_info.Statevector` or :class:`~qiskit.quantum_info.DensityMatrix` objects
+obtained from a :class:`~qiskit.QuantumCircuit`.
 
 .. jupyter-execute::
 
@@ -87,67 +108,53 @@
    state = DensityMatrix(qc)
    plot_state_city(state)
 
-.. 
-   Common parameters
-   -----------------
-
-   The figures created by counts and state visulizations functions (listed in the table below) are
-   genereted by `Matplotlib`. Some of the common parameters are listed here:
+Common Keyword Arguments
+------------------------
 
-   - title (str): a text string to use for the plot title
-   - legend (list): a list of strings to use for labels of the data.
-   - figsize (tuple): figure size in inches 
-   - color (str or list): string or lists of strings for plotting
-   - ax (Matplotlib.axes.Axes): An optional Axes object to be used for the visualization output. If
-   none is specified a new matplotlib Figure will be created and used. Additionally, if specified
-   there will be no returned Figure since it is redundant.
-   - filename (str): file path to save image to.
+The figures created by counts and state visualizations functions are mostly generated by
+`Matplotlib <https://matplotlib.org/>`_. As a result there are keyargs inherited from
+`Matplotlib` that are common to most functions, including:
 
-   Use title and legend
-   --------------------
+- `title` (`str`): a text string to use for the plot title
+- `legend` (`list`): a list of strings to use for labels of the data.
+- `figsize` (`tuple`): figure size in inches 
+- `color` (`str` or `list`): string or lists of strings for plotting
+- `ax` (`Matplotlib.axes.Axes`): An optional Axes object to be used for the visualization output. If
+none is specified a new `Matplotlib.Figure` will be created and used. Additionally, if specified
+there will be no returned Figure since it is redundant.
+- `filename` (`str`): file path to save image to.
 
-   .. jupyter-execute::
+.. jupyter-execute::
 
-      from qiskit.tools.visualization import plot_histogram
+   from qiskit.tools.visualization import plot_histogram
 
-      counts1 = {'00': 525, '11': 499}
-      counts2 = {'00': 511, '11': 514}
+   counts1 = {'00': 525, '11': 499}
+   counts2 = {'00': 511, '11': 514}
 
-      data = [counts1, counts2]
-      plot_histogram(data)
+   data = [counts1, counts2]
+   plot_histogram(data)
 
-   You can specify `legend`, `title`, `figsize` and `color` by passing to the kwargs.
+You can specify `legend`, `title`, `figsize` and `color` by passing to the kwargs.
 
-   .. jupyter-execute::
+.. jupyter-execute::
 
-      legend = ['First execution', 'Second execution']
-      title = 'New histogram'
-      figsize = (10,10)
-      color=['crimson','midnightblue']
-      plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
+   legend = ['First execution', 'Second execution']
+   title = 'New histogram'
+   figsize = (10,10)
+   color=['crimson','midnightblue']
+   plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
 
-   You can save the figure to file either by passing the file name to `filename` kwarg or use
-   `Matplotlib.Figure.savefig()` method.
+You can save the figure to file either by passing the file name to `filename` kwarg or use
+`Matplotlib.Figure.savefig` method.
 
-   .. jupyter-execute::
+.. jupyter-execute::
 
-      plot_histogram(data, filename='new_hist.png')
+   plot_histogram(data, filename='new_hist.png')
 
    hist = plot_histogram(data)
    hist.savefig('new_hist.png')
 
 
-.. autosummary::
-   :toctree: ../stubs/
-
-   plot_histogram
-   plot_bloch_vector
-   plot_bloch_multivector
-   plot_state_city
-   plot_state_hinton
-   plot_state_paulivec
-   plot_state_qsphere
-
 Device Visualizations
 =====================
 

From a8202fd63d2efbcab22af46cb419f214c2fb2ad0 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 31 Aug 2022 11:13:33 +0200
Subject: [PATCH 06/22] add sections to apis

---
 qiskit/visualization/__init__.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index bfe24d371641..bc5ce255acdb 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -42,10 +42,20 @@
 APIs
 ----
 
+Counts Visualization
+~~~~~~~~~~~~~~~~~~~~
+
 .. autosummary::
    :toctree: ../stubs/
 
    plot_histogram
+
+State Visualization
+~~~~~~~~~~~~~~~~~~~
+
+.. autosummary::
+   :toctree: ../stubs/
+
    plot_bloch_vector
    plot_bloch_multivector
    plot_state_city
@@ -53,7 +63,6 @@
    plot_state_paulivec
    plot_state_qsphere
 
-
 Example Usage
 -------------
 

From b65d46a402bc90870804831e4923979d1698edbe Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 31 Aug 2022 12:34:35 +0200
Subject: [PATCH 07/22] fix internal links

---
 qiskit/visualization/__init__.py | 45 ++++++++++++++++++--------------
 1 file changed, 26 insertions(+), 19 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index bc5ce255acdb..90403ebd4f4f 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -43,7 +43,7 @@
 ----
 
 Counts Visualization
-~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 .. autosummary::
    :toctree: ../stubs/
@@ -51,7 +51,7 @@
    plot_histogram
 
 State Visualization
-~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^
 
 .. autosummary::
    :toctree: ../stubs/
@@ -67,7 +67,7 @@
 -------------
 
 Counts Visualization
-~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 Here is an example of using :func:`plot_histogram` to visualize measurement outcome counts:
 
@@ -78,11 +78,11 @@
    counts = {"00": 501, "11": 499}
    plot_histogram(counts)
 
-The data can be a dictionary of bit string as key and counts as value or more commonly a
+The data can be a dictionary with bit string as key and counts as value, or more commonly a
 :class:`~qiskit.result.Counts` object obtained from :meth:`~qiskit.result.Result.get_counts`.
 
 State Visualization
-~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^
 
 Here is an example of using :func:`plot_state_city` to visualize a quantum state:
 
@@ -94,9 +94,9 @@
             [1-0.5j, 1+0.5j]]
    plot_state_city(state)
 
-The state can be array-like list of lists, `numpy.array` or more commonly
+The state can be array-like list of lists, ``numpy.array``, or more commonly
 :class:`~qiskit.quantum_info.Statevector` or :class:`~qiskit.quantum_info.DensityMatrix` objects
-obtained from a :class:`~qiskit.QuantumCircuit`.
+obtained from a :class:`~qiskit.circuit.QuantumCircuit`:
 
 .. jupyter-execute::
 
@@ -117,21 +117,26 @@
    state = DensityMatrix(qc)
    plot_state_city(state)
 
+You can find code examples for each visualization functions on the individual function `API page
+<#apis>`_.
+
 Common Keyword Arguments
 ------------------------
 
 The figures created by counts and state visualizations functions are mostly generated by
 `Matplotlib <https://matplotlib.org/>`_. As a result there are keyargs inherited from
-`Matplotlib` that are common to most functions, including:
+``Matplotlib`` that are common to most functions, including:
+
+* ``title`` (``str``): a text string to use for the plot title.
+* ``legend`` (``list``): a list of strings to use for labels of the data.
+* ``figsize`` (``tuple``): figure size in inches .
+* ``color`` (``list``): a list of strings for plotting.
+* ``ax`` (`Matplotlib.axes.Axes <https://matplotlib.org/stable/api/axes_api.html>`_): An optional
+  ``Axes`` object to be used for the visualization output. If none is specified a new
+  `Matplotlib.figure.Figure <https://matplotlib.org/stable/api/figure_api.html>`_ will be created
+  and used. Additionally, if specified there will be no returned ``Figure`` since it is redundant.
+* ``filename`` (``str``): file path to save image to.
 
-- `title` (`str`): a text string to use for the plot title
-- `legend` (`list`): a list of strings to use for labels of the data.
-- `figsize` (`tuple`): figure size in inches 
-- `color` (`str` or `list`): string or lists of strings for plotting
-- `ax` (`Matplotlib.axes.Axes`): An optional Axes object to be used for the visualization output. If
-none is specified a new `Matplotlib.Figure` will be created and used. Additionally, if specified
-there will be no returned Figure since it is redundant.
-- `filename` (`str`): file path to save image to.
 
 .. jupyter-execute::
 
@@ -143,7 +148,7 @@
    data = [counts1, counts2]
    plot_histogram(data)
 
-You can specify `legend`, `title`, `figsize` and `color` by passing to the kwargs.
+You can specify ``legend``, ``title``, ``figsize`` and ``color`` by passing to the kwargs.
 
 .. jupyter-execute::
 
@@ -153,8 +158,10 @@
    color=['crimson','midnightblue']
    plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
 
-You can save the figure to file either by passing the file name to `filename` kwarg or use
-`Matplotlib.Figure.savefig` method.
+You can save the figure to file either by passing the file name to ``filename`` kwarg or use
+`Matplotlib.figure.Figure.savefig
+<https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure.savefig>`_ method.
+
 
 .. jupyter-execute::
 

From 479a5f2c29c97a3b87bdcbdbb1c5c15f68ffe4ba Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 31 Aug 2022 12:50:19 +0200
Subject: [PATCH 08/22] remove generated hist figure

---
 new_hist.png | Bin 9830 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 new_hist.png

diff --git a/new_hist.png b/new_hist.png
deleted file mode 100644
index 286c0bbc8fe69c03cfe646b520f2294c7556f03a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 9830
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
EFCSZxm;e9(


From b17bfbfd7d428a88c86ae2ba056755487523ea4e Mon Sep 17 00:00:00 2001
From: Luciano Bello <bel@zurich.ibm.com>
Date: Fri, 2 Sep 2022 13:32:32 +0200
Subject: [PATCH 09/22] lint

---
 qiskit/visualization/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 90403ebd4f4f..b0806bb0269d 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -22,7 +22,7 @@
 ========
 
 The visualization module contain functions that visualizes measurement outcome counts, quantum
-states, circuits, pulses, devices and more. 
+states, circuits, pulses, devices and more.
 
 Prerequisites
 =============

From 46fa3e3ee9986133071f89a33074062509e34cfb Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Tue, 6 Sep 2022 12:15:37 +0200
Subject: [PATCH 10/22] use matplotlib instead of Matplotlib in class reference

---
 qiskit/visualization/__init__.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index b0806bb0269d..d715f8c8335f 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -131,9 +131,9 @@
 * ``legend`` (``list``): a list of strings to use for labels of the data.
 * ``figsize`` (``tuple``): figure size in inches .
 * ``color`` (``list``): a list of strings for plotting.
-* ``ax`` (`Matplotlib.axes.Axes <https://matplotlib.org/stable/api/axes_api.html>`_): An optional
+* ``ax`` (`matplotlib.axes.Axes <https://matplotlib.org/stable/api/axes_api.html>`_): An optional
   ``Axes`` object to be used for the visualization output. If none is specified a new
-  `Matplotlib.figure.Figure <https://matplotlib.org/stable/api/figure_api.html>`_ will be created
+  `matplotlib.figure.Figure <https://matplotlib.org/stable/api/figure_api.html>`_ will be created
   and used. Additionally, if specified there will be no returned ``Figure`` since it is redundant.
 * ``filename`` (``str``): file path to save image to.
 
@@ -159,7 +159,7 @@
    plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
 
 You can save the figure to file either by passing the file name to ``filename`` kwarg or use
-`Matplotlib.figure.Figure.savefig
+`matplotlib.figure.Figure.savefig
 <https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure.savefig>`_ method.
 
 

From 11e09e0b1a919df48a983ce9b5851cdddc39118c Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Tue, 6 Sep 2022 12:50:03 +0200
Subject: [PATCH 11/22] change to a valid denisty matrix in examples

---
 qiskit/visualization/__init__.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index d715f8c8335f..22902cb95dd7 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -90,8 +90,8 @@
 
    from qiskit.tools.visualization import plot_state_city
 
-   state = [[0+1.0j, 0-1.0j],
-            [1-0.5j, 1+0.5j]]
+   state = [[ 0.75  , 0.433j],
+            [-0.433j, 0.25  ]]
    plot_state_city(state)
 
 The state can be array-like list of lists, ``numpy.array``, or more commonly

From e9b96d98d473f2a24b47d200b13a02fc8b05a9b7 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 17:24:41 +0200
Subject: [PATCH 12/22] import from qiskit.visualization instead of
 qiskit.tools.visualization

---
 qiskit/visualization/__init__.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 22902cb95dd7..7dd479307568 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -73,7 +73,7 @@
 
 .. jupyter-execute::
 
-   from qiskit.tools.visualization import plot_histogram
+   from qiskit.visualization import plot_histogram
 
    counts = {"00": 501, "11": 499}
    plot_histogram(counts)
@@ -88,7 +88,7 @@
 
 .. jupyter-execute::
 
-   from qiskit.tools.visualization import plot_state_city
+   from qiskit.visualization import plot_state_city
 
    state = [[ 0.75  , 0.433j],
             [-0.433j, 0.25  ]]
@@ -140,7 +140,7 @@
 
 .. jupyter-execute::
 
-   from qiskit.tools.visualization import plot_histogram
+   from qiskit.visualization import plot_histogram
 
    counts1 = {'00': 525, '11': 499}
    counts2 = {'00': 511, '11': 514}
@@ -235,7 +235,7 @@
 
    visualize_transition
 
-Array/Matrix Visualizations
+Array/Matrix Visualizations21
 ===========================
 
 .. autosummary::

From 7b1e00ea61fe1638e17c7561156ba743b7f438ff Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:06:45 +0200
Subject: [PATCH 13/22] remove unintended changes

---
 qiskit/visualization/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 7dd479307568..4aff4f2c3fb1 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -235,7 +235,7 @@
 
    visualize_transition
 
-Array/Matrix Visualizations21
+Array/Matrix Visualizations
 ===========================
 
 .. autosummary::

From 257d9a4461d14e39652336a53d0616546896ec0d Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:13:08 +0200
Subject: [PATCH 14/22] split counts and state visualizations

---
 qiskit/visualization/__init__.py | 46 ++++++++++++++++----------------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 4aff4f2c3fb1..e5b5fa0bffa0 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -34,41 +34,23 @@
 
    pip install 'qiskit[visualization]'
 
-Counts and State Visualizations
-===============================
+Counts Visualizations
+=====================
 
-This section contains functions that visualize measurement outcome counts and quantum states.
+This section contains functions that visualize measurement outcome counts.
 
 APIs
 ----
 
-Counts Visualization
-^^^^^^^^^^^^^^^^^^^^
-
 .. autosummary::
    :toctree: ../stubs/
 
    plot_histogram
 
-State Visualization
-^^^^^^^^^^^^^^^^^^^
-
-.. autosummary::
-   :toctree: ../stubs/
-
-   plot_bloch_vector
-   plot_bloch_multivector
-   plot_state_city
-   plot_state_hinton
-   plot_state_paulivec
-   plot_state_qsphere
 
 Example Usage
 -------------
 
-Counts Visualization
-^^^^^^^^^^^^^^^^^^^^
-
 Here is an example of using :func:`plot_histogram` to visualize measurement outcome counts:
 
 .. jupyter-execute::
@@ -81,8 +63,26 @@
 The data can be a dictionary with bit string as key and counts as value, or more commonly a
 :class:`~qiskit.result.Counts` object obtained from :meth:`~qiskit.result.Result.get_counts`.
 
-State Visualization
-^^^^^^^^^^^^^^^^^^^
+State Visualizations
+====================
+
+This section contains functions that visualize quantum states.
+
+APIs
+----
+.. autosummary::
+   :toctree: ../stubs/
+
+   plot_bloch_vector
+   plot_bloch_multivector
+   plot_state_city
+   plot_state_hinton
+   plot_state_paulivec
+   plot_state_qsphere
+
+
+Example Usage
+-------------
 
 Here is an example of using :func:`plot_state_city` to visualize a quantum state:
 

From 1c1c14a7d7909e8b7720d220be7b05c54e557446 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:14:28 +0200
Subject: [PATCH 15/22] remove overview and prerequisite headings

---
 qiskit/visualization/__init__.py | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index e5b5fa0bffa0..48752d57af8c 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -18,15 +18,9 @@
 .. currentmodule:: qiskit.visualization
 
 
-Overview
-========
-
 The visualization module contain functions that visualizes measurement outcome counts, quantum
 states, circuits, pulses, devices and more.
 
-Prerequisites
-=============
-
 To use visualization functions, you are required to install visualization optionals to your
 development environment:
 

From 2df1bca572742b23dd8b667fcdc39774c1363709 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:23:38 +0200
Subject: [PATCH 16/22] move common kwargs sections to the top level

---
 qiskit/visualization/__init__.py | 99 ++++++++++++++++----------------
 1 file changed, 51 insertions(+), 48 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 48752d57af8c..92c1c870c6b3 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -28,6 +28,57 @@
 
    pip install 'qiskit[visualization]'
 
+
+Common Keyword Arguments
+========================
+
+Many of the figures created by visualization functions in this module are created by `Matplotlib
+<https://matplotlib.org/>`_ and accept a subset of the following common arguments. Consult the
+individual documentation for exact details.
+
+* ``title`` (``str``): a text string to use for the plot title.
+* ``legend`` (``list``): a list of strings to use for labels of the data.
+* ``figsize`` (``tuple``): figure size in inches .
+* ``color`` (``list``): a list of strings for plotting.
+* ``ax`` (`matplotlib.axes.Axes <https://matplotlib.org/stable/api/axes_api.html>`_): An optional
+  ``Axes`` object to be used for the visualization output. If none is specified a new
+  `matplotlib.figure.Figure <https://matplotlib.org/stable/api/figure_api.html>`_ will be created
+  and used. Additionally, if specified there will be no returned ``Figure`` since it is redundant.
+* ``filename`` (``str``): file path to save image to.
+
+
+.. jupyter-execute::
+
+   from qiskit.visualization import plot_histogram
+
+   counts1 = {'00': 525, '11': 499}
+   counts2 = {'00': 511, '11': 514}
+
+   data = [counts1, counts2]
+   plot_histogram(data)
+
+You can specify ``legend``, ``title``, ``figsize`` and ``color`` by passing to the kwargs.
+
+.. jupyter-execute::
+
+   legend = ['First execution', 'Second execution']
+   title = 'New histogram'
+   figsize = (10,10)
+   color=['crimson','midnightblue']
+   plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
+
+You can save the figure to file either by passing the file name to ``filename`` kwarg or use
+`matplotlib.figure.Figure.savefig
+<https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure.savefig>`_ method.
+
+
+.. jupyter-execute::
+
+   plot_histogram(data, filename='new_hist.png')
+
+   hist = plot_histogram(data)
+   hist.savefig('new_hist.png')
+
 Counts Visualizations
 =====================
 
@@ -114,55 +165,7 @@
 You can find code examples for each visualization functions on the individual function `API page
 <#apis>`_.
 
-Common Keyword Arguments
-------------------------
-
-The figures created by counts and state visualizations functions are mostly generated by
-`Matplotlib <https://matplotlib.org/>`_. As a result there are keyargs inherited from
-``Matplotlib`` that are common to most functions, including:
 
-* ``title`` (``str``): a text string to use for the plot title.
-* ``legend`` (``list``): a list of strings to use for labels of the data.
-* ``figsize`` (``tuple``): figure size in inches .
-* ``color`` (``list``): a list of strings for plotting.
-* ``ax`` (`matplotlib.axes.Axes <https://matplotlib.org/stable/api/axes_api.html>`_): An optional
-  ``Axes`` object to be used for the visualization output. If none is specified a new
-  `matplotlib.figure.Figure <https://matplotlib.org/stable/api/figure_api.html>`_ will be created
-  and used. Additionally, if specified there will be no returned ``Figure`` since it is redundant.
-* ``filename`` (``str``): file path to save image to.
-
-
-.. jupyter-execute::
-
-   from qiskit.visualization import plot_histogram
-
-   counts1 = {'00': 525, '11': 499}
-   counts2 = {'00': 511, '11': 514}
-
-   data = [counts1, counts2]
-   plot_histogram(data)
-
-You can specify ``legend``, ``title``, ``figsize`` and ``color`` by passing to the kwargs.
-
-.. jupyter-execute::
-
-   legend = ['First execution', 'Second execution']
-   title = 'New histogram'
-   figsize = (10,10)
-   color=['crimson','midnightblue']
-   plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
-
-You can save the figure to file either by passing the file name to ``filename`` kwarg or use
-`matplotlib.figure.Figure.savefig
-<https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure.savefig>`_ method.
-
-
-.. jupyter-execute::
-
-   plot_histogram(data, filename='new_hist.png')
-
-   hist = plot_histogram(data)
-   hist.savefig('new_hist.png')
 
 
 Device Visualizations

From 23957d78409c157a14139fe36cda2b61d320dba7 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:25:07 +0200
Subject: [PATCH 17/22] remove link to api table

---
 qiskit/visualization/__init__.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 92c1c870c6b3..91966603d66b 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -162,10 +162,7 @@
    state = DensityMatrix(qc)
    plot_state_city(state)
 
-You can find code examples for each visualization functions on the individual function `API page
-<#apis>`_.
-
-
+You can find code examples for each visualization functions on the individual function API page.
 
 
 Device Visualizations

From d98e867a28ca368438d22a1e63ab53ca64f1dcca Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:44:53 +0200
Subject: [PATCH 18/22] remove apis headings

---
 qiskit/visualization/__init__.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 91966603d66b..00e613eaaa79 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -84,9 +84,6 @@
 
 This section contains functions that visualize measurement outcome counts.
 
-APIs
-----
-
 .. autosummary::
    :toctree: ../stubs/
 
@@ -113,8 +110,6 @@
 
 This section contains functions that visualize quantum states.
 
-APIs
-----
 .. autosummary::
    :toctree: ../stubs/
 

From 9d6f500af4ab40423fc51b42769d9fd2f0ac1ea2 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:48:52 +0200
Subject: [PATCH 19/22] remove extra blank lines

---
 qiskit/visualization/__init__.py | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 00e613eaaa79..646d9df040d6 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -17,7 +17,6 @@
 
 .. currentmodule:: qiskit.visualization
 
-
 The visualization module contain functions that visualizes measurement outcome counts, quantum
 states, circuits, pulses, devices and more.
 
@@ -28,7 +27,6 @@
 
    pip install 'qiskit[visualization]'
 
-
 Common Keyword Arguments
 ========================
 
@@ -46,7 +44,6 @@
   and used. Additionally, if specified there will be no returned ``Figure`` since it is redundant.
 * ``filename`` (``str``): file path to save image to.
 
-
 .. jupyter-execute::
 
    from qiskit.visualization import plot_histogram
@@ -89,7 +86,6 @@
 
    plot_histogram
 
-
 Example Usage
 -------------
 
@@ -120,7 +116,6 @@
    plot_state_paulivec
    plot_state_qsphere
 
-
 Example Usage
 -------------
 
@@ -159,7 +154,6 @@
 
 You can find code examples for each visualization functions on the individual function API page.
 
-
 Device Visualizations
 =====================
 

From 2987132abb1e5e318f9ff770d22fc812c7bdca7d Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Wed, 7 Sep 2022 19:49:37 +0200
Subject: [PATCH 20/22] remove extra blank lines

---
 qiskit/visualization/__init__.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 646d9df040d6..c6baf84b8633 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -68,7 +68,6 @@
 `matplotlib.figure.Figure.savefig
 <https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure.savefig>`_ method.
 
-
 .. jupyter-execute::
 
    plot_histogram(data, filename='new_hist.png')

From b96d97bffe24a105e0423f9d54cdcdd322fe45d8 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Thu, 8 Sep 2022 11:27:23 +0200
Subject: [PATCH 21/22] minor twig on the counts to make them 1000 shots in
 total

---
 qiskit/visualization/__init__.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 701328dc0322..6a2d64a922b9 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -48,8 +48,8 @@
 
    from qiskit.visualization import plot_histogram
 
-   counts1 = {'00': 525, '11': 499}
-   counts2 = {'00': 511, '11': 514}
+   counts1 = {'00': 499, '11': 501}
+   counts2 = {'00': 511, '11': 489}
 
    data = [counts1, counts2]
    plot_histogram(data)

From 8778f4b0529b051e88fbd4e7d65228a2cd717389 Mon Sep 17 00:00:00 2001
From: Junye Huang <h.jun.ye@gmail.com>
Date: Thu, 8 Sep 2022 11:30:56 +0200
Subject: [PATCH 22/22] add an intro sentence before the example for common
 kwargs

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

diff --git a/qiskit/visualization/__init__.py b/qiskit/visualization/__init__.py
index 6a2d64a922b9..1440dad9d6c5 100644
--- a/qiskit/visualization/__init__.py
+++ b/qiskit/visualization/__init__.py
@@ -44,6 +44,8 @@
   and used. Additionally, if specified there will be no returned ``Figure`` since it is redundant.
 * ``filename`` (``str``): file path to save image to.
 
+The following example demonstrates the common usage of these arguments:
+
 .. jupyter-execute::
 
    from qiskit.visualization import plot_histogram