meta
v3.0.2
Пожалуйста, посетите нашу веб -страницу для получения информации и учебных пособий о Meta!
Meta - это современный инструментарий Data Sciences C ++
Доксигенную документацию можно найти здесь.
У нас есть прохождение для нескольких разных частей мета на домашней странице Meta.
Если бы вы использовали Meta в своем исследовании, мы очень оценили бы цитирование для нашей демонстрационной бумаги ACL:
@InProceedings{meta-toolkit,
author = {Massung, Sean and Geigle, Chase and Zhai, Cheng{X}iang},
title = {{MeTA: A Unified Toolkit for Text Retrieval and Analysis}},
booktitle = {Proceedings of ACL-2016 System Demonstrations},
month = {August},
year = {2016},
address = {Berlin, Germany},
publisher = {Association for Computational Linguistics},
pages = {91--96},
url = {http://anthology.aclweb.org/P16-4016}
}Mac OS X 10,6 или выше требуется. Вы можете добиться успеха с 10.5, но это не тестируется.
Вам нужно будет установлен Homebrew, а также инструменты командной строки для XCODE (HomeBrew также требует этого, и он будет предпринять для них во время установки, или вы можете установить их с помощью xcode-select --install на недавних версиях OS X).
После установки Homebrew запустите следующие команды, чтобы получить зависимости для Meta:
brew update
brew install cmake jemalloc lzlib icu4cЧтобы начать, запустите следующие команды:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
CXX=clang++ cmake ../ -DCMAKE_BUILD_TYPE=Release -DICU_ROOT=/usr/local/opt/icu4c
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
Направления здесь во многом зависят от вашей установленной версии Ubuntu. Чтобы проверить, в какой версии вы находитесь, запустите следующую команду:
cat /etc/issueИсходя из того, что вы видите, вы должны продолжить одно из следующих руководств:
Если ваша версия составляет менее 12,04 LT, ваша операционная система не поддерживается (даже вашим поставщиком!), И вам следует обновить как минимум до 12,04 LT (или 14,04 LT, если это возможно).
Опираясь на Ubuntu 12.04 LTS требует большей работы, чем его более современная сестра 14.04, но это можно сделать относительно легко. Однако вам нужно будет установить более новый компилятор C ++ из PPA и переключиться на него, чтобы построить мета. Нам также нужно будет установить более новую версию Cmake, чем изначально.
Начните с запуска следующих команд, чтобы получить зависимости, которые нам понадобятся для построения мета.
# this might take a while
sudo apt-get update
sudo apt-get install python-software-properties
# add the ppa that contains an updated g++
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
# this will probably take a while
sudo apt-get install g++ g++-4.8 git make wget libjemalloc-dev zlib1g-dev
wget http://www.cmake.org/files/v3.2/cmake-3.2.0-Linux-x86_64.sh
sudo sh cmake-3.2.0-Linux-x86_64.sh --prefix=/usr/localВо время установки Cmake вы должны согласиться с лицензией, а затем сказать «n», включив подкаталог. Вы должны быть в состоянии запустить следующие команды и увидеть следующий вывод:
g++-4.8 --versionдолжен печатать
g++-4.8 (Ubuntu 4.8.1-2ubuntu1~12.04) 4.8.1
Copyright (C) 2013 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
и
/usr/local/bin/cmake --versionдолжен печатать
cmake version 3.2.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Как только все зависимости будут установлены, вы должны быть готовы к созданию. Запустите следующие команды, чтобы начать:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
CXX=g++-4.8 /usr/local/bin/cmake ../ -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
У Ubuntu 14.04 есть достаточно недавний GCC для построения мета, но нам нужно добавить PPA для более поздней версии Cmake.
Начните с запуска следующих команд для установки зависимостей для Meta.
# this might take a while
sudo apt-get update
sudo apt-get install software-properties-common
# add the ppa for cmake
sudo add-apt-repository ppa:george-edison55/cmake-3.x
sudo apt-get update
# install dependencies
sudo apt-get install g++ cmake libicu-dev git libjemalloc-dev zlib1g-devПосле того, как все зависимости будут установлены, вы должны дважды проверить свои версии, выполнив следующие команды.
g++ --versionдолжен вывозить
g++ (Ubuntu 4.8.2-19ubuntu1) 4.8.2
Copyright (C) 2013 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
и
cmake --versionдолжен вывозить
cmake version 3.2.2
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Как только все зависимости будут установлены, вы должны быть готовы к созданию. Запустите следующие команды, чтобы начать:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
cmake ../ -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
Предложение Ubuntu Non-LTS Desktop в 15.10 имеет достаточно современного программного обеспечения в своих хранилищах для создания мета без особых проблем. Чтобы установить зависимости, запустите следующие команды.
apt update
apt install g++ git cmake make libjemalloc-dev zlib1g-devКак только все зависимости будут установлены, вы должны быть готовы к созданию. Запустите следующие команды, чтобы начать:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
cmake ../ -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
Arch Linux последовательно имеет самые современные пакеты из -за настройки Rolling Release, так что это часто самая простая платформа для настройки.
Чтобы установить зависимости, запустите следующие команды.
sudo pacman -Sy
sudo pacman -S clang cmake git icu libc++ make jemalloc zlibКак только все зависимости будут установлены, вы должны быть готовы к созданию. Запустите следующие команды, чтобы начать:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
CXX=clang++ cmake ../ -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
Это было протестировано с Fedora 22+ (самая старая в настоящее время поддерживается Fedora на момент письма). Вы можете иметь успех с более ранними версиями, но это не тестируется. (Если вы находитесь в более старой версии Fedora, используйте yum вместо dnf для команд, приведенных ниже.)
Чтобы начать, установите некоторые зависимости:
# These may be already installed
sudo dnf install make git wget gcc-c++ jemalloc-devel cmake zlib-develВы должны быть в состоянии запустить следующие команды и увидеть следующий вывод:
g++ --versionдолжен печатать
g++ (GCC) 5.3.1 20151207 (Red Hat 5.3.1-2)
Copyright (C) 2015 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
и
cmake --versionдолжен печатать
cmake version 3.3.2
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Как только все зависимости будут установлены, вы должны быть готовы к созданию. Запустите следующие команды, чтобы начать:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
cmake ../ -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему со следующей командой:
./unit-test --reporter=spec Мета может быть построена в CentOS 7 и выше. Centos 7 поставляется с достаточно недавним компилятором (GCC 4.8.5), но слишком старая версия Cmake. Таким образом, мы установим компилятор и связанные с ними библиотеки из менеджера пакетов и сами установим свой собственный более поздний cmake .
# install build dependencies (this will probably take a while)
sudo yum install gcc gcc-c++ git make wget zlib-devel epel-release
sudo yum install jemalloc-devel
wget http://www.cmake.org/files/v3.2/cmake-3.2.0-Linux-x86_64.sh
sudo sh cmake-3.2.0-Linux-x86_64.sh --prefix=/usr/local --exclude-subdirВы должны быть в состоянии запустить следующие команды и увидеть следующий вывод:
g++ --versionдолжен печатать
g++ (GCC) 4.8.5 20150623 (Red Hat 4.8.5-4)
Copyright (C) 2015 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
и
/usr/local/bin/cmake --versionдолжен печатать
cmake version 3.2.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Как только все зависимости будут установлены, вы должны быть готовы к созданию. Запустите следующие команды, чтобы начать:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
/usr/local/bin/cmake ../ -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
Примечание. Пожалуйста, не делайте этого, если вы можете получить мета -работу каким -либо другим возможным способом , так как файловая система EWS имеет привычку быть невыносимо медленным и увеличивая время компиляции на несколько порядков. Например, сравнение шагов cmake , make и unit-test на моем рабочем столе и EWS дает следующее:
| система | время cmake | make время | Время unit-test |
|---|---|---|---|
| мой рабочий стол | 0m7.523s | 2m30.715s | 0m36.631s |
| EWS | 1m28s | 11m28.473s | 1m25.326s |
Если вы находитесь на машине, управляемой разработкой ее в UIUC, вы должны следовать этому руководству. Эти системы имеют программное обеспечение, которое слишком старое для создания мета, но Engrit был достаточно любезен, чтобы упаковать обновленные версии исследовательского программного обеспечения в качестве модулей. Модули, предоставленные для GCC и Cmake, достаточно недавно, чтобы построить мета, так что это в основном просто.
Чтобы настроить ваши зависимости ( вам нужно делать это каждый раз, когда вы войдите в систему ), запустите следующие команды:
module load gcc
module load cmake/3.5.0Как только вы это сделаете, дважды проверьте свои версии, выполнив следующие команды.
g++ --versionдолжен вывозить
g++ (GCC) 5.3.0
Copyright (C) 2015 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
и
cmake --versionдолжен вывозить
cmake version 3.5.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Если ваши версии верны, вы должны быть готовы построить. Чтобы начать, запустите следующие команды:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta/
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
CXX= ` which g++ ` CC= ` which gcc ` cmake ../ -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
Meta может быть построена на Windows, используя инструмент Mingw-W64 с GCC. Мы настоятельно рекомендуем использовать MSYS2, так как это облегчает извлечение компилятора и связанных библиотек значительно проще, чем было бы иначе, и имеет тенденцию иметь очень актуальные пакеты по сравнению с другими подобными распределениями Mingw.
Примечание. Если вы обнаружите себя запутанным или потерянным по приведенным ниже инструкциям, пожалуйста, обратитесь к наше руководство по визуальной настройке для Windows, которое включает в себя скриншоты для каждого шага, включая обновление MSYS2 и инструментального оборудования Mingw-W64.
Для начала загрузите установщик для MSYS2 с связанного веб -сайта и следуйте инструкциям на этой странице. После того, как вы установили его, вы должны использовать оболочку Mingw, чтобы запустить новый терминал, в котором вы должны запустить следующие команды для загрузки зависимостей и связанного программного обеспечения, необходимого для построения:
pacman -Syu git make patch mingw-w64-x86_64-{gcc,cmake,icu,jemalloc,zlib} --force ( --force необходима для оборудования ошибки с новейшим установщиком MSYS2 на момент написания времени.)
Затем выйдите из оболочки и запустите Shell "Mingw-W64 Win64". Вы можете получить инструментарий и начать с:
# clone the project
git clone https://github.com/meta-toolkit/meta.git
cd meta
# set up submodules
git submodule update --init --recursive
# set up a build directory
mkdir build
cd build
cp ../config.toml .
# configure and build the project
cmake .. -G " MSYS Makefiles " -DCMAKE_BUILD_TYPE=Release
makeТеперь вы можете проверить систему, выполнив следующую команду:
./unit-test --reporter=specЕсли все пройдет, поздравляю! Мета, кажется, работает над вашей системой.
Есть правила для чистого, аккуратного и доктора. После того, как вы запустите команду cmake , вы сможете просто make как обычно, когда вы разрабатываете,-это обнаружит, когда файл cmakelists.txt изменился, и восстановить маркировку, если это необходимо.
Для компиляции в режиме отладки просто замените Release от Debug в соответствующей команде cmake для вашей ОС выше и восстановите, используя make After.
Не стесняйтесь обращаться на форуме, если вы столкнетесь с проблемами, которые создают настройку. Мы регулярно строим с широким спектром компиляторов и операционных систем с помощью наших настройки непрерывной интеграции (Travis-Ci для Linux и OS X и Appveyor для Windows), поэтому мы можем быть достаточно уверены, что все должно основываться почти на всех основных платформах.
