Herd Immunity - Revision history

Admin at 15:20, 8 May 2017

2017-05-08T15:20:06Z

← Older revision		Revision as of 17:20, 8 May 2017
Line 46:		Line 46:
	* If the main app is busy doing a simulation, then the button on the bottom left will say "Run Soon!" - otherwise, if the main app is ready and waiting for the next parameters, it will say "Run Now!". The app will queue all the jobs up and process them in order.		* If the main app is busy doing a simulation, then the button on the bottom left will say "Run Soon!" - otherwise, if the main app is ready and waiting for the next parameters, it will say "Run Now!". The app will queue all the jobs up and process them in order.


	~~== Usage History ==~~

	~~Here are the events where we've used this game.~~

	* March 2015 - HPRU Open Day.
	* [http://www3.imperial.ac.uk/newsandeventspggrp/imperialcollege/administration/outreach/eventssummary/event_18-12-2012-13-51-41 July 2014 - Imperial Y10 Summer School Workshop] - Harriet Mills and Rafal Mostowy.
	* [[June 2013 - MRC Centenary, Science Museum]]

	== Credits and Thanks ==		== Credits and Thanks ==

	The Herd Immunity Java code, Android code and Web support was written by Wes Hinsley. The idea, and a lot of later ideas to make it much more exciting, was from Neil Ferguson. Many thanks also to all who demonstrated this in exciting ways at the Centenary event.		The Herd Immunity Java code, Android code and Web support was written by Wes Hinsley. The idea, and a lot of later ideas to make it much more exciting, was from Neil Ferguson. Many thanks also to all who demonstrated this in exciting ways at the Centenary event.

Admin: /* Running on a Standalone Machine */

2017-05-05T11:48:36Z

Running on a Standalone Machine

← Older revision		Revision as of 13:48, 5 May 2017
Line 9:		Line 9:

	The game can be used as a standalone application, or with various additional dependencies, it can be controlled through a tablet, which has been our favourite and most engaging way of using the game in public events.		The game can be used as a standalone application, or with various additional dependencies, it can be controlled through a tablet, which has been our favourite and most engaging way of using the game in public events.

			== Platforms ==

			The code for the main app is in Java, but has only been tested so far on Windows. Will update with better cross-platform support soon - the things I'm thinking about are the fonts, and a small bunch of external scripts that are called from the web platform for clearing or restoring data. (And, trivially, the run scripts). Nothing that hard.

	== Running on a Standalone Machine ==		== Running on a Standalone Machine ==

Admin at 14:48, 3 May 2017

2017-05-03T14:48:32Z

← Older revision		Revision as of 16:48, 3 May 2017
Line 12:		Line 12:
	== Running on a Standalone Machine ==		== Running on a Standalone Machine ==

	Download the ZIP file [https://mrcdata.dide.ic.ac.uk/resources/herd.zip here], which containing Java source and compiled classes. I compiled with Java 8u91; install Java from [http://java.sun.com Oracle] if you need to. Unzip it to any folder you like. (Don't just run it from inside the ZIP - it won't work!). If you need an unzipper, try [http://7-zip.org 7-Zip]. Then click on '''~~run_local~~.bat''' in the root folder. (Or simply '''javaw Herd'''. Being native Java code, it should also be fine on Linux and Mac, but I haven't specifically tested.		Download the ZIP file [https://mrcdata.dide.ic.ac.uk/resources/herd.zip here], which containing Java source and compiled classes. I compiled with Java 8u91; install Java from [http://java.sun.com Oracle] if you need to. Unzip it to any folder you like. (Don't just run it from inside the ZIP - it won't work!). If you need an unzipper, try [http://7-zip.org 7-Zip]. Then click on '''run.bat''' in the root folder. (Or simply '''javaw Herd'''. Being native Java code, it should also be fine on Linux and Mac, but I haven't specifically tested.

	=== The User Interface ===		=== The User Interface ===
Line 27:		Line 27:

	== Running with Androids ==		== Running with Androids ==
			[[File:herd_android_screenshot.png\|500px\|right]]

	=== Web Server ===		=== Web Server ===

	We'll be using tablets to talk to the Herd Immunity main app, by being on the same wifi network, and communicating via the [[Web Platform for MRC Outreach Events]] - it's the same platform used for the [[Barcode Epidemic]], so you only need to set it up once on one laptop, even if you want to run both the [[Barcode Epidemic]] and the Herd Immunity app at the same time. The only thing I'd suggest is: run the Herd Immunity app on a laptop of its own, because it wants all the resources it can get to run smoothly. Anyway, see the [[Web Platform for MRC Outreach Events]] page for setting up the web server platform, and make a note of the IP address of the web server, because the Herd Immunity Android app will want to know it.		We'll be using tablets to talk to the Herd Immunity main app, by being on the same wifi network, and communicating via the [[Web Platform for MRC Outreach Events]] - it's the same platform used for the [[Barcode Epidemic]], so you only need to set it up once on one laptop, even if you want to run both the [[Barcode Epidemic]] and the Herd Immunity app at the same time. The only thing I'd suggest is: run the Herd Immunity app on a laptop of its own, because it wants all the resources it can get to run smoothly. Anyway, see the [[Web Platform for MRC Outreach Events]] page for setting up the web server platform, and make a note of the IP address of the web server, because the Herd Immunity Android app will want to know it.

			=== The Android App ===

			* Download the android app [https://mrcdata.dide.ic.ac.uk/resources/HerdImmunity.apk here], and install it in whatever way you usually coax Android to install things. Once you've got it installed, the app menu (the three dots on the top right), will let you check for updates.
			* This time, you need to run the main bouncing ball software in network mode with something similar to '''javaw Herd /URL http://192.168.2.2/epi''' (or look in the run.bat file). It won't wait for you to click anything; instead it will start running simulations and collecting sample data points for its graphs, in an orderly distributed way.
			* Make sure you're connected to the right wifi, and then run the android app. If it's the first time, press the three-dots, and Set Server URL to something like '''http://192.168.2.2/epi'''
			* The buttons let you choose the initial percentage of the population that is vaccinated, and the reproductive number. You can also optionally give a name for the data-point you're about to collect - the most recent five points obtained for each graph can have names next to them.
			* While the main app is in "Demo" mode, it loops indefinitely, keeping itself busy. As soon as you run your first android-driven experiment, it will stop that behaviour, and wait on the graph screen for someone to request the next simulation to be done. If you want it to go back into demo mode again, push the Demo Mode button!
			* If the main app is busy doing a simulation, then the button on the bottom left will say "Run Soon!" - otherwise, if the main app is ready and waiting for the next parameters, it will say "Run Now!". The app will queue all the jobs up and process them in order.


	== Usage History ==		== Usage History ==

Admin: /* Running with Androids */

2017-04-27T14:12:23Z

Running with Androids

← Older revision		Revision as of 16:12, 27 April 2017
Line 27:		Line 27:

	== Running with Androids ==		== Running with Androids ==

			=== Web Server ===

			We'll be using tablets to talk to the Herd Immunity main app, by being on the same wifi network, and communicating via the [[Web Platform for MRC Outreach Events]] - it's the same platform used for the [[Barcode Epidemic]], so you only need to set it up once on one laptop, even if you want to run both the [[Barcode Epidemic]] and the Herd Immunity app at the same time. The only thing I'd suggest is: run the Herd Immunity app on a laptop of its own, because it wants all the resources it can get to run smoothly. Anyway, see the [[Web Platform for MRC Outreach Events]] page for setting up the web server platform, and make a note of the IP address of the web server, because the Herd Immunity Android app will want to know it.

	== Usage History ==		== Usage History ==

Admin at 14:42, 12 September 2016

2016-09-12T14:42:29Z

← Older revision		Revision as of 16:42, 12 September 2016
Line 1:		Line 1:
	[[File:herd_20_5.mp4\|500px\|right]]		[[File:herd_20_5.mp4\|500px\|right]]

	~~== Herd Immunity ==~~

	Work in progress! Details below could change!		Work in progress! Details below could change!

	=== Introduction ===		== Introduction ==
	Also known as the Billiard Ball Game, and various alternatives! It's a fun and pretty Java application that shows a load of coloured balls bouncing around a space. At the beginning they will either be green (susceptible), or blue (vaccinated). Then a couple will turn red (infected), and they will each try to infect the next R<sub>0</sub> different balls they bounce into. If those victims are susceptible, then they will turn red and start trying to do their own infecting. When R<sub>0</sub> attempts to infect have been made, they becoming immune (grey). The vaccination percentage, and R<sub>0</sub> are the things you can choose; R<sub>0</sub> is a whole number between 3 and 8, and vaccination between 0 and 100% in 10% intervals.		Also known as the Billiard Ball Game, and various alternatives! It's a fun and pretty Java application that shows a load of coloured balls bouncing around a space. At the beginning they will either be green (susceptible), or blue (vaccinated). Then a couple will turn red (infected), and they will each try to infect the next R<sub>0</sub> different balls they bounce into. If those victims are susceptible, then they will turn red and start trying to do their own infecting. When R<sub>0</sub> attempts to infect have been made, they becoming immune (grey). The vaccination percentage, and R<sub>0</sub> are the things you can choose; R<sub>0</sub> is a whole number between 3 and 8, and vaccination between 0 and 100% in 10% intervals.

Line 12:		Line 10:
	The game can be used as a standalone application, or with various additional dependencies, it can be controlled through a tablet, which has been our favourite and most engaging way of using the game in public events.		The game can be used as a standalone application, or with various additional dependencies, it can be controlled through a tablet, which has been our favourite and most engaging way of using the game in public events.

	=== Running on a Standalone Machine ===		== Running on a Standalone Machine ==

	Download the ZIP file [https://mrcdata.dide.ic.ac.uk/resources/herd.zip here], which containing Java source and compiled classes. I compiled with Java 8u91; install Java from [http://java.sun.com Oracle] if you need to. Unzip it to any folder you like. (Don't just run it from inside the ZIP - it won't work!). If you need an unzipper, try [http://7-zip.org 7-Zip]. Then click on '''run_local.bat''' in the root folder. (Or simply '''javaw Herd'''. Being native Java code, it should also be fine on Linux and Mac, but I haven't specifically tested.		Download the ZIP file [https://mrcdata.dide.ic.ac.uk/resources/herd.zip here], which containing Java source and compiled classes. I compiled with Java 8u91; install Java from [http://java.sun.com Oracle] if you need to. Unzip it to any folder you like. (Don't just run it from inside the ZIP - it won't work!). If you need an unzipper, try [http://7-zip.org 7-Zip]. Then click on '''run_local.bat''' in the root folder. (Or simply '''javaw Herd'''. Being native Java code, it should also be fine on Linux and Mac, but I haven't specifically tested.

	==== The User Interface ====		=== The User Interface ===

	It's really easy. You click the up and down arrows vary the reproductive number, and the percentage vaccination, then you click the big button to run the simulation. Then you wait and watch in awe and wonder as the simulation runs and presents you its results. At the end, you'll see a graph of all the collected samples for that R<sub>0</sub>, and the key will highlight which sample was the one you just did. (Afraid in the current standalone version, you can't name your sample, which you can with the android version below. I might fix that one day - then again, it's nice to not really need a keyboard while you're demoing).		It's really easy. You click the up and down arrows vary the reproductive number, and the percentage vaccination, then you click the big button to run the simulation. Then you wait and watch in awe and wonder as the simulation runs and presents you its results. At the end, you'll see a graph of all the collected samples for that R<sub>0</sub>, and the key will highlight which sample was the one you just did. (Afraid in the current standalone version, you can't name your sample, which you can with the android version below. I might fix that one day - then again, it's nice to not really need a keyboard while you're demoing).

	==== Demo mode ====		=== Demo mode ===

	If you run '''run_local_demo.bat''' (or javaw Herd /DEMO), then it runs in a demo mode, which cycles round non-interactively, collecting data evenly across vaccination coverage and R<sub>0</sub> - so if you leave it running overnight, it will collect enough samples to give you good looking best-fit curves for all the graphs. There's no exit button, so you'll have to do ALT+F4 in windows to exit. (Need to test Mac/Linux!)		If you run '''run_local_demo.bat''' (or javaw Herd /DEMO), then it runs in a demo mode, which cycles round non-interactively, collecting data evenly across vaccination coverage and R<sub>0</sub> - so if you leave it running overnight, it will collect enough samples to give you good looking best-fit curves for all the graphs. There's no exit button, so you'll have to do ALT+F4 in windows to exit. (Need to test Mac/Linux!)

	==== Managing Data ====		=== Managing Data ===

	There's a batch file '''clear.bat''', which will make a directory of the form bkp_yyyymmdd_hhmmss, and copy the current data in it. Then it will replace the data files with the ones found in "bkp_OneSample", which contain just a single point for every graph. And to restore a previously backed up dataset, (which is just a file copy really), '''restore.bat bkp_201609012_152819''' for example. NB - at present, these batch files have the working directory hard coded into the file. I'll fix this soon - in the meantime, edit them!		There's a batch file '''clear.bat''', which will make a directory of the form bkp_yyyymmdd_hhmmss, and copy the current data in it. Then it will replace the data files with the ones found in "bkp_OneSample", which contain just a single point for every graph. And to restore a previously backed up dataset, (which is just a file copy really), '''restore.bat bkp_201609012_152819''' for example. NB - at present, these batch files have the working directory hard coded into the file. I'll fix this soon - in the meantime, edit them!

	=== Running with Androids ===		== Running with Androids ==

	=== Usage History ===		== Usage History ==

	Here are the events where we've used this game.		Here are the events where we've used this game.
Line 38:		Line 36:
	* [[June 2013 - MRC Centenary, Science Museum]]		* [[June 2013 - MRC Centenary, Science Museum]]

	=== Credits and Thanks ===		== Credits and Thanks ==

	The Herd Immunity Java code, Android code and Web support was written by Wes Hinsley. The idea, and a lot of later ideas to make it much more exciting, was from Neil Ferguson. Many thanks also to all who demonstrated this in exciting ways at the Centenary event.		The Herd Immunity Java code, Android code and Web support was written by Wes Hinsley. The idea, and a lot of later ideas to make it much more exciting, was from Neil Ferguson. Many thanks also to all who demonstrated this in exciting ways at the Centenary event.

Admin at 14:41, 12 September 2016

2016-09-12T14:41:39Z

← Older revision		Revision as of 16:41, 12 September 2016
Line 33:		Line 33:

	Here are the events where we've used this game.		Here are the events where we've used this game.

	~~== Previous Events ==~~

	* March 2015 - HPRU Open Day.		* March 2015 - HPRU Open Day.

Admin: /* Managing Data */

2016-09-12T14:39:45Z

Managing Data

← Older revision		Revision as of 16:39, 12 September 2016
Line 26:		Line 26:
	==== Managing Data ====		==== Managing Data ====

	There's a batch file '''clear.bat''', which will make a directory of the form bkp_yyyymmdd_hhmmss, and copy the current data in it. Then it will replace the data files with the ones found in "bkp_OneSample", which contain just a single point for every graph. NB - at present, these batch files have the working directory hard coded into the file. I'll fix this soon - in the meantime, edit them!		There's a batch file '''clear.bat''', which will make a directory of the form bkp_yyyymmdd_hhmmss, and copy the current data in it. Then it will replace the data files with the ones found in "bkp_OneSample", which contain just a single point for every graph. And to restore a previously backed up dataset, (which is just a file copy really), '''restore.bat bkp_201609012_152819''' for example. NB - at present, these batch files have the working directory hard coded into the file. I'll fix this soon - in the meantime, edit them!

	=== Running with Androids ===		=== Running with Androids ===

Admin: /* Running on a Standalone Machine */

2016-09-12T14:38:05Z

Running on a Standalone Machine

@@ Line 14: / Line 14: @@
 === Running on a Standalone Machine ===
-Download the ZIP file [https://mrcdata.dide.ic.ac.uk/resources/herd.zip here], which containing Java source and compiled classes. I compiled with Java 8u91; install Java from [http://java.sun.com Oracle] if you need to. Unzip it to any folder you like. (Don't just run it from inside the ZIP - it won't work!). If you need an unzipper, try [http://7-zip.org 7-Zip]. Then click on '''runthis.bat''' in the root folder. Being Java code, it should also be fine on Linux and Mac.
+Download the ZIP file [https://mrcdata.dide.ic.ac.uk/resources/herd.zip here], which containing Java source and compiled classes. I compiled with Java 8u91; install Java from [http://java.sun.com Oracle] if you need to. Unzip it to any folder you like. (Don't just run it from inside the ZIP - it won't work!). If you need an unzipper, try [http://7-zip.org 7-Zip]. Then click on '''run_local.bat''' in the root folder. (Or simply '''javaw Herd'''. Being native Java code, it should also be fine on Linux and Mac, but I haven't specifically tested.
 === Usage History ===

Admin at 15:41, 8 September 2016

2016-09-08T15:41:53Z

← Older revision		Revision as of 17:41, 8 September 2016
Line 1:		Line 1:
			[[File:herd_20_5.mp4\|500px\|right]]

	== Herd Immunity ==		== Herd Immunity ==

Admin: Created page with "== Herd Immunity == Work in progress! Details below could change! === Introduction === Also known as the Billiard Ball Game, and various alternatives! It's a fun and pretty..."

2016-09-08T15:31:08Z

Created page with "== Herd Immunity == Work in progress! Details below could change! === Introduction === Also known as the Billiard Ball Game, and various alternatives! It's a fun and pretty..."

New page

== Herd Immunity ==

Work in progress! Details below could change!

=== Introduction ===
Also known as the Billiard Ball Game, and various alternatives! It's a fun and pretty Java application that shows a load of coloured balls bouncing around a space. At the beginning they will either be green (susceptible), or blue (vaccinated). Then a couple will turn red (infected), and they will each try to infect the next R0 different balls they bounce into. If those victims are susceptible, then they will turn red and start trying to do their own infecting. When R0 attempts to infect have been made, they becoming immune (grey). The vaccination percentage, and R0 are the things you can choose; R0 is a whole number between 3 and 8, and vaccination between 0 and 100% in 10% intervals.

After each run, the number of infections made is recorded and plotted on a graph; there is one graph for each value of R0 with vaccination coverage on the x-axis, and number of hosts on the y-axis. After a few samples have been connected, a best fit curve will be plotted, showing the basic herd immunity principle: vaccinating for example 30% of the population causes a reduction of much more than 30% in the final number of cases.

The game can be used as a standalone application, or with various additional dependencies, it can be controlled through a tablet, which has been our favourite and most engaging way of using the game in public events.

=== Running on a Standalone Machine ===

Download the ZIP file [https://mrcdata.dide.ic.ac.uk/resources/herd.zip here], which containing Java source and compiled classes. I compiled with Java 8u91; install Java from [http://java.sun.com Oracle] if you need to. Unzip it to any folder you like. (Don't just run it from inside the ZIP - it won't work!). If you need an unzipper, try [http://7-zip.org 7-Zip]. Then click on '''runthis.bat''' in the root folder. Being Java code, it should also be fine on Linux and Mac.

=== Usage History ===

Here are the events where we've used this game.

== Previous Events ==

* March 2015 - HPRU Open Day.
* [http://www3.imperial.ac.uk/newsandeventspggrp/imperialcollege/administration/outreach/eventssummary/event_18-12-2012-13-51-41 July 2014 - Imperial Y10 Summer School Workshop] - Harriet Mills and Rafal Mostowy.
* [[June 2013 - MRC Centenary, Science Museum]]

=== Credits and Thanks ===

The Herd Immunity Java code, Android code and Web support was written by Wes Hinsley. The idea, and a lot of later ideas to make it much more exciting, was from Neil Ferguson. Many thanks also to all who demonstrated this in exciting ways at the Centenary event.