This is an Agent Based Model simulator of the Zombie Disease.
Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
spec
.gitignore
Gemfile
Gemfile.lock
LICENSE.txt
README.md
Rakefile
zombies.gemspec

README.md

Zombie Epidemic

This is an Agent Based Model simulator of the Zombie Disease.

Examples

Below two results obtained with the simulator. Legend:

  • green: healthy human
  • yellow: infected human
  • red: zombie
  • black: killed human or zombie

Human wins! Zombie wins!

I've presented the simulator first at Paris.rb Jan 2015.

Installation

Install it yourself as:

$ gem install zombie_epidemic

Usage

Run the simulation

With the default parameters, you just type:

zombie_epidemic

It will store the results as PNG files into the current directory.

Build the movie from the PNG sequences

zombie_epidemic movie

The Model

Space

The space is a discrete 2D bounded map. Each point (x, y) is a square that could be occupied by an agent or an obstacle.

Time

The time is discrete. Each time step represents enough time for a normal action, such as a step. It is about 0.5 second.

An Agent

An agent is a person charactherized by the following:

  • a position, and
  • a health state.

Every time step, an agent can:

  • walk,
  • attack, or
  • stay.

Without any cost, an agent perceive:

  • his surrounding (obstacles, position of agents), and
  • neighbors' status (zombie or not)

The quality of the perceptions and actions are altered by the health state: a zombie doesn't perceive well, neither it walks well.

The health state

The disease model SIZX is implemented as the following state transition machine:

S -------> I -------> Z -------> X
|          |                     ^
|          |---------------------|
|--------------------------------|

TODO

  • other characteristics (e.g. energy level)
  • other actions
  • other perceptions
  • load custom map
  • custom strategy

Contributing

  1. Fork it ( https://github.com/toch/zombie_epidemic/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request