Installation
EpiTools comes in a single flavour as software package for Matlab. We suggest to use the lastest Matlab version available (2014a) since we developed and tested for retrocompatibility only for a small number of old Matlab releases. At this time of the developing plan, you will still need a full and licenced installation on Matlab since our program is just a wrapped ensamble of matlab and c++ functions working together.
How to install it and receive our latest patches or updates
Installing EpiTools from our website
From the home page of EpiTools you can easily download the latest available version of EpiTools. This comes as a package where you will find only the needed files (no deprecated functions, crap files none wants on his machine). This is the most polished and clean version of EpiTools.
- Download the package from here
- Explode the package
- From the directory generated by exploding the package, double click on the launcher file correspondent to your operative system.
- Done!
In case the launcher complains as follows:
EpiTools_mac: Permission denied
follow these instructions from a new console windows (in OsX, open a new Terminal session).
cd directory-where-you-downloaded-and-exploded-epitools
chmod +x EpiTools_mac
Q: updates?
A: We are working on a nice and neat implementation of auto updates. Unfortunately we are not ready yet to provide them automatically from EpiTools framework. However, the package you find here on our website will be always the latest version of our software!
Q: Command line access?
A: To ensure the best GUI flexibility with Epitools for matlab V2 we had to disable the command line access for now. You can still download EpiTools for matlab V1 with command line support from here. A simple tutorial script called EpiTools_CommandLine.m is provided as example in the main archive folder.
Installing EpiTools from the git repository
Once you granted access to our repository, installing EpiTools is a piece of cake. You just have to clone our repository from our online versioning system (Bitbucket, a manager for GIT and MERCURIAL repositories). If you do not know what GIT is here you will find nice tutorials. Git comes automatically if you are using any version of SourceTree or any other gui software of your choice (here a selection).
You can do it in two different ways according to how do you feel about using the terminal or GUI applications.
In SourceTree
-
Clone our git repository (click on Actions>Clone>Clone in SourceTree)
-
Select the release branch (master) and an appropriate empty folder i.e. /Users/your-username/epitools
-
Open Matlab.
-
In Matlab, navigate to the directory where you clone the repository and point to ./src/
-
Right click on EpiTools.m and select Run.
-
Wait until the EpiTools interface will appear.
In Terminal
-
Point an empty directory
-
Execute the following command
git clone https://github.com/epitools/epitools-matlab.git
-
Open Matlab.
-
In Matlab, navigate to the directory where you clone the repository and point to ./src/
-
Right click on EpiTools.m and select Run.
-
Wait until the EpiTools interface will appear.
Updating EpiTools
If you cloned our repository you must have a git client version installed locally on your machine.
In SourceTree
-
Open SourceTree (you will find it in the Applications folder)
-
Double-click on EpiTools repository in the Bookmarks list
-
Click on Fetch to retrieve all the new branches of the repository
-
Double click on the branch you are interested in (usual the ones under the folder release) in order to check it out.
-
Click on Pull to download all the new modifications made to the software
-
Close SourceTree
From the terminal
For those of you who are into bash and terminal command
- Open a new terminal window
- Navigate to the directory where you cloned EpiTool repository
-
Type the following commands:
git status git fetch git checkout master git pull
-
Exit the terminal