Difference between revisions of "Using Eclipse / Mojave"

From Einstein Toolkit Documentation
Jump to: navigation, search
(Installing Photran)
 
(4 intermediate revisions by 3 users not shown)
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 20: Line 20:
 
* Type the word "Photran" in the filter text box.
 
* Type the word "Photran" in the filter text box.
 
* Select all checkboxes, and click next to continue the install.
 
* Select all checkboxes, and click next to continue the install.
 +
* If this does not work, you can try "http://download.eclipse.org/releases/juno" instead of "http://download.eclipse.org/tools/ptp/updates/helios" and filter for "Photran"
  
 
==Creating a Mojave Project in Eclipse==
 
==Creating a Mojave Project in Eclipse==
Line 25: Line 26:
 
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 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===
+
===To install===
  
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. An on disk install makes use of a previous installation.
  
* 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]]
 
===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==
 
==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.
 

Latest revision as of 04:42, 20 March 2013

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

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

Installing from the web creates a completely new Cactus installation within the Eclipse workspace. An on disk install makes use of a previous installation.

  • 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

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.