Il s'agit du référentiel officiel du package de programme xtb
développé par le groupe Grimme à Bonn.
Les binaires liés statiquement (Intel Compiler) peuvent être trouvés sur la dernière page de version, une version pour Linux (Intel 18.0.2, GLIBC 2.19) et Windows (Intel 2022) est fournie. Le programme et la bibliothèque xtb
sont packagés sur conda-forge pour Linux (x86_64, aarch64, ppc64le) et MacOS (x86_64, arm64). Pour les utilisateurs homebrew, un tap personnalisé est disponible sur grimme-lab/homebrew-qc fournissant des binaires MacOS/x86_64 préconstruits, pour les binaires MacOS/arm64 seront compilés automatiquement lors de l'installation.
Les versions Bleeding Edge (Linux uniquement) de la dernière source de ce référentiel sont disponibles sur la balise de version continue.
Ce projet prend en charge deux systèmes de construction, meson et CMake. Un petit guide sur l'utilisation de chacun est donné ici, suivez les instructions liées pour des informations plus détaillées (guide des mésons, guide CMake).
Compilateurs :
Utiliser meson comme système de construction nécessite que vous installiez une version relativement nouvelle comme la 0.62 ou une version plus récente. Pour utiliser le backend par défaut de meson, vous devez installer Ninja version 1.7 ou plus récente.
export FC=ifort CC=icc
meson setup build --buildtype release --optimization 2 -Dfortran_link_args= " -qopenmp "
ninja -C build test
Important
La compilation avec meson
sur macOS diffère légèrement du protocole pour les systèmes basés sur Linux. Différentes bibliothèques BLAS peuvent conduire à des résultats divergents dans de rares cas – veuillez respecter les instructions suivantes.
gcc
, gfortran
et openblas
à l'aide de Homebrew. Plus d'informations sur la configuration brew
. Exemple: brew install gcc gfortran openblas
meson setup
adapté suivant pour compiler xtb
sur macOS. Évidemment, les chemins d'accès aux bibliothèques peuvent différer sur votre système. LDFLAGS= " -L/opt/homebrew/opt/openblas/lib " CPPFLAGS= " -I/opt/homebrew/opt/openblas/include " FC=gfortran-14 CC=gcc-14 meson setup _build --buildtype release -Dlapack=openblas
Assurez-vous que la suite de tests s'exécute sans erreurs.
Pour installer les binaires xtb
sur /usr/local
(cela peut nécessiter sudo
)
ninja -C build install
Pour plus d'informations sur la construction avec méson, consultez les instructions ici.
Le système de build CMake nécessite l'installation de make et de CMake, ce dernier doit être la version 3.9 ou plus récente.
Construire xtb
avec CMake fonctionne avec la chaîne de commandes suivante :
cmake -B build -DCMAKE_BUILD_TYPE=Release
make -C build
make -C build test
Pour installer les binaires xtb
sur /usr/local
(cela peut nécessiter sudo
)
make -C build install
Pour des informations plus détaillées sur la construction avec CMake, consultez les instructions ici.
L'installation de xtb
à partir du canal conda-forge
peut être réalisée en ajoutant conda-forge
à vos canaux avec :
conda config --add channels conda-forge
Une fois le canal conda-forge
activé, xtb
peut être installé avec :
conda install xtb
Il est possible de lister toutes les versions de xtb
disponibles sur votre plateforme avec :
conda search xtb --channel conda-forge
La documentation xtb
est hébergée sur read-the-docs.
Veuillez lire nos directives de contribution avant de contribuer à ce projet.
Nous développons ce programme pour rendre nos recherches possibles. De nombreuses fonctionnalités proposées aujourd'hui par xtb
ont été ajoutées parce qu'elles étaient absolument nécessaires et que de nombreux contributeurs ont fait de ces fonctionnalités une réalité :
Les contributeurs sont classés par ordre alphabétique. Certaines contributions sont antérieures à la version GitHub de ce projet et ne sont pas visibles dans l'historique des validations du référentiel. Pour les données des contributeurs de l'historique des validations depuis, regardez ici.
Référence générale à xtb
et aux méthodes GFN implémentées :
pour GFN-xTB :
pour GFN-FF :
pour la solvatation implicite GBSA et ALPB :
pour la solvatation implicite ddCOSMO et CPCM-X :
pour DFT-D4 :
pour sTDA-xTB :
dans le contexte des spécifications de masse :
pour la métadynamique, reportez-vous à :
pour les calculs SPH, reportez-vous à :
pour l’ONIOM se référer à :
Toutes les références sont disponibles au format bibtex.
xtb
est un logiciel libre : vous pouvez le redistribuer et/ou le modifier selon les termes de la licence publique générale limitée GNU telle que publiée par la Free Software Foundation, soit la version 3 de la licence, soit (à votre choix) toute version ultérieure.
xtb
est distribué dans l'espoir qu'il sera utile, mais sans aucune garantie ; sans même la garantie implicite de qualité marchande ou d’adéquation à un usage particulier. Voir la licence publique générale limitée GNU pour plus de détails.
Sauf indication contraire explicite de votre part, toute contribution soumise intentionnellement pour inclusion dans xtb
par vous, telle que définie dans la licence GNU Lesser General Public, sera sous licence comme ci-dessus, sans termes ou conditions supplémentaires.