Add alt text to images (Qiskit#13555)

* Add alt text to images

* Update operation.py

* Update parameter.py

* Update quantumcircuit.py

* try breaking line

* Update __init__.py

* Update fourier_checking.py

* Update graph_state.py

* Update grover_operator.py

* add more alt text and some missing directives

* add nofigs for missing figures

* Add more alt text

* next set

* need different text when there's no code

* fix text when no code

* more alt text

* remove brackets

* More alt text and some fixes

* Adding more text

* more alt text

* missing file name

* missing blank line

* extra blank line

* update allowlist

* fix spacing

* add more alt text

* Apply suggestions from code review

Co-authored-by: Eric Arellano <[email protected]>

* Apply suggestions from code review

Co-authored-by: Elena Peña Tapia <[email protected]>

---------

Co-authored-by: Eric Arellano <[email protected]>
Co-authored-by: Elena Peña Tapia <[email protected]>

Author: 3 people

qiskit/circuit/__init__.py

@@ -64,6 +64,7 @@
 
 
 .. plot::
+   :alt: Circuit diagram output by the previous code.
    :include-source:
 
    from qiskit import QuantumCircuit
@@ -1144,6 +1145,7 @@ def __array__(self, dtype=None, copy=None):
 drawing:
 
 .. plot::
+    :alt: Circuit diagram output by the previous code.
     :include-source:
     :context:
     :show-source-link: False

qiskit/circuit/controlledgate.py

@@ -70,6 +70,7 @@ def __init__(
         Create a controlled standard gate and apply it to a circuit.
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
 
            from qiskit import QuantumCircuit, QuantumRegister
@@ -84,6 +85,7 @@ def __init__(
         Create a controlled custom gate and apply it to a circuit.
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
 
            from qiskit import QuantumCircuit, QuantumRegister

qiskit/circuit/library/__init__.py

@@ -26,6 +26,7 @@
 For example, to append a multi-controlled CNOT:
 
 .. plot::
+   :alt: Circuit diagram output by the previous code.
    :include-source:
 
    from qiskit.circuit.library import MCXGate

qiskit/circuit/library/arithmetic/piecewise_chebyshev.py

@@ -37,6 +37,7 @@ class PiecewiseChebyshev(BlueprintCircuit):
     Examples:
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
 
             import numpy as np

qiskit/circuit/library/basis_change/qft.py

@@ -38,6 +38,7 @@ class QFT(BlueprintCircuit):
     For 4 qubits, the circuit that implements this transformation is:
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import QFT
        from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -48,6 +49,7 @@ class QFT(BlueprintCircuit):
     The respective circuit diagram is:
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import QFT
        from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -64,6 +66,7 @@ class QFT(BlueprintCircuit):
     on 5 qubits with approximation degree 2 yields (the barriers are dropped in this example):
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import QFT
        from qiskit.visualization.library import _generate_circuit_library_visualization

qiskit/circuit/library/boolean_logic/inner_product.py

@@ -55,6 +55,7 @@ class InnerProduct(QuantumCircuit):
 
     Reference Circuit:
         .. plot::
+           :alt: Diagram illustrating the previously described circuit.
 
            from qiskit.circuit.library import InnerProduct
            from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -121,6 +122,7 @@ class InnerProductGate(Gate):
 
     Reference Circuit:
         .. plot::
+           :alt: Diagram illustrating the previously described circuit.
 
            from qiskit.circuit import QuantumCircuit
            from qiskit.circuit.library import InnerProductGate

qiskit/circuit/library/boolean_logic/quantum_and.py

@@ -32,6 +32,7 @@ class AND(QuantumCircuit):
     The AND gate without special flags equals the multi-controlled-X gate:
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import AND
        from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -43,6 +44,7 @@ class AND(QuantumCircuit):
     ``[-1, 0, 0, 1, 1]``.
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import AND
        from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -116,6 +118,7 @@ class AndGate(Gate):
     The AndGate gate without special flags equals the multi-controlled-X gate:
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit import QuantumCircuit
        from qiskit.circuit.library import AndGate
@@ -129,6 +132,7 @@ class AndGate(Gate):
     ``[-1, 0, 0, 1, 1]``.
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit import QuantumCircuit
        from qiskit.circuit.library import AndGate

qiskit/circuit/library/boolean_logic/quantum_or.py

@@ -33,6 +33,7 @@ class OR(QuantumCircuit):
     The OR gate without special flags:
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import OR
        from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -44,6 +45,7 @@ class OR(QuantumCircuit):
     flags ``[-1, 0, 0, 1, 1]``.
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import OR
        from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -117,6 +119,7 @@ class OrGate(Gate):
     The OrGate gate without special flags:
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit import QuantumCircuit
        from qiskit.circuit.library import OrGate
@@ -130,6 +133,7 @@ class OrGate(Gate):
     flags ``[-1, 0, 0, 1, 1]``.
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit import QuantumCircuit
        from qiskit.circuit.library import OrGate

qiskit/circuit/library/boolean_logic/quantum_xor.py

@@ -53,6 +53,7 @@ def __init__(
 
         Reference Circuit:
             .. plot::
+               :alt: Diagram illustrating the previously described circuit.
 
                from qiskit.circuit.library import XOR
                from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -88,6 +89,7 @@ class BitwiseXorGate(Gate):
     Reference Circuit:
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit import QuantumCircuit
        from qiskit.circuit.library import BitwiseXorGate

qiskit/circuit/library/fourier_checking.py

@@ -70,6 +70,7 @@ def __init__(self, f: Sequence[int], g: Sequence[int]) -> None:
 
         Reference Circuit:
             .. plot::
+               :alt: Diagram illustrating the previously described circuit.
 
                from qiskit.circuit.library import FourierChecking
                from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -124,6 +125,7 @@ def fourier_checking(f: Sequence[int], g: Sequence[int]) -> QuantumCircuit:
     **Reference Circuit:**
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit.circuit.library import fourier_checking