Functions for image and signal processing, based on the packages Scikit-image, Hyperspy, Atomap, PyPrismatic, ASE, periodictable etc. Written by members of the TEMUL group from the University of Limerick, Ireland (though we welcome all help, hints and contributions!)
pip install temul-toolkitFor full installation instructions and documentation, go to temul-toolkit.readthedocs.io.
To use the vast majority of the temul functionality,
import it from the api module::
import temul.api as tml
Jupyter Notebooks and MyBinder allow us to analyse data in the browser without needing any downloads using the below "launch binder" button.
If the button does not work, try this link instead. You also share this link with others for quick access.
-
To run through some code documentation tutorials, go to the "code_tutorials" folder after clicking the above button.
-
To analyse data published in the listed scientific papers, go to the "publication_examples" folder after clicking the above button.
| Publication Details | Folder Location in TEMUL |
|---|---|
| M. Hadjimichael, Y. Li et al, Metal-ferroelectric supercrystals with periodically curved metallic layers, Nature Materials 2021 | publication_examples/PTO_supercrystal_hadjimichael |
| K. Moore et al Highly charged 180 degree head-to-head domain walls in lead titanate, Nature Communications Physics 2020 | publication_examples/PTO_Junction_moore |
| K. Moore et al Charged Domain Wall and Polar Vortex Topologies in a Room-Temperature Magnetoelectric Multiferroic Thin Film, ACS Appl. Mater. Interfaces 2022, 14, 4 | Coming soon |
| E.N. O'Connell et al TopoTEM: A Python Package for Quantifying and Visualizing Scanning Transmission Electron Microscopy Data of Polar Topologies, Microsc Microanal. 2022 doi:10.1017/S1431927622000435 URL Arxiv Version (to be updated while M&M version is not open access (it will be soon!) | See the Docs |
To cite the latest TEMUL toolkit, use the following DOI:
To cite all TEMUL Toolkit versions, use this DOI:
You can also cite the TopoTEM publication if you only worked with polarisation-type analysis.
- See the TopopTEM publication here. It is annoyingly still not open access. Until that point, see the ArXiv link about in the table, or contact me via the Discussion tab above.
We use flake8 to enforce coding style:
pip install -r tests/requirements.txt
flake8 temul
flake8 tests
flake8 docsTests are carried out with pytest:
pip install -r tests/requirements.txt
pytest testsTo build the docs, do the following::
pip install -r docs/requirements.txt
sphinx-build docs _build # open "index.html" in the "_build" directoryMake sure that the docs build locally and online (if you have the rights to check that).
temul gets its version from the latest git tag. If you think that a
new version should be published, create a tag on the master branch
(if you have the necessary permissions to do so):
git tag -a 'x.y.z' -m 'new tag'
git push --tags <remote>GitHub Actions will then automatically build source package and wheels and publish them on PyPI.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent