Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/avivace/physarum
Physarum polycephalum slime mould computing simulation, implemented on a custom VueJS + Unity3D stack
https://github.com/avivace/physarum
adamatzky agent-based-modeling agent-based-simulation complex-systems implementation integration physarum simulation simulation-framework slime slime-mold smart-slime unity unity2d vue vuejs
Last synced: 27 days ago
JSON representation
Physarum polycephalum slime mould computing simulation, implemented on a custom VueJS + Unity3D stack
- Host: GitHub
- URL: https://github.com/avivace/physarum
- Owner: avivace
- License: gpl-3.0
- Created: 2019-07-02T21:49:39.000Z (over 5 years ago)
- Default Branch: develop
- Last Pushed: 2020-09-26T13:36:55.000Z (about 4 years ago)
- Last Synced: 2024-05-02T02:40:29.766Z (7 months ago)
- Topics: adamatzky, agent-based-modeling, agent-based-simulation, complex-systems, implementation, integration, physarum, simulation, simulation-framework, slime, slime-mold, smart-slime, unity, unity2d, vue, vuejs
- Language: C#
- Homepage: https://avivace.github.io/Physarum
- Size: 69.4 MB
- Stars: 21
- Watchers: 3
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Physarum
Final project for my Complex Systems course, from my [MSc in Computer Science](https://github.com/avivace): *Physarum polycephalum slime mould computing simulations.*
By [Matteo Coppola](https://github.com/matteocoppola), [Luca Palazzi](https://github.com/lucapalazzi), [Antonio Vivace](https://github.com/avivace).
### [Live demo](https://avivace.github.io/Physarum)
### [Documentation](docs/report.pdf)
### [Slides](Slides.pdf)
## Develop
Clone the project locally: `git clone [email protected]:avivace/Physarum.git`
### Unity
Be sure you are on Unity 2018.3.14f1 (64-bit).
> Use windows to produce the webgl build, since on linux it doesn't work, reporting `il2cpp/build/il2cpp.exe did not run properly!`.
**Unity** -> **Open Project** -> Select the **"UnityProject"** folder inside the cloned repository. Once the project import finished, drag and drop the "SampleScene" from the assets folder (Project Pane) into the Hyerarchy pane.
Each attached component and selected asset for a component loses its link due to cache being invalidated when exporting/importing so you have to manually select:
- SimulationManager script, attached to GameObject
+ ImageAsset, pointing to the desired map to run
+ Tile: tile(Tile)
+ Camera: the main Camera
- Click on Tile from the inspector, and select the sprite (DefaultSprite)
- Attach the CameraManager script to the Main Camera
Double click on "SampleScene" then you can run the project (Play).
#### WEBGL build
You need a webgl build to deploy and plug the application into the VueJS UI.
Launch the Unity webgl build and select `Physarum/webapp/public/unitybuild` as destination folder. Refresh the web application because the webpack/vue hot reloads breaks UnityLoader.
### Web UI application
A simple VueJS application, using Vuetify as CSS framework.
```
npm run serve
```
Due to GitHub limitations for github pages, we use the `master` branch to deploy builds, and the `develop` as an actual branch.
### Deploy
```
npm run deploy
```
Builds the web application and deploys it at [avivace.github.io/Physarum](https://avivace.github.io/Physarum).
An internal API has been developed to allow bidirectional stateful comunication between the VueJS instance and the webgl build of the Unity application. The Unity application is able to send updates about the status of the simulation to Vue, so we can se real time updates, while the Vue application can send actions and modify parameters or select the map.
Vue -> Unity's PayloadHandler
Unity ExternalCall -> Vue
### Documentation
To build:
```
cd docs/
pdflatex report.tex
```
## Resources
#### Web UI <-> Unity
- [WebGL: Interacting with browser scripting](https://docs.unity3d.com/2018.4/Documentation/Manual/webgl-interactingwithbrowserscripting.html)
- [JsonUtility.FromJson](https://docs.unity3d.com/ScriptReference/JsonUtility.FromJson.html)
- [Application.ExternalCall](https://docs.unity3d.com/540/Documentation/ScriptReference/Application.ExternalCall.html)
- [Application.ExternalEval](https://docs.unity3d.com/540/Documentation/ScriptReference/Application.ExternalEval.html)