Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
13 changes: 7 additions & 6 deletions docs/api/covidcast-signals/fb-survey.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: Symptom Surveys
title: COVID-19 Trends and Impact Survey
parent: Data Sources and Signals
grand_parent: COVIDcast Epidata API
---

# Symptom Surveys
# COVID-19 Trends and Impact Survey
{: .no_toc}

* **Source name:** `fb-survey`
Expand All @@ -17,9 +17,10 @@ grand_parent: COVIDcast Epidata API

## Overview

This data source is based on symptom surveys run by the Delphi group at Carnegie
Mellon. Facebook directs a random sample of its users to these surveys, which
are voluntary. Users age 18 or older are eligible to complete the surveys, and
This data source is based on the [COVID-19 Trends and Impact Survey
(CTIS)](../../symptom-survey/) run by the Delphi group at Carnegie Mellon.
Facebook directs a random sample of its users to these surveys, which are
voluntary. Users age 18 or older are eligible to complete the surveys, and
their survey responses are held by CMU and are sharable with other health
researchers under a data use agreement. No individual survey responses are
shared back to Facebook. See our [surveys
Expand Down Expand Up @@ -575,7 +576,7 @@ $$

where $$\pi_i$$ is an estimated probability (produced by Facebook) that an
individual with the same state-by-age-gender profile as user $$i$$ would be a
Facebook user and take our CMU survey. The adjustment we make follows a standard
Facebook user and take our survey. The adjustment we make follows a standard
inverse probability weighting strategy (this being a special case of importance
sampling).

Expand Down
10 changes: 5 additions & 5 deletions docs/symptom-survey/coding.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: Questions and Coding
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey
nav_order: 6
---

# Questions and Coding
{: .no_toc}

The symptom surveys have been deployed in several waves. We have tried to ensure
the coding of waves is consistent. This page provides the full survey text and
coding schemes.
The COVID-19 Trends and Impacts Survey (CTIS) has been deployed in several waves.
We have tried to ensure the coding of waves is consistent. This page provides
the full survey text and coding schemes.


## Table of contents
Expand Down Expand Up @@ -467,7 +467,7 @@ new items were meant to capture reasons for vaccine hesitancy among respondents.
when you use responses from multiple waves of this survey, since they may
shift which occupations respondents choose.
* C14a is a revision of item C14, changed from "the past 5 days" to "the past
7 days" to be consistent with other items on the COVID Symptom Survey.
7 days" to be consistent with other items on CTIS.
C14a replaces C14.
* C17a is a revision of item C17, which asked respondents if they have had a
flu vaccination since June 2020. C17a changed the date to July 1, 2020 and
Expand Down
14 changes: 7 additions & 7 deletions docs/symptom-survey/collaboration-revision.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
---
title: Collaboration and Survey Revision
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey
nav_order: 1
---

# Collaboration and Survey Revision

Delphi continues to revise the COVID-19 Symptom Survey instruments in order to
prioritize items that have the greatest utility for the response to the COVID-19
pandemic. We conduct revisions in collaboration with data users, fellow
researchers, and public health officials, to ensure the survey data best serves
public health and research goals.
Delphi continues to revise the COVID-19 Trends and Impact Survey (CTIS)
instruments in order to prioritize items that have the greatest utility for the
response to the COVID-19 pandemic. We conduct revisions in collaboration with
data users, fellow researchers, and public health officials, to ensure the
survey data best serves public health and research goals.

## Proposing Revisions

If there is a revision or question you would like us to consider, please fill
out [this form requesting details about your
proposal](https://forms.gle/q6NS8fPJJofKQ9mM8). This request can be submitted by
researchers regardless of whether they have a signed Data Use Agreement for the
individual responses to the COVID Symptom Survey.
individual responses to the COVID-19 Trends and Impact Survey.

## Collaboration Meetings

Expand Down
5 changes: 3 additions & 2 deletions docs/symptom-survey/contingency-tables.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: Contingency Tables
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey
nav_order: 4
---

# Contingency Tables
{: .no_toc}

This documentation describes the fine-resolution contingency tables produced by
grouping [COVID Symptom Survey](./index.md) individual responses by various
grouping [COVID-19 Trends and Impact Survey (CTIS)](./index.md) individual responses by various
self-reported demographic features.

* [Weekly files](https://www.cmu.edu/delphi-web/surveys/weekly-rollup/)
Expand Down Expand Up @@ -119,6 +119,7 @@ Within a CSV, the first few columns store metadata of the aggregation:
| `ISO_3` | Three-letter ISO country code ("USA") |
| `GID_0` | GADM level 0 ID |
| `state` | State name; "Overall" if aggregation not grouped at the state level |
| `GID_1` | GADM level 1 ID |
| `state_fips` | State FIPS code; `NA` if aggregation not grouped at the state level |
| `county` | County name; "Overall" if aggregation not grouped at the county level |
| `county_fips` | County FIPS code; `NA` if aggregation not grouped at the county level |
Expand Down
16 changes: 8 additions & 8 deletions docs/symptom-survey/data-access.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
---
title: Getting Data Access
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey
nav_order: 0
---

# Getting Data Access

The Delphi Research Group at Carnegie Mellon University (CMU), in partnership
with Facebook, has conducted the COVID Symptom Survey to better understand the
spread of COVID-19 and its effects on public health and well-being. This may
help improve our local and national responses to the pandemic and our
understanding of how it has affected society.
with Facebook, has conducted the COVID-19 Trends and Impact Survey (CTIS) to
better understand the spread of COVID-19 and its effects on public health and
well-being. This may help improve our local and national responses to the
pandemic and our understanding of how it has affected society.

[High-level aggregates](../api/covidcast.md) of select survey items are
publicly available in the [COVIDcast API](../api/covidcast-signals/fb-survey.md).
Expand All @@ -25,9 +25,9 @@ Agreement (DUA). To request access to the data please submit the information
requested in [Facebook's page on obtaining data
access](https://dataforgood.fb.com/docs/covid-19-symptom-survey-request-for-data-access/),
which sets out the basic conditions and provides a form to request access. An
[international version of the COVID Symptom Survey](https://covidmap.umd.edu/)
is conducted by the University of Maryland (UMD) and access can be requested
through the same form.
[international version of CTIS](https://covidmap.umd.edu/) is conducted by the
University of Maryland (UMD) and access can be requested through the same
form.

The United States survey protocol has been reviewed by the Carnegie Mellon
University Institutional Review Board with IRB ID STUDY2020_00000162.
Expand Down
40 changes: 26 additions & 14 deletions docs/symptom-survey/index.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: COVID Symptom Survey
title: COVID-19 Trends and Impact Survey
has_children: true
nav_order: 2
---

# COVID Symptom Survey
# COVID-19 Trends and Impact Survey

Since April 2020, Delphi has conducted a voluntary COVID-19 symptom survey,
Since April 2020, Delphi has conducted a voluntary survey about COVID-19,
distributed daily to users in the United States via a partnership with Facebook.
This survey asks respondents about COVID-like symptoms, their behavior (such as
social distancing), mental health, and economic and health impacts they have
Expand All @@ -29,7 +29,7 @@ If you have questions about the survey or getting access to data, contact us at

## Credits

The COVID Symptom Survey is a project of the [Delphi
The COVID-19 Trends and Impact Survey (CTIS) is a project of the [Delphi
Group](https://delphi.cmu.edu/) at Carnegie Mellon University. The Principal
Investigator is [Alex Reinhart](https://www.refsmmat.com/); Wichada La
Motte-Kerr is Survey Coordinator. The survey protocol is reviewed by the
Expand Down Expand Up @@ -59,18 +59,30 @@ the survey in publications based on the data. Specifically, we ask that you:
2. Cite this web page for details about the survey. For example, you may cite it
as

> Delphi Group (2021). COVID Symptom Survey.
> Delphi Group (2021). COVID-19 Trends and Impact Survey.
> <https://cmu-delphi.github.io/delphi-epidata/symptom-survey/>

A journal article describing the survey and its methods is currently in
preparation, and we will update this page when it is available so that you
can cite it instead.
3. Send a copy of your publication, once it appears publicly as a preprint or
journal article, to <[email protected]>.

Additionally, please note that the data use agreement requires that if you
disclose survey microdata, Delphi must agree on the aggregation method that you
will use to ensure reported estimates do not disclose any individual
identifiable information, including individual survey results. If you are unsure
whether a particular aggregation will prevent disclosure of individual survey
results, please email us at <[email protected]>.
3. The data use agreement requires that if you disclose survey microdata, Delphi
must agree on the aggregation method that you will use to ensure reported
estimates do not disclose any individual identifiable information, including
individual survey results. If you are unsure whether a particular aggregation
will prevent disclosure of individual survey results, please email us at
<[email protected]>.
4. Finally, send a copy of your publication, once it appears publicly as a
preprint or journal article, to <[email protected]>.

When referring to the survey in text, we prefer the following formats:

* Long form (such as in an introduction or methods description): "The Delphi
Group at Carnegie Mellon University U.S. COVID-19 Trends and Impact Survey, in
partnership with Facebook".
* Short form (used after the long form has been introduced): "The U.S. COVID-19
Trends and Impact Survey"
* Acronym form: "Delphi US CTIS"

Prior to July 2021, the survey was known as the COVID Symptom Survey (CSS), and
some older documentation and publication may still refer to this name. We prefer
that new publications and materials refer to the new name.
12 changes: 6 additions & 6 deletions docs/symptom-survey/modules.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
title: Survey Modules & Randomization
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey
nav_order: 7
---

# Questions and Coding
{: .no_toc}

To reduce the overall length of the instrument and minimize response burden, the
COVID Symptom Survey will consist of a block of daily core questions and will
use a randomized module approach for the other topics. Implementation of this
approach started in [Wave 11](coding.md#wave-11), which launched on May 20,
2021.
To reduce the overall length of the instrument and minimize response burden,
the COVID-19 Trends and Impact Survey (CTIS) will consist of a block of daily
core questions and will use a randomized module approach for the other topics.
Implementation of this approach started in [Wave 11](coding.md#wave-11), which
launched on May 20, 2021.

Each respondent invited to take the survey will be asked the daily core
questions. The daily core questions for Wave 11 include:
Expand Down
8 changes: 4 additions & 4 deletions docs/symptom-survey/problems.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: Problems and Data Errors
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey
nav_order: 8
---

# Problems and Data Errors
{: .no_toc}

Given the scale of the COVID Symptom Survey, we occasionally encounter data
errors or survey implementation problems that affect the interpretation of
results. All problems will be logged here.
Given the scale of the COVID-19 Trends and Impact Survey (CTIS), we occasionally
encounter data errors or survey implementation problems that affect the
interpretation of results. All problems will be logged here.

## Table of contents
{: .no_toc .text-delta}
Expand Down
9 changes: 5 additions & 4 deletions docs/symptom-survey/server-access.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
---
title: SFTP Server Access
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey
nav_order: 2
---

# SFTP Server Access

Researchers with data use agreements to access the raw data from the COVID-19
symptom survey can access the data over SFTP. (If you do not have a data use
agreement, see the [main survey page](index.md) for information about getting
access and about aggregate data that is available for public download.)
Trends and Impact Survey (CTIS) can access the data over SFTP. (If you do not
have a data use agreement, see the [main survey page](index.md) for
information about getting access and about aggregate data that is available
for public download.)

If you're not familiar with SFTP, it is a protocol for securely accessing and downloading
large amounts of data from remote servers. The instructions below explain how to
Expand Down
11 changes: 6 additions & 5 deletions docs/symptom-survey/survey-files.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,17 @@
---
title: Response Files
parent: COVID Symptom Survey
parent: COVID-19 Trends and Impact Survey (CTIS)
nav_order: 3
---

# Response Files
{: .no_toc}

Users with access to the [COVID Symptom Survey](./index.md) individual response
data should have received SFTP credentials for a private server where the data
are stored. To connect to the server, see the [server access documentation](server-access.md).
This documentation describes the survey data available on that server.
Users with access to the [COVID-19 Trends and Impact Survey (CTIS)](./index.md)
individual response data should have received SFTP credentials for a private
server where the data are stored. To connect to the server, see the [server
access documentation](server-access.md). This documentation describes the
survey data available on that server.

You must sign a Data Use Agreement with Facebook and with CMU to gain
access to the individual survey responses. If you have not done so, aggregate
Expand Down
Loading