Virtual Scanner Tabletop Web Games
Virtual Scanner Tabletop is an extension to Virtual Scanner that comprises of educational games about MRI that can be run by simulation or connected to a real educational MRI scanner. Target audience include high school, college, and post-grad students as well as members of the MR and scientific community at large.
Quickstart
pip install
Method 1: - On the command line, make a new virtual environment.
pip install vs-tabletop
- cd into the main folder called "vstabletop" (
venv\Lib\site-packages\vstabletop
) and runapp.py
. Click into the link in the program output (examplee: http://127.0.0.1:5000/). Log in as admin using password123456
.
Troubleshooting
(version 1.0.0b5) - You might encounter problems with installing Kiwisolver which requires Visual C++. If you have trouble getting the Visual C++, you can ignore the kiwisolver and perform the following steps:
- Install vs-tabletop without dependencies:
pip install vs-tabletop==1.0.0b4 --no-deps
- After it's installed, find
requirements.txt
in thevstabletop
folder and remove thekiwisolver==1.0.1
line - Install the rest of the requirements:
pip install -r requirements.txt
- Run
app.py
the same way as described above. The games should be able to run normally.
Method 2: Cloning
- Clone the repository.
- Make a virtual environment, activate it, and install everything specified in
requirements.txt
-
cd
into the app directory and runquestions.py
to set up the database. - Run the app in one of two ways:
(a) Run app.py using Pycharm or other IDE, or on the command line with
python app.py
(b) On the command line, set the FLASK_APP variable (set FLASK_APP=app
on Windows, orexport FLASK_APP=app
on non-Windows). Then run the app with:flask run
- Click into the link in the program output (example: http://127.0.0.1:5000/) or copy & paste it into the browser. Log in as admin using password
123456
.
Please provide feedback here after you've tried all the beginner games
Tabletop Games
The eight tabletop games are grouped into 4 pairs, each containing a "beginner" game and an "advanced" game. Games 1, 3, 5, 7 are beginner games and the games 2, 4, 6, 8 are advanced games.
# | Game | Conceptsr |
---|---|---|
1 | What's in an image? | FOV, resolution, windowing |
2 | K-space magiK | projection imaging, k-space |
3 | Brains, please! | contrast, T1/T2/PD, TR/TE/FA |
4 | Fresh blood | flow imaging |
5 | Proton's got moves | M9, precession, RF pulses, signal detection |
6 | Relaxation station | T1 and T2 relaxation, FID |
7 | Puzzled by projection I | 1D and 2D projection (forward) |
8 | Puzzled by projection II | 1D and 2D projection (inverse) |
Screenshots
Screenshots are in-development previews of the games. They will be updated at the first release.
Login page
Game navigation
Module 1 (beginner): What's in an image?
Module 2 (beginner): Brains, please!
Module 3 (beginner): Proton's got moves
Module 4 (beginner): Puzzled by Projection I
References
Brain images from the Coursera Neurohacking in R (https://www.kaggle.com/datasets/ilknuricke/neurohackinginrimages) were used in Game 2.