Python module to directly import data from the CDC FluView dashboard (http://gis.cdc.gov/grasp/fluview/fluportaldashboard.html) into an interactive session.
Currently, the module will import data from FluView and save to a csv file. It will also save the imported data into a pandas data frame for further analysis.
- requests (http://docs.python-requests.org/en/latest/)
- pandas (http://pandas.pydata.org/)
Navigate to where you downloaded the module and start up iPython.
import cdc
import pandas
# Interactive session with pandas.
ili = cdc.FluView(data_sources='ili', seasons='all', region='census',
sub_regions=[1, 2])
df = ili.to_pandas_df()
df.columns
# Saving to a csv file.
ili.save_csv()If you save to a csv file and do not specify a filename or path, then the file will be saved to the same directory where you started iPython with a timestamp as the filename.
A few notes about the input parameters:
- data_sources
- You can collect data specifically from the ILI database or the WHO NREVSS from FluView or both. If you want both ILI and WHO data you can modify the data_sources variable to be a list such as ['ili', 'who'].
- seasons
- The seasons variable can also be modified to be a list of season integers or a single season of interest, e.g. seasons=45 or seasons=[37,49,55].
- region
- The region parameter can be an integer or a string indicating which region of interest to pull data from, e.g region='national' or region=3.
- sub_regions
- If you have chosen the region to be either census (2) or hhs (1)
then you can specify a single subregion or a list of subregions to
collect data on. Valid subregion values are:
- HHS Regions
- An integer from [1, 10]
- Census
- An integer from [1, 9] or
- a string from ['new england', 'mid-atlantic', 'east north central', 'west north central', 'south atlantic', 'east south central', 'west south central', 'mountain', 'pacific']
- Note that if you select the region to be national, then there are no subregions to collect data on.
- HHS Regions
- If you have chosen the region to be either census (2) or hhs (1)
then you can specify a single subregion or a list of subregions to
collect data on. Valid subregion values are: