Skip to content

Physarum polycephalum slime mould computing simulation, implemented on a custom VueJS + Unity3D stack

License

Notifications You must be signed in to change notification settings

avivace/Physarum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Physarum

Final project for my Complex Systems course, from my MSc in Computer Science: Physarum polycephalum slime mould computing simulations.

By Matteo Coppola, Luca Palazzi, Antonio Vivace.

Develop

Clone the project locally: git clone git@github.com: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.

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