blossom

KO | EN

gitlite — search

#python #typescript #android #machine-learning #deep-learning #nodejs #cli #kubernetes #awesome-list #vue #pytorch #mcp #ios #openai

(★ 9)

A Python package for simulating the evolution of organisms.

blossom Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# blossom [![PyPI version](https://badge.fury.io/py/blossom.svg)](https://badge.fury.io/py/blossom) [![Documentation Status](https://readthedocs.org/projects/blossom/badge/?version=latest)](https://blossom.readthedocs.io/en/latest/?badge=latest)

Blossom is a Python package for simulating the dynamics of organism populations. Blossom supports both one and two dimensional worlds.

## Installation

You can use pip to install the latest version of the package automatically:

```
pip install blossom
```

Alternately, execute:

```
git clone git@github.com:blossom-evolution/blossom.git
python setup.py install
```

## Basic Usage

To start a simulation project, create a new directory to house all custom 
scripts, including a configuration file `config.yml`. In this config file, you
specify species parameters, including starting population, max age, and action
methods. Some action methods are built-in (for movement, eating, drinking, and
reproduction), but you may use custom methods defined in external Python 
scripts, which are imported at runtime by Blossom via `linked_modules`.

World parameters are also specified in the config file, including dimensions 
and the distribution of water and food. You may also set limits on the number
of timesteps and organisms, in order to control the simulation in case of
runaway populations.

With your project directory set up, you may run the simulation using the 
included command-line interface (CLI):

```
blossom run
```

Note that for reproducibility, you can set the random seed either in the config
file or at the CLI. For additional options, run `blossom run -h`.

## Dashboard

Blossom provides a dashboard that runs in your local browser, tracking the 
progress of your population runs.

Initiate the dashboard, run

```
blossom dashboard TRACK_DIR [-p PORT]
```
where `TRACK_DIR` is the simulation project directory. You can then view the 
dashboard at `localhost:PORT`.

![dashboard screenshot](https://raw.githubusercontent.com/blossom-evolution/blossom/main/media/blossom-dashboard.png)

## GIF of Simple 100 x 100 Simulation

![example simulation](https://raw.githubusercontent.com/blossom-evolution/blossom/main/media/combined.gif)

blossom

blossom Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

blossom

blossom Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README