Metadata-Version: 2.1
Name: oommfodt
Version: 0.8.2
Summary: Python package for reading and analysis of OOMMF .odt files.
Home-page: https://joommf.github.io
Author: Marijan Beg, Ryan A. Pepper, Thomas Kluyver, and Hans Fangohr
Author-email: jupyteroommf@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Description-Content-Type: text/markdown
Requires-Dist: pandas
Requires-Dist: openpyxl
Requires-Dist: xlrd
Requires-Dist: xlwt
Requires-Dist: pytest

# oommfodt
Marijan Beg<sup>1,2</sup>, Ryan A. Pepper<sup>2</sup>, Thomas Kluyver<sup>1</sup>, and Hans Fangohr<sup>1,2</sup>

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

| Description | Badge |
| --- | --- |
| Latest release | [![PyPI version](https://badge.fury.io/py/oommfodt.svg)](https://badge.fury.io/py/oommfodt) |
|                | [![Anaconda-Server Badge](https://anaconda.org/conda-forge/oommfodt/badges/version.svg)](https://anaconda.org/conda-forge/oommfodt) |
| Build | [![Build Status](https://travis-ci.org/joommf/oommfodt.svg?branch=master)](https://travis-ci.org/joommf/oommfodt) |
|       |  [![Build status](https://ci.appveyor.com/api/projects/status/sr110qs3qj00yqib?svg=true)](https://ci.appveyor.com/project/marijanbeg/oommfodt) |
| Coverage | [![codecov](https://codecov.io/gh/joommf/oommfodt/branch/master/graph/badge.svg)](https://codecov.io/gh/joommf/oommfodt) |
| Documentation | [![Documentation Status](https://readthedocs.org/projects/oommfodt/badge/?version=latest)](http://oommfodt.readthedocs.io/en/latest/?badge=latest) |
| Badge | [![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/joommf/oommfodt/master?filepath=index.ipynb) |
| Dependecies | [![Requirements Status](https://requires.io/github/joommf/oommfodt/requirements.svg?branch=master)](https://requires.io/github/joommf/oommfodt/requirements/?branch=master) |
| License | [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause) |

## About

`oommfodt` is a Python package that provides:

- Reading, analysis, and plotting of [OOMMF](https://math.nist.gov/oommf/) `.odt` files

- Conversion of OOMMF `.odt` files to [pandas](https://pandas.pydata.org) dataframes and saving to different file types, such as Excel spreadsheet `.xls`

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

## Installation

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

#### Python requirements

Before installing `oommfodt` 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](https://www.anaconda.com/) Python distribution. [Download Anaconda](https://www.anaconda.com/download) for your operating system and follow instructions on the download page. Further information about installing Anaconda can be found [here](https://conda.io/docs/user-guide/install/download.html).

#### `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 `oommfodt` version currently in the Python Package Index repository [PyPI](https://pypi.org/project/oommfodt/) on all operating systems run:

    python3 -m pip install oommfodt

#### `conda`

`oommfodt` is installed using `conda` by running

    conda install --channel conda-forge oommfodt

For further information on the `conda` package, dependency, and environment management, please have a look at its [documentation](https://conda.io/docs/). 

## Updating

If you used pip to install `oommfodt`, you can update to the latest released version in [PyPI](https://pypi.org/project/oommfodt/) by running

    python3 -m pip install --upgrade oommfodt

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

    conda upgrade oommfodt

#### Development version

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

    git clone https://github.com/joommf/oommfodt.git
    python3 -m pip install --upgrade oommfodt

**Note**: If you do not have `git` on your system, it can be installed by following the instructions [here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git).

## Binder

`oommfodt` 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 `oommfodt` in the cloud, follow this [link](https://mybinder.org/v2/gh/joommf/oommfodt/master?filepath=index.ipynb).

## Documentation

Documentation for `oommfodt` is available [here](http://oommfodt.readthedocs.io/en/latest/?badge=latest), where APIs and tutorials (in the form of Jupyter notebooks) are available.

## Support

If you require support on installation or usage of `oommfodt` or if you want to report a problem, you are welcome to raise an issue in our [joommf/help](https://github.com/joommf/help) repository.

## License

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

## How to cite

If you use `oommfodt` 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](http://aip.scitation.org/doi/10.1063/1.4977225) (2017).

2. DOI will be available soon

## Acknowledgements

`oommfodt` was developed as a part of [OpenDreamKit](http://opendreamkit.org/) – Horizon 2020 European Research Infrastructure project (676541).


