!!! UNDER CONSTRUCTION !!!

All platforms

Mac OS X

To install:

Download the appropriate file.
Type the following command and follow the instructions. You will be prompted for a location to install EMAN2 and if you want to add export PATH=... to your .profile file.
```
   bash <path to EMAN2 installer>
```
If you choose to update your .profile file, restart your terminal program for a fresh shell. Or, you can manually run the export command that is printed at the end of the installation.

Linux

To install:

Download the appropriate file.
Type the following command and follow the instructions. You will be prompted for a location to install EMAN2 and if you want to add export PATH=... to your .bashrc file.
```
   bash <path to EMAN2 installer>
```
If you choose to update your .bashrc file, restart your terminal program for a fresh shell. Or, you can manually run the export command that is printed at the end of the installation.

Cluster installations

Follow the instructions about cluster installation in the note printed at the end of the installation process.

Run:

    bash <path to EMAN2 directory>/utils/uninstall_openmpi.sh
    bash <path to EMAN2 directory>/utils/install_pydusa.sh
 #   bash <path to EMAN2 directory>/utils/uninstall_openmpi.sh

Windows

1. Download and install EMAN2 binary.

2. Install Python Launcher.

Bash On Windows

1. Install "Bash on Windows 10", https://www.howtogeek.com/249966/how-to-install-and-use-the-linux-bash-shell-on-windows-10/.

2. When prompted to set a user name, enter root. This should give you an account without a password.

Install OpenGL and X Server, set environment variables

1. Install OpenGL.

    sudo apt-get update
    sudo apt-get install libsm-dev \
                         libxrender-dev \
                         build-essential \
                         libgl1-mesa-dev \
                         mesa-utils \
                         mesa-common-dev
    sudo apt-get autoremove

2. Install Xming X Server for Windows.

3. Set environment variables.

    export DISPLAY=:0
    glxinfo | grep OpenGL
    export KMP_AFFINITY=disabled # per https://github.com/Microsoft/BashOnWindows/issues/785#issuecomment-238079769

4. Download and install eman2.2.linux64.centos7.sh.

5. Start X Server before running eman2.

Archive Context

Windows:

After installation, try running:
- e2version.py
- e2speedtest.py
- e2display.py
Do not try to run EMAN2 programs using desktop Icons. You need to open a command prompt and run the commands from there. Even the GUI tools should be launched this way.

Additional tips:

Bold text, you should put the EMAN2 'source' after the EMAN1 'source' in your .bashrc file.
List 2

Testing

After installing on any of the systems below, you should test to make sure it's working. While we have unit testing, it is mainly for developers. Instead, we suggest just running the following 4 basic tests:

e2version.py (make sure the displayed version is what you expect, including the timestamp. If you have any problems we need you to include the output from this command in your message)
e2speedtest.py (will also give you the relative speed to expect from your machine)
e2projectmanager.py (if the GUI pops up, it's working)
e2proc2d.py anyimagefile bdb:test (anyimagefile is any 2d image or stack supported by eman2, this will make sure the database works)

Environement Variable Setting For EMAN2 (All platforms)

In some rare cases, the EMAN2 installer will not be able to update your environment variables properly. In such cases, we need set up environment variables like PATH, LD_LIBRARY_PATH and PYTHONPATH for EMAN2 to work correctly. These environment variables should be automatically set when you run eman-installer script when you install binary EMAN release.