Docs > Ikaros on OS X
Ikaros works well under OS X (and other Unix-like systems). These are the OS X specific instructions on how to build Ikaros and how to add a module to the system.
Building Ikaros is very easy. You need to perform three steps:
To run Ikaros you can either run it directly from XCode or use the Terminal application.
The ikaros control file can be changed by specifying a new "Argument" in the IKAROS Info window. The Info window is opened by selecting "IKAROS" under "Executables" in Groups & Files and choosing "Get Info" in the File-menu. It is best to use a reliative path to the ikc file here, for example: "../Examples/web_ui_objects.ikc", since this allows the project to be moved around.
In XCode, press the "Run" button to start Ikaros. Ikaros will run the WebUI Demo and will start up with that file and wait for a web browser to connect to port 127.0.0.1:8000. Enter this URL into FireFox or WebKit (Safari 2.0 does not support SVG). This will show a start-up page in the browser from which the different views can be selected.
At the shell prompt write the following:
> ikaros experimentfile.ikc
Here, "experimentfile.ikc" is the path to the experiment you want to run. You must set up your search path so that it includes the directory with the Ikaros binaries. This is usually the directory IKAROS.1.0.0/Bin. Command line options can also be specified here.
Note that the Ikaros binary must be placed at the correct location relative to the Source directory. If you move the binary from the Ikaros/Bin directory or set up your path so that Ikaros/Bin in in your search path, you need to change IKAROSPATH in IKAROS_System.h to point to the absolute location of the Ikaros directory.
While quite easy to add another module to the simulator it does involve a few steps. The idea is to create a new folder to hold the module, add the folder to the project, add a bit of documentation (you will thank yourself for doing this), and tell the system to add the module to the Ikaros.
An example on how to write an IKAROS module can be found here.
Apple OS X
http://www.apple.com/
OS X 10.4.9
XCode
http://developer.apple.com/
XCode 2.4.1
Ikaros
http://www.ikaros-project.org/
Ikaros 1.0
A combined installer for libjpeg and libpng is available here.
libpng.org
http://www.libpng.org/
libpng v1.2.17
Independent JPEG Group
http://www.ijg.org/
libjpeg 6b
Copyright © 2001-2007 Christian Balkenius