Skip to content

README.md

Latest commit

 

History

History
81 lines (50 loc) · 2.74 KB

README.md

File metadata and controls

81 lines (50 loc) · 2.74 KB
Raw

Virus Spread Simulator

Overview

Virus Spread Simulator is a Java-based application designed to simulate the spread of a virus in a population. This application provides a visual representation of how individuals in a population move and interact, and how these interactions can lead to the spread of a virus. It includes features such as different health states for individuals (healthy, no symptoms, symptoms, immune) and dynamic movement of individuals within a simulated environment.

Features

  • Simulation of Virus Spread: Visualize how a virus can spread through a population over time.
  • Health States: Individuals can be in different health states: healthy, showing no symptoms, showing symptoms, or immune.
  • Dynamic Movement: Individuals move within the simulation area, with their movement patterns affecting the spread of the virus.
  • Boundary Collision: Individuals change direction upon hitting the boundaries of the simulation area.
  • State Persistence: Ability to save and load the state of the simulation for future analysis.
  • Customizable Parameters: Adjust parameters like the number of individuals, infection radius, and initial immunity.

Installation

  1. Clone the Repository:

    git clone https://github.com/username/virus-spread-simulator.git
cd virus-spread-simulator

  2. Build the Application:

    Requires Java JDK 11 or higher and Maven. Run the following command to build the application:

    mvn clean install

  3. Run the Application:

    After building, run the application using:

    java -jar target/virus-spread-simulator-1.0.jar

Usage

  1. Start the Simulation: Use the 'Start' button in the application to start the simulation.

  2. Adjust Parameters: Adjust parameters like the number of individuals and initial immunity using the provided sliders and input fields.

  3. Save/Load Simulation State: Save the current state of the simulation and load it later for further analysis.

  4. View Simulation: Observe how the virus spreads among the population within the simulation area.

Contributing

Contributions to the Virus Spread Simulator are welcome. Please follow these steps to contribute:

  1. Fork the repository.
  2. Create a new branch for your feature (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Your Name – biegan664maciek@gmail.com

Project Link:

https://github.com/username/virus-spread-simulator