|
|
# Setup
|
|
|
## Table of Contents
|
|
|
|
|
|
1.[Setup](manual-setup)
|
|
|
- [General setup](manual-setup#general-setup)
|
|
|
- [Installation instructions](manual-setup#installation-instructions)
|
|
|
1.[ Setup](manual-setup)
|
|
|
- [General Setup](manual-setup#general-setup)
|
|
|
- [Installation Instructions](manual-setup#installation-instructions)
|
|
|
- [Python, pip and Qt](manual-setup#python-pip-and-qt)
|
|
|
- [Requirements](manual-setup#requirements)
|
|
|
- [Caffe](manual-setup#caffe)
|
|
|
- [Launching Barista](manual-setup#launching-barista)
|
|
|
- [Caffe Path Configuration](manual-setup#caffe-path-configuration)
|
|
|
- [Per-Project Caffe Path](manual-setup#per-project-caffe-path)
|
|
|
- [Caffe Root for Precompiled Packages](manual-setup#caffe-root-for-precompiled-packages)
|
|
|
- [Caffe Path Configuration](manual-setup#caffe-version-configuration)
|
|
|
- [Per-Project Caffe Path](manual-setup#per-project-caffe-version)
|
|
|
|
|
|
2.[Overview](manual-overview)
|
|
|
2.[ Overview](manual-overview)
|
|
|
|
|
|
3.[Network creation](manual-network)
|
|
|
3.[ Caffe Version Management](manual-caffeversions)
|
|
|
|
|
|
4.[Network training](manual-training)
|
|
|
4.[ Network Creation](manual-network)
|
|
|
|
|
|
5.[Miscellaneous](manual-miscellaneous)
|
|
|
5.[ Network Training](manual-training)
|
|
|
|
|
|
6.[ Miscellaneous](manual-miscellaneous)
|
|
|
|
|
|
|
|
|
## General Setup
|
... | ... | @@ -43,12 +44,12 @@ Barista is written in Python 2. So first of all install Python and the (python) |
|
|
|
|
|
PyQt is needed for Baristas GUI. To install it, run:
|
|
|
|
|
|
`$ sudo apt-get install python-pyqt5 qt5-default`
|
|
|
`$ sudo apt-get install python-pyqt5 qt5-default python-tk`
|
|
|
|
|
|
## Requirements
|
|
|
There are a number of Python modules that need to be installed in order to run Barista. All of them can be easily installed by using the requirements file which is located in the Barista root Folder. The command to install all requirements is as follows:
|
|
|
|
|
|
`$ pip install -r /path/to/requirements.txt`
|
|
|
`$ pip2 install -r /path/to/requirements.txt`
|
|
|
|
|
|
### Caffe
|
|
|
Of course, you need a working installation of caffe. For a detailed description see [the official website](http://caffe.berkeleyvision.org/installation.html). Although there is now an apt package available for Ubuntu >= 17.04, it is advisable to download and **build** the most current version **from source**.
|
... | ... | @@ -58,45 +59,19 @@ Finally, you can run Barista from its root directory by using the main.py: |
|
|
|
|
|
`$ python main.py`
|
|
|
|
|
|
Once you have a Barista Project created, you can also launch Barista with the project directly:
|
|
|
|
|
|
`$ python main.py -o /path/to/project/`
|
|
|
|
|
|
## Caffe Path Configuration
|
|
|
On your first start of Barista, it will ask you to add a valid Caffe path (i.e., the path to a local checkout of the caffe repository, in the following referred to as the **Caffe Path**). The following window will open and with a click on the file-button in the right bottom corner you will be able to select a Caffe path from your working directory.
|
|
|
On your first start of Barista, it will ask you to add a valid Caffe version (i.e., all required files of a local checkout of the caffe repository, in the following referred to as the **Caffe Version**). The following window will open and with a click on the file-buttons in the right corner you will be able to select the corresponding files and folders from your working directory. If the Caffe Root folder is set first, Barista tries to find the other files and folders automatically, if thats not possible, they need to be set manually.
|
|
|
|
|
|
![Caffepath](Caffepath.png)
|
|
|
![Caffepath](Caffepath)
|
|
|
|
|
|
After you have done this, select "Save and start Barista" and Barista saves the given path, so you won't have to set it again the next time you start the program.
|
|
|
After you have done this, select "Save and start Barista" and Barista adds the given Caffe Version, if valid, so you won't have to set it again the next time you start the program.
|
|
|
The window to select or create a new project will open right away.
|
|
|
|
|
|
## Per-project Caffe Path
|
|
|
There are two existing Caffe paths that can be used. One is saved globally in Baristas settings, while the other is saved per project. An empty per-project path (which is the default) makes Barista use the global setting. Both Caffe paths (global and the path of the current project) can be changed by using the entry "Settings -> Change Caffe Path" in the menu bar. After changing a path, Barista (currently) needs to be restarted.
|
|
|
|
|
|
## Caffe Root for Precompiled Packages
|
|
|
Some distributions conveniently offer precompiled packages for caffe.
|
|
|
Although it is advised to clone the latest version of caffe and building it locally, Barista can use precompiled versions of caffe with some additional work.
|
|
|
Using symbolic links, we can create a dummy "caffe root" folder structure that resembles that of a source folder, but only contains the paths required by Barista.
|
|
|
The tree structure of such a folder should look as follows:
|
|
|
|
|
|
```
|
|
|
> tree caffe_root_dummy/
|
|
|
caffe_root_dummy/
|
|
|
├── python
|
|
|
│ └── caffe -> ${caffe_python_files}
|
|
|
├── src
|
|
|
| └── caffe
|
|
|
| └── proto -> ${caffe_proto_folder}
|
|
|
└── build
|
|
|
└── tools
|
|
|
└── caffe -> ${caffe_executable}
|
|
|
```
|
|
|
|
|
|
`${caffe_python_files}` should contain the python files of Barista, i.e., pycaffe.py etc.
|
|
|
|
|
|
`${caffe_proto_folder}` should be the path of a folder containing the caffe.proto file.
|
|
|
|
|
|
`${caffe_executable}` should be the caffe binary used to start training from command line.
|
|
|
|
|
|
For example, when installing caffe from the archlinux user repository, the symlinks should be set up like:
|
|
|
* `caffe_root_dummy/python/caffe -> /usr/lib/python2.7/site-packages/caffe/`
|
|
|
* `caffe_root_dummy/src/caffe/proto -> /usr/share/caffe/`
|
|
|
* `caffe_root_dummy/build/tools/caffe -> /usr/bin/caffe.bin`
|
|
|
## Per-project Caffe Version
|
|
|
Barista keeps track of all Caffe Versions and one of them is set as default. However every project can define its own default Caffe Version. An empty per-project version (which is the default) makes Barista use the global setting. Caffe Versions can be changed using the entry "Tools -> Caffe Version Manager" in the menu bar.
|
|
|
|
|
|
| [previous page](manual) | [start page](manual) | [next page](manual-overview) | |