NetLogo banner

 Contact Us

 Modeling Commons

 User Manuals:


NetLogo Models Library:
HubNet Activities

For information about HubNet, click here.

(back to the library)

Disease Doctors HubNet

[screen shot]

If you download the NetLogo application, this model is included. (You can also run this model in your browser, but we don't recommend it; details here.)


This model is a modified version of the Disease activity which, simulates the spread of a disease through a population. In this version the population can consist of students, which are turtles controlled by individual students via the HubNet Client, androids, infectable turtles controlled by the computer and doctors, un-infectable turtles that can heal other turtles. Doctors do not exist in the Disease activity.

For further documentation on the original Disease activity, see the Participatory Simulations Guide found at


Turtles move around, possibly catching an infection, either randomly in the case of androids and doctors or as controlled by HubNet clients. Healthy turtles on the same patch as sick turtles have an INFECTION-CHANCE chance also becoming sick. A plot shows the number of sick turtles at each time tick, and if SHOW-SICK? is on, sick turtles have a red circle attached to their shape. Both students and androids can become sick, doctors cannot. If an infectable turtle is on the same patch as a doctor they are cured.

Initially, all turtles are healthy. A number of turtles equal to INITIAL-NUMBER-SICK become sick when the INFECT button is pressed.


Quickstart Instructions:

Teacher: Follow these directions to run the HubNet activity. Optional: Zoom In (see Tools in the Menu Bar) Optional: Change any of the settings. Optional: Add androids and doctors.

Everyone: Open up a HubNet Client on your machine and type your user name, select this activity and press ENTER.

Teacher: Have the students move their turtles around to acquaint themselves with the interface. Press the INFECT button in the NetLogo interface to start the simulation.

Everyone: Watch the plot of the number infected.

Teacher: To start the activity again with the same group, stop the model by pressing the GO button, if it is on. Change any of the settings that you would like. Press the SETUP button or the CURE-ALL button, SETUP will kill the androids and doctors, CURE-ALL will not.

Teacher: Restart the simulation by pressing the GO button again. Infect some turtles and continue.

Teacher: To start the simulation over with a new group stop the model by pressing the GO button, press the RESET button in the Control Center and follow these instructions again from the beginning.


SETUP - sets all students to an uninfected state, kills all androids, and increments the run-number so the data in the plot will overlay the previous run. CURE-ALL - sets all turtles to an uninfected state and increments the run-number. GO - runs the simulation CREATE-ANDROIDS - adds NUM-ANDROIDS randomly moving turtles to the simulation CREATE-DOCTORS - adds NUM-DOCTORS turtles that can heal other turtles INFECT - infects INITIAL-NUMBER-SICK of the turtles in the simulation NEXT >>> - shows the next quick start instruction <<< PREVIOUS - shows the previous quick start instruction RESET INSTRUCTIONS - shows the first quick start instruction


NUM-ANDROIDS - defines how many androids are created by the CREATE-ANDROIDS button NUM-DOCTORS - defines how many doctors are created by the CREATE-DOCTORS button ANDROID-DELAY - the delay time, in seconds, for android movement - the higher the number, the slower the androids move DOCTOR-DELAY - the delay time, in seconds, for doctor movement - the higher the number, the slower the doctors move INITIAL-NUMBER-SICK - the number of turtles that become infected spontaneously when the INFECT button is pressed INFECTION-CHANCE - sets the percentage chance that every tenth of a second a healthy turtle will become sick if it is on the same patch as an infected turtle


WANDER? - when on, the androids and doctors wander randomly. When off, they do not move SHOW-SICK? - when on, sick turtles add to their original shape a red circle. When off, they can move through the population unnoticed


INFECTABLE TURTLES - the sum of students and androids since doctors cannot be infected. NUMBER SICK - the number of turtles that are infected


NUMBER SICK - shows the number of sick turtles versus time

Client Information

After logging in, the client interface will appear for the students, and if GO is pressed in NetLogo they will be assigned a turtle which will be described in the YOU ARE A: monitor. Their current location will be shown in the LOCATED AT: monitor. If the student doesn't like their assigned shape and/or color they can hit the CHANGE APPEARANCE button at any time to change to another random appearance.

The SICK? monitor will show "true" if your turtle is infected, or "false" will be shown if your turtle is not infected.

The student controls the movement of their turtle with the UP, DOWN, LEFT, and RIGHT buttons and the STEP-SIZE slider. Clicking any of the directional buttons moves their turtle in the appropriate direction a distance of STEP-SIZE.


If no doctors are present no matter how you change the various parameters, the same basic plot shape emerges. After using the model once with the students, ask them how they think the plot will change if you alter a parameter and when you add doctors. Altering the initial percentage sick and the infection chance will have different effects on the plot.


Use the model with the entire class to serve as an introduction to the topic. Then have students use the NetLogo model individually, in a computer lab, to explore the effects of the various parameters. Discuss what they find, observe, and can conclude from this model.

Ask students to predict how the shape of the plot change will change when doctors are added.


Try to make the androids and doctors smarter about how they move around the world.

Experiment with different infection scenarios, for example once a turtle is cured it builds immunity to the disease or turtles may still carry the disease and infect others even after it has been cured.


Disease Disease Solo


If you mention this model or the NetLogo software in a publication, we ask that you include the citations below.

For the model itself:

Please cite the NetLogo software as:


Copyright 2006 Uri Wilensky.


This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License. To view a copy of this license, visit or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

Commercial licenses are also available. To inquire about commercial licenses, please contact Uri Wilensky at

(back to the NetLogo Models Library)