Epidemic modeling is to build models to represent, characterize, and simulate the spread of an infectious disease in some given population, and ultimately aims to understand and even predict such spread for the purpose of control and intervention of the disease (Andersson and Britton 2000) . Conventional epidemic modeling is a top-down process, i.e., it assumes that the spread of disease can be represented by a generalized mathematical model; specifics of the process can be derived from this model; states of individuals can be inferred based on the state of the population; and situation of local areas is the same as that of the entire area. Conventional epidemic models typically work with aggregate data and focus on the temporal dimension, without considering spatial variation within the study area (Li et al. 2019 ; Li et al. 2020 ).
Individualization and spatialization are considered to be major trends in epidemic modeling, and the two are closely coupled and can naturally converge into one integrated modeling approach (Li et al. 2020). This, on the one hand, is driven by the growing recognition, in the field of epidemiology, of the importance of individual characteristics and spatial variation in epidemic modeling. On the other hand, it is supported and facilitated by the increasing availability of data of patients and the population, the increasing capacity of computing, as well as the rapid development of computational scientific approaches based on that data and capacity (Shi and Wang 2015 ).
Within this context, we have developed a bottom-up epidemic modeling approach, the Epidemic Forest (Li et al. 2019 ). We adapt it to the COVID-19 disease and applied it to real-world combats against the pandemic. The model intends to model the individual-level transmission by taking into account all available information about the patients, the population at risk, and the environment, including but not limited to: epidemiological characteristics, demographics, residence, work, mobility, transportation, social network, vector habitats (in the case of vector-borne diseases), and even genetics. The model represents a disease spread process starting from a primary case using a tree structure. If an epidemic/pandemic has multiple/many primary cases, their epidemic trees form an epidemic forest (herein referred to as epi-forest). The modeling process is to construct this forest based on the modeled individual-level transmission relationship. With the constructed epi-forest, detailed spatiotemporal and epidemiological characteristics of the epidemic/pandemic that may not be available from a top-down model can be quickly and empirically derived, which may provide specific evidence and guidance to planning and decision making of control and intervention, and also inform the prediction and scenario simulation of the epidemic/pandemic.
However, the bottom-up approach to epidemic modeling requires handling large volume of data and performing intensive computation, which may be cumbersome to many researchers and practitioners who do not have easy access to a high-performance computing platform. This difficulty has hindered the adoptability and reproducibility of the approach, which is what we are trying to address with the CyberGIS in this NSF program. With the support of this NSF program, we created a Jupyter Notebook (http://jupyter.org) on the CyberGISX platform (https://cybergisxhub.cgwebdev.cigi.illinois.edu/) that provides documents and access to the five modules of the epi-forest modeling process in a sequence, including Disaggregating Trajectory Data, Evaluating Trajectory Overlap, Building Epidemic Forest, Extracting Epidemic Features, and Simulating Scenarios. The current five modules are designed to model a human-human communicable disease like COVID-19. They can also be adapted to suit a vector-borne disease like Dengue Fever or Lyme Disease. The users can choose to run certain modules based on the data they possess and/or the purpose of their project. With the simple register and login process of this platform, a user can easily access this Notebook, try it with the provided test data, and run it with their own data.
A Screenshots of Jupyter Notebook of the epi-forest modeling process on CyberGISX.
Hakan Andersson and Tom Britton, 2000, Stochastic Epidemic Models and Their Statistical Analysis. Springer.
Li, M., Shi, X., Li, X., Ma, W., He, J., and Liu, T., 2019, Epidemic Forest: A Spatiotemporal Model of Communicable Diseases. Annals of the American Association of Geographers. 109(3): 812-836. DOI: 10.1080/24694452.2018.1511413.
Li, M., Shi, X., and Li, X., 2020, Integration of Spatialization and Individualization: The Future of Epidemic Modelling for Communicable Diseases, Annals of GIS, 26(3): 219-226. DOI: 10.1080/19475683.2020.1768438.
Shi, X. and Wang, S., 2015, Computational and Data Sciences for Health-GIS, Annals of GIS, 21(2): 111–118. DOI: 10.1080/19475683.2015.1027735.
The purpose of this website, https://cybergisxhub.cigi.illinois.edu/
is to provide information to You related to “CyberGISX Project” (“Project”). This Project aims to enable open access and sharing of computation- and data-intensive geospatial analytics, under Apache 2.0 license agreement.
The initial version of the Project (“Original Project”), was developed by the CyberGIS Center for Advanced Digital and Spatial Studies (CyberGIS Center) and is solely owned by The Board of Trustees of the Illinois of Illinois.
The Site and its content is made available by the Board of Trustees of the Illinois of Illinois (“Illinois”, “we”, “our”, “us”), on behalf of the CyberGIS Center. The Site is owned by the Illinois.
or otherwise accessing the Site. Please read these Terms carefully. The Terms govern Your use of the Site and any incorporated content (such as Illinois or third party software, text, data, information, or graphics) made available through the Site.
By continuing to use this site, You accept these Terms. If You are not willing to be bound by these Terms, please stop using this Site.
1. Governing Terms:
The Terms are governed by Illinois’s web privacy notices and policy links presented here:
You hereby accept that all intellectual property, including copyrights, and other proprietary rights in or related to Original Project and Site are, and will remain, the exclusive property of Illinois, whether or not specifically recognized or perfected under applicable law. As End User, You will not take any action that jeopardizes Illinois’s proprietary rights.
3. Credit and Attribution.
You agree to credit and attribute the authors and creators of Project that You use with the copyright notice or statement of credit/attribution as customarily acceptable in industry.
In no event shall Illinois or its employees be liable for any damages (including, without limitation, damages for loss of data or profit, or due to business interruption) arising out of the use or inability to use the content on Site, even if Illinois or a Illinois authorized representative has been notified orally or in writing of the possibility of such damage. Because some jurisdictions do not allow limitations on implied warranties, or limitations of liability for consequential or incidental damages, these limitations may not apply to you.
5. Modification of Site and Terms.
Illinois reserves the right to modify the Site and may discontinue, temporarily or permanently, the Site for any reason, at its sole discretion, with or without notice to You. Illinois may likewise change the Terms from time to time with or without notice to you. You agree to review the Terms periodically to ensure that you are aware of any modifications. Your continued access to the Site after the modifications have become effective shall be deemed your conclusive acceptance of the modified Terms.
If you violate or fail to comply with any of these Terms or in Illinois’ sole discretion restrict or inhibit any other user from using or enjoying the Site, Illinois may terminate your access to the Site account without notice to You.
CyberGISX Project Contributor License Agreement
Version 1.0 February 9, 2021
Thank you for your interest in contributing to the CyberGISX Project. In order to contribute, you will need to provide your name and contact information and sign this CyberGISX Project Contributor License Agreement, which sets the terms and conditions of the intellectual property license granted with your contributions.
This CyberGISX Project Contributor License Agreement (“Agreement”) is by and between you, any person or entity (“You” or “Your”) and the Board of Trustees of the University of Illinois, a body corporate and politic of the State of Illinois (“Illinois”). Please read this document carefully before signing and keep a copy for your records. By signing this Agreement or making a “Contribution” to the “CyberGISX Project” as defined below (even if You do not sign), You agree to the following:
1. “CyberGISX Project” is an open-source software project that aims to enable open access and sharing of computation- and data-intensive geospatial analytics with computational reproducibility and transparency support available under Apache 2.0 license agreement: https://www.apache.org/licenses/LICENSE-2.0
2. “Contribution” means all of Your contributions of object code, source code, content, and documentation, and any modifications thereof, to the CyberGISX Project.
3. “Licensed Patents” mean patent claims licensable by You which are necessarily infringed by the making, using, selling, offering for sale, having made, import, or transfer of either Your Contribution alone or when combined with the CyberGISX Project.
4. “Representation.” You represent the following to the best of your knowledge:
a. You are at least 18 years of age and have full power and authority to enter into this Agreement and to grant the rights in and to the Contribution as set forth herein (individuals who are under 18 years of age and who wish to contribute to the CyberGISX project may not enter into this Agreement, but may contact CyberGISX at email@example.com to explore alternatives);
b. If your employer has rights to intellectual property that You create as part of the Contribution, You represent that You have obtained permission from Your employer to make the Contribution on behalf of that employer, or Your employer waived any rights in and to Your Contribution, or Your employer authorizes the Contribution and agrees to be bound by the terms herein by signing as an entity below;
c. That either:
1. all documentation and code in the Contribution is Your original work and includes complete details of any third-party license and any other restriction (including, but not limited to related patents and trademarks) of which You are personally aware and which are associated with any part of Your Contributions; or
2. any part of the Contribution that is not Your original creation is submitted to CyberGISX separately from any original Contribution, includes the complete details of its source and any corresponding license and any other restriction (including, but not limited to related patents, trademarks, and license agreements) of which You are personally aware, and is conspicuously marked as "Submitted on behalf of a third party: [named here]".
d. That Your Contribution does not include any viruses, worms, Trojan horses, malicious code or other harmful or destructive content;
e. The CyberGISX Project delivered under this Agreement may be subject to U.S. export control laws and may be subject to export or import regulations in other countries. You agree to comply strictly with all such laws and regulations and acknowledge that You have the responsibility, at Your own expense, to obtain such licenses to export, re-export, or import as may be required; and
f. Your Contribution does not include any encryption technology and no government license or permission is required for the export, import, transfer or use of the Contribution.
5. Notification. Your representations are accurate, and You agree to notify Illinois of any facts or circumstances of which You become aware that would make any of Your representations inaccurate in any respect.
6. License grant to Contributions. You grant to Illinois and to recipients of the CyberGISX software (collectively, “Recipients”), a perpetual, irrevocable, non-exclusive, worldwide, royalty-free unrestricted license to use, reproduce, prepare derivative works of, publicly display, publicly perform, distribute, and sublicense the Contribution, and such derivative works, in source code and object code forms.
7. License grant to Patents.
8. No support. Except for the rights granted to Recipients above, You reserve all right, title, and interest in and to Your Contribution. You are not expected to provide support for your Contributions.
9. No Warranties. Subject to Your representations above, Your Contributions are provided on an “AS-IS” basis WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND (express or implied), including, without limitation, any implied warranty of merchantability and fitness for a particular purpose, and any warranty of non-infringement.
10. No Liability. Illinois, its trustees, directors, officers, employees, students, and agents have no liability for any infringement of any copyright, patent, or other right of third parties in connection with any Contributions, the CyberGISX Project, or CyberGISX software, and are not liable for any direct, indirect, punitive, special, incidental, consequential, or exemplary damages arising in connection with any Contribution, the CyberGISX Project, or CyberGISX software.
11. Indemnity. You agree to indemnify, defend, and hold Illinois and its subsidiaries, affiliates, officers, agents, employees, partners, licensees, and licensors harmless from any claim or demand, including but not limited to reasonable attorneys’ fees, made by any third party due to or arising out of Contributions You submit, post, transmit or otherwise make available through the CyberGISX Project, as well as Your use of the CyberGISX software; connection to the CyberGISX Project; or violation of any rights of another.
12. You agree that Illinois may assign this Agreement and CyberGISX Project to any third party without notice or consent.
13. Illinois is under no obligation to accept or include Your Contribution to the CyberGISX Project.
14. This Agreement is governed by the laws of the State of Illinois, excluding its conflict of laws provisions.