/iDEA

interacting Dynamic Electrons Approach

Primary LanguageJupyter NotebookOtherNOASSERTION

iDEA - The interacting Dynamic Electrons Approach

Exploring exact and approximate methods for many-electron quantum mechanics.

pip tag Documentation Status Issues Pull Requests

iDEA (interacting Dynamic Electrons Approach) is a high-performance, user friendly, free software framework in python for state-of-the-art research, experiments, testing and education in many-body quantum physics with a focus on reproducibility, interactivity and simplicity.

Homepage

View on GitHub

demo

Installation

User

To install the latest version of the iDEA code:

pip install iDEA-latest

To add iDEA to your poetry environment:

poetry add iDEA-latest

Developer

If you would like to develop iDEA, first fork this git repository, and then clone from there.

Add the upstream repository: git remote add upstream https://github.com/iDEA-org/iDEA.git

And then install locally: python setup.py install

Documentation

For full details of usage please see our tutorial. The full API documentation is available at readthedocs.

Features

Some of iDEA's features:

  • Exact solution of the many-electron problem by solving the static and time-dependent Schrödinger equation, including exact exchange and correlation.
  • Exact solutions which approach the degree of exchange and correlation in realistic systems.
  • Free choice of external potential that may be time-dependent, on an arbitrarilty dense spatial grid, for any number of electron with any spin configuration.
  • Implementation of various approximate methods (established and novel) for comparison, including:
    • Non-interacting electrons
    • Hartree theory
    • Restricted and unrestricted Hartree-Fock
    • The Local Density Approximation (LDA)
    • Hybrid functionals
  • Implementation of all common observables.
  • Reverse-engineering to solve potential inversion, from exact Kohn-Sham DFT and beyond.
  • Fully parallelised using OpenBLAS.
  • Fully parallelised for all cuda supporting GPUS.

Example

In order to solve the Schrödinger equation for the two electron atom for the ground-state charge density and total energy:

import iDEA
system = iDEA.system.systems.atom
ground_state = iDEA.methods.interacting.solve(system, k=0)
n = iDEA.observables.density(system, state=ground_state)
E = ground_state.energy

import matplotlib.pyplot as plt
print(E)
plt.plot(system.x, n, 'k-')
plt.show()

Tutorial

We provide a tutorial where you can learn how to use the iDEA code in your research and teaching projects.

Papers You Can Reproduce With iDEA

  1. "Advantageous nearsightedness of many-body perturbation theory contrasted with Kohn-Sham density functional theory", J. Wetherell, M. J. P. Hodgson, L. Talirz, and R. W. Godby, Physical Review B 99 045129 (2019). paper, reprint, preprint, code.

More coming soon...

The development and applications of the iDEA code from 2010 to 2021 is documented here.

Teaching

iDEA can also be used to create teaching content, visualisations and expositions> For example, see the following YouTube video created using iDEA.

iDEA was used to create teaching content for the Density Functional Theory MOOC on Coursera.

Developers

Contributors

We thank all of the developers, PhD students, masters students, summer project interns and researchers for thier key contributions to iDEA:

Sean Adamson, Jacob Chapman, Thomas Durrant, Razak Elmaslmane, Mike Entwistle, Rex Godby, Matt Hodgson, Piers Lillystone, Aaron Long, Robbie Oliver, James Ramsden, Ewan Richardson, Matthew Smith, Leopold Talirz and Jack Wetherell.

Getting Involved

To get involved:

  • Raising issues and pull requests here is greatly appreciated!
  • We can add any papers that can be fully reproduced by iDEA to our dedicated page by sending your open access paper to jack.wetherell@gmail.com.
  • We provide a template to get you started!

Dependencies

iDEA supports python 3.8+ along with the following dependences:

numpy >= "1.22.3"
scipy >= "1.8.0"
matplotlib >= "3.5.1"
jupyterlab >= "3.3.2"
tqdm >= "4.64.0"