Metadata-Version: 2.1
Name: emdfile
Version: 0.0.1
Project-URL: github, https://github.com/py4dstem/emdfile
Project-URL: emdatasets, https://emdatasets.com/format/
Author-email: Ben Savitzky <ben.savitzky@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: h5py>=3.2.0
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: tqdm>=4.46.1
Description-Content-Type: text/markdown

# emdfile

EMD (Electron Microscopy Dataset) 1.0 is an HDF5 based file format which
is designed to carry arbitrary data and metadata.  An overview of the
file specification can be found [here](https://emdatasets.com/format/).


`emdfile` is a Python package defining write and read functions and a set of
classes which together interface between EMD 1.0 files and Python runtime
objects.  The classes are designed to quickly build, save to, and read from
filetree-like representations of data and metadata.


## Installation

Run

>>> pip install emdfile

Or, to install from source code, clone this repository and from the
distribution level directory (i.e. where pyproject.toml lives) run

>>> pip install .



## Examples and syntax

For an example, see
[tutorials/emd_intro_example.ipynb](./tutorials/emd_intro_example.ipynb).

For an walkthrough of the syntax, see
[tutorials/emd_package_walkthrough.ipynb](./tutorials/emd_package_walkthrough.ipynb).

For an example of a downstream Python package with it's IO build on emdfile, see
[tutorials/test_custom_class.py](./tutorials/test_custom_class.py) and
[tutorials/sample_custom_class_module](./tutorials/sample_custom_class_module).





