aiida-skeaf


Nameaiida-skeaf JSON
Version 0.1.0 PyPI version JSON
download
home_pageNone
SummaryAiiDA plugin for the Supercell K-space Extremal Area Finder (SKEAF) code
upload_time2025-08-21 19:16:38
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseNone
keywords aiida plugin
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![Build Status][ci-badge]][ci-link]
[![Coverage Status][cov-badge]][cov-link]
[![Docs status][docs-badge]][docs-link]
[![PyPI version][pypi-badge]][pypi-link]

# aiida-skeaf

AiiDA plugin for the Supercell K-space Extremal Area Finder (SKEAF) code.

## Installation

```shell
pip install aiida-skeaf
verdi quicksetup  # better to set up a new profile
verdi plugin list aiida.calculations  # should now show your calclulation plugins
```


## Usage

Here goes a [complete example](examples/example_01.py) of how to submit a test calculation using this plugin.

A quick demo of how to submit a calculation:
```shell
verdi daemon start     # make sure the daemon is running
cd examples
./example_01.py        # run test calculation
verdi process list -a  # check record of calculation
```

An exemplary `verdi node show`:
```
Property     Value
-----------  ------------------------------------
type         SkeafCalculation
state        Finished [0]
pk           137264
uuid         92d3ff92-9ab4-4828-9794-4172d7dcad50
label
description
ctime        2022-03-01 19:12:16.157988+00:00
mtime        2022-03-01 19:13:28.369793+00:00
computer     [2] localhost

Inputs          PK  Type
----------  ------  ----------
bxsf        137262  RemoteData
code        137230  Code
parameters  137263  Dict

Outputs                PK  Type
-----------------  ------  ----------
frequency          137268  ArrayData
output_parameters  137267  Dict
remote_folder      137265  RemoteData
retrieved          137266  FolderData
```

A frequency vs angle plot can be found in [examples/results/example_01.png](examples/results/example_01.png)

## Development

```shell
git clone https://github.com/aiidaplugins/aiida-skeaf .
cd aiida-skeaf
pip install flit
flit install -s .[pre-commit,testing]  # install extra dependencies
pre-commit install  # install pre-commit hooks
pytest -v  # discover and run all tests
```

See the [developer guide](http://aiida-skeaf.readthedocs.io/en/latest/developer_guide/index.html) for more information.

## License

MIT

[ci-badge]: https://github.com/qiaojunfeng/aiida-skeaf/workflows/ci/badge.svg?branch=master
[ci-link]: https://github.com/qiaojunfeng/aiida-skeaf/actions
[cov-badge]: https://coveralls.io/repos/github/qiaojunfeng/aiida-skeaf/badge.svg?branch=master
[cov-link]: https://coveralls.io/github/qiaojunfeng/aiida-skeaf?branch=master
[docs-badge]: https://readthedocs.org/projects/aiida-skeaf/badge
[docs-link]: http://aiida-skeaf.readthedocs.io/
[pypi-badge]: https://badge.fury.io/py/aiida-skeaf.svg
[pypi-link]: https://badge.fury.io/py/aiida-skeaf


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "aiida-skeaf",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "aiida, plugin",
    "author": null,
    "author_email": "Junfeng Qiao <qiaojunfeng@outlook.com>",
    "download_url": "https://files.pythonhosted.org/packages/09/3c/e6f590667ccb0fe0c1e66f8a84a9e2fe07a6045b94fdae7733d02300a7bb/aiida_skeaf-0.1.0.tar.gz",
    "platform": null,
    "description": "[![Build Status][ci-badge]][ci-link]\n[![Coverage Status][cov-badge]][cov-link]\n[![Docs status][docs-badge]][docs-link]\n[![PyPI version][pypi-badge]][pypi-link]\n\n# aiida-skeaf\n\nAiiDA plugin for the Supercell K-space Extremal Area Finder (SKEAF) code.\n\n## Installation\n\n```shell\npip install aiida-skeaf\nverdi quicksetup  # better to set up a new profile\nverdi plugin list aiida.calculations  # should now show your calclulation plugins\n```\n\n\n## Usage\n\nHere goes a [complete example](examples/example_01.py) of how to submit a test calculation using this plugin.\n\nA quick demo of how to submit a calculation:\n```shell\nverdi daemon start     # make sure the daemon is running\ncd examples\n./example_01.py        # run test calculation\nverdi process list -a  # check record of calculation\n```\n\nAn exemplary `verdi node show`:\n```\nProperty     Value\n-----------  ------------------------------------\ntype         SkeafCalculation\nstate        Finished [0]\npk           137264\nuuid         92d3ff92-9ab4-4828-9794-4172d7dcad50\nlabel\ndescription\nctime        2022-03-01 19:12:16.157988+00:00\nmtime        2022-03-01 19:13:28.369793+00:00\ncomputer     [2] localhost\n\nInputs          PK  Type\n----------  ------  ----------\nbxsf        137262  RemoteData\ncode        137230  Code\nparameters  137263  Dict\n\nOutputs                PK  Type\n-----------------  ------  ----------\nfrequency          137268  ArrayData\noutput_parameters  137267  Dict\nremote_folder      137265  RemoteData\nretrieved          137266  FolderData\n```\n\nA frequency vs angle plot can be found in [examples/results/example_01.png](examples/results/example_01.png)\n\n## Development\n\n```shell\ngit clone https://github.com/aiidaplugins/aiida-skeaf .\ncd aiida-skeaf\npip install flit\nflit install -s .[pre-commit,testing]  # install extra dependencies\npre-commit install  # install pre-commit hooks\npytest -v  # discover and run all tests\n```\n\nSee the [developer guide](http://aiida-skeaf.readthedocs.io/en/latest/developer_guide/index.html) for more information.\n\n## License\n\nMIT\n\n[ci-badge]: https://github.com/qiaojunfeng/aiida-skeaf/workflows/ci/badge.svg?branch=master\n[ci-link]: https://github.com/qiaojunfeng/aiida-skeaf/actions\n[cov-badge]: https://coveralls.io/repos/github/qiaojunfeng/aiida-skeaf/badge.svg?branch=master\n[cov-link]: https://coveralls.io/github/qiaojunfeng/aiida-skeaf?branch=master\n[docs-badge]: https://readthedocs.org/projects/aiida-skeaf/badge\n[docs-link]: http://aiida-skeaf.readthedocs.io/\n[pypi-badge]: https://badge.fury.io/py/aiida-skeaf.svg\n[pypi-link]: https://badge.fury.io/py/aiida-skeaf\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "AiiDA plugin for the Supercell K-space Extremal Area Finder (SKEAF) code",
    "version": "0.1.0",
    "project_urls": {
        "Source": "https://github.com/aiidaplugins/aiida-skeaf"
    },
    "split_keywords": [
        "aiida",
        " plugin"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9923b655b59e4a26514643702b783149918c75c6087d3a2cd4208962e745aa8f",
                "md5": "4c803dad23a110f606dc80fbfac27a4d",
                "sha256": "f7034a1267f563cc33d75d9e52944ab97f5fe5d8901d29c6c31ffe851780bbc2"
            },
            "downloads": -1,
            "filename": "aiida_skeaf-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4c803dad23a110f606dc80fbfac27a4d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 26061,
            "upload_time": "2025-08-21T19:16:36",
            "upload_time_iso_8601": "2025-08-21T19:16:36.936115Z",
            "url": "https://files.pythonhosted.org/packages/99/23/b655b59e4a26514643702b783149918c75c6087d3a2cd4208962e745aa8f/aiida_skeaf-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "093ce6f590667ccb0fe0c1e66f8a84a9e2fe07a6045b94fdae7733d02300a7bb",
                "md5": "c7957b922a23e19ad9537ca3e19106de",
                "sha256": "4e7f992c1472835e0b6be05b44e532de0932cbac2bbfaef8f7b3aaa76e3959a2"
            },
            "downloads": -1,
            "filename": "aiida_skeaf-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "c7957b922a23e19ad9537ca3e19106de",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 20055,
            "upload_time": "2025-08-21T19:16:38",
            "upload_time_iso_8601": "2025-08-21T19:16:38.511974Z",
            "url": "https://files.pythonhosted.org/packages/09/3c/e6f590667ccb0fe0c1e66f8a84a9e2fe07a6045b94fdae7733d02300a7bb/aiida_skeaf-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-21 19:16:38",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "aiidaplugins",
    "github_project": "aiida-skeaf",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "aiida-skeaf"
}
        
Elapsed time: 0.85264s