added documentation for get_standard_gate_name_mapping

qiskit/circuit/library/__init__.py

@@ -126,6 +126,13 @@
    ZGate
    GlobalPhaseGate
 
+
+Utility functions (section TBD)
+================================
+
+.. autofunction:: get_standard_gate_name_mapping
+
+
 Standard Directives
 ===================
 
@@ -573,3 +580,4 @@
 from .grover_operator import GroverOperator
 from .phase_oracle import PhaseOracle
 from .overlap import UnitaryOverlap
+from .standard_gates import get_standard_gate_name_mapping

qiskit/circuit/library/standard_gates/__init__.py

@@ -48,7 +48,25 @@
 
 def get_standard_gate_name_mapping():
     """Return a dictionary mapping the name of standard gates and instructions to an object for
-    that name."""
+    that name.
+
+    For Example:
+
+    .. code-block::
+
+        from qiskit.circuit.library.standard_gates import get_standard_gate_name_mapping
+
+        gate_name_map = get_standard_gate_name_mapping()
+        cx_object = gate_name_map["cx"]
+
+        print(cx_object)
+        print(type(cx_object))
+
+    .. parsed-literal::
+
+        Instruction(name='cx', num_qubits=2, num_clbits=0, params=[])
+        _SingletonCXGate"""
+
     from qiskit.circuit.parameter import Parameter
     from qiskit.circuit.measure import Measure
     from qiskit.circuit.delay import Delay