Skip to content
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.

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

Release Delphi Epidata 4.1.29 #1589

Merged
merged 5 commits into from
Jan 29, 2025
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
2 changes: 1 addition & 1 deletion .bumpversion.cfg
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
[bumpversion]
current_version = 4.1.28
current_version = 4.1.29
commit = False
tag = False

Expand Down
2 changes: 1 addition & 1 deletion dev/local/setup.cfg
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[metadata]
name = Delphi Development
version = 4.1.28
version = 4.1.29

[options]
packages =
Expand Down
13 changes: 10 additions & 3 deletions docs/api/covidcast-signals/google-symptoms.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,15 @@ nav_order: 1
* **Time type:** day (see [date format docs](../covidcast_times.md))
* **License:** To download or use the data, you must agree to the Google [Terms of Service](https://policies.google.com/terms)

<div style="background-color:#ff00001c; padding: 10px 30px;"><strong>Data issue:</strong> Between May 13 2024 and August 6 2024, signals values were 25%-50% lower compared to previous time periods. This affects <i>all</i> signals and symptom sets. Currently there is no explanation for the decrease in search volume, and the issue is under investigation by our data source partners.</div>

## Overview

This data source is based on the [COVID-19 Search Trends symptoms
dataset](https://console.cloud.google.com/marketplace/product/bigquery-public-datasets/covid19-search-trends?hl=en-GB). Using
this search data, we estimate the volume of searches mapped to symptom sets related
to COVID-19. The resulting daily dataset for each region shows the average relative frequency of searches for each symptom set. The signals are measured in arbitrary units that are normalized for overall search users in the region and scaled by the maximum value of the normalized popularity within a geographic region across a specific time range. **Values are comparable across signals in the same location but NOT across geographic regions**. For example, within a state, we can compare `s01_smoothed_search` and `s02_smoothed_search`. However, we cannot compare `s01_smoothed_search` between states. Larger numbers represent increased relative popularity of symptom-related searches.

Between May 13 2024 and August 6 2024, [signal values were much lower](#limitations) compared to previous time periods due to a data outage.

#### Symptom sets

* _s01_: Cough, Phlegm, Sputum, Upper respiratory tract infection
Expand Down Expand Up @@ -94,7 +94,7 @@ population-weighted averaging.

For aggregation purposes only, we assign a value of 0 to source regions that
have no data provided due to quality or privacy issues for a certain day (see
Limitations for details). We do not report aggregated regions if none of their
[Limitations](#limitations) for details). We do not report aggregated regions if none of their
source regions have data. Because of this censoring behavior, the resulting data
for aggregated regions does not fully match the _actual_ search volume for these
regions (which is not provided to us).
Expand All @@ -106,6 +106,13 @@ As a result the delay can range from 3 to 10 days or even more. We check for
updates every day and provide the most up-to-date data.

## Limitations

Between May 13 2024 and August 6 2024, signal values were 25%-50% lower compared to previous time periods.
This affected _all_ signals and symptom sets.
The drop does not reflect actual search term popularity during the affected period.
The apparent decrease in search volume was caused by an outage in the data pipeline on the source side.
The data was unfortunately not recoverable and the dip can not be repaired, but data outside the listed time period is unaffected.

When daily volume in a region does not meet quality or privacy thresholds, set
by Google, no daily value is reported. Weekly data may be available from Google
in these cases, but we do not yet support importation using weekly data.
Expand Down
4 changes: 2 additions & 2 deletions docs/api/covidcast-signals/nhsn.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: NHSN ED Visits
title: NHSN Respiratory Hospitalizations
parent: Data Sources and Signals
grand_parent: Main Endpoint (COVIDcast)
nav_order: 1
---
# National Syndromic Surveillance Program Emergency Department Visits
# National Healthcare Safety Network Respiratory Hospitalizations
{: .no_toc}

* **Source name:** `nhsn`
Expand Down
2 changes: 1 addition & 1 deletion src/acquisition/covidcast/csv_importer.py
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ class CsvImporter:
REQUIRED_COLUMNS = {'geo_id', 'val', 'se', 'sample_size'}

# reasonable time bounds for sanity checking time values
MIN_YEAR = 2019
MIN_YEAR = 2017 # `google-symptoms` has 2017 data
MAX_YEAR = 2030

# The datatypes expected by pandas.read_csv. Int64 is like float in that it can handle both numbers and nans.
Expand Down
2 changes: 1 addition & 1 deletion src/client/delphi_epidata.R
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Epidata <- (function() {
# API base url
BASE_URL <- getOption('epidata.url', default = 'https://api.delphi.cmu.edu/epidata/')

client_version <- '4.1.28'
client_version <- '4.1.29'

auth <- getOption("epidata.auth", default = NA)

Expand Down
2 changes: 1 addition & 1 deletion src/client/delphi_epidata.js
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
}
})(this, function (exports, fetchImpl, jQuery) {
const BASE_URL = "https://api.delphi.cmu.edu/epidata/";
const client_version = "4.1.28";
const client_version = "4.1.29";

// Helper function to cast values and/or ranges to strings
function _listitem(value) {
Expand Down
2 changes: 1 addition & 1 deletion src/client/packaging/npm/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "delphi_epidata",
"description": "Delphi Epidata API Client",
"authors": "Delphi Group",
"version": "4.1.28",
"version": "4.1.29",
"license": "MIT",
"homepage": "https://github.com/cmu-delphi/delphi-epidata",
"bugs": {
Expand Down
2 changes: 1 addition & 1 deletion src/server/_config.py
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

load_dotenv()

VERSION = "4.1.28"
VERSION = "4.1.29"

MAX_RESULTS = int(10e6)
MAX_COMPATIBILITY_RESULTS = int(3650)
Expand Down