For the Simulation Project you need to setup an OpenGL environment.

1. Install freeglut library (Windows only)

   Start Git Bash as Administrator an run the following command

   install/install_freeglut.sh

2. Install XQuartz X.Org Window System (MacOS only) On the MacOS host, we use xquartz to provide us with a MacOS X Window System.
   Download and install xquartz
   Log out and Log in to activate the changes the terminal

3. Configure XQuartz to allow network connections from host

   1. Get your IP address

      Run the following command in the terminal to see your IP address

      ifconfig en0 | grep 'inet ' | awk '{print $2}'

   2. Start XQuartz

      open -a XQuartz

      which will open a XQuartz terminal in which you enter

      xhost {Your IP}

      having {Your IP} replaced with your IP-address.

      Click on the word 'XQuartz' on the top left of your screen (next to the Apple logo) and select Preference. Open the tab Security and check 'Allow connections from network clients'

   3. Install Socat The graphical Python script runs with a Linux X Window System in a Docker container. To connect this to the MacOS X Window System on the host we use the command line utility socat.

      brew install socat

4. Generate the simulation modules

   Run the following command at project/simpylc

   sh ./generate_simulations.sh

5. Test the GUI

   Run the following command at project/simpylc

   sh ./start_client.sh

1. Create your own repository MakeAIWork2 on Github

   Browse to github.com and create public repository MakeAIWork2.

2. Share your repository with the teachers

   Post the link to your remote repository MakeAIWork2 in your private Teams channel

3. Clone your git repository

   Clone your git repository MakeAIWork2 from Github to the parent directory of MakeAIWork

4. Download and copy subfolders of this repository

   Download this repository as zip-file and extract the contents (files and subdirectories) from the zip-file to your (own) local git directory MakeAIWork2.

5. Add and commit copied contents

   Add and commit the contents to your (own) remote github repository

   Run the following commands from your MakeAIWork2 directory

   git add .
   git commit -m "Added contents for MakeAIWork2"
   git push

6. Configure git

   In order to commit and push your changes, you need identitify yourself.

   Open a (git)bash, enter directory MakeAIWork2 and run:

   install/git_config.sh {your_github_username} {your@student.email.com}

   This script will also set the pull policy to rebase.

Python (virtual) workspace

1. Create virtual Python environment

   install/create_virtual_env.sh

2. Install Python libraries

   install/install_requirements.sh

Install Docker Desktop To facilitate you with a managed portable isolated Development Environment, we provide a Docker image in which all dependencies are preinstalled. We prefer Docker for isolation since it is a much lighter solution than Virtual Machine.

1. Download and install Docker Desktop

   Download for Mac with Apple M* chip

2. Configure Docker Desktop

   Open Docker Desktop, go to settings and select Start when you login

   In Windows you can a script to enable Docker Desktop to start directly after you start Git Bash:

   sh/git_bash_profile.sh

   this script will also navigate automatically to the MakeAIWork directory.

   Visual Studio Code Configuration

   Install Python extensions

   1. Install the Git Easy extension

   2. Install the Mermaid extension

   3. Install the Docker extension

   4. Install the MongoDB extension (Periode 3)

   ---

   References

   How to Use Linux Terminal in Windows 10
   Jupyter
   Running GUI's with Docker on OS X