From fc2b9f83fe4905075abbe1eba04dc2929f4273d6 Mon Sep 17 00:00:00 2001 From: Jonathan Chico Date: Thu, 23 Nov 2023 17:08:41 +0100 Subject: [PATCH] (WIP) documentation improvement. --- README.md | 2 +- docs/source/_static/logo.pptx | Bin 94959 -> 0 bytes docs/source/developers/index.md | 51 ++++++++++-------- docs/source/getting_started/index.md | 4 +- docs/source/index.md | 4 +- docs/source/topics/data/potential.md | 2 +- docs/source/tutorials/first_md.md | 2 +- docs/source/tutorials/first_raw.md | 11 +--- .../include/scripts/run_raw_basic.py | 13 ++--- examples/launch_lammps_raw_script.py | 13 ++--- 10 files changed, 47 insertions(+), 55 deletions(-) delete mode 100644 docs/source/_static/logo.pptx diff --git a/README.md b/README.md index a2867c76..a3f36b12 100644 --- a/README.md +++ b/README.md @@ -96,7 +96,7 @@ conda install lammps==2019.06.05 You can specify a different executable name for LAMMPS with: ```shell -tox -e py37 -- --lammps-exec lmp_exec +tox -e 3.9-aiida_lammps -- --lammps-exec lmp_exec ``` To output the results of calcjob executions to a specific directory: diff --git a/docs/source/_static/logo.pptx b/docs/source/_static/logo.pptx deleted file mode 100644 index f029058f8cc7161333026aa5636cf60f8bc5fa00..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 94959 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 diff --git a/docs/source/developers/index.md b/docs/source/developers/index.md index e4021366..cf625086 100644 --- a/docs/source/developers/index.md +++ b/docs/source/developers/index.md @@ -6,31 +6,40 @@ This is a guide for internal development of `aiida-lammps` The code is formatted and linted using [pre-commit](https://pre-commit.com/), which runs in an isolated, virtual environment: -```shell -$ pip install pre-commit -$ pre-commit run --all +```console +pip install pre-commit +pre-commit run --all ``` or to automate runs, triggered before each commit: -```shell -$ pre-commit install +```console +pre-commit install ``` +To avoid problems arising from different configurations in virtual environments, one can also use [tox](https://tox.wiki/en/latest/index.html) to run the pre-commit command inside a clean virtual environment. This can be done in the following manner + +```console +pip install tox +pip install -e .[pre-commit] +tox -e pre-commit +``` + + ## Testing -The test suite can be run in an isolated, virtual environment using `tox` (see `tox.ini` in the repo): +The test suite can be run in an isolated, virtual environment using `tox` (see `[tool.tox]` in `pyproject.toml`): -```shell -$ pip install tox -$ tox -e py37 +```console +pip install tox +tox -e 3.8-aiida_lammps ``` or directly: -```shell -$ pip install .[tests] -$ pytest -v +```console +pip install .[tests] +pytest -v ``` The tests require that both PostgreSQL and RabbitMQ are running. @@ -40,33 +49,33 @@ Some tests require that a `lammps` executable be present. The easiest way to achieve this is to use Conda: -```shell -$ conda install lammps==2019.06.05 +```console +conda install lammps==2019.06.05 # this will install lmp_serial and lmp_mpi ``` You can specify a different executable name for LAMMPS with: -```shell -$ tox -e py37 -- --lammps-exec lmp_exec +```console +tox -e 3.8-aiida_lammps -- --lammps-exec lmp_exec ``` To output the results of calcjob executions to a specific directory: -```shell -$ pytest --lammps-workdir "test_workdir" +```console +pytest --lammps-workdir "test_workdir" ``` ## Documentation To run a full docs build: -```shell -$ tox -e docs-clean +```console +tox -e docs-clean ``` or to re-build from the current documentation: -```shell +```console $ tox -e docs-update ``` diff --git a/docs/source/getting_started/index.md b/docs/source/getting_started/index.md index 5714a553..7157ac6b 100644 --- a/docs/source/getting_started/index.md +++ b/docs/source/getting_started/index.md @@ -29,7 +29,7 @@ The package can be installed either from the Python Package Index {{ PyPI }} or :::{tab-item} PyPI Installing via {{ PyPI }} can be done making use of the Python package manager {{ pip }}: -```shell +```console pip install aiida-lammps ``` @@ -39,7 +39,7 @@ This will install the latest release version available in {{ PyPI }}. Other rele :::{tab-item} Source To install from source one needs to clone the repository and then install the package making use of {{ pip }}: -```shell +```console git clone https://github.com/aiidaplugins/aiida-lammps.git pip install -e aiida-lammps ``` diff --git a/docs/source/index.md b/docs/source/index.md index 6d1988f4..1d1303f0 100644 --- a/docs/source/index.md +++ b/docs/source/index.md @@ -38,7 +38,7 @@ reference/api/index # AiiDA LAMMPS Plugin -{{ aiida_lammps }} is a Python package that allows the workflow management and data provenance tracking framework [AiiDA](http://aiida-core.readthedocs.io/) run {{ LAMMPS }} calculations. +{{ aiida_lammps }} is a Python package that allows the workflow management and data provenance tracking framework [AiiDA](http://aiida-core.readthedocs.io/) to run {{ LAMMPS }} calculations. {{ LAMMPS }} is a classical molecular dynamics (MD) code with a focus on materials modeling, it is used broadly inside the MD community due to its flexibility, and in-built capability to generate complex workflows in its input script. @@ -109,6 +109,6 @@ The same basic types of calculations than were previously supported (optimizatio {{ aiida_lammps }} has been designed in such a way that the base ``Calculation`` method can run a single-phase LAMMPS calculation with as much flexibility as possible, with multi-stage runs being handled by specially designed ``WorkChains`` instead. -### What does this implies? +### What does this imply? Instead of relying on the internal {{ LAMMPS }} scripting language to treat loops, multiple phases, definition of custom variables, etc., those tasks are off loaded to the AiiDA workchains, allowing one to make use of the provenance tracking, automated data storage and caching capabilities of AiiDA. diff --git a/docs/source/topics/data/potential.md b/docs/source/topics/data/potential.md index e313940d..5b7200ec 100644 --- a/docs/source/topics/data/potential.md +++ b/docs/source/topics/data/potential.md @@ -1,4 +1,4 @@ -# `LammpsPotentialData` +# ``LammpsPotentialData`` The potential is one of the most important pieces of data in a MD simulation, since it controls how the atoms interact with each other. In ``aiida-lammps`` the potential file is stored in the `LammpsPotentialData` data type, which will store the entire potential file in the database, and add certain attributes so that the data node is easily queryable for later usage. These attributes have been chosen so that they resemble the [OpenKIM](https://openkim.org/doc/schema/kimspec/) standard as much as possible. diff --git a/docs/source/tutorials/first_md.md b/docs/source/tutorials/first_md.md index 23068ead..a22070f9 100644 --- a/docs/source/tutorials/first_md.md +++ b/docs/source/tutorials/first_md.md @@ -60,7 +60,7 @@ import requests import io # Download the potential from the repository and store it as a BytesIO object -_stream = io.BytesIO(requests.get('https://openkim.org/files/MO_546673549085_000/Fe_2.eam.fs').text.encode('ascii')) +_stream = io.BytesIO(requests.get('https://openkim.org/files/MO_546673549085_000/Fe_2.eam.fs', timeout=20).text.encode('utf-8')) # Set the metadata for the potential potential_parameters = { diff --git a/docs/source/tutorials/first_raw.md b/docs/source/tutorials/first_raw.md index df918fc6..8af8a33c 100644 --- a/docs/source/tutorials/first_raw.md +++ b/docs/source/tutorials/first_raw.md @@ -90,15 +90,8 @@ As one can notice the script wants to read a file named `data.rhodo` via the [`r ```python import requests -data = SinglefileData( - io.StringIO( - textwrap.dedent( - requests.get( - "https://raw.githubusercontent.com/lammps/lammps/develop/bench/data.rhodo" - ).text - ) - ) -) +request = requests.get("https://raw.githubusercontent.com/lammps/lammps/develop/bench/data.rhodo") +data = SinglefileData(io.StringIO(request.text)) builder.files = {"data": data} builder.filenames = {"data": "data.rhodo"} ``` diff --git a/docs/source/tutorials/include/scripts/run_raw_basic.py b/docs/source/tutorials/include/scripts/run_raw_basic.py index 1294e9ca..a0b39c78 100755 --- a/docs/source/tutorials/include/scripts/run_raw_basic.py +++ b/docs/source/tutorials/include/scripts/run_raw_basic.py @@ -48,16 +48,11 @@ ) ) ) -data = SinglefileData( - io.StringIO( - textwrap.dedent( - requests.get( - "https://raw.githubusercontent.com/lammps/lammps/develop/bench/data.rhodo", - timeout=20, - ).text - ) - ) +request = requests.get( + "https://raw.githubusercontent.com/lammps/lammps/develop/bench/data.rhodo", + timeout=20, ) +data = SinglefileData(io.StringIO(request.text)) builder = CalculationFactory("lammps.raw").get_builder() builder.code = load_code("lammps@localhost") diff --git a/examples/launch_lammps_raw_script.py b/examples/launch_lammps_raw_script.py index 9aa9c553..4dfb3355 100644 --- a/examples/launch_lammps_raw_script.py +++ b/examples/launch_lammps_raw_script.py @@ -45,16 +45,11 @@ ) ) ) -data = orm.SinglefileData( - io.StringIO( - textwrap.dedent( - requests.get( - "https://raw.githubusercontent.com/lammps/lammps/develop/bench/data.rhodo", - timeout=20, - ).text - ) - ) +request = requests.get( + "https://raw.githubusercontent.com/lammps/lammps/develop/bench/data.rhodo", + timeout=20, ) +data = SinglefileData(io.StringIO(request.text)) builder = plugins.CalculationFactory("lammps.raw").get_builder() builder.code = orm.load_code("lammps-23.06.2022@localhost")