Difference between revisions of "Using Eclipse / Mojave"

From Einstein Toolkit Documentation
Jump to: navigation, search
(Building with Mojave)
Line 8: Line 8:
 
* Click on Help > Install New Software ...
 
* Click on Help > Install New Software ...
 
* Click on the Add tab, a dialogue will appear
 
* Click on the Add tab, a dialogue will appear
* In the dialogue, put "Mojave" for the name, and "http://stevenrbrandt.com/Mojave-Update/" for the location.
+
* In the dialogue, put "Mojave" for the name, and "http://mojave.cct.lsu.edu/Mojave-Update/" for the location.
 
* The dialogue below will create a checkbox next to Mojave. Click next to continue the install.
 
* The dialogue below will create a checkbox next to Mojave. Click next to continue the install.
 
* Please make sure that your system also has perl, python, git, and subversion installed as well.
 
* Please make sure that your system also has perl, python, git, and subversion installed as well.
Line 29: Line 29:
 
Installing from the web creates a completely new Cactus installation within the Eclipse workspace.
 
Installing from the web creates a completely new Cactus installation within the Eclipse workspace.
  
* Click File > Project > New Mojave Project
+
* Click File > Project > Fortran
* Select the radio button for installing from the web
+
* Assign a project name and pick a project type (Makefile project is recommended). Click next.
* On the next page of the wizard, fill in your email address (for configuration of SimFactory), a project name, and the location of a thornlist. By default, einsteintoolkit.th will be loaded. This is a big project and will take time to download.
+
* On the next screen you are asked to select configurations. Click next.
 +
* The next screen you may see is "Test page". If you see it, ignore it and click next.
 +
* The next screen you will see is the "New Mojave Project" page.
 +
* You can either select an existing (i.e. Disk project), or load Cactus from the web (download project). A regular project is simply a Fortran project with no Cactus affiliation.
 +
* Regardless of your choice of installation type, filling in the requisite form fields with valid values should enable the "Finish" button.
  
 
[[Image:MojaveInstall.png|300px]]
 
[[Image:MojaveInstall.png|300px]]
Line 46: Line 50:
 
==Building with Mojave==
 
==Building with Mojave==
  
* Right click on your project name in the package explorer and select properties. Select Mojave. This dialogue will allow you to configure your thornlist, par file, which host you want to compile on, and what options you want.
+
* A new button named "Mojave" should be present on your toolbar.
* Every time you modify a source file, it becomes possible to build.
+
* For each Cactus project you will have the option to "Edit Variables..." or perform an action such as "Build", "Clean Build", "Remote Build".
* Building is triggered from Projects > Build Project.
+
* Editing variables changes the behavior of the other options. The variables control which thornlist you are using, which remote machine, etc.
* When building, errors and warnings generated by the compiler will appear in the "Console" window. These messages will be hyperlinked to the source code, enabling you to quickly navigate.
+
* If the existing set of options is not to your liking, you can edit the .mojave.xml file located in the root of the Cactus install. You can add new variable types and commands to suit your needs.
* Note: The cancel button does not always stop a compile instantly. It sends a kill, closes streams, then reclaims outstanding characters in the input buffer.
 
 
 
==Things that don't work yet==
 
 
 
* The run button does not currently launch Cactus jobs.
 
* Mojave does not work on Windows.
 

Revision as of 18:10, 24 March 2011

Installing Eclipse

  • Go to http://www.eclipse.org/downloads/, select the Eclipse IDE for C/C++ developers. Select the relevant operating system and download, then untar / unzip. That is all there is the installation.
  • To run eclipse, simply start the binary. Eclipse typically requires a "workspace" to manage its projects. It will prompt you for the creation of this directory when you first start the program.

Installing Mojave

  • Click on Help > Install New Software ...
  • Click on the Add tab, a dialogue will appear
  • In the dialogue, put "Mojave" for the name, and "http://mojave.cct.lsu.edu/Mojave-Update/" for the location.
  • The dialogue below will create a checkbox next to Mojave. Click next to continue the install.
  • Please make sure that your system also has perl, python, git, and subversion installed as well.
  • If you wish to build locally, you will also need gcc, g++, gfortran (or equivalent compilers), and make.

Installing Photran

  • Click on Help > Install New Software ...
  • Click on the Add tab, a dialogue will appear
  • In the dialogue, put "PTP" for the name, and "http://download.eclipse.org/tools/ptp/updates/helios" for the location.
  • Type the word "Photran" in the filter text box.
  • Select all checkboxes, and click next to continue the install.

Creating a Mojave Project in Eclipse

To use Mojave you first need to create a Cactus project. These projects can either come from the web, or you can use an existing installation on disk.

To install from the web

Installing from the web creates a completely new Cactus installation within the Eclipse workspace.

  • Click File > Project > Fortran
  • Assign a project name and pick a project type (Makefile project is recommended). Click next.
  • On the next screen you are asked to select configurations. Click next.
  • The next screen you may see is "Test page". If you see it, ignore it and click next.
  • The next screen you will see is the "New Mojave Project" page.
  • You can either select an existing (i.e. Disk project), or load Cactus from the web (download project). A regular project is simply a Fortran project with no Cactus affiliation.
  • Regardless of your choice of installation type, filling in the requisite form fields with valid values should enable the "Finish" button.

MojaveInstall.png

To use an existing install

This install creates links from within the Eclipse workspace to another location. It will not overwrite any files. Deleting an installation (even if you check delete project contents) of this type will leave all linked directories unharmed.

  • Click File > Project > New Mojave Project
  • Select the radio button for using an existing install
  • On the wizard, select an Eclipse project name and browse to the existing install.
  • Note that Mojave expects the Python version of SimFactory.

Building with Mojave

  • A new button named "Mojave" should be present on your toolbar.
  • For each Cactus project you will have the option to "Edit Variables..." or perform an action such as "Build", "Clean Build", "Remote Build".
  • Editing variables changes the behavior of the other options. The variables control which thornlist you are using, which remote machine, etc.
  • If the existing set of options is not to your liking, you can edit the .mojave.xml file located in the root of the Cactus install. You can add new variable types and commands to suit your needs.