Skip to main content

Python package for definition, reading, and visualisation of finite-difference fields.

Project description


Marijan Beg1,2, Martin Lang1, Ryan A. Pepper1, Thomas Kluyver1,2, and Hans Fangohr1,2,3

1 Faculty of Engineering and Physical Sciences, University of Southampton, Southampton SO17 1BJ, United Kingdom
2 European XFEL GmbH, Holzkoppel 4, 22869 Schenefeld, Germany
3 Max Planck Institute for the Structure and Dynamics of Matter, Luruper Chaussee 149, 22761 Hamburg, Germany

Description Badge
Tests Build status
Releases PyPI version
Anaconda-Server Badge
Coverage codecov
Documentation Documentation Status
YouTube YouTube
Binder Binder
Platforms Platforms
Downloads Downloads
License License


discretisedfield is a Python package, integrated with Jupyter, providing:

  • definition of finite-difference regions, meshes, lines, and fields,

  • analysis of finite-difference fields,

  • visualisation using matplotlib and k3d, and

  • manipulation of different file types (OVF, VTK, and HDF5).

It is available on Windows, MacOS, and Linux. It requires Python 3.8+.


APIs and tutorials are available in the documentation. To access the documentation, use the badge in the table above.

Installation, testing, and upgrade

We recommend installation using conda package manager. Instructions can be found in the documentation.


This package can be used in the cloud via Binder. To access Binder, use the badge in the table above.


YouTube video tutorials are available on the Ubermag channel.


If you require support, have questions, want to report a bug, or want to suggest an improvement, please raise an issue in ubermag/help repository.


All contributions are welcome, however small they are. If you would like to contribute, please fork the repository and create a pull request. If you are not sure how to contribute, please contact us by raising an issue in ubermag/help repository, and we are going to help you get started and assist you on the way.


  • Sergii Mamedov (@sergii-mamedov), European XFEL, Germany
  • Natalie Downing (@gamdow), University of Southampton, United Kingdom
  • Min RK (@minrk), Simula Research Laboratory, Norway
  • Rebecca Carey (@rlc2v07), University of Southampton, United Kingdom


Licensed under the BSD 3-Clause "New" or "Revised" License. For details, please refer to the LICENSE file.

How to cite

  1. M. Beg, R. A. Pepper, and H. Fangohr. User interfaces for computational science: A domain specific language for OOMMF embedded in Python. AIP Advances 7, 56025 (2017).

  2. M. Beg, M. Lang, R. A. Pepper, T. Kluyver, and H. Fangohr. discretisedfield: Python package for the analysis and visualisation of finite-difference fields. DOI: 10.5281/zenodo.3539461 (2021).


  • OpenDreamKit – Horizon 2020 European Research Infrastructure project (676541)

  • EPSRC Programme Grant on Skyrmionics (EP/N032128/1)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for discretisedfield, version 0.11.1
Filename, size File type Python version Upload date Hashes
Filename, size discretisedfield-0.11.1-py3-none-any.whl (1.9 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size discretisedfield-0.11.1.tar.gz (1.9 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page