# peaks
[](https://github.com/phrgab/peaks)
[](https://research.st-andrews.ac.uk/kinggroup/peaks)
[](https://docs.astral.sh/ruff/formatter/)
`peaks`: **P**ython **E**lectron Spectroscopy **A**nalysis by **K**ing Group **S**t Andrews.
<!-- overview-start -->
`peaks` provides a collection of analysis tools for the loading, processing and visualisation of spectroscopic data, with a core focus on tools for angle-resolved photoemission.
`peaks` is an evolution of the `PyPhoto` package originally developed by Phil King, Brendan Edwards, Tommaso Antonelli, Edgar Abarca Morales, Lewis Hart, and Liam Trzaska from the [King group](https://www.quantummatter.co.uk/king) at the [University of St Andrews](http://www.st-andrews.ac.uk). This version of `peaks` is the result of a major restructuring of the package in 2023-2025 by Brendan Edwards, Phil King, and Shu Mo.
Contact [pdk6@st-andrews.ac.uk](pdk6@st-andrews.ac.uk).
<!-- overview-end -->
## Citation
<!-- citation-start -->
If you use `peaks` in your work, please cite:
*`peaks`: a Python package for analysis of angle-resolved photoemission and related spectroscopies* \
Phil D. C. King, Brendan Edwards, Shu Mo, Tommaso Antonelli,
Edgar Abarca Morales, Lewis Hart, and Liam Trzaska \
[arXiv:2508.04803](https://arxiv.org/abs/2508.04803) (2025)
<!-- citation-end -->
<!-- installation-start -->
## Installation
`peaks` is registed on [PyPI](https://pypi.org/project/peaks-arpes/) under the name `peaks-arpes`.
It is recommended to install `peaks` in its own isolated environment. E.g. using conda:
```bash
conda create -n peaks python=3.12
conda activate peaks
pip install peaks-arpes
```
`peaks` will then be installed together with its core dependencies.
### Optional dependencies
To install optional dependencies, append `\[dep1, dep2, ...\]` to the end of the `pip install ...` command, where `dep` is the name of the dependency. The following options can currently be specified:
- **structure** - required for the use of the `bz` module, for e.g. plotting Brillouin zones on the data;
- **ML** - required for the use of the machine learning module;
- **dev** - optional development dependencies, used for e.g. linting the code and installing pre-commit hooks.
- **docs** - optional dependencies for building local copies of the documentation.
### Installing from source
The latest version of `peaks` can be installed directly from source:
```bash
pip install git+https://github.com/phrgab/peaks.git
```
To install a specific tagged version, append `@<tag>` to the end of the git link where `<tag>` is the tag name.
<!-- installation-end -->
<!-- basic-usage-start -->
## Basic Usage
`peaks` is typically run in a Jupyter notebook or equivalent. To import peaks run:
```python
import peaks as pks
```
See the [User Guide](https://research.st-andrews.ac.uk/kinggroup/peaks/latest/user_guide.html) for more information on the package and its use.
<!-- basic-usage-end -->
## Documentation
The peaks documentation can be found at [research.st-andrews.ac.uk/kinggroup/peaks](https://research.st-andrews.ac.uk/kinggroup/peaks).
## Contributing
Contributions to the package are welcome. Please see the [contributing guide](https://research.st-andrews.ac.uk/kinggroup/peaks/latest/contributing.html) in the documentation for more information.
## License
Copyright 2019-2025, peaks developers
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
peaks also makes extensive use of many other packages - see dependencies in pyproject.toml and their relevant licenses in the source control of those packages.
Raw data
{
"_id": null,
"home_page": null,
"name": "peaks-arpes",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ARPES, photoemission, spectroscopy, xarray",
"author": "Brendan Edwards",
"author_email": "Phil King <pdk6@st-andrews.ac.uk>, Shu Mo <sm584@st-andrews.ac.uk>",
"download_url": "https://files.pythonhosted.org/packages/22/13/f57729567c6a57f0ba47ce60edd96259938ecff803a07d9b5cd074a03f7e/peaks_arpes-0.4.2.tar.gz",
"platform": null,
"description": "# peaks\n\n[](https://github.com/phrgab/peaks)\n[](https://research.st-andrews.ac.uk/kinggroup/peaks)\n[](https://docs.astral.sh/ruff/formatter/)\n\n`peaks`: **P**ython **E**lectron Spectroscopy **A**nalysis by **K**ing Group **S**t Andrews.\n\n<!-- overview-start -->\n`peaks` provides a collection of analysis tools for the loading, processing and visualisation of spectroscopic data, with a core focus on tools for angle-resolved photoemission.\n\n`peaks` is an evolution of the `PyPhoto` package originally developed by Phil King, Brendan Edwards, Tommaso Antonelli, Edgar Abarca Morales, Lewis Hart, and Liam Trzaska from the [King group](https://www.quantummatter.co.uk/king) at the [University of St Andrews](http://www.st-andrews.ac.uk). This version of `peaks` is the result of a major restructuring of the package in 2023-2025 by Brendan Edwards, Phil King, and Shu Mo.\n\nContact [pdk6@st-andrews.ac.uk](pdk6@st-andrews.ac.uk).\n\n<!-- overview-end -->\n\n## Citation\n<!-- citation-start -->\nIf you use `peaks` in your work, please cite:\n\n*`peaks`: a Python package for analysis of angle-resolved photoemission and related spectroscopies* \\\nPhil D. C. King, Brendan Edwards, Shu Mo, Tommaso Antonelli,\nEdgar Abarca Morales, Lewis Hart, and Liam Trzaska \\\n[arXiv:2508.04803](https://arxiv.org/abs/2508.04803) (2025)\n\n<!-- citation-end -->\n\n<!-- installation-start -->\n## Installation\n\n`peaks` is registed on [PyPI](https://pypi.org/project/peaks-arpes/) under the name `peaks-arpes`.\n\nIt is recommended to install `peaks` in its own isolated environment. E.g. using conda:\n\n```bash\nconda create -n peaks python=3.12\nconda activate peaks\npip install peaks-arpes\n```\n`peaks` will then be installed together with its core dependencies.\n\n### Optional dependencies\nTo install optional dependencies, append `\\[dep1, dep2, ...\\]` to the end of the `pip install ...` command, where `dep` is the name of the dependency. The following options can currently be specified:\n\n- **structure** - required for the use of the `bz` module, for e.g. plotting Brillouin zones on the data;\n- **ML** - required for the use of the machine learning module;\n- **dev** - optional development dependencies, used for e.g. linting the code and installing pre-commit hooks.\n- **docs** - optional dependencies for building local copies of the documentation. \n\n### Installing from source\n\nThe latest version of `peaks` can be installed directly from source:\n```bash\npip install git+https://github.com/phrgab/peaks.git\n```\n\n\nTo install a specific tagged version, append `@<tag>` to the end of the git link where `<tag>` is the tag name.\n<!-- installation-end -->\n\n<!-- basic-usage-start -->\n## Basic Usage\n`peaks` is typically run in a Jupyter notebook or equivalent. To import peaks run:\n```python\nimport peaks as pks\n```\n\nSee the [User Guide](https://research.st-andrews.ac.uk/kinggroup/peaks/latest/user_guide.html) for more information on the package and its use.\n<!-- basic-usage-end -->\n\n## Documentation\nThe peaks documentation can be found at [research.st-andrews.ac.uk/kinggroup/peaks](https://research.st-andrews.ac.uk/kinggroup/peaks).\n\n## Contributing\nContributions to the package are welcome. Please see the [contributing guide](https://research.st-andrews.ac.uk/kinggroup/peaks/latest/contributing.html) in the documentation for more information.\n\n## License\nCopyright 2019-2025, peaks developers\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at\n\nhttps://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.\n\npeaks also makes extensive use of many other packages - see dependencies in pyproject.toml and their relevant licenses in the source control of those packages. \n",
"bugtrack_url": null,
"license": null,
"summary": "Python tools for analysis of angle-resolved photoemission and related spectroscopic data",
"version": "0.4.2",
"project_urls": {
"Documentation": "https://research.st-andrews.ac.uk/kinggroup/peaks/",
"Issues": "https://github.com/phrgab/peaks/issues",
"Source": "https://github.com/phrgab/peaks"
},
"split_keywords": [
"arpes",
" photoemission",
" spectroscopy",
" xarray"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cfbaa5b58ca6d27b4796014af9f552ed6e26d244e6719bcfa2b8fc149c48eb67",
"md5": "cbc5b471c4534ed5495d9eeae6ad6ea9",
"sha256": "b39ec9caf810bd9b9f3e7ed7ef066824b5b6f5a1cc19f320c43b5509749f9d11"
},
"downloads": -1,
"filename": "peaks_arpes-0.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cbc5b471c4534ed5495d9eeae6ad6ea9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 508098,
"upload_time": "2025-08-08T16:32:12",
"upload_time_iso_8601": "2025-08-08T16:32:12.358337Z",
"url": "https://files.pythonhosted.org/packages/cf/ba/a5b58ca6d27b4796014af9f552ed6e26d244e6719bcfa2b8fc149c48eb67/peaks_arpes-0.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2213f57729567c6a57f0ba47ce60edd96259938ecff803a07d9b5cd074a03f7e",
"md5": "f6e05bd672114b0964f96c52cfade2bf",
"sha256": "58017e49c2fc3888b09289a1120b209506c78454a2f81bedd64926b60a185fa5"
},
"downloads": -1,
"filename": "peaks_arpes-0.4.2.tar.gz",
"has_sig": false,
"md5_digest": "f6e05bd672114b0964f96c52cfade2bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 468732,
"upload_time": "2025-08-08T16:32:14",
"upload_time_iso_8601": "2025-08-08T16:32:14.079811Z",
"url": "https://files.pythonhosted.org/packages/22/13/f57729567c6a57f0ba47ce60edd96259938ecff803a07d9b5cd074a03f7e/peaks_arpes-0.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-08 16:32:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "phrgab",
"github_project": "peaks",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "peaks-arpes"
}
JSON
