## Cellulo-lua

Bachelor Project - see [report.pdf](/report.pdf)

The purpose of this project is to develop a virtual reality experience to explore human behaviour within a swarm, using the Oculus Quest VR headset and Cellulo robots developed by the Computer-Human Interaction in Learning and Instruction (CHILI) lab at EPFL.

### Installing LÖVR

This project uses the LÖVR framework, which needs to be installed on the desired platform to run.

*Note that if running on an Android platform such as the Oculus Quest, LÖVR only needs to be installed on the headset, not the computer where you are editing the project.*

#### Linux

```
git clone https://github.com/bjornbytes/lovr
git submodule init
git submodule update
cd lovr
mkdir build
cd build
cmake ..
cmake --build .
```

#### Other platforms (Windows, macOS, Android)

See [LÖVR downloads page](https://lovr.org/downloads) for official builds of the framework.

### Launching

Run with `lovr .` to run on the local development machine.

#### Android

To run on a remote Android platform (e.g. Oculus Quest), plug the device into the computer and install the LÖVR apk (`adb install lovr.apk`)

Once installed, you can push local files to the LÖVR game source folder on the Android device.
This project uses the [lodr](https://github.com/mcclure/lodr) library to automatically restart the app when a file is modified.

Navigate to the root of the project and run `watch adb push --sync . /sdcard/Android/data/org.lovr.test/files/.lodr`. The `watch` command will automatically look for changes locally every few seconds. To push files only once, remove it.

### Testing

[*luaunit*](https://github.com/bluebird75/luaunit) is used for unit tests.

LÖVE needs to be installed.

Navigate to the root of the project and run with `love test`