Guides‎ > ‎

Behaviour Composer direct to NetLogo guide

This is the guide for the version of BC2NetLogo that works with NetLogo 6.0. Click for the guide for the version compatible with NetLogo 5.3.1

The BC2NetLogo program enables one to build models in the Behaviour Composer and to run them in NetLogo. It speeds up and automates the process of sending the model from the browser to the NetLogo program. 

How to download and install BC2NetLogo

Download and unzip these files then click on BC2NetLogo.jar inside the BC2NetLogo folder after unzippingSee these instructions if you previously installed BC2NetLogo.

This program requires that Java has been installed. If you have problems launching it visit java.com to download the latest Java.

Some Mac users have reported problems due to security settings. See these instructions if your Mac installation isn't working. 

If you get an error such as installation is missing required file then most likely it is because your operating system is displaying the contents of the zip file but the files have not yet been extracted from the zip archive. To fix this, copy the BC2NetLogo folder to anywhere on your computer. If you get an error such as windows doesn't know how to open this file then you need to install Java 8 (or higher) from java.com.

Launching

Just click (or double-click) on the BC2NetLogo file inside the BC2NetLogo folder (Windows users should click on the BAT file, others the JAR file).   To launch the 3D version on Windows click on the BC2NetLogo3D.bat script. To use 3D on Macs and Linux we recommend you download the latest NetLogo and run NetLogo 3D and download NLOGO3D files from the Behaviour Composer.

Adding custom parameters to the launch

Click on SetOptions.jar to alter
  • Model ID -- can be a URL with a 'frozen=' parameter or just the value of that parameter. The URL can be obtained from the Share tab.
  • Session ID -- can be a session URL with a 'share=' parameter or just the value of that parameter or the word 'new' to indicate a new session is desired.
  • User ID -- can be a session URL with a 'user=' parameter or just the value of that parameter or the word 'new' to indicate a new user identity is desired.
  • Extra parameters -- any other URL parameters accepted by the Behaviour Composer. E.g. 'tab=' to start with a tab already opened to a URL.
  • Server -- useful if running another instance of the Behaviour Composer, e.g. on localhost when no internet access is available.
  • Installation folder -- where the BC2NetLogo software is located. "." is a valid option which means the folder where BC2NetLogo is installed.
  • Translation tick box -- click to launch a version that is translated on the fly by Google Translate.

Usage

You should see NetLogo being launched and a web page being opened.  Create your model in the browser as usual. Instead of the Run and Download tabs you'll see a Send model to NetLogo tab. When you click on that your model will be assembled and loaded automatically into NetLogo.

Managing multiple models

You can switch between as many models as you like using the My Models tab. We recommend you give descriptions to the models you are working on and click the hide check box of those you aren't.  Next time you launch BC2NetLogo it will begin with the last model you worked on.

If you want to use a model that you have the URL of (either a frozen model or one that recreates the session perhaps copied from an earlier use of  BC2NetLogo) then paste the URL in the first line of the Code tab in BC2NetLogo and then click 'Send model to NetLogo'.

Removing History now and then

BC2NetLogo reconstructs your session when it loads. This provides a history that you can inspect and move back and forth through versions. But the longer the history the more time it takes to load. We recommend that now and then you click on Settings and Reload without history.

How to access images and data so the code runs in both BC2NetLogo and Java applets

NetLogo commands such as import-drawing should use the path "NetLogoData" in order to work in both applets and BC2NetLogo. If, for example, you wanted to use the file 'world.png' then import-drawing "NetLogoData/world.png" will work in the applet. You should put world.png in the NetLogoData that was part of the BC2NetLogo zip file. You should also send it to info@modelling4all.org in order for it to be copied to the server so applets can access the file. If you aren't concerned with compatibility with Java applets then you can place images and data files anywhere.

Using the BehaviorSpace tool

The BC2NetLogo tool stores any experiments created with the BehaviourSpace tool so that experiments are not lost when the model is updated.

How to bring a model into BC2NetLogo

There are two ways to import a model:
  1. Paste the Model ID into the model section of the settings of the BC2NetLogo installer/launcher.
  2. Paste the 'frozen' model URL into the 'Import Prototypes' button in the Composer tab.

How to send edits made in NetLogo to the Behaviour Composer

Warning: experimental feature. You can edit the code and the user interface widgets and then when you send a model from BC2NetLogo the system will attempt to copy your edits to your current Behaviour Composer model.

Advantages over running Java applets

  1. No security warnings (Java applets aren't considered secure these days)
  2. Faster execution
  3. Faster loading
  4. Clearer error messages
  5. Agent and patch inspector
  6. Easier to debug
  7. Local file I/O
  8. 3D views and 3D NetLogo
  9. NetLogo tools such as BehaviorSpace
  10. NetLogo logging is available
  11. Easier transition to NetLogo programming

Installing on top of an old installation

If you have previously installed BC2NetLogo we recommend you extract these files to the current BC2NetLogo folder. Click on SetOptions to ensure that the "Server" field is set to http://798-dot-m4a-gae-hrd.appspot.com

If you choose to use a different folder for this installation then reset the 'folder' option in the settings dialogue after start BC2NetLogo. If you unable to install Java version 8 or you encounter errors with the new release try the previous release which can run under Java 7

Mac trouble shooting

If you have administrator rights try clicking on the BC2NetLogo.jar file while holding down the control button and then allow it to run. Mac users may need to run the previous release. The previous version generates annoying but harmless warnings. 
Comments