From EosPedia
Revision as of 23:59, 18 May 2017 by Shirak (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

 Here, we explain how to install the Eos.

Installation of Eos

 When the install tools described in (Download)are used, you can run the Eos in most cases. Please refer to Download. If not running, then you follow the following description on compilation. This will lead to the runnable Eos, in most cases.

Setting environment of Eos

 First, you must prepare environment file that is written about informations as the place where put Eos downloaded (Download)
Check that EOS_HOME is set to directory "Eos/base/" in the environment file.

e.g.: Eos_env

If you download by using git, a sample file is in the directory "Eos/base/env/".
In this case, it is set that "Eos/base/" is to $HOME.

By the following, the environment is set.

$ source Eos_env

Or, Add the script (e.g. .bashrc) as be set automatically environment file when run shell.

in .bashrc

if [ -f $HOME/.Eos_env ] ; then
    source $HOME/.Eos_env

Then, check that the following commands work.

$ mrcInfo -h
Usage: /..A../Eos/bin/..B../mrcInfo
    [-i[nput]            In                  (NULL      )] :Essential :InputDataFile
    [-o[utput]           Out                 (stdout    )] :Optional  :OutputDataFile
    [-c[onfig]           configFile          (NULL      )] :Optional  :ConfigurationFile
    [-m[ode]             mode                (0         )] :Optional  :Mode


$ echo $EOS_HOME

if output above is same one below,



$ echo $EOS_HOST

if output above is same one in capital letters below,


Basic setting has been successful in that case.

Build of Eos

 It is expected that downloaded data can work directly. However, you may need to download the binary according to each environment. And, it may not work depending on the environment of version. If downloaded data can't work directly, Try compile, link and rebuild with the following method.

Setting the development environment of each host

 Prepare your development environment on each host.


 It will be necessary to install the 4 software. (Xcode, Command Line Tools, XQuartz, Graphics Tools for Xcode)

  1. Install Xcode latest version.
  2. (In the case of OS10.8 or later) Install Command Line Tools as Additional Downloads.
    Command line can't work only installing of XCode.
    $ gcc --version
    Check that the version of gcc is displayed by the command above.
  3. (In the case of OS10.8 or later) Install execution environment of X11(XQuartz).
    Case before it, it is sufficient installation of XCode.
  4. (In the case of Mountain Lion or later) Case to use OpenGL, it needs Graphics Tools for Xcode.

Case of Linux

 In the case of Linux, I can run as it is in many cases. However, recently development environment may not be sufficient in some cases. We would like to organize each time the problem is discovered.

  • Notes on icc

 You can compile it by gcc or icc. In the case of no icc environment or CPU of INTEL compatible, it may not work. Therefore it switches the use environment by environment value FLAG_ICC (default setting is using gcc). Provided Eos_env can switch automatically between the host with icc and the host without it. In the case to use binary files compiled by icc, set FLAG_ICC="icc" even if a host does not install the icc. Otherwise, set FLAG_ICC="".

  • Case to use PHI
  • Case to use GPGPU
    • Case to use NVIDIA(CUDA)

Case of Windows

 There is the way by using Cygwin or the way to run in a virtual machine environment of Linux such as Ubuntu on how to set the environment.

Case of other environments

   Previously we made sure that it works in some UNIX environments, but currently we don't make sure it, because we don't have environments as it. Compile and link usually will be able on UNIX, because it is not that we use special environments. The command that is tuned up to speed may not be able to work.

Simple method of rebuild

Most simple method of rebuild is below.

$ cd $EOS_HOME
$ make setting
$ make rebuild

If it failed, you need finely set as below.

Compile various libraries for Eos

 First, Compile various libraries for Eos. In the following, XXXX shows the OS type of each host.

$ cd $(EOS_HOME)/util/srcXXXX

Or Compile each on the subdirectory as Graphics, TclTk and MATH.

$ cd $(EOS_HOME)/util/srcXXXX/Graphics
$ cd $(EOS_HOME)/util/srcXXXX/MATH
$ cd $(EOS_HOME)/util/srcXXXX/TclTk

Command of Compile

$ make check
$ make config
$ make all

Install Objects of Eos

Next, Install Eos-Objects(Library).

Method of install all Objects

You can install all Objects by the method as below.

$ cd $(EOS_HOME)/util/Objects
$ make check
$ make depend
$ make clean
$ make 
$ make install

Method of install each Objects

You can install each Objects by the method as below. It is case of mrcImage.

$ cd $(EOS_HOME)/util/Objects/DataManip/mrcImage 
$ make check
$ make depend
$ make clean
$ make 
$ make install

Install Tools

Next, install Eos-Tools.

Install all Tools

You can install all Tools by the method as below.

$ cd $(EOS_HOME)/util/Tools
$ make check
$ make depend
$ make clean
$ make 
$ make install

Install each Tools

 You can install each Tools by the method as below. It is case of Display2.

$ cd $(EOS_HOME)/util/Tools/Integration/Display2/src
$ make check
$ make depend
$ make clean
$ make 
$ make install

make clean may not need, but execute just in case for anytime getting new executable.