Inspector APIs Doc Updates (#12701)

Summary: This PR updates the Inspector APIs' documentation to introduce
the calculate_numeric_gap for the executorch 0.7 release.

Differential Revision: D78692027

Co-authored-by: Juntian Liu <[email protected]>

Author: pytorchbot

devtools/inspector/_inspector.py

@@ -1362,17 +1362,19 @@ def get_exported_program(
             else self._etrecord.graph_map.get(graph)
         )
 
-    def calculate_numeric_gap(self, distance: str = "MSE") -> pd.DataFrame:
+    def calculate_numeric_gap(self, distance: str = "MSE"):
         """
         Compares logged intermediate outputs from the exported graph (in ETRecord)
         with runtime outputs (in ETDump) using a user-specific numerical comparator.
+        To use this function, you must first generate the ETRecord using the `bundle_program`,
+        and then create the Inspector instance with the ETRecord and ETDump. The Inspector can then
+        compare the intermediate outputs from the AOT and the runtime.
 
         Args:
             distance: the metrics the inspector will use for gap calculation. Should be one of "MSE", "L1" and "SNR".
 
         Returns:
-            pd.DataFrame: A DataFrame listing corresponding operator outputs from
-                          both stages and their computed numerical gaps.
+            pd.DataFrame: A DataFrame listing corresponding operator intermediate outputs from both stages and their computed numerical gaps.
         """
         aot_intermediate_outputs, aot_debug_handle_to_op_name = (
             self._get_aot_intermediate_outputs_and_op_names()

docs/source/_static/img/calculate_numeric_gap.png

@@ -106,6 +106,21 @@ get_exported_program
     Equality constraints: []
 
 
+calculate_numeric_gap
+~~~~~~~~~~~~~~~~~~
+
+.. autofunction:: executorch.devtools.Inspector.calculate_numeric_gap
+
+.. _example-usage-4:
+
+**Example Usage:**
+
+.. code:: python
+
+    print(inspector.calculate_numeric_gap("L1"))
+
+.. image:: _static/img/calculate_numeric_gap.png
+
 Inspector Attributes
 --------------------