-
Notifications
You must be signed in to change notification settings - Fork 28
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit d616a7e
Showing
352 changed files
with
61,064 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
# Sphinx build info version 1 | ||
# This file records the configuration used when building these files. When it is not found, a full rebuild will be done. | ||
config: ee697909c9be9f6648d02b4ba48ea36d | ||
tags: 645f666f9bcd5a90fca523b33c5a78b7 |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+23.8 KB
.doctrees/reference/lobsterpy.featurize.batch.BatchCoxxFingerprint.doctree
Binary file not shown.
Binary file added
BIN
+21.9 KB
.doctrees/reference/lobsterpy.featurize.batch.BatchDosFeaturizer.doctree
Binary file not shown.
Binary file added
BIN
+18.1 KB
.doctrees/reference/lobsterpy.featurize.batch.BatchStructureGraphs.doctree
Binary file not shown.
Binary file added
BIN
+23.4 KB
.doctrees/reference/lobsterpy.featurize.batch.BatchSummaryFeaturizer.doctree
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+14.5 KB
.doctrees/reference/lobsterpy.featurize.core.FeaturizeCharges.doctree
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+27.7 KB
.doctrees/reference/lobsterpy.featurize.core.FeaturizeLobsterpy.doctree
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+7.04 KB
.doctrees/reference/lobsterpy.featurize.utils.get_structure_path.doctree
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+45.9 KB
.doctrees/reference/lobsterpy.plotting.InteractiveCohpPlotter.doctree
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+13.4 KB
.doctrees/reference/lobsterpy.plotting.layout_dicts.cohp_axis_style_dict.doctree
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+13.4 KB
.doctrees/reference/lobsterpy.plotting.layout_dicts.energy_axis_style_dict.doctree
Binary file not shown.
Binary file added
BIN
+9.93 KB
.doctrees/reference/lobsterpy.plotting.layout_dicts.layout_dict.doctree
Binary file not shown.
Binary file added
BIN
+7.15 KB
.doctrees/reference/lobsterpy.plotting.layout_dicts.legend_style_dict.doctree
Binary file not shown.
Binary file added
BIN
+7.26 KB
.doctrees/reference/lobsterpy.plotting.layout_dicts.spin_down_trace_style_dict.doctree
Binary file not shown.
Binary file added
BIN
+7.21 KB
.doctrees/reference/lobsterpy.plotting.layout_dicts.spin_up_trace_style_dict.doctree
Binary file not shown.
Binary file not shown.
Binary file added
BIN
+27.3 KB
.doctrees/reference/lobsterpy.structuregraph.graph.LobsterGraph.doctree
Binary file not shown.
Binary file added
BIN
+5.04 KB
.doctrees/reference/lobsterpy.structuregraph.graph.TYPE_CHECKING.doctree
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Empty file.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Binary file added
BIN
+62.6 KB
_images/4ba0a42cb06271f4b81f0e1ba60836043613fdb955480a951b6bb675345eee39.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+75.4 KB
_images/7060294ad2ce3eac4e31dee71f5c148629bacdf98b76c8b91b191c2d6c7130ed.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+20 KB
_images/8b4e10d7705d8df8dcc2c6169193a2c60db191387778e6e4882526b0c64c5a43.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+50.2 KB
_images/930c85a9ead0b7dfb27c0e130608f60413d411d94903f58b4071a95038b226d1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+26.4 KB
_images/c0cc69a6ee72c465684c908c88fa9223954e20a52758062837ad59f6ae0d662f.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
```{include} ../../CHANGELOG.md | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,32 @@ | ||
License | ||
======= | ||
|
||
BSD 3-Clause License | ||
|
||
Copyright (c) 2021, LobsterPy Development Team | ||
All rights reserved. | ||
|
||
Redistribution and use in source and binary forms, with or without | ||
modification, are permitted provided that the following conditions are met: | ||
|
||
1. Redistributions of source code must retain the above copyright notice, this | ||
list of conditions and the following disclaimer. | ||
|
||
2. Redistributions in binary form must reproduce the above copyright notice, | ||
this list of conditions and the following disclaimer in the documentation | ||
and/or other materials provided with the distribution. | ||
|
||
3. Neither the name of the copyright holder nor the names of its | ||
contributors may be used to endorse or promote products derived from | ||
this software without specific prior written permission. | ||
|
||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | ||
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | ||
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | ||
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE | ||
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | ||
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR | ||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER | ||
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | ||
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | ||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
```{include} ../../CONTRIBUTING.md | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
# Developer Installation | ||
|
||
Install LobsterPy from source, by cloning the repository via [github](https://github.com/JaGeo/LobsterPy.git) | ||
|
||
```bash | ||
git clone https://github.com/JaGeo/LobsterPy.git | ||
cd LobsterPy | ||
pip install -e .[featurizer,docs,tests,dev] | ||
``` | ||
This will install LobsterPy will all dependencies for tests, pre-commit and docs building. | ||
|
||
## Running unit tests | ||
|
||
Unit tests can be run from the source folder using `pytest`. | ||
|
||
```bash | ||
pytest | ||
``` | ||
This will run all the tests. | ||
|
||
To get a detailed report of test coverage you can use following command | ||
```bash | ||
pytest --cov=lobsterpy --cov-report term-missing --cov-append | ||
``` | ||
|
||
If you feel test execution takes too long locally, you can speedup the execution using [pytest-xdist](https://pypi.org/project/pytest-xdist/). Install this in library in your environment using | ||
|
||
```bash | ||
pip install pytest-xdist | ||
``` | ||
|
||
Once installed, you can now use multiple processors to run your tests. For example, if you want to use 8 processors to run tests in parallel, run | ||
|
||
```bash | ||
pytest -n 8 | ||
``` | ||
|
||
We rely on pytest-split to run tests in parallel on github workflow, thus it is necessary to update the test-durations files in the repository, incase you add new tests. To generate this file, use | ||
|
||
```bash | ||
pytest --cov=lobsterpy --cov-append --splits 1 --group 1 --durations-path ./tests/test_data/.pytest-split-durations --store-durations | ||
``` | ||
|
||
## Building the documentation locally | ||
|
||
The atomate2 documentation can be built using the sphinx package. | ||
|
||
The docs can be built to the `_build` directory: | ||
|
||
```bash | ||
sphinx-build -W docs _build | ||
``` | ||
|
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,84 @@ | ||
```{toctree} | ||
:caption: User Guide | ||
:hidden: | ||
installation/index | ||
fundamentals/index | ||
tutorial/index | ||
``` | ||
|
||
```{toctree} | ||
:caption: Reference | ||
:hidden: | ||
reference/index | ||
reference/cli | ||
``` | ||
|
||
```{toctree} | ||
:caption: Contributing Guide | ||
:hidden: | ||
dev/contributing | ||
dev/dev_installation | ||
``` | ||
|
||
```{toctree} | ||
:caption: About | ||
:hidden: | ||
about/changelog | ||
about/license | ||
``` | ||
|
||
# LobsterPy documentation | ||
|
||
**Date**: {sub-ref}`today` | ||
|
||
**Useful links**: | ||
[Github Repository](https://github.com/JaGeo/LobsterPy) | | ||
[PyPI](https://pypi.org/project/lobsterpy/) | | ||
[Issues & Ideas](https://github.com/JaGeo/LobsterPy/issues) | | ||
|
||
LobsterPy is a package that enables automatic analysis of LOBTSER outputs to get summarized bonding information and relevant bond plots. Additionally, one can also generate features for machine learning studies from LOBSTER outputs. | ||
|
||
::::{grid} 1 1 2 2 | ||
:class-container: text-center | ||
:gutter: 3 | ||
|
||
|
||
:::{grid-item-card} | ||
:link: fundamentals/index | ||
:link-type: doc | ||
:class-header: bg-light | ||
**Fundamental Aspects** | ||
^^^ | ||
This guide contains a detailed explanation of the key functionalites on | ||
which LobsterPy automatic analysis is based on. | ||
::: | ||
|
||
:::{grid-item-card} | ||
:link: installation/index | ||
:link-type: doc | ||
:class-header: bg-light | ||
**User Guide** | ||
^^^ | ||
This guide provides in-depth information for getting started and tutorials for *LobsterPy*. | ||
::: | ||
|
||
:::{grid-item-card} | ||
:link: https://materialsproject.github.io/atomate2/user/codes/vasp.html#lobster | ||
:class-header: bg-light | ||
**LOBSTER Workflow** | ||
^^^ | ||
Here you can find how to use our completely automated workflow to perform bonding analysis with | ||
LOBSTER and Lobsterpy via atomate2. | ||
::: | ||
|
||
|
||
:::{grid-item-card} | ||
:link: dev/dev_installation | ||
:link-type: doc | ||
:class-header: bg-light | ||
**Developer guide** | ||
^^^ | ||
Do you want contribute or improve existing functionalities? | ||
Check out the developer guide. | ||
::: | ||
:::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
Getting started | ||
================ | ||
```{include} ../../README.md | ||
--- | ||
start-line: 5 | ||
--- | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
CLI Reference | ||
============== | ||
|
||
.. toctree:: | ||
:maxdepth: 1 | ||
|
||
cli_subcommands/createinputs | ||
cli_subcommands/description | ||
cli_subcommands/descriptionquality | ||
cli_subcommands/plotauto | ||
cli_subcommands/plotautoia | ||
cli_subcommands/plotdos | ||
cli_subcommands/ploticohpdistance | ||
cli_subcommands/plot |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
create-inputs | ||
============== | ||
|
||
Create inputs for lobster computation. It works only with PBE POTCARs. | ||
|
||
.. hint:: Aliases available | ||
|
||
- createinputs | ||
|
||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: create-inputs | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
description | ||
============ | ||
|
||
Deliver a text description of the COHPs or COBIS or COOP results from Lobster and VASP | ||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: description | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
description-quality | ||
=================== | ||
|
||
Deliver a text description of the LOBSTER calc quality analysis. Mandatory required files: POSCAR, POTCAR or POTCAR symbols, lobsterout, lobsterin. Optional files (BVA comparison): CHARGE.lobster, (DOS comparison): DOSCAR.lobster/ DOSCAR.LSO.lobster, Vasprun.xml. | ||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: description-quality |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
plot | ||
==== | ||
|
||
Plot specific COHPs/COBIs/COOPs based on bond numbers. | ||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: plot | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,19 @@ | ||
plot-automatic | ||
============== | ||
|
||
Plot most important COHPs or COBIs or COOPs automatically. This option also includes an automatic description. | ||
|
||
.. hint:: Aliases available | ||
|
||
- plot-auto | ||
- auto-plot | ||
- autoplot | ||
- automatic-plot | ||
- automaticplot | ||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: plot-automatic | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
plot-automatic-ia | ||
================== | ||
|
||
Creates an interactive plot of most important COHPs or COBIs or COOPs automatically. | ||
|
||
.. hint:: Aliases available | ||
|
||
- plot-auto-ia | ||
- auto-plot-ia | ||
- autoplotia | ||
- automatic-plot-ia | ||
- automaticplot-ia | ||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: plot-automatic-ia |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
plot-dos | ||
========= | ||
|
||
Plots DOS from lobster computation. | ||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: plot-dos | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
plot-icohp-distance | ||
==================== | ||
|
||
Plot ICOHPs or ICOOPs or ICOBIs with respect to bond lengths. | ||
|
||
.. hint:: Aliases available | ||
|
||
- ploticohpdistance | ||
|
||
.. argparse:: | ||
:module: lobsterpy.cli | ||
:func: get_parser | ||
:prog: lobsterpy | ||
:path: plot-icohp-distance | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
Python API reference | ||
==================== | ||
|
||
|
||
.. currentmodule:: lobsterpy | ||
|
||
.. autosummary:: | ||
:recursive: | ||
:toctree: | ||
:nosignatures: | ||
|
||
cohp | ||
featurize | ||
plotting | ||
structuregraph |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
Analysis | ||
======== | ||
|
||
.. currentmodule:: lobsterpy.cohp.analyze | ||
|
||
.. autoclass:: Analysis | ||
:show-inheritance: | ||
:members: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
lobsterpy.cohp.analyze | ||
====================== | ||
|
||
.. automodule:: lobsterpy.cohp.analyze | ||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
.. rubric:: Classes | ||
|
||
.. autosummary:: | ||
:toctree: | ||
:nosignatures: | ||
|
||
Analysis | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
Description | ||
=========== | ||
|
||
.. currentmodule:: lobsterpy.cohp.describe | ||
|
||
.. autoclass:: Description | ||
:show-inheritance: | ||
:members: |
Oops, something went wrong.