Difference between revisions of "Download"

Revision as of 06:16, 11 May 2017

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 downloadaed) 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 collaborational 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

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