!!! 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.

Testing

After installing on any of the systems below, you should test to make sure it's working by 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)