3.5. covid19_movie_updates

This CLI is designed to be used by an external service to update the COVID-19 cumulative case and death summary movies and figures for the CONUS, MSAs, and US states or territories. It uses MPI through the mpi4py Python module to parallelize the process of creating summary movies and figures; thus, it can leverage running on a supercomputer to parallelize individually long and high-memory tasks.

It uses API level back-ends to create COVID-19 summary movies and figures, of the CLI front-ends covid19_create_movie_or_summary and covid19_state_summary. Its help output, when running covid19_movie_updates -h, is the following,

usage: covid19_movie_updates [-h] [--region [region [region ...]]] [--state [state [state ...]]] [--dirname DIRNAME] [--topN TOPN] [--info]

optional arguments:
  -h, --help            show this help message and exit
  --region [region [region ...]]
                        regions to choose to create summary plots, big movies, and smaller movies.
  --state [state [state ...]]
                        states to choose to create summary plots, big movies, and smaller movies.
  --dirname DIRNAME     The name of the directory to which to put all this stuff. Default is /g/g12/islam5/.local/src/covid19_stats/docsrc.
  --topN TOPN           Print out JSON formatted COVID-19 summary data for the topN US MSAs. Default is 50.
  --info                If chosen, then turn on INFO logging.

This will create eighteen COVID-19 case and death summary movies and figures for each specified region you specify: the CONUS (if chosen), MSAs, and US states and territories. For example, for the CONUS, it creates these figures and movies in the specified output directory,

Here are the flags and their meanings.

  • --dirname specifies the directory into which to dump the output simulation results. The default is current working directory.

  • --region specifies the MSAs or CONUS. Thus, --region nyc conus means to create summary data for the NYC metropolitan area and the CONUS.

  • --state specifies the US states or territories. Thus, --state California Texas Virginia means to create summary data for the states of California, Texas, and Virginia.

  • In addition, the --topN flag specifies the \(N \ge 1\) top MSAs for which to create and store COVID-19 summary data into a JSON file. This JSON file lives in the speciified directory. Its name is covid19_topN_LATEST.json. This example file has the data for the top 50 MSAs, and I include it below,

      1[
  2  {
  3    "RANK": 1,
  4    "PREFIX" : "nyc",
  5    "NAME" : "NYC Metro Area",
  6    "POPULATION" : 19216182,
  7    "FIRST INC." : "01 March 2020",
  8    "NUM DAYS" : 1104,
  9    "NUM CASES" : 7177099,
 10    "NUM DEATHS" : 88179,
 11    "MAX CASE COUNTY" : "3247350",
 12    "MAX CASE COUNTY NAME" : "New York City, New York"
 13
 14  },
 15  {
 16    "RANK": 2,
 17    "PREFIX" : "losangeles",
 18    "NAME" : "LA Metro Area",
 19    "POPULATION" : 18711436,
 20    "FIRST INC." : "25 January 2020",
 21    "NUM DAYS" : 1140,
 22    "NUM CASES" : 6265538,
 23    "NUM DEATHS" : 61716,
 24    "MAX CASE COUNTY" : "3715057",
 25    "MAX CASE COUNTY NAME" : "Los Angeles County, California"
 26
 27  },
 28  {
 29    "RANK": 3,
 30    "PREFIX" : "chicago",
 31    "NAME" : "Chicago Metro Area",
 32    "POPULATION" : 9458539,
 33    "FIRST INC." : "24 January 2020",
 34    "NUM DAYS" : 1141,
 35    "NUM CASES" : 2859144,
 36    "NUM DEATHS" : 27146,
 37    "MAX CASE COUNTY" : "1533935",
 38    "MAX CASE COUNTY NAME" : "Cook County, Illinois"
 39
 40  },
 41  {
 42    "RANK": 4,
 43    "PREFIX" : "dallas",
 44    "NAME" : "Dallas Metro Area",
 45    "POPULATION" : 7573136,
 46    "FIRST INC." : "09 March 2020",
 47    "NUM DAYS" : 1096,
 48    "NUM CASES" : 2150835,
 49    "NUM DEATHS" : 20090,
 50    "MAX CASE COUNTY" : "696583",
 51    "MAX CASE COUNTY NAME" : "Dallas County, Texas"
 52
 53  },
 54  {
 55    "RANK": 5,
 56    "PREFIX" : "houston",
 57    "NAME" : "Houston Metro Area",
 58    "POPULATION" : 7066141,
 59    "FIRST INC." : "04 March 2020",
 60    "NUM DAYS" : 1101,
 61    "NUM CASES" : 1984182,
 62    "NUM DEATHS" : 17061,
 63    "MAX CASE COUNTY" : "1275028",
 64    "MAX CASE COUNTY NAME" : "Harris County, Texas"
 65
 66  },
 67  {
 68    "RANK": 6,
 69    "PREFIX" : "bayarea",
 70    "NAME" : "Bay Area",
 71    "POPULATION" : 6860207,
 72    "FIRST INC." : "31 January 2020",
 73    "NUM DAYS" : 1134,
 74    "NUM CASES" : 1709859,
 75    "NUM DEATHS" : 9180,
 76    "MAX CASE COUNTY" : "497578",
 77    "MAX CASE COUNTY NAME" : "Santa Clara County, California"
 78
 79  },
 80  {
 81    "RANK": 7,
 82    "PREFIX" : "dc",
 83    "NAME" : "DC Metro Area",
 84    "POPULATION" : 6280487,
 85    "FIRST INC." : "05 March 2020",
 86    "NUM DAYS" : 1100,
 87    "NUM CASES" : 1542539,
 88    "NUM DEATHS" : 12681,
 89    "MAX CASE COUNTY" : "261545",
 90    "MAX CASE COUNTY NAME" : "Fairfax County, Virginia"
 91
 92  },
 93  {
 94    "RANK": 8,
 95    "PREFIX" : "miami",
 96    "NAME" : "Miami Metro Area",
 97    "POPULATION" : 6166488,
 98    "FIRST INC." : "06 March 2020",
 99    "NUM DAYS" : 1099,
100    "NUM CASES" : 2796257,
101    "NUM DEATHS" : 25086,
102    "MAX CASE COUNTY" : "1545273",
103    "MAX CASE COUNTY NAME" : "Miami-Dade County, Florida"
104
105  },
106  {
107    "RANK": 9,
108    "PREFIX" : "philadelphia",
109    "NAME" : "Philadelphia Metro Area",
110    "POPULATION" : 6102434,
111    "FIRST INC." : "06 March 2020",
112    "NUM DAYS" : 1099,
113    "NUM CASES" : 1641446,
114    "NUM DEATHS" : 20382,
115    "MAX CASE COUNTY" : "394710",
116    "MAX CASE COUNTY NAME" : "Philadelphia County, Pennsylvania"
117
118  },
119  {
120    "RANK": 10,
121    "PREFIX" : "atlanta",
122    "NAME" : "Atlanta Metro Area",
123    "POPULATION" : 6020364,
124    "FIRST INC." : "02 March 2020",
125    "NUM DAYS" : 1103,
126    "NUM CASES" : 1653692,
127    "NUM DEATHS" : 18105,
128    "MAX CASE COUNTY" : "276851",
129    "MAX CASE COUNTY NAME" : "Fulton County, Georgia"
130
131  },
132  {
133    "RANK": 11,
134    "PREFIX" : "phoenix",
135    "NAME" : "Phoenix Metro Area",
136    "POPULATION" : 4948203,
137    "FIRST INC." : "26 January 2020",
138    "NUM DAYS" : 1139,
139    "NUM CASES" : 1687900,
140    "NUM DEATHS" : 20660,
141    "MAX CASE COUNTY" : "1530926",
142    "MAX CASE COUNTY NAME" : "Maricopa County, Arizona"
143
144  },
145  {
146    "RANK": 12,
147    "PREFIX" : "boston",
148    "NAME" : "Boston Metro Area",
149    "POPULATION" : 4873019,
150    "FIRST INC." : "01 February 2020",
151    "NUM DAYS" : 1133,
152    "NUM CASES" : 1401594,
153    "NUM DEATHS" : 15532,
154    "MAX CASE COUNTY" : "437431",
155    "MAX CASE COUNTY NAME" : "Middlesex County, Massachusetts"
156
157  },
158  {
159    "RANK": 13,
160    "PREFIX" : "detroit",
161    "NAME" : "Detroit Metro Area",
162    "POPULATION" : 4319629,
163    "FIRST INC." : "10 March 2020",
164    "NUM DAYS" : 1095,
165    "NUM CASES" : 1357029,
166    "NUM DEATHS" : 20263,
167    "MAX CASE COUNTY" : "537074",
168    "MAX CASE COUNTY NAME" : "Wayne County, Michigan"
169
170  },
171  {
172    "RANK": 14,
173    "PREFIX" : "seattle",
174    "NAME" : "Seattle Metro Area",
175    "POPULATION" : 3979845,
176    "FIRST INC." : "21 January 2020",
177    "NUM DAYS" : 1144,
178    "NUM CASES" : 1001913,
179    "NUM DEATHS" : 6607,
180    "MAX CASE COUNTY" : "551112",
181    "MAX CASE COUNTY NAME" : "King County, Washington"
182
183  },
184  {
185    "RANK": 15,
186    "PREFIX" : "minneapolis",
187    "NAME" : "Minneapolis Metro Area",
188    "POPULATION" : 3640043,
189    "FIRST INC." : "06 March 2020",
190    "NUM DAYS" : 1099,
191    "NUM CASES" : 1129123,
192    "NUM DEATHS" : 8552,
193    "MAX CASE COUNTY" : "386090",
194    "MAX CASE COUNTY NAME" : "Hennepin County, Minnesota"
195
196  },
197  {
198    "RANK": 16,
199    "PREFIX" : "sandiego",
200    "NAME" : "San Diego Metro Area",
201    "POPULATION" : 3338330,
202    "FIRST INC." : "10 February 2020",
203    "NUM DAYS" : 1124,
204    "NUM CASES" : 1068002,
205    "NUM DEATHS" : 6047,
206    "MAX CASE COUNTY" : "1068002",
207    "MAX CASE COUNTY NAME" : "San Diego County, California"
208
209  },
210  {
211    "RANK": 17,
212    "PREFIX" : "tampa",
213    "NAME" : "Tampa Metro Area",
214    "POPULATION" : 3194831,
215    "FIRST INC." : "01 March 2020",
216    "NUM DAYS" : 1104,
217    "NUM CASES" : 966535,
218    "NUM DEATHS" : 12040,
219    "MAX CASE COUNTY" : "478412",
220    "MAX CASE COUNTY NAME" : "Hillsborough County, Florida"
221
222  },
223  {
224    "RANK": 18,
225    "PREFIX" : "denver",
226    "NAME" : "Denver Metro Area",
227    "POPULATION" : 2967239,
228    "FIRST INC." : "05 March 2020",
229    "NUM DAYS" : 1100,
230    "NUM CASES" : 881782,
231    "NUM DEATHS" : 6643,
232    "MAX CASE COUNTY" : "225230",
233    "MAX CASE COUNTY NAME" : "Denver County, Colorado"
234
235  },
236  {
237    "RANK": 19,
238    "PREFIX" : "stlouis",
239    "NAME" : "St. Louis Metro Area",
240    "POPULATION" : 2803228,
241    "FIRST INC." : "07 March 2020",
242    "NUM DAYS" : 1098,
243    "NUM CASES" : 862248,
244    "NUM DEATHS" : 9502,
245    "MAX CASE COUNTY" : "294851",
246    "MAX CASE COUNTY NAME" : "St. Louis County, Missouri"
247
248  },
249  {
250    "RANK": 20,
251    "PREFIX" : "baltimore",
252    "NAME" : "Baltimore Metro Area",
253    "POPULATION" : 2800053,
254    "FIRST INC." : "08 March 2020",
255    "NUM DAYS" : 1097,
256    "NUM CASES" : 593319,
257    "NUM DEATHS" : 7819,
258    "MAX CASE COUNTY" : "172497",
259    "MAX CASE COUNTY NAME" : "Baltimore County, Maryland"
260
261  },
262  {
263    "RANK": 21,
264    "PREFIX" : "charlotte",
265    "NAME" : "Charlotte Metro Area",
266    "POPULATION" : 2636883,
267    "FIRST INC." : "11 March 2020",
268    "NUM DAYS" : 1094,
269    "NUM CASES" : 894329,
270    "NUM DEATHS" : 6956,
271    "MAX CASE COUNTY" : "368329",
272    "MAX CASE COUNTY NAME" : "Mecklenburg County, North Carolina"
273
274  },
275  {
276    "RANK": 22,
277    "PREFIX" : "orlando",
278    "NAME" : "Orlando Metro Area",
279    "POPULATION" : 2608147,
280    "FIRST INC." : "12 March 2020",
281    "NUM DAYS" : 1093,
282    "NUM CASES" : 857773,
283    "NUM DEATHS" : 7667,
284    "MAX CASE COUNTY" : "473481",
285    "MAX CASE COUNTY NAME" : "Orange County, Florida"
286
287  },
288  {
289    "RANK": 23,
290    "PREFIX" : "sanantonio",
291    "NAME" : "San Antonio Metro Area",
292    "POPULATION" : 2550960,
293    "FIRST INC." : "12 February 2020",
294    "NUM DAYS" : 1122,
295    "NUM CASES" : 842837,
296    "NUM DEATHS" : 8401,
297    "MAX CASE COUNTY" : "698818",
298    "MAX CASE COUNTY NAME" : "Bexar County, Texas"
299
300  },
301  {
302    "RANK": 24,
303    "PREFIX" : "portland",
304    "NAME" : "Portland Metro Area",
305    "POPULATION" : 2492412,
306    "FIRST INC." : "28 February 2020",
307    "NUM DAYS" : 1106,
308    "NUM CASES" : 525128,
309    "NUM DEATHS" : 4542,
310    "MAX CASE COUNTY" : "171526",
311    "MAX CASE COUNTY NAME" : "Multnomah County, Oregon"
312
313  },
314  {
315    "RANK": 25,
316    "PREFIX" : "sacramento",
317    "NAME" : "Sacramento Metro Area",
318    "POPULATION" : 2363730,
319    "FIRST INC." : "21 February 2020",
320    "NUM DAYS" : 1113,
321    "NUM CASES" : 594838,
322    "NUM DEATHS" : 5158,
323    "MAX CASE COUNTY" : "409284",
324    "MAX CASE COUNTY NAME" : "Sacramento County, California"
325
326  },
327  {
328    "RANK": 26,
329    "PREFIX" : "pittsburgh",
330    "NAME" : "Pittsburgh Metro Area",
331    "POPULATION" : 2317600,
332    "FIRST INC." : "13 March 2020",
333    "NUM DAYS" : 1092,
334    "NUM CASES" : 664718,
335    "NUM DEATHS" : 8953,
336    "MAX CASE COUNTY" : "339976",
337    "MAX CASE COUNTY NAME" : "Allegheny County, Pennsylvania"
338
339  },
340  {
341    "RANK": 27,
342    "PREFIX" : "lasvegas",
343    "NAME" : "Las Vegas Metro Area",
344    "POPULATION" : 2266715,
345    "FIRST INC." : "05 March 2020",
346    "NUM DAYS" : 1100,
347    "NUM CASES" : 671243,
348    "NUM DEATHS" : 9313,
349    "MAX CASE COUNTY" : "671243",
350    "MAX CASE COUNTY NAME" : "Clark County, Nevada"
351
352  },
353  {
354    "RANK": 28,
355    "PREFIX" : "austin",
356    "NAME" : "Austin Metro Area",
357    "POPULATION" : 2227083,
358    "FIRST INC." : "13 March 2020",
359    "NUM DAYS" : 1092,
360    "NUM CASES" : 592521,
361    "NUM DEATHS" : 3888,
362    "MAX CASE COUNTY" : "298036",
363    "MAX CASE COUNTY NAME" : "Travis County, Texas"
364
365  },
366  {
367    "RANK": 29,
368    "PREFIX" : "cincinnati",
369    "NAME" : "Cincinnati Metro Area",
370    "POPULATION" : 2221208,
371    "FIRST INC." : "14 March 2020",
372    "NUM DAYS" : 1091,
373    "NUM CASES" : 684609,
374    "NUM DEATHS" : 6551,
375    "MAX CASE COUNTY" : "238207",
376    "MAX CASE COUNTY NAME" : "Hamilton County, Ohio"
377
378  },
379  {
380    "RANK": 30,
381    "PREFIX" : "kansascity",
382    "NAME" : "Kansas City Metro Area",
383    "POPULATION" : 2157990,
384    "FIRST INC." : "07 March 2020",
385    "NUM DAYS" : 1098,
386    "NUM CASES" : 492829,
387    "NUM DEATHS" : 5911,
388    "MAX CASE COUNTY" : "178296",
389    "MAX CASE COUNTY NAME" : "Johnson County, Kansas"
390
391  },
392  {
393    "RANK": 31,
394    "PREFIX" : "columbus",
395    "NAME" : "Columbus Metro Area",
396    "POPULATION" : 2122271,
397    "FIRST INC." : "14 March 2020",
398    "NUM DAYS" : 1091,
399    "NUM CASES" : 604543,
400    "NUM DEATHS" : 5057,
401    "MAX CASE COUNTY" : "366781",
402    "MAX CASE COUNTY NAME" : "Franklin County, Ohio"
403
404  },
405  {
406    "RANK": 32,
407    "PREFIX" : "indianapolis",
408    "NAME" : "Indianapolis Metro Area",
409    "POPULATION" : 2074537,
410    "FIRST INC." : "06 March 2020",
411    "NUM DAYS" : 1099,
412    "NUM CASES" : 597776,
413    "NUM DEATHS" : 7139,
414    "MAX CASE COUNTY" : "268696",
415    "MAX CASE COUNTY NAME" : "Marion County, Indiana"
416
417  },
418  {
419    "RANK": 33,
420    "PREFIX" : "cleveland",
421    "NAME" : "Cleveland Metro Area",
422    "POPULATION" : 2048449,
423    "FIRST INC." : "09 March 2020",
424    "NUM DAYS" : 1096,
425    "NUM CASES" : 574017,
426    "NUM DEATHS" : 6856,
427    "MAX CASE COUNTY" : "350654",
428    "MAX CASE COUNTY NAME" : "Cuyahoga County, Ohio"
429
430  },
431  {
432    "RANK": 34,
433    "PREFIX" : "nashville",
434    "NAME" : "Nashville Metro Area",
435    "POPULATION" : 1934317,
436    "FIRST INC." : "05 March 2020",
437    "NUM DAYS" : 1100,
438    "NUM CASES" : 668218,
439    "NUM DEATHS" : 6136,
440    "MAX CASE COUNTY" : "247844",
441    "MAX CASE COUNTY NAME" : "Davidson County, Tennessee"
442
443  },
444  {
445    "RANK": 35,
446    "PREFIX" : "virginiabeach",
447    "NAME" : "Virginia Beach Metro Area",
448    "POPULATION" : 1768901,
449    "FIRST INC." : "09 March 2020",
450    "NUM DAYS" : 1096,
451    "NUM CASES" : 453537,
452    "NUM DEATHS" : 4510,
453    "MAX CASE COUNTY" : "115797",
454    "MAX CASE COUNTY NAME" : "Virginia Beach city, Virginia"
455
456  },
457  {
458    "RANK": 36,
459    "PREFIX" : "providence",
460    "NAME" : "Providence Metro Area",
461    "POPULATION" : 1624578,
462    "FIRST INC." : "14 March 2020",
463    "NUM DAYS" : 1091,
464    "NUM CASES" : 612896,
465    "NUM DEATHS" : 6457,
466    "MAX CASE COUNTY" : "278748",
467    "MAX CASE COUNTY NAME" : "Providence County, Rhode Island"
468
469  },
470  {
471    "RANK": 37,
472    "PREFIX" : "milwaukee",
473    "NAME" : "Milwaukee Metro Area",
474    "POPULATION" : 1575179,
475    "FIRST INC." : "11 March 2020",
476    "NUM DAYS" : 1094,
477    "NUM CASES" : 556438,
478    "NUM DEATHS" : 4334,
479    "MAX CASE COUNTY" : "341776",
480    "MAX CASE COUNTY NAME" : "Milwaukee County, Wisconsin"
481
482  },
483  {
484    "RANK": 38,
485    "PREFIX" : "jacksonville",
486    "NAME" : "Jacksonville Metro Area",
487    "POPULATION" : 1559514,
488    "FIRST INC." : "10 March 2020",
489    "NUM DAYS" : 1095,
490    "NUM CASES" : 501122,
491    "NUM DEATHS" : 6066,
492    "MAX CASE COUNTY" : "317516",
493    "MAX CASE COUNTY NAME" : "Duval County, Florida"
494
495  },
496  {
497    "RANK": 39,
498    "PREFIX" : "oklahomacity",
499    "NAME" : "Oklahoma City Metro Area",
500    "POPULATION" : 1408950,
501    "FIRST INC." : "13 March 2020",
502    "NUM DAYS" : 1092,
503    "NUM CASES" : 449768,
504    "NUM DEATHS" : 4827,
505    "MAX CASE COUNTY" : "245039",
506    "MAX CASE COUNTY NAME" : "Oklahoma County, Oklahoma"
507
508  },
509  {
510    "RANK": 40,
511    "PREFIX" : "raleigh",
512    "NAME" : "Raleigh Metro Area",
513    "POPULATION" : 1390785,
514    "FIRST INC." : "03 March 2020",
515    "NUM DAYS" : 1102,
516    "NUM CASES" : 493942,
517    "NUM DEATHS" : 1959,
518    "MAX CASE COUNTY" : "391609",
519    "MAX CASE COUNTY NAME" : "Wake County, North Carolina"
520
521  },
522  {
523    "RANK": 41,
524    "PREFIX" : "memphis",
525    "NAME" : "Memphis Metro Area",
526    "POPULATION" : 1346045,
527    "FIRST INC." : "08 March 2020",
528    "NUM DAYS" : 1097,
529    "NUM CASES" : 437122,
530    "NUM DEATHS" : 5382,
531    "MAX CASE COUNTY" : "298816",
532    "MAX CASE COUNTY NAME" : "Shelby County, Tennessee"
533
534  },
535  {
536    "RANK": 42,
537    "PREFIX" : "richmond",
538    "NAME" : "Richmond Metro Area",
539    "POPULATION" : 1291900,
540    "FIRST INC." : "12 March 2020",
541    "NUM DAYS" : 1093,
542    "NUM CASES" : 358387,
543    "NUM DEATHS" : 3843,
544    "MAX CASE COUNTY" : "100129",
545    "MAX CASE COUNTY NAME" : "Chesterfield County, Virginia"
546
547  },
548  {
549    "RANK": 43,
550    "PREFIX" : "neworleans",
551    "NAME" : "New Orleans Metro Area",
552    "POPULATION" : 1270530,
553    "FIRST INC." : "09 March 2020",
554    "NUM DAYS" : 1096,
555    "NUM CASES" : 408479,
556    "NUM DEATHS" : 4208,
557    "MAX CASE COUNTY" : "142493",
558    "MAX CASE COUNTY NAME" : "Jefferson Parish, Louisiana"
559
560  },
561  {
562    "RANK": 44,
563    "PREFIX" : "louisville",
564    "NAME" : "Louisville/Jefferson County Metro Area",
565    "POPULATION" : 1265108,
566    "FIRST INC." : "08 March 2020",
567    "NUM DAYS" : 1097,
568    "NUM CASES" : 453152,
569    "NUM DEATHS" : 4452,
570    "MAX CASE COUNTY" : "283708",
571    "MAX CASE COUNTY NAME" : "Jefferson County, Kentucky"
572
573  },
574  {
575    "RANK": 45,
576    "PREFIX" : "saltlakecity",
577    "NAME" : "Salt Lake City Metro Area",
578    "POPULATION" : 1232696,
579    "FIRST INC." : "25 February 2020",
580    "NUM DAYS" : 1109,
581    "NUM CASES" : 435583,
582    "NUM DEATHS" : 1946,
583    "MAX CASE COUNTY" : "410508",
584    "MAX CASE COUNTY NAME" : "Salt Lake County, Utah"
585
586  },
587  {
588    "RANK": 46,
589    "PREFIX" : "hartford",
590    "NAME" : "Hartford Metro Area",
591    "POPULATION" : 1204877,
592    "FIRST INC." : "14 March 2020",
593    "NUM DAYS" : 1091,
594    "NUM CASES" : 303899,
595    "NUM DEATHS" : 4358,
596    "MAX CASE COUNTY" : "237137",
597    "MAX CASE COUNTY NAME" : "Hartford County, Connecticut"
598
599  },
600  {
601    "RANK": 47,
602    "PREFIX" : "buffalo",
603    "NAME" : "Buffalo Metro Area",
604    "POPULATION" : 1127983,
605    "FIRST INC." : "15 March 2020",
606    "NUM DAYS" : 1090,
607    "NUM CASES" : 331481,
608    "NUM DEATHS" : 3914,
609    "MAX CASE COUNTY" : "271398",
610    "MAX CASE COUNTY NAME" : "Erie County, New York"
611
612  },
613  {
614    "RANK": 48,
615    "PREFIX" : "birmingham",
616    "NAME" : "Birmingham Metro Area",
617    "POPULATION" : 1090435,
618    "FIRST INC." : "13 March 2020",
619    "NUM DAYS" : 1092,
620    "NUM CASES" : 389945,
621    "NUM DEATHS" : 4060,
622    "MAX CASE COUNTY" : "238727",
623    "MAX CASE COUNTY NAME" : "Jefferson County, Alabama"
624
625  },
626  {
627    "RANK": 49,
628    "PREFIX" : "grandrapids",
629    "NAME" : "Grand Rapids Metro Area",
630    "POPULATION" : 1077370,
631    "FIRST INC." : "12 March 2020",
632    "NUM DAYS" : 1093,
633    "NUM CASES" : 332965,
634    "NUM DEATHS" : 3253,
635    "MAX CASE COUNTY" : "201894",
636    "MAX CASE COUNTY NAME" : "Kent County, Michigan"
637
638  },
639  {
640    "RANK": 50,
641    "PREFIX" : "rochester",
642    "NAME" : "Rochester Metro Area",
643    "POPULATION" : 1069644,
644    "FIRST INC." : "11 March 2020",
645    "NUM DAYS" : 1094,
646    "NUM CASES" : 272036,
647    "NUM DEATHS" : 2790,
648    "MAX CASE COUNTY" : "193819",
649    "MAX CASE COUNTY NAME" : "Monroe County, New York"
650
651  }
652
653]

  • Finally, the --info optional flag tells this code to spit out INFO level debugging output.

Warning

This data set can get extremely large even with a few regions. Currently, my (Tanim Islam) data set is over 1.01 GiB in size.

A hopefully illuminating example is shown in covid19_movie_updates_example.bash, where I run a SLURM scheduled job to farm out the creation of COVID-19 summary data among nine processors to 26 different regions,

  • CONUS

  • 13 MSAs: nyc, bayarea, dc, richmond, losangeles, neworleans, chicago, seattle, houston, dallas, albuquerque, newhaven, sacramento.

  • 12 US states or territories: California, Virginia, Texas, Florida, New York, Pennsylvania, Indiana, Michigan, Hawaii, New Mexico, New Jersey, Connecticut.

 1#!/bin/bash
 2#SBATCH --nodes=9
 3#SBATCH --partition=XXXXX
 4#SBATCH --account=YYYYYY
 5#SBATCH --time=23:00:00
 6#SBATCH --job-name="COVID_MOVIE_UPDATES"
 7#SBATCH --output="COVID_MOVIE_UPDATES.out"
 8#SBATCH --error="COVID_MOVIE_UPDATES.err"
 9#SBATCH --comment "just run the problem, see description"
10
11update_date=$(date +"%d-%m-%Y")
12#
13## first update database
14covid19_update_database
15#
16## now generate the COVID-19 cases and deaths, movies and figures, for regions (MSAs, CONUS, states)
17srun -N9 covid19_movie_updates --region nyc bayarea dc richmond losangeles neworleans chicago seattle houston dallas albuquerque newhaven conus --state California Virginia Texas Florida "New York" Pennsylvania Indiana Michigan Hawaii "New Mexico" "New Jersey" Connecticut --topN=50 --dirname=docs --info