HubNet Guide

NetLogo 3.0.2 User Manual   

This section of the User Manual introduces the HubNet system and includes instructions to set up and run a HubNet activity.

HubNet is a technology that lets you use NetLogo to run participatory simulations in the classroom. In a participatory simulation, a whole class takes part in enacting the behavior of a system as each student controls a part of the system by using an individual device, such as a networked computer or TI-83+ calculator.

For example, in the Gridlock simulation, each student controls a traffic light in a simulated city. The class as a whole tries to make traffic flow efficiently through the city. As the simulation runs, data is collected which can afterwards be analyzed on a computer or calculator.

For more information on participatory simulations and their learning potential, please visit the Participatory Simulations Project web site.

Understanding HubNet


NetLogo is a programmable modeling environment. It comes with a large library of existing simulations, both participatory and traditional, that you can use and modify. Content areas include social science and economics, biology and medicine, physics and chemistry, and mathematics and computer science. You and your students can also use it to build your own simulations. For more about NetLogo, see the NetLogo Users Manual.

In traditional NetLogo simulations, the simulation runs according to rules that the simulation author specifies. HubNet adds a new dimension to NetLogo by letting simulations run not just according to rules, but by direct human participation.

Since HubNet builds upon NetLogo, we recommend that before trying HubNet for the first time, you become familiar with the basics of NetLogo. To get started using NetLogo models, see Tutorial #1: Running Models in the NetLogo Users Manual.

HubNet Architecture

HubNet simulations are based on a client-server architecture. The activity leader uses the NetLogo application to run a HubNet activity. When NetLogo is running a HubNet activity, we refer to it as a HubNet server. Participants use a client application to log in and interact with the HubNet server.

There are two types of HubNet available. With Computer HubNet, participants run the HubNet Client application on computers connected by a regular computer network. In Calculator HubNet, created in conjunction with Texas Instruments, participants use TI-83+ graphing calculators as clients which communicate via the TI-Navigator system.

We hope to add support for other types of clients such as cell phones and PDA's (Personal Digital Assistants).

Computer HubNet


The following activities are available in the Models Library, in the Computer HubNet Activities folder. For many models, you will find a discussion of its educational goals and suggested ways to incorporate it into your classroom in the Participatory Simulations Guide on the Participatory Simulations Project web site. More information can also be found in the Information Tab in each model.


To use Computer HubNet, you need a networked computer with NetLogo installed for the activity leader, and a networked computer with NetLogo installed for each participant. We also suggest an attached projector for the leader to project the entire simulation to the participants.

Starting an activity

You'll find the HubNet activities in NetLogo's Models Library, in the HubNet Computer Activities folder. We suggest doing a few practice runs of an activity before trying it in front of a class. [screen shot]

Open a Computer HubNet model. NetLogo will prompt you to enter the name of your new HubNet session. This is the name that participants will use to identify this activity. Enter a name and press Start.

NetLogo will open the HubNet Control Center, which lets you interact with the HubNet server.

In each activity, you'll see a box on the screen labeled "QuickStart Instructions". This contains step by step instructions to run the activity. Click the "Next>>>" button to advance to the next instruction.

You, as the leader, should then notify everyone that they may join. To join the activity, participants launch the HubNet Client application and enter their name. They should see your activity listed and can join your activity by selecting it and pressing Enter. If the activity you started is not listed the student can enter the server address manually which can be found in the HubNet Control Center.

HubNet Control Center

[screen shot]

The HubNet Control Center lets you interact with the HubNet server. It displays the name, activity, address and port number of your server. The "Mirror 2D View" checkbox controls whether the HubNet participants can see the view on their clients, assuming there is a view in the client setup. The "Mirror plots" checkbox controls whether participants will receive plot information.

The client list on the right displays the names of clients that are currently connected to you activity. To remove a participant from the activity, select their name in the list and press the Kick button. To launch your own HubNet client press the Local button, this is particularly useful when you are debugging an activity.

The lower part of the Control Center displays messages when a participant joins or leaves the activity. To broadcast a message to all the participants, click on the field at the bottom, type your message and press Broadcast Message.


I started a HubNet activity, but when participants open a HubNet Client, my activity isn't listed.

On some networks, the HubNet Client cannot automatically detect a HubNet server. Tell your participants to manually enter the server name and port of your HubNet server, which appear in the HubNet Control Center.

Note: The technical details on this are as follows. In order for the client to detect the server, multicast routing must be available between them. Not all networks support multicast routing. In particular, networks that use the IPsec protocol typically do not support multicast. The IPsec protocol is used on many virtual private networks (VPN's).

When a participant tries to connect to my activity, nothing happens after they click Enter.

If your computer or network has a firewall, it may be impeding the HubNet server from communicating. Make sure that your computer and network are not blocking ports used by the HubNet server (ports 9173 - 9180).

The view on the HubNet client is grey.

There is no view on the HubNet client.

Some activities don't have a view on the client.

I can't quit a HubNet client.

You will have to force the client to quit. On OS X, force quit the application by selecting Force Quit... in the Apple menu. On Windows, press Ctrl-Alt-Delete to open the Task Manager, select HubNet Client and press End Task.

My computer went to sleep while running a HubNet activity. When I woke the computer up, I got an error and HubNet wouldn't work anymore.

The HubNet server may stop working if the computer goes to sleep. If this happens, quit the NetLogo application and start over. Change the settings on your computer so it won't sleep again.

My problem is not addressed on this page.

Please send us an email at

Known Limitations

If HubNet malfunctions, please send us an email at

Please note that:

Calculator HubNet


To use Calculator HubNet, you need:

NOTE: Calculator HubNet works with a prototype version of the TI-Navigator system, and is not yet compatible with the commercially available version. To learn more about the TI-Navigator system, please visit the Texas Instruments website.

We are actively working in partnership with Texas Instruments on integrating the new TI-Navigator with Calculator HubNet. We expect to release a new version in the near future.

For more information about Calculator HubNet, please refer to the Participatory Simulations Guide which can be found on the Participatory Simulations Project web site.

Teacher workshops

For information on upcoming workshops and NetLogo and HubNet use in the classroom, please contact us at

HubNet Authoring Guide

To learn about authoring or modifying HubNet activities, see the HubNet Authoring Guide.

Getting help

If you have any questions about Computer HubNet or Calculator HubNet, or need help getting started, please email us at