ReMobidyc

web based multi-agent simulator for individual-based modeling in population dynamics and ecotoxicology

https://github.com/ReMobidyc/ReMobidyc

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.3%) to scientific vocabulary

Keywords

ecotoxicology indivisual-based-modeling multi-agent-simulation multi-agent-systems pharo population-dynamics simulator
Last synced: 6 months ago · JSON representation

Repository

web based multi-agent simulator for individual-based modeling in population dynamics and ecotoxicology

Basic Info
  • Host: GitHub
  • Owner: ReMobidyc
  • License: mit
  • Language: Smalltalk
  • Default Branch: main
  • Homepage:
  • Size: 19.7 MB
Statistics
  • Stars: 13
  • Watchers: 2
  • Forks: 3
  • Open Issues: 10
  • Releases: 13
Topics
ecotoxicology indivisual-based-modeling multi-agent-simulation multi-agent-systems pharo population-dynamics simulator
Created over 4 years ago · Last pushed 11 months ago
Metadata Files
Readme License

README.md

Pharo version CI License

logo

reːmobidyc

reːmobidyc (also denoted as re:mobidyc or ReMobidyc without the exotic punctuation letter) is a multi-agent simulator for individual-based modeling in population dynamics and ecotoxicology.

Presentations

  • for biologists:

ReMobidyc: develop and run Individual-Based Models, even with little coding skills

  • for computer scientists:

https://www.slideshare.net/esug/remobidyc-the-overview

Installation

reːmobidyc is implemented on the Pharo system. There are three ways to install reːmobidyc.

1. from binary package

The pre-built packages are available at the official distribution site.

The latest release:
Keelung
 

2. from Pharo

If you have the Pharo installation, you can install reːmobidyc by evaluating the following expression. (Open a Playground by the Browse>>Playground menu in the menubar, then copy&paste the text below into the Playground. Select all the pasted text and select the "Do-it" in the right-click menu. After the system loads the latest reːmobidyc code, save the image by the Pharo>>Save menu in the menubar.)

EpMonitor disableDuring: [ Metacello new onConflictUseLoaded; onWarningLog; repository: 'github://ReMobidyc/ReMobidyc:main/'; baseline: 'ReMobidyc'; load ]

3. from command shell

The following one-liner will download Pharo and install reːmobidyc.

curl https://raw.githubusercontent.com/ReMobidyc/ReMobidyc/main/scripts/install-remobidyc.sh | bash

Modeling Language

Documentation is still under construction. Please see the following "cheatsheets".

Examples

1. Simplified SugarScape

animation of sugascape example

Each cell grows grass (indicated by green rect) and each goat (yellow dot) eats grass. This example exhibits the interaction between an animat and the cell where the animat is located.

2. Goat and Wolf

animation of goat and wolf example

Each cell grows grass (indicated by green rect), each goat (yellow dot) eats grass and each wolf (red dot) preys on its nearest goat. This example exhibits the interaction between two animats.

3. Grasshopper

animation of grasshoppers example

Each cell grows grass(indicated by green rect), a grasshopper (yellow dot) eats grass. When a grasshopper is matured by age, it lays 5 eggs (cyan dots), and each egg hatches in 20 days. This example exhibits life stages of individuals.

A tutorial to build this Grasshopper model is available.

Background

reːMobidyc is a variation of Mobidyc that inherits the design rationale of Mobidyc. The objective of reːMobidyc is to renovate the original Mobidyc keeping its design principles. The base system is changed from VisualWorks to Pharo. They are both Smalltalk systems, and Pharo is today's most actively developed/used open-source Smalltalk system. We will renovate the implementation of Mobidyc from its very basis to apply outcomes from computer science. The development of reːMobidyc is just beginning, and we will need time to re-produce the functionality of the original Mobidyc.

[1] The original Mobidyc site

Design Rationale

As a tool for scientific research, reːMobidyc will provide the following features

  • Easy to model

    • A behavior of an agent will be defined in a declarative manner instead of series of commands, if-statements and loops.
  • Easy to modify

    • Every component in a behavioral definition will be type-checked so that the user can find minor errors before running it.
  • Easy to verify model

    • A definition can have assertions that double-checks its behavior so that the user can be sure that the model is defined as intended.
  • Easy to reproduce

    • reːMobidyc will make all simulation reproduceable including randomized actions.
  • Easy to verify output

    • States of agents at every step in simulation will be stored in persistent memory so that the user and reviewers can check its validity.
  • Easy to trace

    • The user can trace which agent had interaction with a particular agent to find the cause of an observed phenomenon.
  • Easy to publish

    • The user can publish her/his model along with input/intermediate/output data and visualized images as an evidence in scientific research.
  • Easy to implement

    • reːMobidyc will define its own modeling language in formal specification language so that its execution engine can be implemneted by third persons with complete compatibility.

Architectural design

To achieve the objectives above, reːMobidyc will have the following major components.

  • Persistent storage

    • reːMobidyc will use persistent storages, such as file systems and RDBs, to store models, states of agents at all simulation steps, input data and output data.
  • Reproducible random numbers

    • reːMobidyc will have its own random number generator and make its code open so that all actions taken in a simulation can be accurately reproduceable.
  • Web servers and APIs

    • reːMobidyc will have web-based UI so that models can be shared by research communities.
    • reːMobidyc will provide web API to retrieve models and simulation data so that anyone can create specialized native applications.

Organizational Contributors

The reːmobidyc project is supported by DGtal Aqua Lab, Shizuoka University and Software Research Associates, Inc.

DGtal Aqua Lab  SRA logo

Owner

  • Name: re:Mobidyc
  • Login: ReMobidyc
  • Kind: organization

GitHub Events

Total
  • Release event: 1
  • Push event: 6
  • Pull request event: 4
  • Fork event: 1
  • Create event: 2
Last Year
  • Release event: 1
  • Push event: 6
  • Pull request event: 4
  • Fork event: 1
  • Create event: 2

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 837
  • Total Committers: 3
  • Avg Commits per committer: 279.0
  • Development Distribution Score (DDS): 0.004
Past Year
  • Commits: 103
  • Committers: 1
  • Avg Commits per committer: 103.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Tomohiro Oda t****a@g****m 834
DGtalAquaLab-Gael 6****l 2
Serge Stinckwich S****h@g****m 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 41
  • Total pull requests: 98
  • Average time to close issues: about 2 months
  • Average time to close pull requests: 19 minutes
  • Total issue authors: 2
  • Total pull request authors: 1
  • Average comments per issue: 0.88
  • Average comments per pull request: 0.0
  • Merged pull requests: 98
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 7
  • Average time to close issues: N/A
  • Average time to close pull requests: 4 minutes
  • Issue authors: 1
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 7
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • tomooda (36)
  • Mr-Dispatch (1)
Pull Request Authors
  • tomooda (113)
Top Labels
Issue Labels
enhancement (20) UI (17) bug (9) processor (9) language (7) documentation (1) help wanted (1)
Pull Request Labels

Dependencies

.github/workflows/test.yml actions
  • actions/checkout v2 composite
  • hpi-swa/setup-smalltalkCI v1 composite