TCU Senior Design 2025-2026

Viral Agent-Based Model Interface

A graphical interface for running CUDA-powered viral infection simulations, built so researchers and students can use it without writing code.

About the Project

The Problem

Graduate students at TCU use a CUDA C agent-based model to study virus-mediated cell interactions. Previously, running the model meant editing parameter files by hand and launching simulations from the terminal, making it difficult for undergraduates and non-experts to use.

Our Solution

We built a PySide6 desktop GUI that provides intuitive controls for configuring simulation parameters, launching GPU-accelerated simulations, and visualizing the results. No command-line or code editing required.

The Impact

The interface makes the model available for undergraduate research and classroom instruction. It also provides a well-documented, maintainable codebase that future students can extend with new biological processes.

Key Features

01

Parameter Configuration

Adjust cell counts, infection rates, transmission probabilities, and timing through structured input fields with real-time validation.

02

Dual Model Support

Choose between the Original viral transmission model (cell-to-cell and cell-free infection) or the Gerg syncytia formation model, with the UI adapting to show the relevant parameters.

03

Simulation Execution

Launch, monitor, and stop GPU-accelerated CUDA simulations from the interface. Progress feedback and automatic result loading are built in.

04

Data Visualization

Plot uninfected, eclipse, infectious, and dead cell populations alongside virus concentration over time using interactive time-series graphs.

05

Export & Save

Save configurations as JSON, export results to CSV, and generate plot images. Spatial data output is also supported for further analysis.

06

Input Validation

Built-in validation catches out-of-range values and invalid configurations before a simulation can be launched, with clear error messages.

The Team

Ellion Norwood

Team Lead / Backend Engineer
Gabby Campos

Gabby Campos

Frontend Engineer
Stefan Saba

Stefan Saba

Backend Engineer
Hebert Alvarez

Hebert Alvarez

Backend Engineer
Bereket Mezgebu

Bereket Mezgebu

Frontend Engineer
Derek Le

Derek Le

Backend Engineer
Aqil Dhanani

Aqil Dhanani

Backend Engineer

Documentation

Key project documents. Click any card to download.