add sensors to android tutorial

Author: betaBison

.gitignore

@@ -144,7 +144,7 @@ instance/
 .scrapy
 
 # Sphinx documentation
-docs/_build/
+docs/build/
 
 # PyBuilder
 target/

notebooks/tutorials/android.ipynb

@@ -13,7 +13,19 @@
    "id": "7954f8b9-22f3-44ba-bf04-8dfedb40250b",
    "metadata": {},
    "source": [
-    "This tutorial walks through how to parse the files obtained from [Google's GNSSLogger Android App](https://play.google.com/store/apps/details?id=com.google.android.apps.location.gps.gnsslogger&pcampaignid=web_share). Details for each data type can be found in Google's [gps-measurement-tools](https://github.com/google/gps-measurement-tools/blob/master/LOGGING_FORMAT.md) repository."
+    "This tutorial walks through how to parse the files obtained from [Google's GNSSLogger Android App](https://play.google.com/store/apps/details?id=com.google.android.apps.location.gps.gnsslogger&pcampaignid=web_share). Details for each data type can be found in Google's [gps-measurement-tools](https://github.com/google/gps-measurement-tools/blob/master/LOGGING_FORMAT.md) repository.\n",
+    "\n",
+    "The toggle switches on the \"Home\" tab of the GNSSLogger app need to be set based on the type(s) of measurements you want to log: fixes, raw, NMEA, Rinex, sensors, etc.\n",
+    "\n",
+    "After data is logged, the measurements can be saved immediately or retrieved at a later time within Android's internal storage. Data can be found on the phone under a directory similar to: ``<phone>/Internal shared storage/Android/data/com.google.android.apps.location.gps.gnsslogger/files/gnss_log/``"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "16a92bd3-daf2-42e5-9eeb-0a5abb6c2d49",
+   "metadata": {},
+   "source": [
+    "![GnssLogger screenshot](https://raw.githubusercontent.com/Stanford-NavLab/gnss_lib_py/derek/android_raw/docs/source/img/gnss_logger_app.jpg)"
    ]
   },
   {
@@ -569,6 +581,142 @@
     "raw_fig = glp.plot_map(wls_estimate)\n",
     "raw_fig.show()"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "928c06d2-56a2-4346-9b1f-5404bf019d1c",
+   "metadata": {},
+   "source": [
+    "## Sensor Measurements gnss_log*.txt"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "02d00300-27a2-4b29-bcd7-143f988de1c0",
+   "metadata": {},
+   "source": [
+    "If the \"sensors\" option is toggled in the GNSSLogger app, then the gnss_log*.txt log file will contain a number of sensor measurements that can be extracted with built in Python classes."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "3a5b5e04-5829-4619-9b81-39e5ce5233ac",
+   "metadata": {},
+   "source": [
+    "### Accelerometer Measurements from gnss_log*.txt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "6986845b-fc8f-4f43-b870-6cc706d5ca3a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "raw_data = glp.AndroidRawAccel(input_path=\"gnss_log.txt\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "67178fcd-7a47-4484-a15d-c772e052680c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"acc_x_uncal_mps2\",label=\"x\")\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"acc_y_uncal_mps2\",label=\"y\",fig=fig)\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"acc_z_uncal_mps2\",label=\"z\",fig=fig)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1f7d84f2-10c5-43be-9b33-b4c222533e9c",
+   "metadata": {},
+   "source": [
+    "### Gyro Measurements from gnss_log*.txt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a5263791-c5b5-4332-bfef-4a6204aa945a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "raw_data = glp.AndroidRawGyro(input_path=\"gnss_log.txt\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f36ffe54-fd86-4471-8dfc-f8eca7b67e8c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"ang_vel_x_uncal_radps\",label=\"x\")\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"ang_vel_y_uncal_radps\",label=\"y\",fig=fig)\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"ang_vel_z_uncal_radps\",label=\"z\",fig=fig)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1dedf8c6-66ec-4862-8e6e-b44610647bb1",
+   "metadata": {},
+   "source": [
+    "### Magnetometer Measurements from gnss_log*.txt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "39d176d5-f11f-441f-8b58-70de6f0389ce",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "raw_data = glp.AndroidRawMag(input_path=\"gnss_log.txt\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "cc717014-1902-4fff-8e1b-3712916906bd",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"mag_x_uncal_microt\",label=\"x\")\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"mag_y_uncal_microt\",label=\"y\",fig=fig)\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"mag_z_uncal_microt\",label=\"z\",fig=fig)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a770c7ea-02fc-43b7-b3d3-93b0e79855be",
+   "metadata": {},
+   "source": [
+    "### Orientation Measurements from gnss_log*.txt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "cd945c3f-5ee7-459d-8b7b-bee7320863fb",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "raw_data = glp.AndroidRawOrientation(input_path=\"gnss_log.txt\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "90d9065b-7573-446a-b20e-9445158a76ca",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"roll_rx_deg\",label=\"roll\")\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"pitch_rx_deg\",label=\"pitch\",fig=fig)\n",
+    "fig = glp.plot_metric(raw_data, \"gps_millis\",\"yaw_rx_deg\",label=\"yaw\",fig=fig)"
+   ]
   }
  ],
  "metadata": {