Skip to main content

TITAN Agent Based Model

Project description

TITAN Simulation

DOI GitHub release (latest by date) codecov GitHub Stable

TITAN (Treatment of Infectious Transmissions through Agent-based Network) is an agent-based simulation model used to explore contact transmission in complex social networks. Starting with the initializing agent population, TITAN iterates over a series of stochastic interactions where agents can interact with one another, transmit infections through various medium, and enter and exit the care continuum. The purpose of TITAN is to evaluate the impact of prevention and treatment models on incidence and prevalence rates of the targeted disease(s) through the use of data fitting simulated trajectories and rich statistics of primary/sub-population attributable proportions.

Agent populations are defined as graphs (nodes connected by edges). Nodes in the graph are used to represent the attributes (or collection of attributes) of an agent (person), and edges define the type of relationship between agents. In practice, a graph represents a social network of connected people through various relationship types, and provides the medium for which agents can interact.

Getting Started

Install the package

pip install titan-model

This includes the script run_titan which can then be used to run the model.


  • Python (or pypy) 3.6 or later

Running the Model

run_titan -p my_params.yml

To run the model, execute the run_titan program. See TITAN params for documentation on how to set and use parameters.

Results of the model are generated and aggregated into the /results/ directory by default. If the model is re-run, the existing results will be overwritten.

Built With

  • Python3.x - Programming language

    Van Rossum G, Drake FL. Python 3 Reference Manual. Scotts Valley, CA: CreateSpace; 2009.

  • Networkx - Network structure backend

    Hagberg A, Swart P, S Chult D. Exploring network structure, dynamics, and function using NetworkX. 2008.

  • Numpy - Numerical libraries

    Oliphant TE. A guide to NumPy. Vol. 1. Trelgol Publishing USA; 2006.


  • Lars Seeman - Initial work
  • Max King - Continued development
  • Sam Bessey - Continued development
  • Mary McGrath - Continued development


This project is licensed under the GNU General Public License version 3 - see the file for details

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

titan-model-3.0.0.tar.gz (81.3 kB view hashes)

Uploaded source

Built Distribution

titan_model-3.0.0-py3-none-any.whl (110.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page