4. THE COVID19_STATS API

The API provides a much richer base of functionality than the CLI tools, although I have gotten very far by using them. The structure of the API consists of a singleton that contains all the GIS, full COVID-19 state of all counties in the US, and necessary configuration data. Fig. 4.1 describes the implementation flow of synthesizing COVID-19 summary data.

Fig. 4.1 COVID19Database is the singleton that contains US GIS data, and trends of cumulative COVID-19 cases and deaths for all counties and atomic territorial units within the United States. It is somewhat-lazily instantiated by GIS functionality that lives in gis, and is in turn called by utility methods in core.

Subsequent subsections describe each of the main modules, with special emphasis given to COVID19Database due to its integral role.

• 4.1. covid19_stats module
  • COVID19Database
    • COVID19Database.all_counties_nytimes_covid19_data()
    • COVID19Database.data_conus()
    • COVID19Database.data_msas_2019()
    • COVID19Database.data_nonconus_states_territories()
    • COVID19Database.data_states()
    • COVID19Database.fips_adj_2018()
    • COVID19Database.fips_countystate_dict()
    • COVID19Database.fips_data_2019()
    • COVID19Database.fips_dataframe_2019()
    • COVID19Database.fips_msas_2019()
    • COVID19Database.fips_popdict_2019()
    • COVID19Database.mapping_state_rname_conus()
    • COVID19Database.mapping_state_rname_nonconus()
  • get_stat_line()
• 4.2. covid19_stats.engine module
  • find_plausible_maxnum()
  • get_string_commas_num()
  • get_string_commas_num_float()
• 4.3. covid19_stats.engine.gis module
  • calculate_total_bbox()
  • construct_adjacency()
  • create_and_store_fips_2019()
  • create_and_store_fips_counties_2019()
  • create_and_store_msas_and_fips_2019()
  • create_fips_popmap_2019()
  • create_msa_2019()
  • do_bbox_intersect()
  • get_fips_adjacency()
  • merge_msas()
• 4.4. covid19_stats.engine.core module
  • create_readme_from_template()
  • display_tabulated_metros()
  • display_tabulated_metros_fromjson()
  • get_boundary_dict()
  • get_clustering_fips()
  • get_county_state()
  • get_data_fips()
  • get_fips_msa()
  • get_incident_data()
  • get_max_cases_county()
  • get_maximum_cases()
  • get_mp4_album_name()
  • get_msa_data()
• 4.5. covid19_stats.engine.viz module
  • create_and_draw_fromfig()
  • create_plots_daysfrombeginning()
  • create_summary_cases_or_deaths_movie_frombeginning()
  • create_summary_movie_frombeginning()
  • display_fips()
  • display_fips_geom()
  • display_msa()
  • get_summary_demo_data()
  • my_colorbar()
  • plot_cases_deaths_region()
  • plot_cases_or_deaths_bycounty()
• 4.6. covid19_stats.engine.viz2 module
  • create_plots_rate_daysfrombeginning()
  • create_summary_cases_or_deaths_rate_movie_frombeginning()
  • create_summary_rate_movie_frombeginning()
  • get_summary_demo_rate_data()
  • plot_cases_deaths_rate_region()
  • plot_cases_or_deaths_rate_bycounty()