Merge pull request #906 from cmu-delphi/release/delphi-epidata-0.3.18

Release Delphi Epidata 0.3.18

Author: krivard

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.3.17
+current_version = 0.3.18
 commit = False
 tag = False
 

docs/Gemfile.lock

@@ -211,7 +211,7 @@ GEM
       jekyll-seo-tag (~> 2.1)
     minitest (5.14.4)
     multipart-post (2.1.1)
-    nokogiri (1.13.3)
+    nokogiri (1.13.4)
       mini_portile2 (~> 2.8.0)
       racc (~> 1.4)
     octokit (4.20.0)

docs/symptom-survey/coding.md

@@ -7,10 +7,17 @@ nav_order: 6
 # Questions and Coding
 {: .no_toc}
 
-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.
-
+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, coding schemes, and history of survey waves and
+revisions.
+
+<div style="background-color:#f5f6fa; padding: 10px 30px;"><strong>Comprehensive
+codebook:</strong> Our <a href="codebook.csv">codebook (CSV)</a> lists all
+questions and answer choices across all waves of the survey. See below for
+details on the <a href="#basic-coding-rules">basic coding rules</a> and the <a
+href="#comprehensive-codebook">formatting of the codebook</a>, and narrative
+explanations of the reasons for each instrument change.</div>
 
 ## Table of contents
 {: .no_toc .text-delta}
@@ -45,12 +52,13 @@ The following columns were added beginning when Wave 4 was deployed:
 * `wave`: Integer specifying the survey wave this respondent completed; see
   below for the full list.
 * `UserLanguage`: Language the respondent completed the survey in.
-- `fips`: The *primary* county FIPS code corresponding to the ZIP code selected
-  by the respondent. Note that ZIP codes can cross county and even state
-  boundaries; if a respondent's ZIP is in multiple counties, the FIPS reported
-  in this column corresponds to the county the ZIP overlaps most with. If a ZIP
-  is not more than 50% in any one county, or if their reported ZIP code cannot
-  be found, `NA` is reported.
+- `fips`: The *primary* county [FIPS
+  code](https://en.wikipedia.org/wiki/FIPS_county_code) corresponding to the ZIP
+  code selected by the respondent. Note that ZIP codes can cross county and even
+  state boundaries; if a respondent's ZIP is in multiple counties, the FIPS
+  reported in this column corresponds to the county the ZIP overlaps most with.
+  If a ZIP is not more than 50% in any one county, or if their reported ZIP code
+  cannot be found, `NA` is reported.
 
 Beginning in Wave 11, the `module` column indicates which module the respondent
 was randomly assigned to. See the [survey modules and randomization](modules.md)
@@ -93,11 +101,11 @@ following rules:
 
 ## Comprehensive Codebook
 
-The [codebook](codebook.csv) describes availability of metadata and question
-fields by survey version. A row is included for each field available in the
-microdata files for a given survey wave. We recommend using the codebook as a
-reference while working with the survey microdata, to ensure you interpret each
-question and answer choice accurately even as items were revised between
+The [codebook (CSV)](codebook.csv) describes availability of metadata and
+question fields by survey version. A row is included for each field available in
+the microdata files for a given survey wave. We recommend using the codebook as
+a reference while working with the survey microdata, to ensure you interpret
+each question and answer choice accurately even as items were revised between
 survey waves.
 
 If a field is available for multiple waves, it is listed separately for each

docs/symptom-survey/contingency-codebook.csv

@@ -11,8 +11,9 @@ 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
 experienced as a result of the pandemic. A high-level overview of the survey is
-posted [on the COVIDcast website](https://delphi.cmu.edu/covid19/ctis/). Data
-collection [will cease on June 25, 2022](end-of-survey.md).
+posted [on the COVIDcast website](https://delphi.cmu.edu/covid19/ctis/), and an
+international version is [conducted by the University of
+Maryland](https://covidmap.umd.edu/). Data collection [will cease on June 25, 2022](end-of-survey.md).
 
 The [survey results dashboard](https://delphi.cmu.edu/covidcast/survey-results/)
 provides a high-level summary of survey results. Geographically aggregated data
@@ -31,14 +32,16 @@ If you have questions about the survey or getting access to data, contact us at
 
 ## Credits
 
-The COVID-19 Trends and Impact Survey (CTIS) is a project of the [Delphi
+The US COVID-19 Trends and Impact Survey (CTIS) is a project of the [Delphi
 Group](https://delphi.cmu.edu/) at Carnegie Mellon University. Team members
 include:
 
 * [Alex Reinhart](https://www.refsmmat.com/), Principal Investigator
 * Wichada La Motte-Kerr, Survey Coordinator
 * Robin Mejia, survey advisor
 * Nat DeFries, statistical developer and data engineer
+* Eu Jing Chua (2020-2021) and Mashrin Srivastava (2021-2022), data analysis
+  interns
 * plus support from many members of the [Delphi
   team](https://delphi.cmu.edu/about/team/)
 
@@ -61,7 +64,7 @@ and others. If you are interested in getting involved, see our
 
 ## Citing the Survey
 
-Researchers who use the survey data for research are asked to credit and cite
+Researchers who use the US survey data for research are asked to credit and cite
 the survey in publications based on the data. Specifically, we ask that you:
 
 1. Include the acknowledgment "This research is based on survey results from

docs/symptom-survey/contingency-tables.md

@@ -15,7 +15,7 @@ Epidata <- (function() {
   # API base url
   BASE_URL <- 'https://delphi.cmu.edu/epidata/api.php'
 
-  client_version <- '0.3.17'
+  client_version <- '0.3.18'
 
   # Helper function to cast values and/or ranges to strings
   .listitem <- function(value) {

docs/symptom-survey/index.md

@@ -22,7 +22,7 @@
   }
 })(this, function (exports, fetchImpl, jQuery) {
   const BASE_URL = "https://delphi.cmu.edu/epidata/";
-  const client_version = "0.3.17";
+  const client_version = "0.3.18";
 
   // Helper function to cast values and/or ranges to strings
   function _listitem(value) {

src/client/delphi_epidata.R

@@ -2,7 +2,7 @@
   "name": "delphi_epidata",
   "description": "Delphi Epidata API Client",
   "authors": "Delphi Group",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "license": "MIT",
   "homepage": "https://github.com/cmu-delphi/delphi-epidata",
   "bugs": {

src/client/delphi_epidata.js

@@ -1,4 +1,4 @@
 from .delphi_epidata import Epidata
 
 name = 'delphi_epidata'
-__version__ = '0.3.17'
+__version__ = '0.3.18'

src/client/packaging/npm/package.json

@@ -5,7 +5,7 @@
 
 setuptools.setup(
     name="delphi_epidata",
-    version="0.3.17",
+    version="0.3.18",
     author="David Farrow",
     author_email="[email protected]",
     description="A programmatic interface to Delphi's Epidata API.",

src/client/packaging/pypi/delphi_epidata/__init__.py

@@ -5,7 +5,7 @@
 
 load_dotenv()
 
-VERSION = "0.3.17"
+VERSION = "0.3.18"
 
 MAX_RESULTS = int(10e6)
 MAX_COMPATIBILITY_RESULTS = int(3650)