diff --git a/.bumpversion.cfg b/.bumpversion.cfg index b56b194c9..a14bdf434 100644 --- a/.bumpversion.cfg +++ b/.bumpversion.cfg @@ -1,5 +1,5 @@ [bumpversion] -current_version = 0.3.8 +current_version = 0.3.9 commit = False tag = False diff --git a/docs/api/covidcast-signals/dsew-cpr.md b/docs/api/covidcast-signals/dsew-cpr.md new file mode 100644 index 000000000..d2d871428 --- /dev/null +++ b/docs/api/covidcast-signals/dsew-cpr.md @@ -0,0 +1,66 @@ +--- +title: Data Strategy and Execution Workgroup Community Profile Report +parent: Data Sources and Signals +grand_parent: COVIDcast Epidata API +--- + +# Data Strategy and Execution Workgroup Community Profile Report (CPR) +{: .no_toc} + +* **Source name:** `dsew-cpr` +* **Earliest issue available:** 2022-01-28 +* **Number of data revisions since 19 May 2020:** 0 +* **Date of last change:** Never +* **Available for:** county, msa, state, hhs, nation (see [geography coding docs](../covidcast_geography.md)) +* **Time type:** day (see [date format docs](../covidcast_times.md)) +* **License:** [Public Domain US Government](https://www.usa.gov/government-works) + +The Community Profile Report (CPR) is published by the Data Strategy and Execution Workgroup (DSEW) of the White House COVID-19 Team. For more information, see the [official description and data dictionary at healthdata.gov](https://healthdata.gov/Health/COVID-19-Community-Profile-Report/gqxm-d9w9) for "COVID-19 Community Profile Report". + +This data source provides various COVID-19 related metrics, of which we report hospital admissions. Other sources of hospital admissions data in COVIDcast include [HHS](hhs.md) and [medical insurance claims](hospital-admissions.md). The CPR differs from these sources in that it is part of the public health surveillance stream (like HHS, unlike claims) but is available at a daily-county level (like claims, unlike HHS). CPR hospital admissions figures at the state level and above are meant to match those from HHS, but are known to differ. See the Limitations section for details. + +County, MSA, state, and HHS-level values are pulled directly from CPR; nation-level values are aggregated up from the state level. + +| Signal | Description | +| --- | --- | +| `confirmed_admissions_covid_1d_7dav` | Number of adult and pediatric confirmed COVID-19 hospital admissions occurring each day. Smoothed using a 7-day average. +Earliest date available: 2019-12-16 for state, HHS, and nation; 2021-01-06 for MSA and county | +| `confirmed_admissions_covid_1d_prop_7dav` | Number of adult and pediatric confirmed COVID-19 hospital admissions occurring each day, per 100,000 population. Smoothed using a 7-day average. +Earliest date available: 2019-12-16 for state, HHS, and nation; 2021-01-06 for MSA and county | + +## Table of contents +{: .no_toc .text-delta} + +1. TOC +{:toc} + +## Estimation + +For counts-based fields like hospital admissions, CPR reports rolling sums for the preceding 7 days. The 7-day average signals are computed by Delphi by dividing each sum by 7 and assigning it to the last date in the included range, so e.g. the signal for June 7 is the average of the underlying data for June 1 through 7, inclusive. + +The `confirmed_admissions_covid_1d_7dav` signal mirrors the `Confirmed COVID-19 admissions - last 7 days` CPR field for all geographic resolutions except nation. Nation-level admissions is calculated by summing state-level values. + +## Limitations + +Nation-level estimates may be inaccurate since aggregations are done using state-level smoothed values instead of raw values. Ideally we would aggregate raw values before smoothing, but the raw values are not accessible in this case. + +Because DSEW does not provide updates on weekends, estimates are not available for all dates. + +### Differences with HHS reports + +An analysis comparing the +[CPR labeled January 5, 2022](https://healthdata.gov/api/views/gqxm-d9w9/files/14ee1150-edf1-4b54-b225-500c8954e6a8?download=true&filename=Community%20Profile%20Report%2020220105.xlsx) +(newest file as of January 6, 2022) with the HHS +[COVID-19 Reported Patient Impact and Hospital Capacity by State Timeseries](https://healthdata.gov/Hospital/COVID-19-Reported-Patient-Impact-and-Hospital-Capa/g62h-syeh) +(downloaded January 6, 2022) suggests that the CPR undercounts the hospital admissions published by HHS by 10-15% or more. We are waiting from clarification from the data provider, but until then, exercise caution when comparing work based on the CPR with work based on HHS reports. + +## Lag and Backfill + +The report is currently updated daily, excluding weekends. However, this is subject to change; DSEW previously issued updates on a twice-weekly schedule. We check for updates daily. + +Hospital admissions are reported with a lag of 2 days, but since the CPR is not updated on weekends, lag effectively varies from 2-4 days. + +## Source and Licensing + +This indicator mirrors and lightly aggregates data originally published by the Data Strategy and Execution Workgroup via [HealthData.gov](https://healthdata.gov/). As a work of the US government, the original data is in the [public domain](https://www.usa.gov/government-works). + diff --git a/src/client/delphi_epidata.R b/src/client/delphi_epidata.R index 7a39106ed..cd8f91924 100644 --- a/src/client/delphi_epidata.R +++ b/src/client/delphi_epidata.R @@ -15,7 +15,7 @@ Epidata <- (function() { # API base url BASE_URL <- 'https://delphi.cmu.edu/epidata/api.php' - client_version <- '0.3.8' + client_version <- '0.3.9' # Helper function to cast values and/or ranges to strings .listitem <- function(value) { diff --git a/src/client/delphi_epidata.js b/src/client/delphi_epidata.js index 9db0f1d30..8fee22ead 100644 --- a/src/client/delphi_epidata.js +++ b/src/client/delphi_epidata.js @@ -22,7 +22,7 @@ } })(this, function (exports, fetchImpl, jQuery) { const BASE_URL = "https://delphi.cmu.edu/epidata/"; - const client_version = "0.3.8"; + const client_version = "0.3.9"; // Helper function to cast values and/or ranges to strings function _listitem(value) { diff --git a/src/client/packaging/npm/package.json b/src/client/packaging/npm/package.json index 1d4cd5d26..df67c1f7c 100644 --- a/src/client/packaging/npm/package.json +++ b/src/client/packaging/npm/package.json @@ -2,7 +2,7 @@ "name": "delphi_epidata", "description": "Delphi Epidata API Client", "authors": "Delphi Group", - "version": "0.3.8", + "version": "0.3.9", "license": "MIT", "homepage": "https://github.com/cmu-delphi/delphi-epidata", "bugs": { diff --git a/src/client/packaging/pypi/delphi_epidata/__init__.py b/src/client/packaging/pypi/delphi_epidata/__init__.py index e711a08b2..4a28a0fd3 100644 --- a/src/client/packaging/pypi/delphi_epidata/__init__.py +++ b/src/client/packaging/pypi/delphi_epidata/__init__.py @@ -1,4 +1,4 @@ from .delphi_epidata import Epidata name = 'delphi_epidata' -__version__ = '0.3.8' +__version__ = '0.3.9' diff --git a/src/client/packaging/pypi/setup.py b/src/client/packaging/pypi/setup.py index d80df295e..31fbd7f0b 100644 --- a/src/client/packaging/pypi/setup.py +++ b/src/client/packaging/pypi/setup.py @@ -5,7 +5,7 @@ setuptools.setup( name="delphi_epidata", - version="0.3.8", + version="0.3.9", author="David Farrow", author_email="dfarrow0@gmail.com", description="A programmatic interface to Delphi's Epidata API.", diff --git a/src/server/_config.py b/src/server/_config.py index 51576a757..29341b307 100644 --- a/src/server/_config.py +++ b/src/server/_config.py @@ -5,7 +5,7 @@ load_dotenv() -VERSION = "0.3.8" +VERSION = "0.3.9" MAX_RESULTS = int(10e6) MAX_COMPATIBILITY_RESULTS = int(3650)