-
Notifications
You must be signed in to change notification settings - Fork 37
Running iDynoMiCS
Warning: this is a work in progress! It is not exhaustive and anything you read here you should check before believing.
The package download is of human-readable .java files and not the computer-readable .class files required to actually run iDynoMiCS. To produce the .class files there are two ways:
The easiest is to use Eclipse, which is the program we recommend to those who wish to develop iDynoMiCS. First import iDynoMiCS into Eclipse via File > Import > General > Existing Projects into Workspace and select the iDyonMiCS directory as the root directory of the project. Next check that that the build path is correct: right-click on the iDynoMiCS project on the left-hand side of the screen and choose properties. In Java Build Path > Libraries the 5 jar files from iDynoMiCS/src/lib should be listed along with the JRE System Library. If they're not there, then click Add JARs... and select them from iDynoMiCS/src/lib.
The next step is to build iDynoMiCS from within Eclipse. This can be done automatically as iDynoMiCS is run: Run > Run or the green button with a white arrow. If Eclipse asks for settings, choose a Java Application (not Applet) and idyno.Idynomics as the main class.
If you don't want to use Eclipse then Ant is an easy alternative. To check you have Ant, open a Command Window (Windows) or Terminal (Mac/Linux) and type ant -version. The response should be something like
Apache Ant(TM) version 1.8.2 compiled on June 20 2012. If it's not, or you want to update Ant, download the latest version of Ant from here.
To compile iDynoMiCS using Ant, change the curent working directory of your Command Window/Terminal to the iDynoMiCS directory and simply type
ant
Ant will use the build.xml file to compile all the .java files into the directory iDynoMiCS/bin.
RunIdyno.py is the best-maintained script for running iDynoMiCS and so the one we recommend. Most operating systems will come with Python already installed. To check whether yours does, and which version you have, open a Command Window (Windows) or Terminal (Mac/Linux) and type
python --version
The response should be something like
Python 2.7.3
If it's not, or you want to update Python, download the latest version of Python 2 from here.