Skip to main content

Python package for defining, reading, analysis, and plotting of finite difference fields.

Project description

discretisedfield

Marijan Beg1,2, Ryan A. Pepper2, Thomas Kluyver1, and Hans Fangohr1,2

1 European XFEL GmbH, Holzkoppel 4, 22869 Schenefeld, Germany
2 Faculty of Engineering and the Environment, University of Southampton, Southampton SO17 1BJ, United Kingdom

Description Badge
Latest release PyPI version
Anaconda-Server Badge
Build Build Status
Build status
Coverage codecov
Documentation Documentation Status
Binder Binder
License License

About

discretisedfield is a Python package that provides:

  • Creation of finite difference meshes

  • Creation, analysis, and plotting of finite difference fields

  • Reading and writing of different file types, such as .ovf and .vtk

It is available on all major operating systems (Windows, MacOS, Linux) and requires Python 3.5 or higher.

Installation

We recommend installing discretisedfield by using either of the pip or conda package managers.

Python requirements

Before installing discretisedfield via pip, please make sure you have Python 3.5 or higher on your system. You can check that by running

python3 --version

If you are on Linux, it is likely that you already have Python installed. However, on MacOS and Windows, this is usually not the case. If you do not have Python 3.5 or higher on your machine, we strongly recommend installing the Anaconda Python distribution. Download Anaconda for your operating system and follow instructions on the download page. Further information about installing Anaconda can be found here.

pip

After installing Anaconda on MacOS or Windows, pip will also be installed. However, on Linux, if you do not already have pip, you can install it with

sudo apt install python3-pip

To install the discretisedfield version currently in the Python Package Index repository PyPI on all operating systems run:

python3 -m pip install discretisedfield

conda

discretisedfield is installed using conda by running

conda install --channel conda-forge discretisedfield

For further information on the conda package, dependency, and environment management, please have a look at its documentation.

Updating

If you used pip to install discretisedfield, you can update to the latest released version in PyPI by running

python3 -m pip install --upgrade discretisedfield

On the other hand, if you used conda for installation, update discretisedfield with

conda upgrade discretisedfield

Development version

The most recent development version of discretisedfield that is not yet released can be installed/updated with

git clone https://github.com/ubermag/discretisedfield.git
python3 -m pip install --upgrade discretisedfield

Note: If you do not have git on your system, it can be installed by following the instructions here.

Binder

discretisedfield can be used in the cloud via Binder. This does not require you to have anything installed and no files will be created on your machine. To use discretisedfield in the cloud, follow this link.

Documentation

Documentation for discretisedfield is available here, where APIs and tutorials (in the form of Jupyter notebooks) are available.

Support

If you require support on installation or usage of discretisedfield or if you want to report a problem, you are welcome to raise an issue in our ubermag/help repository.

License

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

How to cite

If you use discretisedfield in your research, please cite it as:

  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. DOI will be available soon

Acknowledgements

discretisedfield was developed as a part of OpenDreamKit – Horizon 2020 European Research Infrastructure project (676541).

Project details


Download files

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

Source Distribution

discretisedfield-0.8.4.tar.gz (33.6 kB view details)

Uploaded Source

Built Distribution

discretisedfield-0.8.4-py3-none-any.whl (36.6 kB view details)

Uploaded Python 3

File details

Details for the file discretisedfield-0.8.4.tar.gz.

File metadata

  • Download URL: discretisedfield-0.8.4.tar.gz
  • Upload date:
  • Size: 33.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.33.0 CPython/3.7.4

File hashes

Hashes for discretisedfield-0.8.4.tar.gz
Algorithm Hash digest
SHA256 91760ef56cfed70954f1d34ab4a7b60165a8348d02449fc79070c1f96796b35c
MD5 974351bc39e09bef219b8fbd87eaf974
BLAKE2b-256 03c808819cf0b2a19bc04c0e5c2502e034b9ce0c1a417201189957b0a9ff0adc

See more details on using hashes here.

File details

Details for the file discretisedfield-0.8.4-py3-none-any.whl.

File metadata

  • Download URL: discretisedfield-0.8.4-py3-none-any.whl
  • Upload date:
  • Size: 36.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.33.0 CPython/3.7.4

File hashes

Hashes for discretisedfield-0.8.4-py3-none-any.whl
Algorithm Hash digest
SHA256 d33ba7a5b877f5d4929549579bb06112009c85fefa3ee49c78bfdabfbbabbb96
MD5 08b3b2e15fff5d4b6513b3f7b80e7c91
BLAKE2b-256 b3a627ee56f17c756d6d1951b3956b4e0700b7046aca44774c602cc58d8fa0d3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page