Сборка Embedded Learning Library (ELL) на macOS

ELL позволяет вам проектировать и развертывать умные модели машинного обучения на одноплатных компьютерах, таких как Raspberry Pi и Arduino. Большинство ваших взаимодействий с ELL происходит на ноутбуке или настольном компьютере, а не на самом одноплатном компьютере. Ниже описаны шаги по сборке ELL на ноутбуке или настольном компьютере, работающем под macOS.

Клонирование репозитория ELL

Данные инструкции предполагают, что ELL был получен из github.com/Microsoft/ELL с помощью git. Один из способов установки клиента git — открыть терминал и ввести

brew install git

Чтобы клонировать репозиторий ELL, введите

git clone https://github.com/Microsoft/ELL.git

Предварительные требования для сборки ELL

Homebrew — это менеджер пакетов, который облегчает установку предварительных требований. Homebrew можно скачать и установить следующим образом:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Если у вас уже установлен Homebrew, обновите его до последней версии, введя

brew update

LLVM и Clang

ELL зависит от LLVM — компиляторного фреймворка, версии 8.0. Clang — это компилятор C++, построенный на основе LLVM, и это лучший выбор для сборки ELL. Чтобы скачать и установить LLVM и Clang, введите

brew install llvm@8
```В качестве альтернативы, если у вас уже установлен *Xcode* и вы предпочитаете использовать версию *Clang*, включённую в него, вам всё равно нужно установить LLVM и убедиться, что версия командной строки инструментов Xcode доступна.```shell
brew install llvm@8
xcode-select --install

Если у вас уже установлен LLVM, убедитесь, что у вас версия 6.0. Обратите внимание, что CMake предполагает, что бинарные файлы LLVM расположены в стандартном месте Homebrew, что является /usr/local/opt.

CMake 3.8, SWIG 4.0.0, OpenBLAS и Doxygen через Homebrew

ELL использует CMake — систему сборки, версии 3.8 или новее.

В качестве опции, ELL может использовать следующие дополнительные инструменты:

• SWIG версии 4.0.0 — инструмент, который генерирует интерфейсы Python для C++ библиотек. Требуется, если вы планируете использовать ELL из Python.
• OpenBLAS — версии 0.2.19.3 — быстрый линейный алгебра. OpenBLAS может ускорить выполнение моделей до 10 раз.
• Doxygen — версии 1.8.13 — используется для генерации документации кода для API ELL. Чтобы установить все вышеуказанное, введите

brew install cmake
brew install swig
brew install openblas
brew install doxygen

Использование ELL в Python

ELL может быть использован из Python 3.6 по желанию. Легкий способ установки Python и всех необходимых модулей — с помощью Miniconda. Скачайте и установите Miniconda с этого сайта https://conda.io/miniconda.html.

После установки Miniconda, создайте среду Python 3.6 и включите модуль numpy, введя

conda create -n py36 numpy python=3.6

Затем активируйте созданную вами среду, введя

source activate py36
```Вы должны повторить эту команду активации каждый раз, когда открываете новый терминал и намерены использовать ELL из Python. Также убедитесь, что активирована среда `py36` перед сборкой ELL, чтобы гарантировать создание Python интерфейсов.

*OpenCV* — это библиотека, которая помогает с захватом и предварительной обработкой изображений. Чтобы установить OpenCV в текущей Python среде, введите

```shell
conda install -c conda-forge opencv

Сборка ELL

Мы собираем ELL с помощью CMake для создания makefile, запуска этого makefile и, по желанию, сборки Python интерфейсов. Если вы намерены собрать Python интерфейсы, убедитесь, что активирована среда py36 miniconda, как описано выше.

В корневом каталоге репозитория создайте подкаталог build и перейдите в этот каталог.

mkdir build
cd build

Запустите CMake, введя

cmake ..

Не забудьте два точки (..) в конце команды! Это создает makefile для проекта. Затем запустите makefile, введя

make

По желанию, соберите Python интерфейсы, введя

make _ELL_python

Вы можете проверить, что Python интерфейс работает, запустив следующий тест:

ctest . --build-config release -R ell-python-interface-test

Сгенерированные исполняемые файлы появятся в ELL/build/bin.

Устранение неполадок

LLVM не найден, пожалуйста, проверьте, что LLVM установлен.

Попробуйте указать CMake, где найти LLVM, следуя инструкциям:```shell cmake -DLLVM_DIR=$(brew --prefix llvm) ..

## Расширенная установка

Инструкции выше достаточно для начала использования ELL. Для более продвинутых тем, таких как тестирование и генерация документации, пожалуйста, обратитесь к нашим [расширенным инструкциям по установке](INSTALL-Advanced.md).