Skip to content

Mention smoothed fb-survey signals closer to raw signal discussion #272

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Nov 10, 2020
Merged

Mention smoothed fb-survey signals closer to raw signal discussion #272

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1b3cbdf
Mention smoothed signals closer to raw signal discussion
capnrefsmmat Nov 6, 2020
d855a3f
Suggested improvements from Dmitry
capnrefsmmat Nov 6, 2020
cb4db39
Update docs/api/covidcast-signals/fb-survey.md
capnrefsmmat Nov 10, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 16 additions & 17 deletions docs/api/covidcast-signals/fb-survey.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,13 +30,6 @@ described in the sections below:
3. [Testing indicators](#testing-indicators) based on respondent reporting of
their COVID test results

For most `raw_` signals below, there are additional signals with names beginning
with `smoothed_`. These estimate the same quantities as the above signals, but
are smoothed in time to reduce day-to-day sampling noise; see [details
below](#smoothing). Crucially, because the smoothed signals combine information
across multiple days, they have larger sample sizes and hence are available for
more counties and MSAs than the raw signals.

## Table of contents
{: .no_toc .text-delta}

Expand Down Expand Up @@ -84,14 +77,14 @@ influenza-like illness (fever, along with cough or sore throat). Using this
survey data, we estimate the percentage of people who have a COVID-like illness,
or influenza-like illness, in a given location, on a given day.

| Signal | Description |
| Signals | Description |
| --- | --- |
| `raw_cli` | Estimated percentage of people with COVID-like illness based on the [criteria below](#ili-and-cli-indicators), with no smoothing or survey weighting |
| `raw_ili` | Estimated percentage of people with influenza-like illness based on the [criteria below](#ili-and-cli-indicators), with no smoothing or survey weighting |
| `raw_wcli` | Estimated percentage of people with COVID-like illness; adjusted using survey weights [as described below](#survey-weighting) |
| `raw_wili` | Estimated percentage of people with influenza-like illness; adjusted using survey weights [as described below](#survey-weighting) |
| `raw_hh_cmnty_cli` | Estimated percentage of people reporting illness in their local community, as [described below](#estimating-community-cli), including their household, with no smoothing or survey weighting |
| `raw_nohh_cmnty_cli` | Estimated percentage of people reporting illness in their local community, as [described below](#estimating-community-cli), not including their household, with no smoothing or survey weighting |
| `raw_cli` and `smoothed_cli` | Estimated percentage of people with COVID-like illness based on the [criteria below](#ili-and-cli-indicators), with no survey weighting |
| `raw_ili` and `smoothed_ili` | Estimated percentage of people with influenza-like illness based on the [criteria below](#ili-and-cli-indicators), with no survey weighting |
| `raw_wcli` and `smoothed_wcli` | Estimated percentage of people with COVID-like illness; adjusted using survey weights [as described below](#survey-weighting) |
| `raw_wili` and `smoothed_wili` | Estimated percentage of people with influenza-like illness; adjusted using survey weights [as described below](#survey-weighting) |
| `raw_hh_cmnty_cli` and `smoothed_hh_cmnty_cli` | Estimated percentage of people reporting illness in their local community, as [described below](#estimating-community-cli), including their household, with no survey weighting |
| `raw_nohh_cmnty_cli` and `smoothed_nohh_cmnty_cli` | Estimated percentage of people reporting illness in their local community, as [described below](#estimating-community-cli), not including their household, with no survey weighting |

Note that for `raw_hh_cmnty_cli` and `raw_nohh_cmnty_cli`, the illnesses
included are broader: a respondent is included if they know someone in their
Expand All @@ -115,6 +108,12 @@ can be asymptomatic. Instead, we expect these indicators to be useful for
comparison across the United States and across time, to determine where symptoms
appear to be increasing.

**Smoothing.** The signals beginning with `smoothed_` estimate the same quantities as their
`raw` partners, but are smoothed in time to reduce day-to-day sampling noise;
see [details below](#smoothing). Crucially, because the smoothed signals combine
information across multiple days, they have larger sample sizes and hence are
available for more counties and MSAs than the raw signals.

### Defining Household ILI and CLI

For a single survey, we are interested in the quantities:
Expand Down Expand Up @@ -268,9 +267,9 @@ problematic.

### Smoothing

The smoothed versions of the signals described above (with `smoothed_` prefix)
are calculated using seven day pooling. For example, the estimate reported for
June 7 in a specific geographical area (such as county or MSA) is formed by
The smoothed versions of all `fb-survey` signals (with `smoothed_` prefix) are
calculated using seven day pooling. For example, the estimate reported for June
7 in a specific geographical area (such as county or MSA) is formed by
collecting all surveys completed between June 1 and 7 (inclusive) and using that
data in the estimation procedures described above.

Expand Down