[{"data":1,"prerenderedAt":563},["ShallowReactive",2],{"/hubnet":3,"/hubnet-surround":554},{"id":4,"title":5,"body":6,"description":522,"extension":523,"meta":524,"navigation":542,"path":551,"seo":552,"stem":12,"__hash__":553},"content/hubnet.md","HubNet",{"type":7,"value":8,"toc":489},"minimark",[9,21,25,33,36,46,101,109,119,122,125,133,142,145,148,155,164,170,199,208,211,220,223,232,246,254,257,260,269,280,283,286,289,298,307,310,313,322,325,334,345,354,357,366,369,378,381,390,397,406,411,414,437,444,450,457,463,470,477,484],[10,11,15],"h1",{"id":12,"className":13},"hubnet",[14],"section-heading",[16,17,5],"a",{"className":18,"href":20},[19],"section-anchor","#hubnet",[22,23,24],"p",{},"This section of the User Manual introduces the HubNet system and includes\ninstructions to set up and run a HubNet activity.",[22,26,27,28,32],{},"HubNet is a technology that lets you use NetLogo to run ",[29,30,31],"em",{},"participatory\nsimulations"," in the classroom. In a participatory simulation, a whole class\ntakes part in enacting the behavior of a system as each student controls a part\nof the system by using an individual device, such as a networked computer.",[22,34,35],{},"For example, in the Gridlock simulation, each student controls a traffic light\nin a simulated city. The class as a whole tries to make traffic flow efficiently\nthrough the city. As the simulation runs, data is collected which can afterwards\nbe analyzed on a computer.",[22,37,38,39,45],{},"For more information on participatory simulations and their learning potential,\nplease visit the\n",[16,40,44],{"href":41,"rel":42},"http://ccl.northwestern.edu/rp/ps/index.shtml",[43],"nofollow","Participatory Simulations Project web site",".",[47,48,51,61],"div",{"className":49},[50],"toc",[52,53,56],"h4",{"id":54,"className":55},"table-of-contents",[14],[16,57,60],{"className":58,"href":59},[19],"#table-of-contents","Table of Contents",[62,63,64,71,77,83,89,95],"ul",{},[65,66,67],"li",{},[16,68,70],{"href":69},"#understanding-hubnet","Understanding HubNet",[65,72,73],{},[16,74,76],{"href":75},"#computer-hubnet","Computer HubNet",[65,78,79],{},[16,80,82],{"href":81},"#teacher-workshops","Teacher workshops",[65,84,85],{},[16,86,88],{"href":87},"#hubnet-authoring-guide","HubNet Authoring Guide",[65,90,91],{},[16,92,94],{"href":93},"#running-hubnet-in-headless-mode","Running HubNet in headless mode",[65,96,97],{},[16,98,100],{"href":99},"#getting-help","Getting help",[102,103,106],"h2",{"id":104,"className":105},"understanding-hubnet",[14],[16,107,70],{"className":108,"href":69},[19],[110,111,114],"h3",{"id":112,"className":113},"netlogo",[14],[16,115,118],{"className":116,"href":117},[19],"#netlogo","NetLogo",[22,120,121],{},"NetLogo is a programmable modeling environment. It comes with a large library of\nexisting simulations, both participatory and traditional, that you can use and\nmodify. Content areas include social science and economics, biology and\nmedicine, physics and chemistry, and mathematics and computer science. You and\nyour students can also use it to build your own simulations.",[22,123,124],{},"In traditional NetLogo simulations, the simulation runs according to rules that\nthe simulation author specifies. HubNet adds a new dimension to NetLogo by\nletting simulations run not just according to rules, but by direct human\nparticipation.",[22,126,127,128,132],{},"Since HubNet builds upon NetLogo, we recommend that before trying HubNet for the\nfirst time, you become familiar with the basics of NetLogo. To get started using\nNetLogo models, see ",[16,129,131],{"href":130},"tutorial1","Tutorial #1: Running Models"," in the NetLogo\nUsers Manual.",[110,134,137],{"id":135,"className":136},"hubnet-architecture",[14],[16,138,141],{"className":139,"href":140},[19],"#hubnet-architecture","HubNet Architecture",[22,143,144],{},"HubNet simulations are based on a client/server architecture. The activity\nleader uses the NetLogo application to run a HubNet activity. When NetLogo is\nrunning a HubNet activity, we refer to it as a HubNet server. Participants use a\nclient application to log in and interact with the HubNet server.",[22,146,147],{},"While HubNet is only supported via the Java Desktop clients at the moment, we\nhope to add support for other types of clients such as tablets and phones in the\nfuture.",[102,149,152],{"id":150,"className":151},"computer-hubnet",[14],[16,153,76],{"className":154,"href":75},[19],[110,156,159],{"id":157,"className":158},"activities",[14],[16,160,163],{"className":161,"href":162},[19],"#activities","Activities",[22,165,166,167,45],{},"The following activities are available in the Models Library, in the HubNet\nActivities folder. Information on how to run the models and activities can be\nfound in the Info tab of each model. Additional discussion of educational goals\nand ways to incorporate many of the activities into your classroom in the\nParticipatory Simulations Guide on the\n",[16,168,44],{"href":41,"rel":169},[43],[62,171,172,175,178,181,184,187,190,193,196],{},[65,173,174],{},"Bug Hunters Camouflage - students hunt bugs and camouflaging emerges.",[65,176,177],{},"Dice Stalagmite HubNet - students roll dice and explore the space of dependent\nand independent events.",[65,179,180],{},"Disease - A disease spreads through the simulated population of students.",[65,182,183],{},"Disease Doctors - A slight modification to the Disease activity where some\nstudents can recover from the disease.",[65,185,186],{},"Gridlock - Students use traffic lights to control the flow of traffic through\na city.",[65,188,189],{},"Polling - Ask students questions and plot their answers.",[65,191,192],{},"Root Beer Game - An adaptation of a popular game created at MIT in the early\n1960s that shows how small delays in a distribution system can create big\nproblems.",[65,194,195],{},"Sampler - Students engage in statistical analysis as individuals and as a\nclassroom. Through these activities, students discover the meaning and use of\nbasic concepts in statistics.",[65,197,198],{},"Tragedy of the Commons - Students work as farmers sharing a common resource.",[110,200,203],{"id":201,"className":202},"clients",[14],[16,204,207],{"className":205,"href":206},[19],"#clients","Clients",[22,209,210],{},"To use the client application you simply need to launch the HubNet client\napplication that is bundled with NetLogo.",[110,212,215],{"id":213,"className":214},"requirements",[14],[16,216,219],{"className":217,"href":218},[19],"#requirements","Requirements",[22,221,222],{},"To use Computer HubNet, you need a networked computer with NetLogo installed for\nthe server. When using the client application you will also need a networked\ncomputer with NetLogo installed for each participant. When using in classroom\nsettings we also suggest an attached projector for the leader to project the\nentire simulation to the participants.",[110,224,227],{"id":225,"className":226},"starting-an-activity",[14],[16,228,231],{"className":229,"href":230},[19],"#starting-an-activity","Starting an activity",[22,233,234,235],{},"You’ll find the HubNet activities in NetLogo’s Models Library, in the HubNet\nActivities folder. We suggest doing a few practice runs of an activity before\ntrying it in front of a class. ",[236,237],"img",{"alt":238,"className":239,"src":241,"width":242,"height":243,"style":244},"hubnet/hubnetstartactivity.png",[240],"netlogo-image","/_content/images/hubnet/hubnetstartactivity.png",292,155,{"aspectRatio":245},"292/155",[22,247,248,249,253],{},"Open a Computer HubNet model. NetLogo will prompt you to enter the name of your\nnew HubNet session. This is the name that participants will use to identify this\nactivity. You may also see a broadcast network selection dropdown for which more\nextensive documentation is available\n",[16,250,252],{"href":251},"/faq#why-is-hubnet-discovery-not-working","in the FAQ",". For now, just enter\na name and press Start.",[22,255,256],{},"NetLogo will open the HubNet Control Center, which lets you interact with the\nHubNet server.",[22,258,259],{},"You, as the leader, should then notify everyone that they may join. To join the\nactivity, participants launch the HubNet Client application and enter their\nname. They should see your activity listed and can join your activity by\nselecting it and pressing Enter. If the activity you started is not listed the\nstudent can enter the server address manually which can be found in the HubNet\nControl Center.",[110,261,264],{"id":262,"className":263},"hubnet-control-center",[14],[16,265,268],{"className":266,"href":267},[19],"#hubnet-control-center","HubNet Control Center",[22,270,271],{},[236,272],{"alt":273,"className":274,"src":275,"width":276,"height":277,"style":278},"hubnet/hubnetcontrolcenter.png",[240],"/_content/images/hubnet/hubnetcontrolcenter.png",468,400,{"aspectRatio":279},"468/400",[22,281,282],{},"The HubNet Control Center lets you interact with the HubNet server. It displays\nthe name, activity, address and port number of your server. The “Mirror 2D View\non clients” checkbox controls whether the HubNet participants can see the view\non their clients, assuming there is a view in the client setup. The “Mirror\nplots on clients” checkbox controls whether participants will receive plot\ninformation.",[22,284,285],{},"The client list on the right displays the names of clients that are currently\nconnected to you activity. To remove a participant from the activity, select\ntheir name in the list and press the Kick button. To launch your own HubNet\nclient press the Local button, this is particularly useful when you are\ndebugging an activity. The “Reset” button kicks out all currently logged in\nclients and reloads the client interface.",[22,287,288],{},"The lower part of the Control Center displays messages when a participant joins\nor leaves the activity. To broadcast a message to all the participants, click on\nthe field at the bottom, type your message and press Broadcast Message.",[110,290,293],{"id":291,"className":292},"troubleshooting",[14],[16,294,297],{"className":295,"href":296},[19],"#troubleshooting","Troubleshooting",[52,299,302],{"id":300,"className":301},"i-started-a-hubnet-activity-but-when-participants-open-a-hubnet-client-my-activity-isnt-listed",[14],[16,303,306],{"className":304,"href":305},[19],"#i-started-a-hubnet-activity-but-when-participants-open-a-hubnet-client-my-activity-isnt-listed","I started a HubNet activity, but when participants open a HubNet Client, my activity isn’t listed.",[22,308,309],{},"On some networks, the HubNet Client cannot automatically detect a HubNet server.\nTell your participants to manually enter the server address and port of your\nHubNet server, which appear in the HubNet Control Center.",[22,311,312],{},"Note: The technical details on this are as follows. In order for the client to\ndetect the server, multicast routing must be available between them. Not all\nnetworks support multicast routing. In particular, networks that use the IPsec\nprotocol typically do not support multicast. The IPsec protocol is used on many\nVirtual Private Networks (VPNs).",[52,314,317],{"id":315,"className":316},"when-a-participant-tries-to-connect-to-an-activity-nothing-happens-the-client-appears-to-hang-or-gives-an-error-saying-that-no-server-was-found",[14],[16,318,321],{"className":319,"href":320},[19],"#when-a-participant-tries-to-connect-to-an-activity-nothing-happens-the-client-appears-to-hang-or-gives-an-error-saying-that-no-server-was-found","When a participant tries to connect to an activity, nothing happens (the client appears to hang or gives an error saying that no server was found).",[22,323,324],{},"If your computer or network has a firewall, it may be impeding the HubNet server\nfrom communicating. Make sure that your computer and network are not blocking\nports used by the HubNet server (ports 9173-9180).",[52,326,329],{"id":327,"className":328},"the-view-on-the-hubnet-client-is-gray",[14],[16,330,333],{"className":331,"href":332},[19],"#the-view-on-the-hubnet-client-is-gray","The view on the HubNet client is gray.",[62,335,336,339,342],{},[65,337,338],{},"Verify that the “Mirror 2D view on clients” checkbox in the HubNet Control\nCenter is selected.",[65,340,341],{},"Make sure that the display switch in the model is on.",[65,343,344],{},"If you have made changes to the size of the view on the server you may need to\npress the “Reset” button in the Control Center to ensure the clients get the\nnew size.",[52,346,349],{"id":347,"className":348},"there-is-no-view-on-the-hubnet-client",[14],[16,350,353],{"className":351,"href":352},[19],"#there-is-no-view-on-the-hubnet-client","There is no view on the HubNet client.",[22,355,356],{},"Some activities don’t have a view on the client. If you want to add a view\nsimply select “HubNet Client Editor” from the Tools Menu and add a view like any\nother widget. Make sure to press the “Reset” button before having clients log\nin.",[52,358,361],{"id":359,"className":360},"i-cant-quit-a-hubnet-client",[14],[16,362,365],{"className":363,"href":364},[19],"#i-cant-quit-a-hubnet-client","I can’t quit a HubNet client.",[22,367,368],{},"You will have to force the client to quit. On OS X, force quit the application\nby selecting Force Quit… in the Apple menu. On Windows, press Ctrl-Alt-Delete\nto open the Task Manager, select HubNet Client and press End Task.",[52,370,373],{"id":371,"className":372},"my-computer-went-to-sleep-while-running-a-hubnet-activity-when-i-woke-the-computer-up-i-got-an-error-and-hubnet-wouldnt-work-anymore",[14],[16,374,377],{"className":375,"href":376},[19],"#my-computer-went-to-sleep-while-running-a-hubnet-activity-when-i-woke-the-computer-up-i-got-an-error-and-hubnet-wouldnt-work-anymore","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.",[22,379,380],{},"The HubNet server may stop working if the computer goes to sleep. If this\nhappens, quit the NetLogo application and start over. Change the settings on\nyour computer so it won’t sleep again.",[52,382,385],{"id":383,"className":384},"my-problem-is-not-addressed-on-this-page",[14],[16,386,389],{"className":387,"href":388},[19],"#my-problem-is-not-addressed-on-this-page","My problem is not addressed on this page.",[22,391,392,393,45],{},"See ",[16,394,396],{"href":395},"/contact","Contacting Us",[110,398,401],{"id":399,"className":400},"known-limitations",[14],[16,402,405],{"className":403,"href":404},[19],"#known-limitations","Known Limitations",[22,407,408,409,45],{},"If HubNet malfunctions, see the bug reporting information at\n",[16,410,396],{"href":395},[22,412,413],{},"Please note that:",[62,415,416,419,422,425,428,431,434],{},[65,417,418],{},"HubNet has not yet been extensively tested with large numbers of clients (i.e.\nmore than about 25). Unexpected results may occur with more clients.",[65,420,421],{},"Out-of-memory conditions are not handled gracefully",[65,423,424],{},"Sending large amounts of plotting messages to the clients can take a long\ntime.",[65,426,427],{},"NetLogo does not handle malicious clients in a robust manner (in other words,\nit is likely vulnerable to denial-of-service type attacks).",[65,429,430],{},"Performance does not degrade gracefully over slow or unreliable network\nconnections.",[65,432,433],{},"If you are on a wireless network or sub-LAN, the IP address in the HubNet\nControl Center is not always the entire IP address of the server.",[65,435,436],{},"Computer HubNet has only been tested on LANs, and not on dial-up connections\nor WANs.",[102,438,441],{"id":439,"className":440},"teacher-workshops",[14],[16,442,82],{"className":443,"href":81},[19],[22,445,446,447,45],{},"For information on upcoming workshops and NetLogo and HubNet use in the\nclassroom, please ",[16,448,449],{"href":395},"contact us",[102,451,454],{"id":452,"className":453},"hubnet-authoring-guide",[14],[16,455,88],{"className":456,"href":87},[19],[22,458,459,460,45],{},"To learn about authoring or modifying HubNet activities, see the\n",[16,461,88],{"href":462},"/hubnet-authoring",[102,464,467],{"id":465,"className":466},"running-hubnet-in-headless-mode",[14],[16,468,94],{"className":469,"href":93},[19],[22,471,472,473,45],{},"To learn about running HubNet activities from the command line, with no GUI on\nthe server, see the HubNet section in the ",[16,474,476],{"href":475},"controlling","Controlling Guide",[102,478,481],{"id":479,"className":480},"getting-help",[14],[16,482,100],{"className":483,"href":99},[19],[22,485,486,487,45],{},"If you have any questions about HubNet or need help getting started,\n",[16,488,449],{"href":395},{"title":490,"searchDepth":491,"depth":492,"links":493},"",5,3,[494,496,501,518,519,520,521],{"id":54,"depth":495,"text":60},4,{"id":104,"depth":497,"text":70,"children":498},2,[499,500],{"id":112,"depth":492,"text":118},{"id":135,"depth":492,"text":141},{"id":150,"depth":497,"text":76,"children":502},[503,504,505,506,507,508,517],{"id":157,"depth":492,"text":163},{"id":201,"depth":492,"text":207},{"id":213,"depth":492,"text":219},{"id":225,"depth":492,"text":231},{"id":262,"depth":492,"text":268},{"id":291,"depth":492,"text":297,"children":509},[510,511,512,513,514,515,516],{"id":300,"depth":495,"text":306},{"id":315,"depth":495,"text":321},{"id":327,"depth":495,"text":333},{"id":347,"depth":495,"text":353},{"id":359,"depth":495,"text":365},{"id":371,"depth":495,"text":377},{"id":383,"depth":495,"text":389},{"id":399,"depth":492,"text":405},{"id":439,"depth":497,"text":82},{"id":452,"depth":497,"text":88},{"id":465,"depth":497,"text":94},{"id":479,"depth":497,"text":100},"HubNet is a technology that lets you use NetLogo to run participatory simulations in the classroom where multiple users can interact with the model.","md",{"source":525,"metadataOutputPath":526,"projectConfig":527,"language":534,"inheritFrom":543,"output":542,"version":528,"keywords":544,"tags":548,"icon":549,"assetsRoot":550},"autogen/hubnet.md","content/hubnet.metadata.yaml",{"version":528,"projectRoot":45,"scanRoot":529,"outputRoot":530,"defaults":531,"engine":537,"partials":538,"dedupeIdenticalDiskWrites":542},"7.0.4","autogen","content",{"inheritFrom":532,"language":534,"output":535,"extension":523,"title":536,"version":528},[533],0,"en",false,"NetLogo User Manual","handlebars",{"directoryPaths":539,"extensions":540},[45],[541,523],"mustache",true,[533],[5,545,546,547,118],"Multi-user","Participatory Simulations","Networking",[5,545,546,547],"i-lucide-network","/home/runner/work/Helio/Helio/apps/docs/autogen","/hubnet",{"title":5,"description":522},"f5lFwnDsjDhwYq301mdU-rxXjg3qTZMN_yOkQLG1IF8",[555,560],{"title":556,"path":557,"stem":558,"description":559},"Cluster Computing (HPC)","/hpc","hpc","An advanced guide on running NetLogo BehaviorSpace experiments on High-Performance Computing (HPC) clusters using Slurm job scheduler.",{"title":88,"path":462,"stem":561,"description":562},"hubnet-authoring","Guide to creating HubNet activities that allow multiple users to participate in NetLogo simulations using networked devices.",1777657789264]