diff --git a/api/sheets/index.md b/api/sheets/index.md index 7d1795560..7574eb24a 100644 --- a/api/sheets/index.md +++ b/api/sheets/index.md @@ -59,3 +59,11 @@ Here's a quick demo on using several of the Data Commons functions to get popula Your spreadsheet should now look like this: ![Sheets first demo](/assets/images/sheets/home_page_demo.png){: height="400"} + +### Sort data + +Because the Data Commons add-on does not actually store values, but only formulas, in a sheet, you can't directly sort the data. To sort the data, you need to copy it as values to a new sheet and then sort as usual: + +1. Select all the columns in the sheet and select **Edit** > **Copy**. +1. Select **Insert** > **Sheet** to create a new sheet. +1. Select **Edit** > **Paste special** > **Values only**. You can now sort each column as desired. diff --git a/api/sheets/tutorials/index.md b/api/sheets/tutorials/index.md index 904338f3d..3a4e958fc 100644 --- a/api/sheets/tutorials/index.md +++ b/api/sheets/tutorials/index.md @@ -13,4 +13,4 @@ Get familiar with the [Data Commons Google Sheets API](..) with these step-by-st - [Analyze the COVID-19 pandemic](sheets_covid.html) - [Obtain latitude information for country capitals in South America](sheets_latitude.html) -- [Sorting the CDC 500 cohort on sleep](sheets_sleep.html) \ No newline at end of file +- [Analyze CDC 500 cities sleep health](sheets_sleep.html) \ No newline at end of file diff --git a/api/sheets/tutorials/sheets_sleep.md b/api/sheets/tutorials/sheets_sleep.md index 9ee02186d..311f65390 100644 --- a/api/sheets/tutorials/sheets_sleep.md +++ b/api/sheets/tutorials/sheets_sleep.md @@ -1,6 +1,6 @@ --- layout: default -title: Sheets CDC 500 Sleep Sorting +title: Sheets CDC 500 cities sleep health nav_order: 2 parent: Tutorials parent_url: /api/sheets/tutorials @@ -8,18 +8,18 @@ grand_parent: Google Sheets grand_parent_url: /api/sheets --- -# Sorting the CDC 500 cohort on sleep +# Analyze the CDC 500 cities for sleep health ## Introduction -The Data Commons API enables easy access to health data for the 500 cities the CDC has prioritized for public health information tracking. This tutorial will walk you through accessing and analyzing that information and scoring each of the cities according to adults residents’ excellence in sleep habits. +The Data Commons API enables easy access to health data for the 500 cities the U.S. Centers for Disease Control and Prevention (CDC) has prioritized for public health information tracking. This tutorial will walk you through accessing and analyzing that information and scoring each of the cities according to adults residents’ excellence in sleep habits, for the year 2020. ## Step 1: Setup Pull up Google Sheets and create a new, blank spreadsheet. You can title it `Data Commons CDC 500 sleep analysis` or any other name of your choosing. ![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_1.png) -To enable the Data Commons API in your spreadsheet, ensure that the Data Commons extension is installed and available under the Extensions tab in the main menu. Hover over the Data Commons menu item, then click on the Fill Place DCIDs option. +To enable the Data Commons API in your spreadsheet, ensure that the Data Commons extension is installed and available under the **Extensions** menu. Hover over the **Data Commons** menu item, then click on the **Fill place DCIDs** option. ![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_2.png) @@ -36,22 +36,18 @@ To get the names of these cities, enter `=DCGETNAME(B1:B500)` into cell C1. The ![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_5.png) -## Step 3: Obtain the sleep health level for each city. +## Step 3: Obtain the sleep health level for each city We will use the percentage of chronically restless residents in each city using the `DCGET` method with the statistical variable `Percent_Person_SleepLessThan7Hours`. (More information on statistical variables is available in the [glossary](https://docs.datacommons.org/glossary.html).) Enter `=DCGET(B1:B500, "Percent_Person_SleepLessThan7Hours", "2016")` into cell D1 in your spreadsheet. The output should look like this: -![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png) +![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png){: width="600"} -## Step 4: Sort on sleep score. -Data Commons has made a tutorial on sorting in Sheets available at . To summarize, the process of sorting on columns looks like this: +## Step 4: Sort on sleep score -- Obtain the desired data from Data Commons. -- Turn on filter views (in the Data dropdown, click "Filter views"). -- Click the inverted triangle at the top of each column. +1. Select columns B, C, and D, and choose **Edit** > **Copy**. +1. Select **Insert** > **Sheet** to add a new sheet. +1. Select **Edit** > **Paste special** > **Values only**. +1. Select column C, click the down arrow, and select **Sort sheet Z to A**. -Follow the example in the video to sort your spreadsheet on the F column. Your final output should look like this: +Your final output should look like this: -![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png) - -Note the added headers and resized column widths for increased clarity. Also, if you’re experiencing slow sorting in the sheet, consider replacing the method calls in the C and D columns with their values. To do this, copy the columns, then paste by value only into their original locations in the spreadsheet. - -To further explore data from this tutorial, check out . \ No newline at end of file +![sorted](/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png){: width="400"} diff --git a/assets/images/sheets/tutorials/sheets_covid_tutorial_7.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_7.png deleted file mode 100644 index cd9316f8a..000000000 Binary files a/assets/images/sheets/tutorials/sheets_covid_tutorial_7.png and /dev/null differ diff --git a/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png index 529ba1c7e..f029ae7a1 100644 Binary files a/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png and b/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png differ diff --git a/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png index 9c51a3fec..87e574d6a 100644 Binary files a/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png and b/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png differ