NOTE: The contents of this page are obsolete. Please see [[http://blake.bcm.edu/emanwiki/EMAN2/Install/BinaryInstall?action=edit&line=13]] for installation instructions.

= EMAN2 Mac OS X Visual Install Guide =

This guide is intended for users who are new to the UNIX shell environment.

= 1. Copy the "EMAN2" folder to Applications =

{{attachment:eman2install1.png}}

= 2. Configure shell environment =

EMAN2 needs to be added to some shell environment variables (PATH, PYTHONPATH, etc.) to run. The "bash" shell is the default on Mac OS X, so we will add EMAN2's init script to bash's ".profile" file in your home directory. Add this line to your ".profile" file.

{{{test -r /Applications/EMAN2/eman2.bashrc && source /Applications/EMAN2/eman2.bashrc}}}

One easy way to open your ".profile" file for editing is with the following command:

{{{touch ~/.profile; open -e ~/.profile}}}

This will create the file if it doesn't exist, and open it in your default text editor. Add the EMAN2 init line and save the file.

{{attachment:eman2install2.png}}

This only needs to be done once. If you download a newer version of EMAN2, you can skip this step. Also, if you run an alternative shell, such as tcsh, see notes below.

'''IMPORTANT NOTE:''' If you already have a file called .bash_profile or .bash_login in your home directory, those files will be used in preference to .profile, and .profile may never get read. If you have one of these files, you should add the statement above to that file instead of .profile.

= 3. Run EMAN2 =

Restart your terminal program for a fresh shell. EMAN2 should now be installed and function properly.

You can check that your EMAN2 installation is working by running:
 * e2version.py
 * e2speedtest.py
 * e2display.py (you will need to click on the rocket-ship that appears in your dock to bring the window to the front)

If anything doesn't work as it should, please provide the full output of e2version.py (even if it's an error) with your help request.

To run EMAN2's graphical project interface, "cd" to a data directory and run "e2projectmanager.py"

= Notes =

== If you get a 'Bad Interpreter' error ==
It is probably due to Mountain Lion's new quarantining process. You can try this:

{{{
xattr -dr com.apple.quarantine /Applications/EMAN2
}}}

Alternatively, you may have installed the wrong EMAN2 package for your operating system. Due to different Python versions, make sure you use the correct Mac OS X 10.6 build, or the Mac OS X 10.7 / 10.8 build.

== Installing EMAN2 in my home directory ==

If you do not have Administrator privileges on your system or want to install EMAN2 in your home directory, you will want to modify the eman2.bashrc file to reflect the correct path to EMAN2 in the EMAN2DIR variable, e.g.:

{{{
export EMAN2DIR=/Users/irees/EMAN2
}}}

== Other shells ==

If you run tcsh as your shell, the shell init file is "~/.cshrc", and the EMAN2 init script is eman2.cshrc:

{{{
test -r /Applications/EMAN2/eman2.cshrc && source /Applications/EMAN2/eman2.cshrc
}}}