Code

D3Q

Third-order anharmonicity and thermal transport by DFPT.

openmaterials.ai / codes / D3Q

D3Q: third-order anharmonicity by perturbation theory, thermal transport by variation

A Quantum ESPRESSO extension: three-phonon matrix elements for arbitrary wave vectors by the 2n+1 theorem, and the phonon Boltzmann equation solved exactly by conjugate gradients.

What it is and how it works

No supercells for the third order

The 2n+1 theorem of density functional perturbation theory gives the third derivative of the energy from first-order wave functions, for three arbitrary wave vectors and for metals as well as insulators (Paulatto 2013).

DFPT 2n+1 matrix elements

An extension of the D3 code computes the anharmonic coefficients on a coarse q grid, 4x4x4 for diamond, then Fourier interpolates them to the dense mesh (Fugallo 2013).

Variational conjugate gradient

The exact BTE solution minimizes a quadratic functional. Preconditioned conjugate gradients converge in four iterations where plain iteration fails at 77 (Fugallo 2013).

Normal, Umklapp, isotopes, borders

Three-phonon normal and Umklapp collisions, elastic isotope scattering from mass variance, and border scattering through a Casimir length and shape factor (Fugallo 2013).

Linewidths at any q

Anharmonic broadening of each branch at finite T, with steps and spikes along the optical branches of graphene and nonzero TA and LA widths at small q (Paulatto 2013).

Collective excitations

The exact solution holds collective phonon excitations, the heat carriers in graphite and graphene, where the SMA is ten times too low (Fugallo 2014).

What people do with it

  • 4conjugate gradient iterations, diamond at 100 KFugallo 2013
  • 3times higher kappa for 0% C13 than 0.07% diamondFugallo 2013
  • 30x30x30q mesh for converged diamond lifetimes, 20 cm-1Fugallo 2013

Graphite and graphene, exact versus SMA

The exact BTE gives the 2000 W/m/K measured in graphite. The SMA gives a tenth. Graphene reaches intrinsic kappa only near 1 mm, with mean free paths of hundreds of um (Fugallo 2014). Fugallo 2014

Phonon hydrodynamics in 2D

In graphene, BN, MoS2, graphane and fluorographene normal scattering dominates above cryogenic T: Poiseuille and Ziman regimes, second sound over about 1 mm in graphene (Cepellotti 2015). Cepellotti 2015

Isotopically enriched diamond

At 100 K the exact BTE follows measurements for 98.9%, 99.9% and 99.93% C12 samples, and predicts up to three times higher kappa for fully enriched diamond (Fugallo 2013). Fugallo 2013

How it is used

  1. Harmonic part

    Quantum ESPRESSO ground state and DFPT phonons on a coarse q grid. d3_q2r.x writes mat2R.

  2. Third order by DFPT

    The 2n+1 matrix elements on the coarse grid. d3_qq2rr.x writes the real-space mat3R.

  3. Refine mat3R

    d3_asr3.x imposes acoustic sum rules and d3_sparse.x prunes small elements.

  4. Linewidths

    d3_lw.x with calculation='lw imag' on a dense q mesh and a smearing in cm-1.

  5. Conductivity

    d3_tk.x with calculation='sma' for RTA or 'cgp' for the exact variational solution.

What D3Q is, how it works and what it is used for, from the papers listed as sources. Every number links to its paper.Poster pageDownload the poster (PNG, 1920 x 1080)

What D3Q is

D3Q extends Quantum ESPRESSO with the third derivative of the energy from density-functional perturbation theory, giving anharmonic force constants without finite displacements. Its thermal transport code solves the Boltzmann equation variationally and computes phonon linewidths. On the map it serves the third-order force constants, the linewidths and the conductivities.

In more detail

Third-order force constants without supercells

The three-phonon scattering coefficients are third derivatives of the total energy with respect to three phonon displacements with wave vectors q, q' and q'' summing to a reciprocal lattice vector. The 2n+1 theorem of density functional perturbation theory expresses them through the first-order change of the density and wave functions, so no supercell is needed. Paulatto 2013 extended the D3 code of Quantum ESPRESSO from the (0, -q, q) case to three arbitrary wave vectors and to metals and zero-gap systems (Paulatto 2013). The coefficients are computed on a coarse grid, 4x4x4 for diamond, and Fourier interpolated to the dense mesh of the transport calculation (Fugallo 2013).

The exact solution of the Boltzmann equation

The Omini-Sparavigna iteration from the single-mode approximation converges only when resistive processes dominate. Fugallo 2013 recast the problem as the minimization of a quadratic functional whose minimum is the conductivity and solved it with a preconditioned conjugate gradient. For diamond at 100 K on a 30x30x30 mesh with 20 cm-1 smearing the iteration becomes unstable after 77 steps at a precision of about 300 W/m/K, while the conjugate gradient converges in four. Without borders the iteration fails after 91 steps with an error near 3000 W/m/K (Fugallo 2013). The transport step cost two orders of magnitude more CPU time than the DFPT force constants.

Linewidths and the single-mode approximation

The anharmonic broadening of a mode is the imaginary part of its self energy, summed over a fine q grid with the two energy-conserving deltas smeared. In graphene the broadening of the optical branches shows sudden steps and spikes, and the TA and LA branches keep a finite width at small q at finite temperature. Within the single-mode approximation the out-of-plane conductivity of graphite agrees with experiment while the in-plane value is about a factor two too low (Paulatto 2013). The exact solution closes this gap. The in-plane conductivity of graphite is an order of magnitude above the SMA and matches the 2000 W/m/K measured on large perfect crystals (Fugallo 2014).

Validation

For diamond the exact BTE follows the measured temperature dependence for samples with 98.9%, 99.9% and 99.93% C12, and a Casimir length of 0.3 cm with shape factor 0.5 describes the finite size (Fugallo 2013). For graphene the exact solution reaches the diffusive limit at lengths two orders of magnitude above the SMA, between 100 um and 1 mm, so an intrinsic kappa needs samples of order 1 mm. Hydrogenation halves the conductivity and fluorination cuts it by an order of magnitude (Fugallo 2014). In graphene, boron nitride and graphane second sound survives to room temperature, and in graphene it propagates over distances of order 1 mm (Cepellotti 2015).

What it computes on the map

5 quantities, drawn by tier with the data flow between them. Dashed boxes are intermediate quantities. Select one for its formula and the other codes that compute it.

Open the full mapShare this submap
Embed this submap
<iframe src="https://openmaterials.ai/m/c56731602651/3000080280?embed=1" title="D3Q on the OpenMaterials map" width="100%" height="480" loading="lazy" style="border:1px solid #EBEBEB;border-radius:6px"></iframe>

Each quantity with the interface the representation records.

Releases on record

Versions on record for this code, with the license read from the release itself.

VersionReleasedLicense
q-e-7.52025-07-24GPL-2.0-only AND (CECILL-2.1 OR GPL-2.0-or-later) AND GPL-3.0-only AND Minpack

References

The code

The papers that describe the code; cite them when you use it.

  1. G. Fugallo, M. Lazzeri, L. Paulatto et al., Ab initio variational approach for evaluating lattice thermal conductivity, Physical Review B, 2013. doi.org/10.1103/PhysRevB.88.045430
  2. L. Paulatto, F. Mauri, M. Lazzeri, Anharmonic properties from a generalized third-order ab initio approach: Theory and applications to graphite and graphene, Physical Review B, 2013. doi.org/10.1103/PhysRevB.87.214303

Applications

Highly cited studies that cite the code, with a few picked by hand.

  1. G. Fugallo, A. Cepellotti, L. Paulatto et al., Thermal Conductivity of Graphene and Graphite: Collective Excitations and Mean Free Paths, Nano Letters, 2014. doi.org/10.1021/nl502059f
  2. A. Cepellotti, G. Fugallo, L. Paulatto et al., Phonon hydrodynamics in two-dimensional materials, Nature Communications, 2015. doi.org/10.1038/ncomms7400

How to cite

L. Paulatto, F. Mauri, M. Lazzeri, Anharmonic properties from a generalized third-order ab initio approach: Theory and applications to graphite and graphene, Phys. Rev. B 87, 214303 (2013); exact BTE: G. Fugallo, M. Lazzeri, L. Paulatto, F. Mauri, Ab initio variational approach for evaluating lattice thermal conductivity, Phys. Rev. B 88, 045430 (2013), doi:10.1103/PhysRevB.88.045430

doi.org/10.1103/PhysRevB.87.214303