Differences between revisions 2 and 3
Revision 2 as of 2017-05-12 19:35:01
Size: 2582
Editor: TunayDurmaz
Comment: under construction
Revision 3 as of 2017-05-12 19:56:38
Size: 3026
Editor: TunayDurmaz
Comment: Mac and Linux instructions
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
== 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)
Line 15: Line 7:
To install:  To install:
Line 17: Line 9:
    1. Download the appropriate file .... .     1. Download the appropriate file.
Line 19: Line 11:
    2. If you use the bash shell, add the following line to your ".profile" file:     2. Type the following command and follow the instructions. You will be prompted for a location to install EMAN2 when the installer starts and if you want to add {{{ export PATH=... }}} to your '.profile' file. {{{
   bash <path to EMAN2 installer>
  }}}
Line 21: Line 15:
    {{{
test -r /Applications/EMAN2/eman2.bashrc && source /Applications/EMAN2/eman2.bashrc
}}}
    3. 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.
Line 25: Line 17:
    3. Restart your terminal program for a fresh shell. EMAN2 should now be installed and function properly.

''Notes:''
 * Placeholder
Line 33: Line 21:
Paragraph: To install:
Line 35: Line 23:
{{{
bash <installer>
}}}
    1. Download the appropriate file.
Line 39: Line 25:
When the installer is done (takes only a few seconds), it will display an instruction to add eman2.bashrc to your login script (or similar, depending on what shell you use).     2. Type the following command and follow the instructions. You will be prompted for a location to install EMAN2 when the installer starts and if you want to add {{{ export PATH=... }}} to your '.bashrc' file. {{{
   bash <path to EMAN2 installer>
  }}}
Line 41: Line 29:

=== Additional tips: ===
 * '''Bold text''', you should put the EMAN2 'source' after the EMAN1 'source' in your .bashrc file.
 * List 2
    3. 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.
Line 61: Line 46:
= Archive Context =


=== 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)

!!! UNDER CONSTRUCTION !!!

All platforms

Mac OS X

To install:

  1. Download the appropriate file.
  2. Type the following command and follow the instructions. You will be prompted for a location to install EMAN2 when the installer starts and if you want to add  export PATH=...  to your '.profile' file.

       bash <path to EMAN2 installer>
  3. 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:

  1. Download the appropriate file.
  2. Type the following command and follow the instructions. You will be prompted for a location to install EMAN2 when the installer starts and if you want to add  export PATH=...  to your '.bashrc' file.

       bash <path to EMAN2 installer>
  3. 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.

Windows

Paragraph.

Paragraph.

Anyway, if you're not deterred by my doom and gloom, we do try to make installation as simple as possible, and it IS possible to use EMAN2 effectively on Windows:

  • If you have installed previous version of EMAN2. Please uninstall it and remove a directory called c:\tmp\eman2db-***.
  • 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.

Archive Context

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.

EMAN2/Install/BinaryInstallAnaconda/ContinuousBuild (last edited 2023-02-19 20:09:56 by TunayDurmaz)