meta
v3.0.2
Veuillez visiter notre page Web pour des informations et des tutoriels sur Meta!
Meta est une boîte à outils moderne des sciences de données C ++ avec
La documentation du doxygène peut être trouvée ici.
Nous avons des procédures pas à pas pour quelques parties différentes de Meta sur la page d'accueil de Meta.
Si vous avez utilisé Meta dans vos recherches, nous apprécierions grandement une citation pour notre document de démonstration du LCA:
@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 ou plus est requis. Vous avez peut-être du succès avec 10,5, mais ce n'est pas testé.
Vous devrez installer Homebrew, ainsi que les outils de ligne de commande pour Xcode (Homebrew le nécessite également, et cela les incitera pendant l'installation, ou vous pouvez les installer avec xcode-select --install sur les versions récentes de OS X).
Une fois l'installation de Homebrew, exécutez les commandes suivantes pour obtenir les dépendances de Meta:
brew update
brew install cmake jemalloc lzlib icu4cPour commencer, exécutez les commandes suivantes:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
Les instructions ici dépendent considérablement de votre version installée d'Ubuntu. Pour vérifier la version sur laquelle vous vous trouvez, exécutez la commande suivante:
cat /etc/issueSur la base de ce que vous voyez, vous devriez procéder avec l'un des guides suivants:
Si votre version est inférieure à 12,04 LTS, votre système d'exploitation n'est pas pris en charge (même par votre fournisseur!) Et vous devez passer à au moins 12,04 LTS (ou 14.04 LTS, si possible).
S'appuyer sur Ubuntu 12.04 LTS nécessite plus de travail que sa sœur plus à jour 14.04, mais cela peut être fait relativement facilement. Vous devrez cependant installer un compilateur C ++ plus récent à partir d'un PPA et y passer pour construire Meta. Nous devrons également installer une nouvelle version CMake plus récente qui est disponible nativement.
Commencez par exécuter les commandes suivantes pour obtenir les dépendances dont nous aurons besoin pour construire Meta.
# 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/localLors de l'installation de CMake, vous devez accepter la licence, puis dire "n" à l'inclusion du sous-répertoire. Vous devriez être en mesure d'exécuter les commandes suivantes et de voir la sortie suivante:
g++-4.8 --versiondevrait imprimer
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.
et
/usr/local/bin/cmake --versiondevrait imprimer
cmake version 3.2.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Une fois les dépendances toutes installées, vous devez être prêt à construire. Exécutez les commandes suivantes pour commencer:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
Ubuntu 14.04 a un GCC suffisamment récent pour construire Meta, mais nous devrons ajouter un PPA pour une version plus récente de Cmake.
Commencez par exécuter les commandes suivantes pour installer les dépendances pour 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-devUne fois que les dépendances sont toutes installées, vous devez doubler vos versions en exécutant les commandes suivantes.
g++ --versiondevrait sortir
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.
et
cmake --versiondevrait sortir
cmake version 3.2.2
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Une fois les dépendances toutes installées, vous devez être prêt à construire. Exécutez les commandes suivantes pour commencer:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
L'offre de bureau non LTS d'Ubuntu en 15.10 a suffisamment de logiciels modernes dans ses référentiels pour construire Meta sans trop de problème. Pour installer les dépendances, exécutez les commandes suivantes.
apt update
apt install g++ git cmake make libjemalloc-dev zlib1g-devUne fois les dépendances toutes installées, vous devez être prêt à construire. Exécutez les commandes suivantes pour commencer:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
Arch Linux possède régulièrement les packages les plus à jour en raison de sa configuration de libération de roulement, c'est donc souvent la plate-forme la plus facile à installer.
Pour installer les dépendances, exécutez les commandes suivantes.
sudo pacman -Sy
sudo pacman -S clang cmake git icu libc++ make jemalloc zlibUne fois les dépendances toutes installées, vous devez être prêt à construire. Exécutez les commandes suivantes pour commencer:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
Cela a été testé avec Fedora 22+ (le Fedora le plus ancien actuellement soutenu à l'époque de la rédaction). Vous avez peut-être du succès avec des versions antérieures, mais ce n'est pas testé. (Si vous êtes sur une ancienne version de Fedora, utilisez yum au lieu de dnf pour les commandes ci-dessous.)
Pour commencer, installez certaines dépendances:
# These may be already installed
sudo dnf install make git wget gcc-c++ jemalloc-devel cmake zlib-develVous devriez être en mesure d'exécuter les commandes suivantes et de voir la sortie suivante:
g++ --versiondevrait imprimer
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.
et
cmake --versiondevrait imprimer
cmake version 3.3.2
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Une fois les dépendances toutes installées, vous devez être prêt à construire. Exécutez les commandes suivantes pour commencer:
# 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
makeVous pouvez maintenant tester le système avec la commande suivante:
./unit-test --reporter=spec La méta peut être construite dans CentOS 7 et plus. Centos 7 est livré avec un compilateur suffisamment récent (GCC 4.8.5), mais une version trop ancienne de CMake. Nous allons donc installer le compilateur et les bibliothèques connexes à partir du gestionnaire de packages et installer notre propre cmake plus récent nous-mêmes.
# 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-subdirVous devriez être en mesure d'exécuter les commandes suivantes et de voir la sortie suivante:
g++ --versiondevrait imprimer
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.
et
/usr/local/bin/cmake --versiondevrait imprimer
cmake version 3.2.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Une fois les dépendances toutes installées, vous devez être prêt à construire. Exécutez les commandes suivantes pour commencer:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
Remarque: veuillez ne pas le faire si vous êtes en mesure de faire fonctionner la méta de toute autre manière possible , car le système de fichiers EWS a l'habitude d'être insupportablement lent et d'augmenter les temps de compilation de plusieurs ordres de grandeur. Par exemple, la comparaison des étapes cmake , make et unit-test sur mon bureau contre EWS donne les éléments suivants:
| système | Temps de cmake | make le temps | temps unit-test |
|---|---|---|---|
| mon bureau | 0m7.523s | 2m30.715 | 0m36.631s |
| Ews | 1m28 | 11m28.473 | 1M25.326S |
Si vous êtes sur une machine gérée en l'ingénierie à l'UIUC, vous devez suivre ce guide. Ces systèmes ont des logiciels beaucoup trop vieux pour construire Meta, mais Engrit a eu la gentillesse de former des versions mises à jour du logiciel de recherche comme modules. Les modules fournis pour GCC et CMake sont suffisamment récents pour construire des méta, il est donc en fait principalement simple.
Pour configurer vos dépendances ( vous devrez le faire chaque fois que vous vous connectez au système ), exécutez les commandes suivantes:
module load gcc
module load cmake/3.5.0Une fois que vous avez fait cela, vérifiez vos versions en exécutant les commandes suivantes.
g++ --versiondevrait sortir
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.
et
cmake --versiondevrait sortir
cmake version 3.5.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).
Si vos versions sont correctes, vous devez être prêt à construire. Pour commencer, exécutez les commandes suivantes:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
Meta peut être construite sur Windows à l'aide de la chaîne d'outils MingW-W64 avec GCC. Nous recommandons fortement d'utiliser MSYS2 car cela facilite la récupération du compilateur et des bibliothèques associées qu'il ne le serait autrement, et il a tendance à avoir des packages très à jour par rapport à d'autres distributions MingW similaires.
Remarque: Si vous vous trouvez confus ou perdu par les instructions ci-dessous, veuillez consulter notre guide de configuration visuelle pour Windows qui comprend des captures d'écran pour chaque étape, y compris la mise à jour de MSYS2 et la chaîne d'outils MingW-W64.
Pour démarrer, téléchargez l'installateur de MSYS2 à partir du site Web lié et suivez les instructions de cette page. Une fois que vous l'avez installé, vous devez utiliser le shell Mingw pour démarrer un nouveau terminal, dans lequel vous devez exécuter les commandes suivantes pour télécharger les dépendances et les logiciels connexes nécessaires à la construction:
pacman -Syu git make patch mingw-w64-x86_64-{gcc,cmake,icu,jemalloc,zlib} --force (La --force est nécessaire pour contourner un bug avec le dernier installateur MSYS2 à l'époque de la rédaction.)
Ensuite, quittez le shell et lancez le shell "MingW-W64 Win64". Vous pouvez obtenir la boîte à outils et commencer avec:
# 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
makeVous pouvez maintenant tester le système en exécutant la commande suivante:
./unit-test --reporter=specSi tout passe, félicitations! Meta semble travailler sur votre système.
Il y a des règles pour nettoyer, bien rangé et doc. Après avoir exécuté la commande cmake une fois, vous pourrez simplement exécuter make comme d'habitude lorsque vous développez --- cela détectera quand le fichier cMakelists.txt a changé et reconstruire des makefiles si elle en a besoin.
Pour compiler en mode débogage, remplacez simplement Release par Debug dans la commande cmake appropriée pour votre système d'exploitation ci-dessus et reconstruisez en utilisant make après.
N'hésitez pas à tendre la main sur le forum si vous rencontrez des problèmes à installer. Nous construisons régulièrement avec une grande variété de compilateurs et de systèmes d'exploitation grâce à nos configurations d'intégration continue (Travis-Ci pour Linux et OS X et Appveyor pour Windows), nous pouvons donc être assez certains que les choses devraient s'appuyer sur presque toutes les principales plateformes.
