Download

Before you download or install

OS-X(Mac) users

After you install the programs shown in EosOnMac, you download the necessary programs as shown below.

Linux users

After you install the programs shown inEosOnLinux, you download the necessary programs as shown below.

git users

git users can download from SourceForge.jp ([projects/eos]). Use of the git command is described in [sourceforge]. Below the commands used in "easy install" are summarized.

Easy Install (git version ：For a "first time" user or a user very eager to use Eos for image processing)

　The "first time" user can install the programs as described below.

　The used commands are given a short description on their meanings.

Easiest Install（Suited to "use only" people）　

$ curl -L  https://osdn.jp/projects/eos/scm/git/base/blobs/master/env/install-eos.sh?export=raw > /tmp/install-eos.sh
$ curl -L  https://osdn.jp/projects/eos/scm/git/base/blobs/master/env/Eos_env?export=raw > /tmp/Eos_env
$ source /tmp/Eos_env
$ source /tmp/install-eos.sh
Set the directory to be installed in  [/home/XXX/Eos]: 　　　　　　　　　　XXX represents your home directory。If no change is needed, press return; Otherwise enter the name of your home directory.
Directory: /home/XXX/Eos
Do you have your git account for OSDN [Y|y or N|n] ?n　　　　　　　　　If you have no OSDN account and would like to just use EOS, you do not have to input a reply.　　　　
Do you want to rewrite /home/Eos/.bash_prfile ? [Y|y or N|n] y　　　　　Asking if the Environmental variables is needed.
Do you want to rewrite /home/Eos/.bashrc ? [Y|y or N|n] y
Cloning into '/home/XXX/Eos'...
-----
Cloning into 'YYYYYYYYY'...　　　　　　　　　　　　　　　　　　　　　YYYYYYYY can be different according to the environment of the host.
-----
Setting an environment for Eos
Please check /home/Eos/.bash_profile.
You finished Eos installation.

Easiest Install（Suited to the developing people））　

$ curl -L  https://osdn.jp/projects/eos/scm/git/base/blobs/master/env/install-eos.sh?export=raw > /tmp/install-eos.sh
$ curl -L  https://osdn.jp/projects/eos/scm/git/base/blobs/master/env/Eos_env?export=raw > /tmp/Eos_env
$ source /tmp/Eos_env
$ source /tmp/install-eos.sh
Set the directory to be installed in  [/home/XXX/Eos]: 　　　　　　　　XXX represents your home directory。If no change is needed, press return; Otherwise enter the name of your home directory.
Directory: /home/XXX/Eos
Do you have your git account for OSDN [Y|y or N|n] ?y　　　　　　　　If you have OSDN account, return y.　　　　　　
Set the git account for OSDN [XXX]:                                Set the account in which ssh-keygen was set。Usually just "return" will do.
Do you want to rewrite /home/XXX/.bash_prfile ? [Y|y or N|n] y　　　　　Asking if the Environmental variables is needed.
Do you want to rewrite /home/XXX/.bashrc ? [Y|y or N|n] y
Cloning into '/home/XXX/Eos'...
Username for 'https://scm.osdn.jp': XXXXX                                                Answer the user name in OSDN.
Password for 'https://XXXXX@scm.osdn.jp': 　　　　　　　　　　　　　 Answer the password in OSDN.
-----
Cloning into 'YYYYYYYYY'...　　　　　　　　　　　　　　　　　　　　　YYYYYYYYcan be different according to the environment of the host.
-----
Setting an environment for Eos
Please check /home/Eos/.bash_profile.
You finished Eos installation.

Commands in details

downloading of install-eos.sh

You download the installer either by

curl -L  https://sourceforge.jp/projects/eos/scm/git/base/blobs/master/env/install-eos.sh?export=raw > /tmp/install-eos.sh

The downloading site is changed from SourceForge to OSDN,

curl -L  https://osdn.jp/projects/eos/scm/git/base/blobs/master/env/install-eos.sh?export=raw > /tmp/install-eos.sh

OR,

wget -q -O -  https://sourceforge.jp/projects/eos/scm/git/base/blobs/master/env/install-eos.sh?export=raw > /tmp/install-eos.sh

wget -q -O -  https://osdn.jp/projects/eos/scm/git/base/blobs/master/env/install-eos.sh?export=raw > /tmp/install-eos.sh

Dowloading (Installing) of Eos

Running install command

　After downloading of the two files as described above, run the following commands.

Set the environment variables.

$ source /tmp/Eos_env

$ source /tmp/install-eos.sh
         or
$ source /tmp/install-eos.sh a_directory_to_be_installed
         or
$ source /tmp/install-eos.sh a_directory_to_be_installed osdn_username

When "a_directory_to_be_installed" and "osdn_username" have been assigned, some of the steps described below will be skipped.

＊Note that install-eos.sh is frequently updated.

Setting of install directory

　Next, you are asked which directory you would like to have the Eos. If you have assigned the directory previously, this step is skipped. When you returned ENTER, you will have the EOS in the default directory (usually $HOME/Eos).

If you do not like $HOME/Eos, you assign a blank directory like,

Set the directroy to be installed [/Users/xxxx/Eos]:  /Users/xxxx/EosTest

＊　If not a blank directory, an error will occur.

Already installed
Use update-eos.sh for updating or set a new directory for installation

＊　When you like to change the default directory beforehand. set the environment variable EOS_HOME0, like

$ export EOS_HOME0=/tmp/Eos

gituser setting

　It is asked if you have an account in OSDN.

　If you are not developing tools (i.e. just an user) 、you give n or N.

Do you have your git account for OSDN [Y|y or N|n] ? n

　If you are developing tools in a collaboration、you need registration in OSDN。The registration can be done later. You can change what you downloaded without the registration. The registration is necessary for uploading what you wrote。 You can register like,

Do you have your git account for OSDN [Y|y or N|n] ? y
Set the git account for OSDN [XXX]:XXX 

XXX is a user name. It is not an account name in OSDN, but a user name in git account、

Setting of Environment variables

　Select if you like to have a calling of Eos_env, which sets environment variables, in your .bash_profile.

Do you want to rewrite /Users/tacyas/.bash_prfile ? [Y|y or N|n] n

When n is selected, you have to set those by yourself or every time you execute "source $EOS_HOME/env/Eos_env".

Do you want to rewrite /Users/tacyas/.bash_prfile ? [Y|y or N|n] y

When y is selected, scripts for setting of environment variables is written in .bash_profile.

The portion to do the job is written is marked as below. This portion can be sometimes overwritten、therefore be careful.

## Eos_env Start
.....
## Eos_env End

Start of Installation

　At this stage, you will find downloading is going on.

　Those who replied that they have an account on OSDN will see the following inquiry.

Username for 'https://scm.osdn.jp': XXXXX
Password for 'https://XXXXX@scm.osdn.jp': 

　If things went well, you will see the output,

You finished Eos installation.

　The scripts for setting of environment variables is inserted in .bashrc in your home directory, on start up of the shell.

If thing went wrong, you have to execute /tmp/Eos_env (which was downloaded) or /env/Eos_env (For /env/, see above) on start up. This is done by,

$ source Eos_env

There may be cases where you have to write in $HOME/.profile, depending on your system.

The following script may be useful when in trouble. This is for using $HOME/Eos. In a case where you would like to install in another place, you must remove a comment of EOS_HOME0 in the setting. Those who have a user account in OSDN for a collaboration development must set EOS_GITUSER0.

## Eos_env Start
##

if [ ! -z $EOS_HOME0 ] ; then 
    if [ -f $EOS_HOME0/env/Eos_env -a ! -f $HOME/.Eos_env ] ; then
        ln -s $EOS_HOME0/env/Eos_env $HOME/.Eos_env
    fi  
fi

#export EOS_HOME0=Eos
#export EOS_GITUSER0=EosUser

test -r $HOME/.Eos_env  && . $HOME/.Eos_env

##
## Eos_env End

See if your install is OK

Check if your installation is OK by submitting a command,

$ mrcInfo -h

●Note 1：Some commands may not work due to absence of cuda an/or X11. You have to install necessary libraries. This will be described somewhere else.

●Note ２：After this install you can do developing works on your own。But you can not upload your work on sourceforge。For uploading, you have to change URL of the origin and have an account in sourceforge. Note that you have downloaded only the most recent version. You have to download all the histories for uploading due to a nature of git. You can download all the necessary information by using the unshallow function in git. The details of this will be described somewhere else.

Note 3: In OS-X(10.11, El Capitan), the cuda library and others can not be loaded due to dyld peculiarity in the system. You have to change SIP to disable. Refer to the trouble shooting to be located at the bottom of this page.

Installing by git command ：installation in a new directory

You make a duplicated Eos with git.

A case for collaboration development of Eos（an account is needd in SourceForge）

Below a description is given for those thinking of collaboration development. They need to upload (or push) the source code onto SourceForge.

Registration in SourceForge

You prepare a Username, a Password and a public_key for the registration.

Setting of the environment variables

Download Eos_env like, Eos_env.

This is identical to $EOS_HOME/env/Eos_env which is obtained by downloading which will be described below.

Next, you submit the following command. A default destination directory is $HOME/Eos. By setting the environment variable：EOS_HOME0, you can change the destination directory.

$ source Eos_env

Now the environment variables are set. If you do not set the environment variables in this way, you have to set up a directory which is equivalent to $EOS_HOME.

When the user name and the Username in SourceForge are not identical, EOS_GITUSER must be set by either using an environment file or doing a manual setting.

export EOS_GITUSER=(SourceForge上のUsername)
   or
export EOS_GITUSER=$USER

1. tarball [1]

2. git from SourceFoge [2]

$ git clone git://git.sourceforge.jp/gitroot/eos/base.git
 or
$ git clone git://git.code.sf.net/p/eosforemimageprocessing/code eosforemimageprocessing-code

3. (PIONE) github or gem

3.1 gem (ruby)

$ gem install pione

3.2 git from github

$ git clone https://github.com/pione/pione.git