From 3578a9d08af5e8cdd0851f852185bce2f2c7bd51 Mon Sep 17 00:00:00 2001 From: Marnik Bercx Date: Wed, 31 May 2023 17:16:52 +0200 Subject: [PATCH] Docs: switch to `sphinx-book-theme` from `pydata_sphinx_theme` The main reason for the switch is to have access to theme-specific elements like margin notes. Another major change compared to `pydata_sphinx_theme` is the absence of a top-level header, which has us move the contents overview into the sidebar. This has the advantage that the user immediately has a bird's eye glance of the documentation contents. Until the documentation becomes larger, this approach is preferable. Several changes are made to the sidebar: 1. Override the default `icon-links.html` component to include an AiiDA icon that links to the AiiDA website. 2. Override the `sbt-sidebar-nav.thml` component to adapt the default maxdepth. 3. A logo is added for dark mode. Some other additions and tweaks: 1. Added badged to the landing page instead of the release version. 2. Adapt the sidebar `toctree` to include captions and point directly to some subsections. 3. The Python API now has a `toctree` element with a clear name, and the `maxdepth` is adapted to make it more readable. 4. Several panels on the landing page are removed, since the corresponding top-level sections are no longer part of the `toctree`. This also makes the remaining panels to the `Get started` and tutorial sections more prominent. Finally, the `intersphinx_mapping` to the `aiida-core` docs is fixed, along with several broken references, mostly in the Hubbard docstring. The `pydantic` and `typing` related intersphinx warnings are ignored using `nitpick_ignore_regex`, since pydantic doesn't use `sphinx` and there seem to be issues with referencing `typing` classes. --- .gitignore | 2 +- docs/Makefile | 3 +- docs/source/_static/aiida-qe-custom.css | 35 ++++-- .../source/{images => _static}/logo_aiida.svg | 0 .../logo_aiida_quantumespresso-dark.png | Bin 0 -> 123259 bytes .../logo_aiida_quantumespresso-light.png} | Bin docs/source/_templates/icon-links.html | 40 ++++++ docs/source/_templates/sbt-sidebar-nav.html | 24 ++++ docs/source/conf.py | 116 ++++-------------- docs/source/howto/calculations/index.md | 7 +- docs/source/howto/index.md | 13 -- docs/source/howto/workflows/index.md | 2 +- docs/source/index.md | 105 ++++------------ docs/source/reference/api/index.md | 12 ++ docs/source/reference/index.md | 9 -- docs/source/topics/index.md | 8 -- src/aiida_quantumespresso/common/hubbard.py | 4 +- .../data/hubbard_structure.py | 20 +-- src/aiida_quantumespresso/utils/hubbard.py | 2 +- 19 files changed, 167 insertions(+), 235 deletions(-) rename docs/source/{images => _static}/logo_aiida.svg (100%) create mode 100644 docs/source/_static/logo_aiida_quantumespresso-dark.png rename docs/source/{images/logo_aiida_quantumespresso.png => _static/logo_aiida_quantumespresso-light.png} (100%) create mode 100644 docs/source/_templates/icon-links.html create mode 100644 docs/source/_templates/sbt-sidebar-nav.html delete mode 100644 docs/source/howto/index.md create mode 100644 docs/source/reference/api/index.md delete mode 100644 docs/source/reference/index.md delete mode 100644 docs/source/topics/index.md diff --git a/.gitignore b/.gitignore index da1f17741..c47e0504b 100644 --- a/.gitignore +++ b/.gitignore @@ -111,4 +111,4 @@ ENV/ submit_test/ # Autogenerated API docs -docs/source/reference/api/aiida_quantumespresso +docs/source/reference/api/auto diff --git a/docs/Makefile b/docs/Makefile index af76c6f1f..20f595cd5 100755 --- a/docs/Makefile +++ b/docs/Makefile @@ -24,7 +24,7 @@ I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source customdefault: $(SPHINXBUILD) -b html -nW --keep-going $(ALLSPHINXOPTS) $(BUILDDIR)/html -all: html view +all: clean html view clean: rm -rf $(BUILDDIR) @@ -34,6 +34,5 @@ html: @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." - view: open $(BUILDDIR)/html/index.html diff --git a/docs/source/_static/aiida-qe-custom.css b/docs/source/_static/aiida-qe-custom.css index 3d37cd7f7..fc02e48e1 100644 --- a/docs/source/_static/aiida-qe-custom.css +++ b/docs/source/_static/aiida-qe-custom.css @@ -11,18 +11,29 @@ font-size: 140%; } -div.navbar-brand-box a.navbar-brand img { - display: block; - height: auto; - width: auto; - max-height: 100vh; - max-width: 90%; - margin: 0 auto; - padding-left: 30px +.navbar-brand { + padding: 0; + padding-top: 0.5rem; +} + +img.logo__image { + max-height: 180px; + padding-left: 1.5rem; + padding-bottom: 1rem; +} + +.navbar-icon-links i.fa-brands { + font-size: 40px!important; +} + +img.aiida-logo { + height: 40px!important; +} + +.fa { + color: var(--pst-color-primary); } -@media (min-width: 768px) { - div.navbar-brand-box a.navbar-brand img { - max-height: 100vh !important - } +.bd-search { + padding: 0 1rem; } diff --git a/docs/source/images/logo_aiida.svg b/docs/source/_static/logo_aiida.svg similarity index 100% rename from docs/source/images/logo_aiida.svg rename to docs/source/_static/logo_aiida.svg diff --git a/docs/source/_static/logo_aiida_quantumespresso-dark.png b/docs/source/_static/logo_aiida_quantumespresso-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..57ba96b4929ceb8d44e796368c869e07fbd0802a GIT binary patch literal 123259 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 `+wN}8 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�@p1=s-^{4BObpDb?dPhq#C7+?S;J)j+q04#E1Rfzbin2REbCNTCy!(4!D-# zLQr%UsW>Da`W0$f*$$$I0F3NtQbLfk3>7k=L0pXM?yBez^b*uSA6Y1aH zg0vXWpwj<>^G@wXl`~MCxKe1z<4{zQh}IF zPsl6WJl0E-2q3gi0SIYX=T&U6#0Ir4;eaKJyooFZvpbeq*Eh^+5vxdzk z5ohl-LwHvKnY?3oHX-A z*1A(ZOqcTkDAoaFq1=oDlprLV^TU(wAZT<%2PVCJ^{#ZnwTK9URu$MC3EvN)LIy8h zKbn+mQs@&JJ|=Trq?c~CkuT_SO*&Y?g}WCQ?f?#}@D zeZB;cnesxXUE_c@(2g41QBZi4@dPzd_l}wz7kd00$@B)Z0k7OC0MdZ+Cty}QD+4qn zA^|E~kt6iQ$>7l=wQS)Dt~p=WK{{Z{5i=U(@)O)^5P%K|cq8S=V>S)lYLU?Zp!-ii zV{t)VYslvNa{{Qvf;~rCiaZ{I*a8TkMH(dEO>@CGJ=uY%=kfL^kXJ5JSJ{$4?bjb8 zg20x7U%k|oauFhe(hXifUc^Y;%)TLq`HTgFn#6(1jakZ>^U3V|0#+!__Z8^CdNQyG zp`W)fC_f4SO4`mtLZ-})jy(_nd=vi$8krVnfYH-mpWa{sO#rPFfwp>$;{N`wRW>n` zchW(J?{pY1AN?>_f;zCA5ixbf)Eod9B)0ppHt*bUHT`TJeprrchfJi2r9 zO#5y}Za-sq7-fj6!J6U0G# z9%n0AX@IwYyKi 2 %} + + {%- endif -%} +{%- endmacro -%} +{%- if theme_icon_links -%} + +{%- endif -%} diff --git a/docs/source/_templates/sbt-sidebar-nav.html b/docs/source/_templates/sbt-sidebar-nav.html new file mode 100644 index 000000000..e9bbe7b66 --- /dev/null +++ b/docs/source/_templates/sbt-sidebar-nav.html @@ -0,0 +1,24 @@ + diff --git a/docs/source/conf.py b/docs/source/conf.py index da595a69e..3be770690 100755 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -14,16 +14,12 @@ import pathlib import time -# Load the dummy profile even if we are running locally, this way the documentation will succeed even if the current -# default profile of the AiiDA installation does not use a Django backend. from aiida.manage.configuration import load_documentation_profile +load_documentation_profile() # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. -import aiida_quantumespresso - -load_documentation_profile() # -- Project information ----------------------------------------------------- @@ -32,11 +28,6 @@ Materials (THEOS) and National Centre for Computational Design and Discovery of Novel Materials (NCCR MARVEL)), Switzerland. All rights reserved""" -# The full version, including alpha/beta/rc tags. -release = aiida_quantumespresso.__version__ -# The short X.Y version. -version = '.'.join(aiida_quantumespresso.__version__.split('.')[:2]) - # -- General configuration ------------------------------------------------ # If your documentation needs a minimal Sphinx version, state it here. @@ -46,7 +37,6 @@ # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ - 'sphinx.ext.autodoc', 'sphinx.ext.mathjax', 'sphinx.ext.intersphinx', 'sphinx.ext.viewcode', @@ -61,9 +51,8 @@ # Setting the intersphinx mapping to other readthedocs intersphinx_mapping = { 'python': ('https://docs.python.org/3.8', None), - 'aiida': ('https://aiida.readthedocs.io/en/latest/', None), + 'aiida': ('https://aiida.readthedocs.io/projects/aiida-core/en/latest/', None), 'aiida_pseudo': ('http://aiida-pseudo.readthedocs.io/en/latest/', None), - 'sphinx': ('https://www.sphinx-doc.org/en/master', None), } myst_enable_extensions = [ @@ -72,18 +61,13 @@ 'substitution' ] -myst_substitutions = { - 'release': release, - 'version': version -} - # Settings for the `autoapi.extenstion` automatically generating API docs filepath_docs = pathlib.Path(__file__).parent.parent filepath_src = filepath_docs.parent / 'src' autoapi_type = 'python' autoapi_dirs = [filepath_src] autoapi_ignore = [filepath_src / 'aiida_quantumespresso' / '*cli*'] -autoapi_root = str(filepath_docs / 'source' / 'reference' / 'api') +autoapi_root = str(filepath_docs / 'source' / 'reference' / 'api' / 'auto') autoapi_keep_files = True autoapi_add_toctree_entry = False @@ -104,18 +88,24 @@ # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. -exclude_patterns = [] +exclude_patterns = ['**.ipynb_checkpoints', 'reference/api/auto/aiida_quantumespresso/index.rst'] # -- Options for HTML output ---------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. -html_theme = 'pydata_sphinx_theme' +html_theme = 'sphinx_book_theme' html_theme_options = { + 'repository_url': 'https://github.com/aiidateam/aiida-quantumespresso', 'github_url': 'https://github.com/aiidateam/aiida-quantumespresso', 'twitter_url': 'https://twitter.com/aiidateam', 'use_edit_page_button': True, + 'logo': { + 'text': 'AiiDA Quantum ESPRESSO', + 'image_light': '_static/logo_aiida_quantumespresso-light.png', + 'image_dark': '_static/logo_aiida_quantumespresso-dark.png', + } } html_static_path = ['_static'] html_context = { @@ -125,10 +115,12 @@ 'doc_path': 'docs/source', 'default_mode': 'light', } +html_sidebars = { + '**': ['navbar-logo.html', 'navbar-icon-links.html', 'search-field.html', 'sbt-sidebar-nav.html'] +} # The name of an image file (relative to this directory) to place at the top # of the sidebar. -html_logo = 'images/logo_docs.png' html_static_path = ['_static'] html_css_files = ['aiida-custom.css', 'aiida-qe-custom.css'] @@ -146,80 +138,18 @@ # Output file base name for HTML help builder. htmlhelp_basename = 'aiida-quantumespressodoc' -# -- Options for LaTeX output --------------------------------------------- - -latex_elements = { - # The paper size ('letterpaper' or 'a4paper'). - #'papersize': 'letterpaper', - - # The font size ('10pt', '11pt' or '12pt'). - #'pointsize': '10pt', - - # Additional stuff for the LaTeX preamble. - #'preamble': '', - - # Latex figure (float) alignment - #'figure_align': 'htbp', -} - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, -# author, documentclass [howto, manual, or own class]). -# latex_documents = [ -# ] - -# The name of an image file (relative to this directory) to place at the top of -# the title page. -#latex_logo = None - -# For "manual" documents, if this is true, then toplevel headings are parts, -# not chapters. -#latex_use_parts = False - -# If true, show page references after internal links. -#latex_show_pagerefs = False - -# If true, show URL addresses after external links. -#latex_show_urls = False - -# Documents to append as an appendix to all manuals. -#latex_appendices = [] - -# If false, no module index is generated. -#latex_domain_indices = True - -# -- Options for manual page output --------------------------------------- - -# One entry per manual page. List of tuples -# (source start file, name, description, authors, manual section). -# man_pages = [ -# ] - -# If true, show URL addresses after external links. -#man_show_urls = False - -# -- Options for Texinfo output ------------------------------------------- - -# Grouping the document tree into Texinfo files. List of tuples -# (source start file, target name, title, author, -# dir menu entry, description, category) -# texinfo_documents = [ -# ] - -# Documents to append as an appendix to all manuals. -#texinfo_appendices = [] - -# If false, no module index is generated. -#texinfo_domain_indices = True - -# How to display URL addresses: 'footnote', 'no', or 'inline'. -#texinfo_show_urls = 'footnote' - -# If true, do not generate a @detailmenu in the "Top" node's menu. -#texinfo_no_detailmenu = False +# ------------------------------------------------------------------------------ # Warnings to ignore when using the -n (nitpicky) option # We should ignore any python built-in exception, for instance +nitpicky = True + +nitpick_ignore_regex = [ + (r'py:.*', r'pydantic.*'), + (r'py:.*', r'con.*'), + (r'.*', r'Literal.*'), + (r'.*', r'Tuple.*'), +] nitpick_ignore = [ ('py:exc', 'ArithmeticError'), ('py:exc', 'AssertionError'), diff --git a/docs/source/howto/calculations/index.md b/docs/source/howto/calculations/index.md index af2e7d221..8b8ab4e3f 100644 --- a/docs/source/howto/calculations/index.md +++ b/docs/source/howto/calculations/index.md @@ -1,6 +1,11 @@ (howto-calculations)= -# How-to run calculations +# Calculations + +:::{important} +The following how-to guides assume that you are familiar with the basics of AiiDA, such as creating data and running processes. +At the very least, make sure you have followed and understand the tutorial on [running a calculation through the API](#tutorials-pw-through-api). +::: ```{toctree} :maxdepth: 1 diff --git a/docs/source/howto/index.md b/docs/source/howto/index.md deleted file mode 100644 index f02b823af..000000000 --- a/docs/source/howto/index.md +++ /dev/null @@ -1,13 +0,0 @@ -# How-to guides - -:::{important} -The following how-to guides assume that you are familiar with the basics of AiiDA, such as creating data and running processes. -At the very least, make sure you have followed and understand the tutorial on [running a calculation through the API](#tutorials-pw-through-api). -::: - -```{toctree} -:maxdepth: 2 - -calculations/index -workflows/index -``` diff --git a/docs/source/howto/workflows/index.md b/docs/source/howto/workflows/index.md index 4031539bf..1b88f4f27 100644 --- a/docs/source/howto/workflows/index.md +++ b/docs/source/howto/workflows/index.md @@ -1,6 +1,6 @@ (howto-workflows)= -# How-to run workflows +# Workflows ```{toctree} :maxdepth: 1 diff --git a/docs/source/index.md b/docs/source/index.md index 590604e13..4a4f99456 100644 --- a/docs/source/index.md +++ b/docs/source/index.md @@ -8,33 +8,32 @@ myst: ```{toctree} :hidden: true -:maxdepth: 2 installation/index tutorials/index -howto/index -topics/index -reference/index ``` -::::{grid} -:reverse: -:gutter: 2 3 3 3 -:margin: 1 2 1 2 +```{toctree} +:hidden: true +:caption: How to -:::{grid-item} -:columns: 12 4 4 4 +howto/calculations/index +howto/workflows/index +``` -```{image} images/logo_aiida_quantumespresso.png -:width: 200px -:class: sd-m-auto +```{toctree} +:hidden: true +:caption: Topic guides +topics/calculations/index +topics/workflows/index ``` -::: -:::{grid-item} -:columns: 12 8 8 8 -:child-align: justify -:class: sd-fs-5 +```{toctree} +:hidden: true +:caption: Reference +reference/api/index +reference/cli/index +``` # AiiDA Quantum ESPRESSO @@ -42,11 +41,10 @@ An AiiDA plugin package to integrate the [Quantum ESPRESSO](http://www.quantumes Compute a variety of material properties with the popular open source DFT code with automatic data provenance provided by AiiDA. Geometry optimizations, ground-state electronic structure, band structures, phonons, and much more. -**aiida-quantumespresso version:** {{ release }} - -::: - -:::: +[![PyPI version](https://badge.fury.io/py/aiida-quantumespresso.svg)](https://badge.fury.io/py/aiida-quantumespresso) +[![PyPI pyversions](https://img.shields.io/pypi/pyversions/aiida-quantumespresso.svg)](https://pypi.python.org/pypi/aiida-quantumespresso) +[![Build Status](https://github.com/aiidateam/aiida-quantumespresso/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/aiidateam/aiida-quantumespresso/actions) +[![Docs status](https://readthedocs.org/projects/aiida-quantumespresso/badge)](http://aiida-quantumespresso.readthedocs.io/) ______________________________________________________________________ @@ -91,67 +89,10 @@ Easy examples to take the first steps with the plugin package. To the tutorials ``` ::: - -:::{grid-item-card} {fa}`question-circle;mr-1` How-to guides -:text-align: center -:shadow: md - -Hands-on guides to achieve specific goals. - -+++ - -```{button-ref} howto/index -:ref-type: doc -:click-parent: -:expand: -:color: primary -:outline: - -To the how-to guides -``` -::: - -:::{grid-item-card} {fa}`bookmark;mr-1` Topic guides -:text-align: center -:shadow: md - -Detailed background information on various concepts. - -+++ - -```{button-ref} topics/index -:ref-type: doc -:click-parent: -:expand: -:color: primary -:outline: - -To the topic guides -``` -::: - -:::{grid-item-card} {fa}`cogs;mr-1` Reference guides -:text-align: center -:shadow: md - -Detailed reference guides on the application programming and command line interfaces. - -+++ - -```{button-ref} reference/api/aiida_quantumespresso/index -:ref-type: doc -:click-parent: -:expand: -:color: primary -:outline: - -To the reference guides -``` -::: :::: -# How to cite +## How to cite If you use this plugin for your research, please cite the following work: @@ -161,7 +102,7 @@ If you use this plugin for your research, please cite the following work: > Martin Uhrin, Sebastiaan. P. Huber, Jusong Yu, Nicola Marzari, and Giovanni Pizzi, [*Workflows in AiiDA: Engineering a high-throughput, event-based engine for robust and modular computational workflows*](https://doi.org/10.1016/j.commatsci.2020.110086), Computational Materials Science **187**, 110086 (2021) -# Acknowledgements +## Acknowledgements We acknowledge support from: diff --git a/docs/source/reference/api/index.md b/docs/source/reference/api/index.md new file mode 100644 index 000000000..be9559d31 --- /dev/null +++ b/docs/source/reference/api/index.md @@ -0,0 +1,12 @@ +# Python API + +```{toctree} +:maxdepth: 3 +auto/aiida_quantumespresso/calculations/index +auto/aiida_quantumespresso/common/index +auto/aiida_quantumespresso/data/index +auto/aiida_quantumespresso/parsers/index +auto/aiida_quantumespresso/tools/index +auto/aiida_quantumespresso/utils/index +auto/aiida_quantumespresso/workflows/index +``` diff --git a/docs/source/reference/index.md b/docs/source/reference/index.md deleted file mode 100644 index 10af28e47..000000000 --- a/docs/source/reference/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Reference - -```{toctree} -:hidden: true -:maxdepth: 2 - -api/aiida_quantumespresso/index -cli/index -``` diff --git a/docs/source/topics/index.md b/docs/source/topics/index.md deleted file mode 100644 index 7b69f598e..000000000 --- a/docs/source/topics/index.md +++ /dev/null @@ -1,8 +0,0 @@ -# Topic guides - -```{toctree} -:maxdepth: 2 - -calculations/index -workflows/index -``` diff --git a/src/aiida_quantumespresso/common/hubbard.py b/src/aiida_quantumespresso/common/hubbard.py index 2682a18ab..99ddca3eb 100644 --- a/src/aiida_quantumespresso/common/hubbard.py +++ b/src/aiida_quantumespresso/common/hubbard.py @@ -85,7 +85,7 @@ def to_tuple(self) -> Tuple[int, str, int, str, float, Tuple[int, int, int], str @staticmethod def from_tuple(hubbard_parameters: Tuple[int, str, int, str, float, Tuple[int, int, int], str]): - """Return a :meth:`~aiida_quantumespresso.common.hubbard.HubbardParameters` instance from a list. + """Return a ``HubbardParameters`` instance from a list. The parameters within the list must have the following order: * atom_index @@ -112,7 +112,7 @@ class Hubbard(BaseModel): """Class for complete description of Hubbard interactions.""" parameters: List[HubbardParameters] - """List of :meth:`~aiida_quantumespress.common.hubbard.HubbardParameters`.""" + """List of :class:`~aiida_quantumespresso.common.hubbard.HubbardParameters`.""" projectors: Literal['atomic', 'ortho-atomic', diff --git a/src/aiida_quantumespresso/data/hubbard_structure.py b/src/aiida_quantumespresso/data/hubbard_structure.py index 71a2fe32f..041aac199 100644 --- a/src/aiida_quantumespresso/data/hubbard_structure.py +++ b/src/aiida_quantumespresso/data/hubbard_structure.py @@ -30,7 +30,7 @@ def __init__( :param pbc: (3,) shape list in bools :param sites: list of lists, each of the shape [symbol, name, position], where position is a (3,) shape list of floats - :param hubbard: a :py:meth:`~aiida_quantumespresso.common.hubbrd.Hubbard` istance + :param hubbard: a :class:`~aiida_quantumespresso.common.hubbard.Hubbard` istance """ super().__init__(cell=cell, **kwargs) self.sites = sites @@ -39,12 +39,12 @@ def __init__( @property def sites(self): - """Return the :meth:`aiida.core.Sites`.""" + """Return the :attr:`~aiida.orm.nodes.data.structure.StructureData.sites`.""" return super().sites @sites.setter def sites(self, values: List[Tuple[str, str, Tuple[float, float, float]]]): - """Set the :meth:`aiida.core.Sites`. + """Set the :attr:`~aiida.orm.nodes.data.structure.StructureData.sites`. :param values: list of sites, each as [symbol, name, (3,) shape list of positions] """ @@ -56,7 +56,7 @@ def sites(self, values: List[Tuple[str, str, Tuple[float, float, float]]]): def hubbard(self) -> Hubbard: """Get the `Hubbard` instance. - :returns: a :py:meth:`~aiida_quantumespresso.common.hubbard.Hubbard` instance. + :returns: a :class:`~aiida_quantumespresso.common.hubbard.Hubbard` instance. """ with self.base.repository.open(self._hubbard_filename, mode='rb') as handle: return Hubbard.parse_raw(json.load(handle)) @@ -77,8 +77,8 @@ def from_structure( ): """Return an instance of ``HubbardStructureData`` from a ``StructureData`` node. - :param structure: :meth:`aiida.orm.StructureData` instance - :param hubbad: :meth:`~aiida_quantumespresso.common.hubbard.Hubbard` instance + :param structure: :class:`aiida.orm.StructureData` instance + :param hubbard: :class:`~aiida_quantumespresso.common.hubbard.Hubbard` instance :returns: ``HubbardStructureData`` instance """ sites = [[structure.get_kind(site.kind_name).symbol, site.kind_name, site.position] for site in structure.sites] @@ -97,7 +97,7 @@ def append_hubbard_parameter( translation: Tuple[int, int, int] = None, hubbard_type: str = 'Ueff', ): - """Append a :meth:`~aiida_quantumespresso.common.hubbard.HubbardParameters``. + """Append a :class:`~aiida_quantumespresso.common.hubbard.HubbardParameters`. :param atom_index: atom index in unitcell :param atom_manifold: atomic manifold (e.g. 3d, 3d-2p) @@ -107,7 +107,7 @@ def append_hubbard_parameter( :param translation: (3,) list of ints, describing the translation vector associated with the neighbour atom, defaults to None :param hubbard_type: hubbard type (U, V, J, ...), defaults to 'Ueff' - (see :meth:`~aiida_quantumespresso.common.hubbard.Hubbard` for full allowed values) + (see :class:`~aiida_quantumespresso.common.hubbard.Hubbard` for full allowed values) """ pymat = self.get_pymatgen_structure() sites = pymat.sites @@ -161,7 +161,7 @@ def initialize_intersites_hubbard( :param neighbour_manifold: neighbour manifold (e.g. 3d, 3d-2p) :param value: value of the Hubbard parameter, in eV :param hubbard_type: hubbard type (U, V, J, ...), defaults to 'V' - (see :meth:`~aiida_quantumespresso.common.hubbard.Hubbard` for full allowed values) + (see :class:`~aiida_quantumespresso.common.hubbard.Hubbard` for full allowed values) :param use_kinds: whether to use kinds for initializing the parameters; when False, it initializes all the ``Kinds`` matching the ``atom_name`` """ @@ -197,7 +197,7 @@ def initialize_onsites_hubbard( :param atom_manifold: atomic manifold (e.g. 3d, 3d-2p) :param value: value of the Hubbard parameter, in eV :param hubbard_type: hubbard type (U, J, ...), defaults to 'Ueff' - (see :meth:`~aiida_quantumespresso.common.hubbard.Hubbard` for full allowed values) + (see :class:`~aiida_quantumespresso.common.hubbard.Hubbard` for full allowed values) :param use_kinds: whether to use kinds for initializing the parameters; when False, it initializes all the ``Kinds`` matching the ``atom_name`` """ diff --git a/src/aiida_quantumespresso/utils/hubbard.py b/src/aiida_quantumespresso/utils/hubbard.py index 62cedacd1..046488fd5 100644 --- a/src/aiida_quantumespresso/utils/hubbard.py +++ b/src/aiida_quantumespresso/utils/hubbard.py @@ -1,5 +1,5 @@ # -*- coding: utf-8 -*- -"""Utility class for handling the :class:`data.hubbard_structure.HubbardStructureData`.""" +"""Utility class for handling the :class:`aiida_quantumespresso.data.hubbard_structure.HubbardStructureData`.""" # pylint: disable=no-name-in-module from itertools import product import os