Add Instructions on Converting CSV to a Spreadsheet

Author: bboyho

docs/assets/Google_Sheets_Logo.png

@@ -0,0 +1,109 @@
+The DataLogger IoT is great at displaying real time data with an IoT service whenever there is an Internet connection available. For those that want to use the DataLogger IoT without a WiFi connection and/or you just want to save data to a microSD card, you can import the comma separated values (CSV) from the text file into a spreadsheet to graph the values.
+
+There are a few spreadsheet programs available that can take text files with CSV but for the scope of this tutorial, we will be using Google Sheets™ to convert the CSV output to a graph.
+
+<div style="text-align: center">
+    <a href="https://www.google.com/sheets/about/"><img src="../assets/Google_Sheets_Logo.png" width="100" length="100" alt="Google Sheets Logo"></a>
+    <br />
+    <i>Image Courtesy of <a href="https://www.google.com/sheets/about/">Google Sheets</a>. </i>
+</div>
+
+!!! note
+    Google and Google Sheets are trademarks of Google LLC. This tutorial is not endorsed by or affiliated with Google in any way. We just thought it was a sweet tool to visualize all the data that was collected by your snazzy DataLogger IoT. 😉
+
+
+
+### Log Some Data!
+
+At this point, we will assume that you have configured connected your devices to the DataLogger IoT and configured its settings. Insert the microSD card into it's socket. Power the DataLogger IoT up and start logging some data! In this case, we were using the DataLogger IoT using the Qwiic Environmental Combo Breakout - ENS160/BME280. of course, you could have other compatible Qwiic-enabled devices connected depending on your setup. For simplicity, a WiFi connection was used to synchronize the clock to the NTP server and a computer's USB port was used to power everything.
+
+!!! tip
+    For users without an Internet connection to sync the clock to the NTP server, you may want to consider using a compatible Qwiic-enabled device like the Qwiic Real Time Clock (RTC) Module - RV-8803 or a Qwiic-enabled u-blox GNSS module. Note that you will need to configure the time to your area before logging any data. U-blox GNSS modules would also need to be able to view a few satellites before being able to synchronize to the UTC.
+
+!!! note
+    For users that require a timestamp with their datasets, make sure to [enable timestamp](https://docs.sparkfun.com/SparkFun_DataLogger/example_timestamp/).
+
+When ready, remove power from the DataLogger IoT and eject the microSD card from the socket. Insert the microSD card into an adapter and connect to your computer.
+
+<div style="text-align: center">
+  <a href="https://cdn.sparkfun.com//assets/parts/7/6/3/6/11609-Action.jpg">
+  <img src="https://cdn.sparkfun.com//assets/parts/7/6/3/6/11609-Action.jpg" width="500" height="500" alt="Memory Card Adapter and USB Reader for microSD cards"></a>
+</div>
+
+
+
+### Importing CSV to a Spreadsheet
+
+Log into your Google account and [open Google Sheets to create a new spreadsheet](https://www.google.com/sheets/about/).
+
+<div style="text-align: center"><a href="https://docs.google.com/spreadsheets/create" target="google_sheets" class="md-button">Click Here to Create a New Google Spreadsheet</a></div>
+
+Head to the menu and select: **File** > **Import**.
+
+<div style="text-align: center">
+  <a href="../assets/csv_to_spreadsheet_imported.JPG"><img src="../assets/csv_to_spreadsheet_imported.JPG" width="600" height="600" alt="Importing Google Sheets"></a>
+</div>
+
+A window will pop up with some options to import a file. Click the **Upload** tab. Click on the **Browse** button to choose the file. Or drag and drop the file into the upload area. In this case, the DataLogger IoT saved the comma separated values to a text file called **sfe0003.txt**.
+
+<div style="text-align: center">
+  <a href="../assets/csv_to_spreadsheet_select_file.JPG"><img src="../assets/csv_to_spreadsheet_select_file.JPG" width="600" height="600" alt="Select CSV File"></a>
+</div>
+
+!!! note
+    Not seeing any data in the file or even a text file saved in the root directory? Make sure that the microSD card is formatted correctly and the DataLogger is configured properly. In the menu, make sure to have the [**SD Card Format** enabled and set to the correct format](../configuration/#logging-logger). In this case, we are using the default CSV format.
+
+Another window will pop up asking how to import the file. From the drop down menu, select: **Import location** > **Create new spreadsheet** and **Separator Type** > **Detect automatically**.  Since the file will include commas to separate each reading, Google Sheets should automatically separate text and values into each cell. Otherwise, you can select **comma** as the separator type.
+
+<div style="text-align: center">
+  <a href="../assets/csv_to_spreadsheet_separator_type.JPG"><img src="../assets/csv_to_spreadsheet_separator_type.JPG" width="600" height="600" alt="Separator Type"></a>
+</div>
+
+!!! note
+    If you have the file open, you can also manually paste the CSV data into the spreadsheet. Select all the contents of the text file and copy the contents onto your clipboard. Right click the cell closest to the top and farthest to the left of the spreadsheet (i.e. A1). Then paste the data. One caveat is that Google Sheets may have problems where it only pastes the title of each column.
+
+    <div style="text-align: center">
+      <a href="../assets/csv_to_spreadsheet_title_header_row.JPG"><img src="../assets/csv_to_spreadsheet_title_header_row.JPG" width="600" height="600" alt="Titles of Each Header Rows Only Pasted"></a>
+    </div>
+
+    If you see this happen, you will need to select all but the header row from the text file. Then copy the contents onto your clipboard again. Right click on the next row the titles (i.e. A2) and paste the data.
+
+    <div style="text-align: center">
+      <a href="../assets/csv_to_spreadsheet_manual_paste.JPG"><img src="../assets/csv_to_spreadsheet_manual_paste.JPG" width="600" height="600" alt="Manual Paste"></a>
+    </div>
+
+!!! tip
+    To separate the values to each column, highlight everything in the column. Then head to the menu and select:  **Data** > **Split text into columns**
+
+    <div style="text-align: center">
+      <a href="../assets/csv_to_spreadsheet_split_text_to_columns.JPG"><img src="../assets/csv_to_spreadsheet_split_text_to_columns.JPG" width="600" height="600" alt="Splitting Text to Columns"></a>
+    </div>
+
+
+
+### Graphing Your Datasets
+
+Hold down the <kbd>Shift</kbd> button on your keyboard and select the columns that you would like to graph using your mouse. Once the data is highlighted, head to the menu and select: **Insert** > **Chart**.
+
+<div style="text-align: center">
+  <a href="../assets/csv_to_spreadsheet_select_columns_to_graph.JPG"><img src="../assets/csv_to_spreadsheet_select_columns_to_graph.JPG" width="600" height="600" alt="Select Datasets to Graph and then select Insert > Chart from menu"></a>
+</div>
+
+The values that were selected will be graphed. You will want to be careful about including too many datasets on the graph as it can be hard to read when they are not in the same range.
+
+<div style="text-align: center">
+  <a href="../assets/csv_to_spreadsheet_select_unformatted_chart.JPG"><img src="../assets/csv_to_spreadsheet_select_unformatted_chart.JPG" width="600" height="600" alt="Unformatted Chart"></a>
+</div>
+
+At this point, try formatting the data based on your preferences and export the graph. The graph below was formatted and exported to a PNG. Note that the values for the AQI were moved to the right of the graph for a better viewing since they were smaller than the datasets for TVOC and eCO<sub>2</sub>.
+
+<div style="text-align: center">
+  <a href="../assets/csv_to_spreadsheet_datalogger_iot_environment_dataset.png"><img src="../assets/csv_to_spreadsheet_datalogger_iot_environment_dataset.png" width="600" height="600" alt="Exported and Formatted Chart"></a>
+</div>
+
+!!! note
+    There are additional features to help format your data based on your personal preferences! Select the column that you would like to format. Then head to the menu: **Format** > **Number**. Select the format that you would like to apply to the dataset. In this case, we adjusted the General Time with **Custom Date and Time** to show a 12-hour format before creating a new graph.
+
+    <div style="text-align: center">
+      <a href="../assets/csv_to_spreadsheet_datalogger_iot_environment_dataset_12-hour_format.png"><img src="../assets/csv_to_spreadsheet_datalogger_iot_environment_dataset_12-hour_format.png" width="600" height="600" alt="Exported and Formatted Chart with 12-hour Format"></a>
+    </div>

docs/assets/csv_to_spreadsheet_datalogger_iot_environment_dataset.png

@@ -20,10 +20,10 @@ icon: fontawesome/solid/scroll
 # Configuration
 --8<-- "./docs/configuration.md"
 
-# Connecting to a WiFi Network
+# Example - Connecting to a WiFi Network
 --8<-- "./docs/wifi_network.md"
 
-# Adding a Timestamp to Data
+# Example - Adding a Timestamp to Data
 --8<-- "./docs/example_timestamp.md"
 
 # Example - Factory Reset
@@ -47,6 +47,12 @@ icon: fontawesome/solid/scroll
 # Example - HTTP
 --8<-- "./docs/example_http.md"
 
+# Example - Arduino IoT Cloud
+--8<-- "./docs/example_arduino_iot_cloud.md"
+
+# Example - How to Convert Comma Separated Values (CSV) to a Spreadsheet
+--8<-- "./docs/example_CSV_to_spreadsheet.md"
+
 # Appendix - Supported Qwiic Devices
 --8<-- "./docs/supported_devices.md"
 

docs/assets/csv_to_spreadsheet_datalogger_iot_environment_dataset_12-hour_format.png

@@ -252,6 +252,7 @@ nav:
       - Azure: example_azure.md
       - HTTP: example_http.md
       - Arduino IoT Cloud: example_arduino_iot_cloud.md
+      - How to Convert Comma Separated Values (CSV) to a Spreadsheet: example_CSV_to_spreadsheet.md
     - Appendix - Supported Qwiic Devices: supported_devices.md
   - Resources: resources.md
   - Support: