New feature: This package now supports queries that require an API key. Call
covidcast.use_api_key() before running fetch functions to
@@ -50,7 +59,7 @@
New feature: covidcast.signal() can now use asynchronous calls. It is primarily for Delphi internal use;
please consult with us if you intend to use this feature.
New feature: covidcast.plot_choropleth() and covidcast.get_geo_df()
add mapping and plotting capabilities that can be used with the data returned by
@@ -133,7 +142,7 @@
New feature: covidcast.signal() now accepts arguments as_of,
issues, and lag to request data that was issued on a specific date, or
@@ -144,14 +153,14 @@
This package provides access to data from the COVIDcast API, which
provides numerous COVID-related data streams, updated daily. The data is retrieved
live from the server when you make a request, and is not stored within the package
@@ -45,7 +45,7 @@
To obtain smoothed estimates of COVID-like illness from our symptom survey,
distributed through Facebook, for every county in the United States between
2020-05-01 and 2020-05-07:
The COVIDcast API records not just each signal’s estimate for a given location
on a given day, but also when that estimate was made, and all updates to that
estimate.
As seen above, the COVIDcast API identifies counties by their FIPS code and
states by two-letter abbreviations. Metropolitan statistical areas are also
identified by unique codes, called CBSA IDs. (Exact details and exceptions are
@@ -471,7 +471,7 @@
This package provides Python access to the COVIDcast Epidata API published by
the Delphi group at Carnegie Mellon University. This API provides daily access to a range of
COVID-related signals Delphi collects from a variety of sources, including
@@ -66,7 +66,7 @@
The returned DataFrame from covidcast.signal() can be plotted using the built-in
covidcast.plot(). Currently, state, county, hospital referral regions
(HRR), and metropolitan statistical area (MSA) geography types are supported.
To create an animation, simply pass the signal DataFrame to covidcast.animate().
The following code creates an MP4 file named test_plot.mp4 which animates our daily signal for
the month of August.
This package provides a plotting function that takes a state, county, HRR, or MSA
signal and generates a choropleth map, using matplotlib underneath. Detailed examples are provided in the
usage examples.
time_value (Optional[date]) – If multiple days of data are present in data, map only values from this
+
time_value (date) – If multiple days of data are present in data, map only values from this
day. Defaults to plotting the most recent day of data in data.
combine_megacounties (bool) – For each state, display all counties without a signal value as a
single polygon with the megacounty value, as opposed to plotting all the county boundaries.
@@ -87,11 +87,11 @@
Generate an animated video file of a signal over time.
Given a signal DataFrame, generates the choropleth for each day to form an animation of the
signal. Accepts arguments for video parameters as well as optional plotting arguments.
@@ -118,13 +118,13 @@
A function for generating a
GeoPandas GeoDataFrame with signal information appended is also
provided if the user desires more control over their plotting.
Obtains data for selected date ranges for all geographic regions of the
United States. Available data sources and signals are documented in the
@@ -104,11 +104,11 @@
lag (Optional[int]) – Integer. If, for example, lag=3, fetch only data that was
+
lag (int) – Integer. If, for example, lag=3, fetch only data that was
published or updated exactly 3 days after the date. For example, a row
with time_value of June 3 will only be included in the results if its
data was issued or updated on June 6. If None, the default, return the
@@ -200,7 +200,7 @@
Given a list of DataFrames, [optionally] lag each one and join them into one DataFrame.
This method takes a list of DataFrames containing signal information for
geographic regions across time, and outputs a single DataFrame with a column
@@ -218,7 +218,7 @@
The COVIDcast API identifies each geographic region – such as a county or state
– using unique codes. For example, counties are identified by their FIPS codes,
while states are identified by a two-letter abbreviation; more detail is given
@@ -310,10 +310,10 @@
Look up state FIPS codes by abbreviation with regular expression support.
Given an individual or list of state abbreviations or regular expressions,
look up the corresponding state FIPS codes. The returned codes are 5 digits: the
@@ -554,7 +554,7 @@
Look up state abbreviation by FIPS codes with regular expression support.
Given an individual or list of FIPS codes or regular expressions, look up the corresponding
state abbreviation. FIPS codes can be the 2 digit code (covidcast.fips_to_abbr("12")) or
@@ -667,7 +667,7 @@