Frequently Asked Questions



1. Downloading Starlogo

StarLogo won't run on my Mac. What should I do?

Make sure you have the latest version of Apple's Macintosh Runtime for Java (2.2). You can download it here.

StarLogo still won't run on my machine. What should I do?

Send an email to bug-starlogo@media.mit.edu and provide details of your configuration and what you've tried to do to make it work.

I've been having trouble downloading StarLogo from your web site. What should I do?

You should try using our ftp site if you have been having trouble downloading from our website. You can ftp to chelona.media.mit.edu The username is sldist and the password (case sensitive) is MrSabb StarLogo is in /pub/starlogo.

Return to Top
2. Running Projects

Why doesn't project X from my old MacStarLogo run anymore?

StarLogo is similar in many ways to MacStarLogo. However, it stores projects in its own unique format. In addition, there are language differences between StarLogo and MacStarLogo that prevent projects from being saved in one program and run by the other. If you would like to translate a MacStarLogo project for use in StarLogo, open it in StarLogo (or a text editor). Some changes will be necessary before it will run. Consult the StarLogo documentation to find out more about how to create projects in StarLogo. If you are having difficulty translating your projects into StarLogo, you can email bug-starlogo@media.mit.edu with questions.

I would like to use sound with my projects. Where can I find a sample project which demonstrates how to do this?

Sounds have been disabled in this release of StarLogo due to the non-standard implementation of Java on different operating systems.

I'm trying to figure out the Import Picture... menu item/command. Can you tell me more about how it works?

In order for Import Picture... to work, you need to have installed a current version of QuickTime (QuickTime for Java) on your computer before you installed StarLogo. (The menu item will not be displayed if QuickTime is not found.) You can download QuickTime from http://www.apple.com/quicktime/download. Import Picture... will load pictures of many types (such as GIF, JPEG, PICT, and others) onto the Graphics Canvas. The picture's colors will be transferred into the patches' colors. (Warning: Do not load very large pictures into StarLogo, or it will run out of memory.)

How can I run a StarLogo project on a web page?

When you are ready to save your desired project, choose "Save Project as Web Page" from the File menu. You will first be prompted to save the StarLogo version of this project (a .slogo file) and then to choose a name for the .html file. To allow the applet to be run over the web, place a copy of this starlogo.jar, your project (.slogo) file, and your web page (.html) file all in the same directory (we recommend that when you FTP this to your website that you choose a binary file transfer), and then load the .html file into your browser. On a Mac, the starlogo.jar file can be found in the StarLogo folder. Windows users can find it inside the Internal StarLogo files folder. We have confirmed that this applet will run on PCs using Internet Explorer and Netscape. If you don't have the Java plug-in for Netscape, your browser will prompt you to download it when you try to load the applet. If you're using a Mac, you will need to use Internet Explorer and MRJ 2.2.5 or later (Note: At the time of this writing MRJ 2.2.5 was not currently available, but should be soon. Please check the Apple web site http://www.apple.com/java/).

What are valid names for buttons?

When you bring up a Button Dialog to create a new button, the "Name" field can be filled with any string of characters. If you have spaces (" ") in this name, they are converted to the dash character ("-") internally. This has two implications. First, it means that you can allow a procedure to call a button by naming it and a procedure and stop a button by prepending the word "stop" to the button name. For example,

to go
myfirstbutton ;the "Name" field of this button contains the string
"myfirstbutton"
startmy-second-button ;the "Name" field of this button contains the string
"my second button"
stopmyfirstbutton
end

The second implication is that you can create naming conflicts between buttons and procedures. For example, if you have a procedure named "graph-it" and a button whose "Name" field is "graph it", the button's name is internally represented as "graph-it" and a name collision occurs. The fix is to change the name of either the button or the procedure.

How do I resize the graphics canvas?

If you click in the white area of the StarLogo window, and then drag your mouse over the black graphics canvas, the canvas should become selected (little black squares will appear at the corners, and some sizing information will appear on the grey toolbar at the top). You can use the black squares to resize the canvas (click and drag), and you use the slider which appears in the toolbar to change the size of the patches.

I'm having trouble opening StarLogo files over a network. What's wrong?

If you have StarLogo 1.2 installed on your local computer and try to double-click a project stored on a computer over the network, StarLogo will try to load a file with a UNC path (UNC paths are path names of the form \\server.name.edu\somedirectory\myfile.slogo). However, UNC paths are not completely supported by Windows, so if you try this StarLogo will give you an error message that the file is not readable. Opening the StarLogo application locally from your Start Menu and then choosing "Open File..." from within StarLogo will allow you to access the network file without a problem.

Return to Top
3. Macintosh Information

I have a Macintosh. Which version should I use?

StarLogo requires Mac OS 8.1 or higher, while MacStarLogo will run on a Mac IIfx or better running Mac OS 7.5 or higher and with at least 256 colors. The features of the two programs are slightly different, so you might want to try StarLogo before making a final decision. For more information, see the Notes section.

I still want to use MacStarLogo.  Where can I find information on it?

The MacStarLogo website has moved to http://www.media.mit.edu/macstarlogo

Return to Top
4. Other

I've read about several other StarLogo projects from Mitchel Resnick's book Turtles, Termites, and Traffic Jams but I can't get any of the code in his book to run in StarLogo. What should I do?

If you are planning on using code from Professor Resnick's book, it will require several modifications in order to run under StarLogo. In particular, you will need to separate his procedures into separate observer and turtle procedures, in much the same way as you would have to if you were porting a project from MacStarLogo to StarLogo. Also, the daemons (demons) in Professor Resnick's book no longer exist; they have been replaced by forever buttons. Consult the StarLogo documentation to find out more about how to create projects in StarLogo.

What other StarLogo-type programs exist and where can I find them?

StarLogoT has been developed at Tufts University and Northwestern University. StarLogoT was built on top of MIT's MacStarLogo, adding some new capabilities and interface features.

NetLogo is a multiplatform complexity modeling and simulation environment that shares many features with StarLogo.

Agentsheets is a commercial product that lets end-users build a wide range of applications that include interactive simulations, games, and intelligent web agents through a graphical user interface.

For more advanced research applications you can also check out Swarm, Ascape, and Repast.

Return to Top
5. Known Bugs

StarLogo has been known to freeze if a project is left running and your screensaver comes on. If you want to run a project for an extended period of time, it would be safest if you turned your screensaver off first.

Return to Top

Commands | Projects | FAQ | Info