Here, we explain how to install the Eos.
- 1 Installation of Eos
- 2 Setting environment of Eos
- 3 Build of Eos
- 3.1 Setting the development environment of each host
- 3.2 Simple method of rebuild
- 3.3 Compile various libraries for Eos
- 3.4 Install Objects of Eos
- 3.5 Install Tools
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.
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.
if [ -f $HOME/.Eos_env ] ; then source $HOME/.Eos_env fi
Then, check that the following commands work.
$ mrcInfo -h
Usage: /..A../Eos/bin/..B../mrcInfo Options: [-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)
- Install Xcode latest version.
- (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.
- (In the case of OS10.8 or later) Install execution environment of X11(XQuartz).
- Case before it, it is sufficient installation of XCode.
- (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 or $ cd $(EOS_HOME)/util/srcXXXX/MATH or $ 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
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.