Revision as of 18:09, 6 December 2009

You are here: PTP > Photran > Builds/Downloads

Photran 5.0.0 Builds/Downloads

This page contains prerelease builds of Photran 5.0.0. It is recommended that you install the latest build.

Note that Photran 5.0 only works with Eclipse 3.5 (Galileo) and CDT 6.0.

Installation Instructions

Updated installation instructions are available in the Photran User's Guide.

System Requirements

To install Photran 5.0...

You must have Eclipse 3.5 (Galileo) installed.

1. You should have the C/C++ Development Tools (CDT) 6.0 installed. If you do not, they will be installed automatically when you install Photran.
2. Eclipse must be running on a Java 1.5 or later Java Virtual Machine (JVM). To get reasonable performance, we recommend Sun's JVM [1] or IBM's [2]. OpenJDK (the default JVM on newer versions Fedora Linux) also works well, although GNU Classpath (the default JVM on older versions of Fedora) is generally too slow to be useful.
3. If you want to compile and build Fortran applications, you must have a make utility (such as GNU Make) and a Fortran compiler (such as GNU Fortran) in your system path. Many Linux/Unix systems include these; details on installing them in Windows and Mac are below.

Installation Procedure

To install Photran, start Eclipse, then...

1. Download the latest Photran zip file from [3]
2. Click on Help > Install New Software...
3. Click on the "Add..." button
4. Click on the "Archive..." button
5. Choose the zip file you downloaded from [4]
6. Click OK to close the Add Site dialog. This will return you to the Install dialog.
7. Expand "Photran (Fortran Development Tools)" and check the boxes next to "Photran End-User Runtime" and "Rephraser Engine End-User Runtime" (the latter is a supporting component)
8. If you are running Linux and have the Intel Fortran Compiler installed, or if you are on a Macintosh and have the IBM XL Fortran compiler installed, expand "Fortran Compiler Support" and select the appropriate compiler.
9. Click on the "Next" button
10. If you get an error message, see below for troubleshooting information.
11. Click the Finish button and agree to the license to complete the installation.

Troubleshooting

The installer in Eclipse 3.5 gives notoriously cryptic error messages, which, unfortunately, are out of Photran's control. Some of the more common ones are below. If you run into a different error message and cannot resolve it, please ask for help on the Photran mailing list.

Problem: You receive the following error message during installation.

Cannot complete the install because one or more required items could not be found.

Missing requirement: 125xxxxxxxxxx 0.0.0.125xxxxxxxxxx requires 'org.eclipse.photran.intel.feature.group [5.0.0.xxxx]' but it could not be found

Solution: You are attempting to install support for the Intel Fortran compiler, but you are not running Linux. Go back in the installation wizard, and uncheck "Linux Intel(R) Fortran Compiler Support.

Problem: You receive the following error message during installation.

Cannot complete the install because one or more required items could not be found.

Software being installed: Photran End-User Runtime 5.0.0.xxxx (org.eclipse.photran.feature.group 5.0.0.xxxx)

Missing requirement: Photran End-User Runtime 5.0.0.xxxx (org.eclipse.photran.feature.group 5.0.0.xxxx) requires 'org.eclipse.cdt.feature.group [xxx)' but it could not be found

Solution: You do not have CDT 6.0 installed, and it couldn't be downloaded and installed automatically. Try installing CDT 6.0 first, then retry installing Photran.

Additional Instructions for Windows Users

To compile and run Fortran programs in Photran, you will need to have a Fortran compiler and make utility installed. gfortran and GNU Make are commonly used (and free). Most Linux/Unix distributions include these. Under Windows, you will need to install Cygwin [5] (which optionally includes gfortran and GNU Make) or MinGW [6] and put them on your Windows PATH.

Instructions for Cygwin

1. Install Cygwin; the defaults are mostly OK, but you will need to explicitly tell it to include the "Devel" packages (at least gcc4-fortran, gdb, and make) when the installer asks you to select what packages to install. (If gcc4-fortran is not listed under the "Devel" packages, you may have chosen a bad mirror; restart the Cygwin installation, and choose a different mirror instead. Georgia Tech's mirror at gtlib.gatech.edu is generally quite fast and reliable, for example.)
2. Add the Cygwin directories to your Windows PATH. Under Windows XP, the process is as follows:
   1. Make sure you are logged in under an administrator account.
   2. Open the Control Panel.
   3. Double-click the System icon.
   4. Switch to the Advanced tab.
   5. Click the Environment Variables button.
   6. Under System Variables, find the variable "Path" in the list, and click on it.
   7. Click Edit.
   8. At the end of the "Variable Value" text, add

      ;C:\Cygwin\bin;C:\Cygwin\usr\bin;C:\Cygwin\usr\local\bin;C:\Cygwin\lib;C:\Cygwin\usr\lib

   9. Click OK, click OK, click OK, and close the Control Panel.
   10. Close and re-open Photran. Windows should now search C:\Cygwin\bin, C:\Cygwin\usr\bin, etc. when it's looking for executables (including make.exe, gcc.exe, and gfortran.exe).

Additional Instructions for Mac OS X Users

If you install gfortran on Mac OS X, it may be installed in /usr/local/bin, which is not (by default) on the PATH. If you are launching Eclipse from a Terminal, the PATH can be set by modifying /etc/paths. However, if you are launching Eclipse from the Finder (by double clicking on it) or the Dock, then the PATH is not obtained from the shell or /etc/paths. Instead, it's obtained from ~/.MacOSX/environment.plist. The format of the environment.plist file is as follows (change the path appropriately). If you create or edit this file, you will need to log out (or reboot) before the changes will take effect.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>PATH</key>
    <string>/usr/local/mpi/bin:/usr/local/bin:/bin:/sbin:/usr/bin:/usr/sbin:/sbin:/usr/sbin:/Developer/Tools:/usr/texbin:/Users/greg/bin</string>
</dict>
</plist>