https://github.com/beyondscheme/elixir-game_of_life

Game of Life in Elixir. Distributed Game of Life with Board Server API. Run it on multiple nodes.
https://github.com/beyondscheme/elixir-game_of_life

elixir game-of-life

Last synced: 6 months ago
JSON representation

Game of Life in Elixir. Distributed Game of Life with Board Server API. Run it on multiple nodes.

• Host: GitHub
• URL: https://github.com/beyondscheme/elixir-game_of_life
• Owner: BeyondScheme
• License: other
• Created: 2016-04-09T19:11:45.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2016-06-23T22:28:10.000Z (over 9 years ago)
• Last Synced: 2025-04-12T12:55:39.239Z (6 months ago)
• Topics: elixir, game-of-life
• Language: Elixir
• Homepage: http://beyondscheme.com/2016/distributed-game-of-life-in-elixir
• Size: 262 KB
• Stars: 56
• Watchers: 5
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# Game Of Life in Elixir

[![Circle CI](https://circleci.com/gh/BeyondScheme/elixir-game_of_life.svg?style=svg)](https://circleci.com/gh/BeyondScheme/elixir-game_of_life)

![Game of Life](images/game_of_life_logo_small.png)

You can run game on master node and connect other nodes into cluster.

Game will distribute tasks across all connected nodes.

## About the project

Please see the article about the [Distributed Game of Life in Elixir](http://beyondscheme.com/2016/distributed-game-of-life-in-elixir).

## Demo

[![asciicast](https://asciinema.org/a/44233.png)](http://beyondscheme.com/2016/distributed-game-of-life-in-elixir#demo)

## Rules

[Conway's Game of Life](https://en.wikipedia.org/wiki/Conway%27s_Game_of_Life)

The universe of the Game of Life is an infinite two-dimensional orthogonal grid of square cells, each of which is in one of two possible states, alive or dead. Every cell interacts with its eight neighbours, which are the cells that are horizontally, vertically, or diagonally adjacent. At each step in time, the following transitions occur:

* Any live cell with fewer than two live neighbours dies, as if caused by under-population.

* Any live cell with two or three live neighbours lives on to the next generation.

* Any live cell with more than three live neighbours dies, as if by over-population.

* Any dead cell with exactly three live neighbours becomes a live cell, as if by reproduction.

The initial pattern constitutes the seed of the system. The first generation is created by applying the above rules simultaneously to every cell in the seed—births and deaths occur simultaneously, and the discrete moment at which this happens is sometimes called a tick (in other words, each generation is a pure function of the preceding one). The rules continue to be applied repeatedly to create further generations.

## How to run

Run first node and print board in loop there.

    $ iex --sname node1 -S mix

    GameOfLife.BoardServer.start_game

    GameOfLife.GamePrinter.start_printing_board

Run second node and add from there a new cells to existing board on the first node.

    $ iex --sname node2 -S mix

    Node.connect :node1@Artur

    Node.list

    Node.self

    GameOfLife.Patterns.Guns.gosper_glider |> GameOfLife.BoardServer.add_cells

Add cells to board.

    cells = [{0, 0}, {1, 0}, {2, 0}, {1, 1}]

    GameOfLife.BoardServer.add_cells(cells)

Add pattern to the board.

    GameOfLife.Patterns.StillLifes.block |> GameOfLife.BoardServer.add_cells

    GameOfLife.Patterns.Guns.gosper_glider |> GameOfLife.BoardServer.add_cells

Add pattern to the board at specific position.

Move left bottom corner of the pattern to specified X and Y position.

    GameOfLife.Patterns.StillLifes.block |> GameOfLife.PatternConverter.transit(-2, -3) |> GameOfLife.BoardServer.add_cells

Example of RPC.

    cells = [{0, 0}, {1, 0}, {2, 0}, {1, 1}]

    :rpc.call(:n1@Artur, GameOfLife.BoardServer, :add_cells, [cells])

## How patterns are defined?

For example `GameOfLife.Patterns.StillLifes.block` is defined in a way the last row

contains cells for the bottom row of the pattern. Left bottom corner of the pattern is at `{0, 0}` position. The pattern is always at positive X and Y axis.

## Installation

https://hex.pm/packages/game_of_life

If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:

  1. Add game_of_life to your list of dependencies in `mix.exs`:

        def deps do

          [{:game_of_life, "~> 1.0.0"}]

        end

  2. Ensure game_of_life is started before your application:

        def application do

          [applications: [:game_of_life]]

        end

## Documentation

Documentation online: https://hexdocs.pm/game_of_life

How to generate documentation on your machine:

    $ mix hex.docs

    $ open doc/index.html

# About Beyond Scheme

Game Of Life in Elixir is maintained by [BeyondScheme.com](http://beyondscheme.com/?utm_source=github)

Yet another software engineers, are we?

We build web applications on a daily basis.

See [what we do or hire us](http://beyondscheme.com/?utm_source=github) to help you with your product.