Sumo
Sumo is a Python toolkit for plotting and analysis of ab initio calculation data. The main features include:
An extensive framework for generating high-symmetry k-point paths.
Plotting scripts for electronic and phonon band structures, density of states, and optical absorption diagrams.
Analysis scripts to calculate parabolic and non-parabolic band effective masses.
The code currently only supports VASP calculations, however, we plan to add support for additional codes in future releases.
Sumo is free to use, however, we ask that you cite the code if you use it in your research.
Warning: There are probably still some bugs. If you think you’ve found one, please report it on the Issue Tracker. We welcome your help in improving and extending the package with your own contributions.
Usage
Sumo is intended to be used via the command-line, however, a fully-documented python API is also provided. A manual, including tutorials and API documentation, is available online. Additionally, the built-in help (-h) option for each command provides a summary of the available options.
Currently, the scripts provided by sumo are:
sumo-kgen: For generating VASP KPOINTS files along high-symmetry k-point paths.
sumo-bandplot: For plotting publication-ready electronic band structure diagrams.
sumo-dosplot: For plotting publication-ready electronic density of states diagrams.
sumo-optplot: For plotting publication-ready optical absorption diagrams.
sumo-phonon-bandplot: For plotting publication-ready phonon band structure diagrams.
sumo-bandstats: For calculating electron and hole effective masses from a band structure.
A guide to using each command can be found on the Tutorial page.
For a preview of the functionality of sumo, see the Gallery.
Installation
We recommend installation from source with Pip, this will automatically install any dependencies:
pip3 install --user sumoTo build the documentation, download the package source and install with extra dependecies:
pip3 install --user .[docs]
cd docs
make htmlDeveloper installation
Developers may prefer to install using pip3 install --user -e . which creates an “editable” local installation. Instead of copying files, this creates links to the source folder so that that tweaks to the code in your source folder will be immediately reflected on the PATH.
Tests
To ensure the code has been installed correctly, the unittests can be run (from the root directory of the project) using:
python -m unittest discover tests
Requirements
Sumo is currently compatible with Python 3.5+ and relies on a number of open-source python packages, specifically:
Sumo uses Pip and setuptools for installation. You probably already have this; if not, your GNU/Linux package manager will be able to oblige with a package named something like python-setuptools. On Max OSX the Python distributed with Homebrew. includes setuptools and Pip.
License
Sumo is made available under the MIT License.
2 maintainers
Release files for sumo 1.0.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sumo-1.0.6.tar.gz | 55.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sumo-1.0.6-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 133.4 kB
Release files / sumo-1.0.6.tar.gz
| Download URL | sumo-1.0.6.tar.gz |
|---|---|
| Size | 55.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2301d4afde35484fea932d2433d6fd7d3ceda305443a26288e2916cf164810d7
|
|
BLAKE2b-256 checksum How to use checksums |
7a3e8145825a888d34f69955a28ba8601a0044e76f6f2010a32ce9075de23900
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / sumo-1.0.6-py2.py3-none-any.whl
| Download URL | sumo-1.0.6-py2.py3-none-any.whl |
|---|---|
| Size | 77.6 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
256b8f8909762c2894e48199f2e374ffaefc529492bfc795f9e7d3d6a5151232
|
|
BLAKE2b-256 checksum How to use checksums |
9863d39e3c1600f77bc2756d35577807c8a5999982eaadb4c33947ff19fde340
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
