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.
Download and unzip these files then click on BC2NetLogo.jar inside the BC2NetLogo folder after unzipping. See 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.
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.
Click on SetOptions.jar to alter
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.
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'.
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.
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
The BC2NetLogo tool stores any experiments created with the BehaviourSpace tool so that experiments are not lost when the model is updated.
There are two ways to import a model:
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.
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.
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.