Skip to content

Commit 1765c71

Browse files
capnrefsmmatcapnrefsmmat
authored
Merge pull request #623 from cmu-delphi/survey-name-update
Update docs to refer to survey as COVID Trends and Impact Survey instead of COVID Symptom Survey
2 parents afb442f + 6837ef5 commit 1765c71

File tree

12 files changed

+151
-108
lines changed

12 files changed

+151
-108
lines changed

‎docs/api/covidcast-signals/fb-survey.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: Symptom Surveys
2+
title: COVID-19 Trends and Impact Survey
33
parent: Data Sources and Signals
44
grand_parent: COVIDcast Epidata API
55
---
66

7-
# Symptom Surveys
7+
# COVID-19 Trends and Impact Survey
88
{: .no_toc}
99

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

1818
## Overview
1919

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

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

‎docs/symptom-survey/coding.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
22
title: Questions and Coding
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey
44
nav_order: 6
55
---
66

77
# Questions and Coding
88
{: .no_toc}
99

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

1414

1515
## Table of contents
@@ -467,7 +467,7 @@ new items were meant to capture reasons for vaccine hesitancy among respondents.
467467
when you use responses from multiple waves of this survey, since they may
468468
shift which occupations respondents choose.
469469
* C14a is a revision of item C14, changed from "the past 5 days" to "the past
470-
7 days" to be consistent with other items on the COVID Symptom Survey.
470+
7 days" to be consistent with other items on CTIS.
471471
C14a replaces C14.
472472
* C17a is a revision of item C17, which asked respondents if they have had a
473473
flu vaccination since June 2020. C17a changed the date to July 1, 2020 and

‎docs/symptom-survey/collaboration-revision.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
---
22
title: Collaboration and Survey Revision
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey
44
nav_order: 1
55
---
66

77
# Collaboration and Survey Revision
88

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

1515
## Proposing Revisions
1616

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

2323
## Collaboration Meetings
2424

‎docs/symptom-survey/contingency-tables.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: Contingency Tables
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey
44
nav_order: 4
55
---
66

77
# Contingency Tables
88
{: .no_toc}
99

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

1414
* [Weekly files](https://www.cmu.edu/delphi-web/surveys/weekly-rollup/)
@@ -119,6 +119,7 @@ Within a CSV, the first few columns store metadata of the aggregation:
119119
| `ISO_3` | Three-letter ISO country code ("USA") |
120120
| `GID_0` | GADM level 0 ID |
121121
| `state` | State name; "Overall" if aggregation not grouped at the state level |
122+
| `GID_1` | GADM level 1 ID |
122123
| `state_fips` | State FIPS code; `NA` if aggregation not grouped at the state level |
123124
| `county` | County name; "Overall" if aggregation not grouped at the county level |
124125
| `county_fips` | County FIPS code; `NA` if aggregation not grouped at the county level |

‎docs/symptom-survey/data-access.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
title: Getting Data Access
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey
44
nav_order: 0
55
---
66

77
# Getting Data Access
88

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

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

3232
The United States survey protocol has been reviewed by the Carnegie Mellon
3333
University Institutional Review Board with IRB ID STUDY2020_00000162.

‎docs/symptom-survey/index.md‎

Lines changed: 26 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: COVID Symptom Survey
2+
title: COVID-19 Trends and Impact Survey
33
has_children: true
44
nav_order: 2
55
---
66

7-
# COVID Symptom Survey
7+
# COVID-19 Trends and Impact Survey
88

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

3030
## Credits
3131

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

62-
> Delphi Group (2021). COVID Symptom Survey.
62+
> Delphi Group (2021). COVID-19 Trends and Impact Survey.
6363
> <https://cmu-delphi.github.io/delphi-epidata/symptom-survey/>
6464
6565
A journal article describing the survey and its methods is currently in
6666
preparation, and we will update this page when it is available so that you
6767
can cite it instead.
68-
3. Send a copy of your publication, once it appears publicly as a preprint or
69-
journal article, to <[email protected]>.
70-
71-
Additionally, please note that the data use agreement requires that if you
72-
disclose survey microdata, Delphi must agree on the aggregation method that you
73-
will use to ensure reported estimates do not disclose any individual
74-
identifiable information, including individual survey results. If you are unsure
75-
whether a particular aggregation will prevent disclosure of individual survey
76-
results, please email us at <[email protected]>.
68+
3. The data use agreement requires that if you disclose survey microdata, Delphi
69+
must agree on the aggregation method that you will use to ensure reported
70+
estimates do not disclose any individual identifiable information, including
71+
individual survey results. If you are unsure whether a particular aggregation
72+
will prevent disclosure of individual survey results, please email us at
73+
<[email protected]>.
74+
4. Finally, send a copy of your publication, once it appears publicly as a
75+
preprint or journal article, to <[email protected]>.
76+
77+
When referring to the survey in text, we prefer the following formats:
78+
79+
* Long form (such as in an introduction or methods description): "The Delphi
80+
Group at Carnegie Mellon University U.S. COVID-19 Trends and Impact Survey, in
81+
partnership with Facebook".
82+
* Short form (used after the long form has been introduced): "The U.S. COVID-19
83+
Trends and Impact Survey"
84+
* Acronym form: "Delphi US CTIS"
85+
86+
Prior to July 2021, the survey was known as the COVID Symptom Survey (CSS), and
87+
some older documentation and publication may still refer to this name. We prefer
88+
that new publications and materials refer to the new name.

‎docs/symptom-survey/modules.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
22
title: Survey Modules & Randomization
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey
44
nav_order: 7
55
---
66

77
# Questions and Coding
88
{: .no_toc}
99

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

1616
Each respondent invited to take the survey will be asked the daily core
1717
questions. The daily core questions for Wave 11 include:

‎docs/symptom-survey/problems.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
22
title: Problems and Data Errors
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey
44
nav_order: 8
55
---
66

77
# Problems and Data Errors
88
{: .no_toc}
99

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

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

‎docs/symptom-survey/server-access.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
22
title: SFTP Server Access
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey
44
nav_order: 2
55
---
66

77
# SFTP Server Access
88

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

1415
If you're not familiar with SFTP, it is a protocol for securely accessing and downloading
1516
large amounts of data from remote servers. The instructions below explain how to

‎docs/symptom-survey/survey-files.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
---
22
title: Response Files
3-
parent: COVID Symptom Survey
3+
parent: COVID-19 Trends and Impact Survey (CTIS)
44
nav_order: 3
55
---
66

77
# Response Files
88
{: .no_toc}
99

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

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

0 commit comments

Comments
 (0)