README.md

Ambient Intelligence Development Environment for People with Neurodegenerative Diseases

This site shows how to use the AIDE toolset for the development of AAL solutions for people with neurogenerative diseases (NDD).

It first briefly explains what is AIDE, how to install it, and then a set of case studies that illustrate what can be done with it.

This has been developed in the context of the project ColoSAAL (TIN2014-57028-R), whose purpose is to facilitate the co-creation of AAL solutions for people with NDD.

The ColoSAAL project proposes a process that involves different actors: end-users, relatives, care-givers, health experts, sociologists, software engineers, and other relevant stakeholders.

They will co-create AAL solutions in an iterative process, where the interaction artifacts are simulations of scenarios of the solutions in daily activities of the end-users (in this case, the people with NDD).

These simulations can be seen and analysed by the different actors, who can comment on them, and such information is taken to provide a refined solution.

In order to do this, several tools from the AIDE Framework are used, mainly SociAALML Editor and PHAT Simulator.

Introduction to the Framework:

AIDE stands for Ambient Intelligence Development Environment and is a set of tools to model, simulate and rapid prototype Ambient Intelligence systems. For more information please visit this link.

1. SociAALML Editor is a graphical editor to model the elements for the simulation. The editor is based on INGENME framework.

2. PHAT Framework is a set of tools (coded using Java) to model and simulate activities of daily living. The main components are:

   2.1 PHAT Generator is a tool that transforms the model defined with SociAALML into java code which can then be executed to see the simulations in action.

   2.2 PHAT Simulator is a simulator developed from scratch using jMonkeyEngine, which makes the entire framework FOSS.

Getting Started:

Installation:

Java 1.8 at least (set variable JAVA_HOME).

Under GNU/Linux you can install it by typing these into the console:

sudo apt install openjdk-8-jre
sudo apt install openjdk-8-jdk-headless

You can check the java version with:

java -version
javac -version

To change between java versions:

sudo update-alternatives --config java

Maven 3.1.1+ at least (set variable M2_HOME).

sudo apt install maven

If you need to set M2 variables add the following lines to your .bashrc or .zshrc or whatever you use:

export M2_HOME="/usr/share/maven"
export M2="$M2_HOME/bin"
export PATH="$M2:$PATH"

Ant (set variable ANT_HOME)

sudo apt install ant

Usage:

1. To generate the java code for the editor and simulations:

mvn clean compile

2. To open SociAALML Editor you go to a project's folder and type:

ant edit

3. To run a simulation

ant runSimName

NOTE: Bash completion for ant is useful when searching for simulations: http://ingenias.sourceforge.net/blog/2012/12/04/a-useful-bashcompletion-extension-for-ant/

Case Study Usage Example:

Download full repository

git clone [email protected]:Melkoroth/AIDEdevelopment.git
cd AIDEdevelopment

Enter project directory, compile and run a simulation

cd e18interview
mvn clean compile 
ant runSimTalkToTV

If you get an error message complaining about encoding you should call maven with the following line:

mvn clean compile -Dfile.encoding=UTF8

This should launch a PHATSIM window with the simulation. It should be similar to this one:

If you are interested in the modelling part:

cd e18interview
mvn clean compile 
ant edit

This will laund the SociAALML editor, which is similar to this capture:

Acknowledgements

This development is part of ColoSAAL project (TIN2014-57028-R) which is funded by Spain's Ministerio de Economía y Competitividad. Developed at GRASIA research group in the Universidad Complutense de Madrid.