Demonstrate show_data in reference notebook

Author: jaladh-singhal

examples/reference-guide.ipynb

@@ -757,22 +757,52 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Show any data file"
+    "## Show any data file\n",
+    "To explore any data file you have at hand without delving into image or table specific options, you can use the `show_data` method of the FireflyClient object."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Preview metadata"
+    "### Preview metadata\n",
+    "It's often useful to preview the metadata of a data file you have no information about. `preview_metadata` parameter allows you to do that:"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
    "metadata": {},
    "outputs": [],
-   "source": []
+   "source": [
+    "some_fpath = '/Users/jsinghal/dev/cm/__test_data/MF.20210502.18830.fits'"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'success': True}"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "fc.show_data(some_fpath, preview_metadata=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This allows you to select which extensions/HDUs to load from a multi-extension FITS file. Same can be done for a VOTable with multiple tables."
+   ]
   },
   {
    "cell_type": "markdown",
@@ -781,10 +811,40 @@
     "### Directly view data"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "spectrum_file_url = 'http://irsa.ipac.caltech.edu/api/spectrumdm/convert/euclid/q1/SIR/102160339/EUC_SIR_W-COMBSPEC_102160339_2024-11-05T16:26:34.614296Z.fits?dataset_id=euclid_combspec&hdu=1644'"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'success': True}"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "fc.show_data(spectrum_file_url, preview_metadata=False)"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
-   "source": []
+   "source": [
+    "Note that show_data is a recent addition to firefly_client and is still evolving. It doesn't allow as much customization as image/table specific methods yet, but it is a quick way to get a look at your data."
+   ]
   }
  ],
  "metadata": {