In this manual there are going to be a few different steps you need take before you can get the Phobialib working. These steps will use the CAVE, Vizard software, Acqknowledge software and the Biopac system.
First you want to check if you have everything to get started.
- Vizard 4.0
- Acqknowledge 4.2
- Biopac system with ECG transmitter
When you have all of the above mentioned software and hardware you can continue with the following steps.
If you run into any problems check the troubleshooting section for that certain step first.
Starting up the CAVE
1. On the desktop you will find the following Cave Tools. This section contains everything you will need to start up the CAVE
2. Launch the Cave Server tool.
3. Now start the CAVE computers by clicking startslaves. You will now see (it can take a few moments) the slaves appearing in the Cave Server Tool.
4. Now run the VizClusterMaster. For now just leave this application running in the background.
5. Go back to the Cave Server tool and choose the “Vizard Clients v4.0” option from the dropdown menu and hit Run! This will give you an error. You can just ignore this and click OK.
6. You will now see the slaves appear in the VizClusterMaster. Check all the checkboxes except for the localhost and uncheck the “Sync frames” option.
7. No go to the Bluetooth Settings. Here you will see multiple Bluetooth devices. Look on the sides of the Wii-Motes to see which device it is, press the 1 and 2 button on the Wii-Mote and double click the associated device in the Bluetooth Settings. If the Wii-Mote is connected successfully you will see a green link appear.
8. Now go to the CAVE and look for the device which is shown below.
On the bottom device right above the power cable there’s a switch. Flip the switch to turn on the FOB.
Don’t forget to turn this off when you’re finished using the CAVE!!
9. Run the Fontys VR-Cave Daemon. Connect both FOB and Wii-Mote by clicking the associated buttons.
10. To turn on the beamers click Beamers ON in the Beamers section.
Only turn on the beamers when you want to run an application in the CAVE. Turn the beamers off when you’re done running the application.
Starting the application
1. The applications are all located in the Cave software folder located in the Folders section. The path for the applications is D:\Cave software\Fobiemetingen.
2. You’re now in the project folder. In here there are a lot of different files and folders. The folders contain the data of the applications including: the audio, images, logs and models. In the backup folder there’s a backup of the entire application in case something goes wrong. The .acq files are the graph files for the Acqknowledge software. You can find a further explanation about this in the Acqknowledge chapter. The .py files are the most important files. These files contain the code for the applications.
3. The three applications which can be run in the CAVE are: - arachnophobia.py - acrophobia.py - claustrophobia.py
4. You can run these applications in two different ways. One of these methods is by right clicking the file and hitting Run. The other method is by right clicking the file and hitting Edit. The last option will open the application in Vizard and allows you to edit the application.
Setting up Biopac
Follow the following instructions to set up the Biopac system. This is not needed to run the applications. Only follow these steps if you want to measure the heartbeat or skin response of the user.
1. Connect the Biopac hardware to the Black LAN cable as shown below. This LAN cable is located next to the Cave-Server computer.
2. Plug in the USB License Key which will be inside of small bag as shown below.
3. Turn on the Biopac system and run the Acqknowledge software. There will be a shortcut on the desktop and in the project folder.
4. Here you can select different files. You can create your own or use the bpmskinsresponse.acq.
5. You will now see a big window with different empty graphs.
6. Click the start button in the left upper corner. A pop up will ask you to turn on the BioNomadix transmitter. Check if the light is green, which means the transmitter is connected. If the light is yellow you will need to charge the transmitter. Click OK to continue to the next pop up. In the next pop up you have to click Calibrate.
Using the template
1. First go to the project folder. (D:\Cave software\Fobiemetingen)
2. Now you will see the file template.py. Right click this file and click Edit.
3. You will now see the code in Vizard. To import your own model/world, place your file into the Models folder and edit the variable WORLD_LOCATION. This is all you need in first place to run your own model in the CAVE.
If you are going to use your own model/world, you need to place this file on all computers. This means you have to go each CAVE client and place your file in the same folder. These files have to end up having the same path on each CAVE Client. On the desktop in the Cave Clients section there are 4 shortcuts to go to these folders.
Optionally you can edit the Booleans or other code to change the application and add more features.
Starting up the CAVE:
1.3 Clientserver has stopped working
This does happen every now and then. If this problem occurs just restart the Cave Server tool.
1.3 Not all slaves connect
When this happens shut down all slave computers by choosing the “Shut down” option in the Cave Server tool dropdown menu and hitting Run! Now cancel the shutdown of the Cave-Server (the pc you’re working on) by clicking Cancel shutdown in the Cave tools section. Then start them back up again by clicking startslaves.
If there’s still one or more slaves that won’t start manually start up the slave yourself.
1.9 FOB won’t connect
If the FOB won’t connect to the Fontys VR-Cave Daemon turn off the FOB. Wait for a couple of minutes, turn the FOB back on and try to connect again. If this still doesn’t work contact Sjaak Verwaaijen about this.