From 832571b3663f0d10f74b6bf9dfb11c0f8ef3230b Mon Sep 17 00:00:00 2001 From: Sean Kavanagh Date: Mon, 15 Jul 2024 16:04:25 -0400 Subject: [PATCH] Update docs formatting and requirements --- CHANGELOG.rst | 8 ++++---- docs/Tips.rst | 2 ++ docs/docs_requirements.txt | 9 +++++---- docs/index.rst | 13 ++++++------- doped/utils/plotting.py | 2 +- 5 files changed, 18 insertions(+), 16 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 1be8c147..1fcd963a 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -67,11 +67,11 @@ v.2.3.3 ---------- - General robustness updates: - Updated file parsing to avoid hidden files. - - Sanity check in `DefectsGenerator` if input symmetry is `P1`. - - Add `NKRED` to `INCAR` mismatch tests. + - Sanity check in ``DefectsGenerator`` if input symmetry is ``P1``. + - Add ``NKRED`` to ``INCAR`` mismatch tests. - Re-parse config & spin degeneracies in concentration/symmetry functions if data not already present - (if user is porting `DefectEntry`s from older `doped` versions or manually). - - Avoid unnecessary `DeprecationWarning`s + (if user is porting ``DefectEntry``s from older ``doped`` versions or manually). + - Avoid unnecessary ``DeprecationWarning``s - Updated docs and linting v.2.3.2 diff --git a/docs/Tips.rst b/docs/Tips.rst index 85fed35f..cb3b9ff8 100644 --- a/docs/Tips.rst +++ b/docs/Tips.rst @@ -500,10 +500,12 @@ In the typical defect calculation workflow with ``doped`` (exemplified in the tu ``DefectsParser(output_path=".")`` – written to ``output_path``. The JSON filename can be set with e.g. ``DefectsParser(json_filename="custom_name.json")``, but the default is ``{Host Chemical Formula}_defect_dict.json``. + - Additionally, a ``voronoi_nodes.json`` file is saved to the bulk supercell calculation directory if any interstitial defects are parsed. This contains information about the Voronoi tessellation nodes in the host structure, which are used for analysing interstitial positions but can be somewhat costly to calculate – so are automatically saved to file once initially computed to reduce parsing times. + - Additionally, if following the recommended structure-searching approach with ``ShakeNBreak`` as shown in the tutorials, ``distortion_metadata.json`` files will be written to the top directory (``output_path``, containing distortion information about all defects) and to each defect directory (containing just the diff --git a/docs/docs_requirements.txt b/docs/docs_requirements.txt index 35333f6c..982f7e4e 100644 --- a/docs/docs_requirements.txt +++ b/docs/docs_requirements.txt @@ -1,7 +1,8 @@ -sphinx -myst-nb +sphinx>=7 +myst-nb>=1.0 recommonmark -renku-sphinx-theme +renku-sphinx-theme>=0.4.0 # can update to >0.5.0 when https://github.com/SwissDataScienceCenter/renku-sphinx-theme/pull/26 merged +sphinx_rtd_theme>=1.3.0 # can update to >2.0 when https://github.com/SwissDataScienceCenter/renku-sphinx-theme/pull/26 merged sphinx_click sphinx_design ase @@ -22,4 +23,4 @@ shakenbreak>=3.3.1 packaging pandas>=1.1.0 pydefect>=0.8.1 -vise>=0.9.0 \ No newline at end of file +vise>=0.9.0 diff --git a/docs/index.rst b/docs/index.rst index 461ee384..885300a1 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -94,14 +94,14 @@ Studies using ``doped``, so far - Z\. Yuan & G. Hautier **First-principles study of defects and doping limits in CaO** `Applied Physics Letters `_ 2024 - B\. E. Murdock et al. **Li-Site Defects Induce Formation of Li-Rich Impurity Phases: Implications for Charge Distribution and Performance of LiNi** :sub:`0.5-x` **M** :sub:`x` **Mn** :sub:`1.5` **O** :sub:`4` **Cathodes (M = Fe and Mg; x = 0.05–0.2)** `Advanced Materials `_ 2024 -- A\. G. Squires et al. **Oxygen dimerization as a defect-driven process in bulk LiNiO₂** `ChemRxiv `_ 2024 +- A\. G. Squires et al. **Oxygen dimerization as a defect-driven process in bulk LiNiO₂** `ChemRxiv `__ 2024 - Y\. Fu & H. Lohan et al. **Factors Enabling Delocalized Charge-Carriers in Pnictogen-Based Solar Absorbers: In-depth Investigation into CuSbSe2** `arXiv `_ 2024 -- S\. Hachmioune et al. **Exploring the Thermoelectric Potential of MgB4: Electronic Band Structure, Transport Properties, and Defect Chemistry** `Chemistry of Materials `_ 2024 -- J\. Hu et al. **Enabling ionic transport in Li3AlP2 the roles of defects and disorder** `ChemRxiv `_ 2024 +- S\. Hachmioune et al. **Exploring the Thermoelectric Potential of MgB4: Electronic Band Structure, Transport Properties, and Defect Chemistry** `Chemistry of Materials `__ 2024 +- J\. Hu et al. **Enabling ionic transport in Li3AlP2 the roles of defects and disorder** `ChemRxiv `__ 2024 - X\. Wang et al. **Upper efficiency limit of Sb₂Se₃ solar cells** `Joule `_ 2024 -- I\. Mosquera-Lois et al. **Machine-learning structural reconstructions for accelerated point defect calculations** `npj Computational Materials `_ 2024 +- I\. Mosquera-Lois et al. **Machine-learning structural reconstructions for accelerated point defect calculations** `npj Computational Materials `__ 2024 - W\. Dou et al. **Band Degeneracy and Anisotropy Enhances Thermoelectric Performance from Sb₂Si₂Te₆ to Sc₂Si₂Te₆** `Journal of the American Chemical Society `_ 2024 -- K\. Li et al. **Computational Prediction of an Antimony-based n-type Transparent Conducting Oxide: F-doped Sb₂O₅** `Chemistry of Materials `_ 2024 +- K\. Li et al. **Computational Prediction of an Antimony-based n-type Transparent Conducting Oxide: F-doped Sb₂O₅** `Chemistry of Materials `__ 2024 - X\. Wang et al. **Four-electron negative-U vacancy defects in antimony selenide** `Physical Review B `_ 2023 - Y\. Kumagai et al. **Alkali Mono-Pnictides: A New Class of Photovoltaic Materials by Element Mutation** `PRX Energy `__ 2023 - S\. M. Liga & S. R. Kavanagh, A. Walsh, D. O. Scanlon, G. Konstantatos **Mixed-Cation Vacancy-Ordered Perovskites (Cs₂Ti** :sub:`1–x` **Sn** :sub:`x` **X₆; X = I or Br): Low-Temperature Miscibility, Additivity, and Tunable Stability** `Journal of Physical Chemistry C`_ 2023 @@ -111,7 +111,7 @@ Studies using ``doped``, so far - J\. Willis, K. B. Spooner, D. O. Scanlon. **On the possibility of p-type doping in barium stannate** `Applied Physics Letters `__ 2023 - J\. Cen et al. **Cation disorder dominates the defect chemistry of high-voltage LiMn** :sub:`1.5` **Ni** :sub:`0.5` **O₄ (LMNO) spinel cathodes** `Journal of Materials Chemistry A`_ 2023 - J\. Willis & R. Claes et al. **Limits to Hole Mobility and Doping in Copper Iodide** `Chemistry of Materials `__ 2023 -- I\. Mosquera-Lois & S. R. Kavanagh, A. Walsh, D. O. Scanlon **Identifying the ground state structures of point defects in solids** `npj Computational Materials`_ 2023 +- I\. Mosquera-Lois & S. R. Kavanagh, A. Walsh, D. O. Scanlon **Identifying the ground state structures of point defects in solids** `npj Computational Materials `__ 2023 - Y\. T. Huang & S. R. Kavanagh et al. **Strong absorption and ultrafast localisation in NaBiS₂ nanocrystals with slow charge-carrier recombination** `Nature Communications`_ 2022 - S\. R. Kavanagh, D. O. Scanlon, A. Walsh, C. Freysoldt **Impact of metastable defect structures on carrier recombination in solar cells** `Faraday Discussions`_ 2022 - Y-S\. Choi et al. **Intrinsic Defects and Their Role in the Phase Transition of Na-Ion Anode Na₂Ti₃O₇** `ACS Applied Energy Materials `__ 2022 @@ -129,7 +129,6 @@ Studies using ``doped``, so far .. _Journal of Physical Chemistry C: https://doi.org/10.1021/acs.jpcc.3c05204 .. _Journal of Materials Chemistry A: https://doi.org/10.1039/D3TA00532A -.. _npj Computational Materials: https://www.nature.com/articles/s41524-023-00973-1 .. _Nature Communications: https://www.nature.com/articles/s41467-022-32669-3 .. _Faraday Discussions: https://doi.org/10.1039/D2FD00043A .. _Chemical Science: https://doi.org/10.1039/D1SC03775G diff --git a/doped/utils/plotting.py b/doped/utils/plotting.py index 697dafe4..25c7924b 100644 --- a/doped/utils/plotting.py +++ b/doped/utils/plotting.py @@ -157,7 +157,7 @@ def format_defect_name( Format defect name for plot titles. (i.e. from Cd_i_C3v_0 to $Cd_{i}^{0}$ or $Cd_{i_{C3v}}^{0}$). - Note this assumes "V_" means vacancy not Vanadium. + Note this assumes "V_..." means vacancy not Vanadium. Args: defect_species (:obj:`str`):