.. image:: https://img.shields.io/github/issues-pr-raw/molssi-seamm/dftbplus_step :target: https://github.com/molssi-seamm/dftbplus_step/pulls :alt: GitHub pull requests
.. image:: https://github.com/molssi-seamm/dftbplus_step/workflows/CI/badge.svg :target: https://github.com/molssi-seamm/dftbplus_step/actions :alt: Build Status
.. image:: https://codecov.io/gh/molssi-seamm/dftbplus_step/branch/master/graph/badge.svg :target: https://codecov.io/gh/molssi-seamm/dftbplus_step :alt: Code Coverage
.. image:: https://github.com/molssi-seamm/dftbplus_step/workflows/CodeQL/badge.svg :target: https://github.com/molssi-seamm/dftbplus_step/security/code-scanning :alt: Code Quality
.. image:: https://github.com/molssi-seamm/dftbplus_step/workflows/Release/badge.svg :target: https://molssi-seamm.github.io/dftbplus_step/index.html :alt: Documentation Status
.. image:: https://img.shields.io/pypi/v/dftbplus_step.svg :target: https://pypi.python.org/pypi/dftbplus_step :alt: PyPi VERSION
A SEAMM_ plug-in for DFTB+, a fast quantum mechanical simulation code.
This plug-in provides a graphical user interface (GUI) for setting up
simulations using DFTB+_ quantum mechanical simulation software
package. DFTB+ does quantum mechanical simulations similar to standard
density functional theory (DFT) for molecules, crystals and
materials. The simulations are carried out in an approximate way using
the D\ ensity F\ unctional based T\ ight B\ inding
method (DFTB), which is typically about two orders of magnitude faster
than traditonal DFT.
DFTB website_.At the moment the plug-in only handles molecular (non-periodic) systems. Periodic systems will be added in an upcoming release.
.. _SEAMM: https://github.com/molssi-seamm .. _DFTB+: https://dftbplus.org .. _DFTB website: https://dftb.org
This package was created with Cookiecutter_ and the
molssi-seamm/cookiecutter-seamm-plugin_ project template.
Developed by the Molecular Sciences Software Institute (MolSSI_), which receives funding from the National Science Foundation under award ACI-1547580
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _molssi-seamm/cookiecutter-seamm-plugin: https://github.com/molssi-seamm/cookiecutter-seamm-plugin
.. _MolSSI: https://molssi.org
2025.2.7 -- Bugfix: Issue with logging and geomeTRIC * Logging at the INFO level made the output from geomTRIC too verbose. Changed to DEBUG level.
2025.1.21 -- Bugfix: Issue with spin-polarized calculations * The code had several errors to do with detecting whether the calculation was spin-polarized or not. This has been fixed and the detection simplified.
2024.12.14 -- Bugfix: Issue with initialization in subflowcharts
2024.10.20 -- Added the standard results for drivers * Added the standard results -- energy, gradients, and model -- that can be written to Results.json for drivers like Structure Step and Thermochemistry Step.
2024.7.30 -- Fix: the Docker build needed updating for changes in SEAMM
2024.7.29 -- Bugfix: initial version of dftbplus.ini * The initial version of dftbplus.ini was not generated correctly if it was missing. This caused a crash when running DFTB+.
2024.4.24 -- Finalized support for Docker containers * Fixed issues and tested running in containers. * Add CI to make a Docker image for DFTB+ * Fixed issue with changes in input for DFTB+: CalculateGradients has become PrintGradients it seems.
2024.1.18 -- Support for running in containers and writing input only. * Added new property: scaled dipole. * Added option to write the input file and not run DFTB+
2023.11.10 -- Standard structure handling and cleaned up output * Switched to standard structure handling and naming, giving consistent options across SEAMM. * Corrected issues with the model name in the properties. * Generally cleaned up the output, mainly indentation.
2023.11.8 -- Bugfix: Fermi level being an array caused problems * The Fermi level in DFTB+ is a vector with 1 or 2 elements, depending whether the calculation is spin-polarized. DFTB+ can handle different Fermi levels, but it is not clear how useful this is, so for the time being not allowing such calculations and treating the Fermi level as a scalar.
2023.11.7 -- Added structure to orbital and density plots * The Dashboard expects 'structure.sdf' in order to display the structure with the orbital or density plots from CUBE files.
2023.3.5 -- Fixed issues with bandstructure and DOS * The bandstructure and DOS substeps updated to work with changes in the underlying classes. This had been missed earlier.
2023.2.17.2 -- Fixed bug with xTB parameters * xTB runs have a blank line in results.tag which caused a crash.
2023.2.17.1 -- Fixed Linux bug with thread limit
2023.2.17 -- Limiting number of threads * By default DFTB+ can try to use all the cores on a larger machine, which can be inneficient for smaller systems. This changes limits DFTB+ to 1 core per 500 atoms, which seems a reasonable start. This will need more work in the future.
2023.2.15 -- Documentation and bug fixes * Restructured the documentation and applied the new theme. * Fixed crash with the plots for potentials that lack the need info for the plots. Silently ignore the plots. * Added standard properties.
2022.10.20 -- Added handling of properties in the database.
2022.9.18 -- Added spin parameters for 3ob dataset * Added the spin parameters for the 3ob parameter set from Prof. Elstner. These were provide by Kewei Zhao on the DFTB+ mailing list, 2022-9-8.
2022.9.15 -- Bugfix: plots for periodic systems * fixed error with density and orbital plots for periodic systems.
2022.9.9 -- Density and orbital plots * Added plots for the density, spin density, and orbitals.
2022.8.22 -- More documentation. * Added the DFTB+ recipe #2
2022.8.21 -- Fixed issue using Python 3.10
2022.8.21 -- Documentation update * Added initial recipes (tutorials)
2022.8.19 -- Improved information about the energy * Corrected total energy to be that of the conventional cell * Added how many primitive cells make up the conventional cell * Added energy per empirical formula unit * Added these energies and counts to the output data, if selected.
2022.8.17 -- Finally fully added DOS and band structure * Now handle magnetic systems * Fixed issues with symmetry changing during optimization cause crashes * Fixed incorrect printing of atom charges and spins * Enhance the ChooseParameters step to support using variables for the parameter dataset and subset
2022.7.24 -- Support for magnetism * Fixed and improved handling of spin in periodic systems * By default now use a previous charge file or charges and spins on atoms, if available, as starting guess. * DOS and bandstructure extended to spin-polarized systems, and a combined graph added for DOS & bandstructure.
2022.7.20.1 -- Correction to DOS and band structure The DOS and band structure needed to be shifted to place the Fermi energy at zero.
2022.7.20 -- Bug fix for band structure Band structure sometimes had a fatal error due to charges on the structure as well as in the charge file from a previous run.
2022.5.23 -- Bug fixes * Spin polarized calculations & more output * Added control over using primitive or actual cell. * Bug fixes: handling atoms with no charge, and printing k-mesh
2022.3.16 -- Added control over using primitive or full cell While usually it is best to use the full symmetry and primitive cell, for some calculations where cancelation of error is import, e.g. defect energies, it is important to use the same cell in all the calculations. This feature allows for this.
2022.3.14 -- Handling spin-polarization and improved output of charges and spin
2022.2.25 -- Added xTB parameters
2022.2.8 -- Added DOS and band structure * Added handling of space group symmetry. * Automatically use the primitive cell when it is different from the conventional cell. * Calculate and graph the DOS when running the energy or optimization. * Added a band structure sub-step to calculate and graph the band structure. This is an initial, working version, but needs considerable enhancement. * To accomplish the above, restructured the code significantly and moved the actual execution of DFTB+ to the appropriate sub-steps. This is need to support e.g. band structure which requires two sequential calculations, the first to calculate the charge density and the second to get the band structure from the fixed charge density.
2022.1.18 -- Updated for DFTB+ 21.2 * Updated to the latest version of DFTB+ (21.2), which made large changes in how optimizations are handled. * Updated the structure handling to give the standard options for where to put the modified configuration and how to name it. * Added enhancement to calculate the electronic energy of formation, and added the reference energies to the metadata for the main 3ob and mio datasets.
2021.11.26 -- Periodic calculations Added handling of the reciprocal space k-mesh for periodic calculations.
2021.10.13 -- Minor fixes and format issues. Also updated for Python 3.8 and 3.9
2021.6.5 -- Added installation of Slater-Koster files.
2021.6.4 -- Updated for new command-line argument handling. Corrected the default path for the Slater-Koster functions.
2021.5.21 -- Added installer for DFTB+ background code Added a plug-in specific installer that installs DFTB+ in the seamm-dftbplus environment if needed, and sets up the configuration file entries needed.
Internal Release
FAQs
A SEAMM plug-in for DFTB+, a fast quantum mechanical simulation code.
We found that dftbplus-step demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Create React App is officially deprecated due to React 19 issues and lack of maintenance—developers should switch to Vite or other modern alternatives.
Security News
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
Security News
The Linux Foundation is warning open source developers that compliance with global sanctions is mandatory, highlighting legal risks and restrictions on contributions.