Skip to main content

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.

Prerequisites

  • 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.

Authors

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

License

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

Metadata

Release files for titan-model 3.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for titan-model 3.3.2
File Size Uploaded Provenance Actions
titan_model-3.3.2.tar.gz 112.5 kB Without provenance Details for titan_model-3.3.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for titan-model 3.3.2
File Interpreter ABI Platform Actions
titan_model-3.3.2-py3-none-any.whl Python 3 none any Details for titan_model-3.3.2-py3-none-any.whl

Total release size: 265.5 kB

Release files / titan_model-3.3.2.tar.gz

Download URL titan_model-3.3.2.tar.gz
Size 112.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b12e79212cec65186c1dbfdf5f857d9b92c286e95802d2b4c619fbb664da0ba4
BLAKE2b-256 checksum
How to use checksums
559c26d8915da5f7001b0c3ed007ff3a649cea05ae22520e970611cd37d5b798
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.8.18 Linux/6.5.0-1022-azure

Release files / titan_model-3.3.2-py3-none-any.whl

Download URL titan_model-3.3.2-py3-none-any.whl
Size 153.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c1bcfdda3e5b3ad1dae6720fd7384f7c41cd4bb5efb3204aaf063634c7d53c85
BLAKE2b-256 checksum
How to use checksums
a116c27b5477b4af28471c29b681bb5c38803386ee314b0f5cc789208b8f6d26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.8.18 Linux/6.5.0-1022-azure

Security for titan-model 3.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page