Metadata-Version: 2.1
Name: scythe-extractors
Version: 0.1.0a0
Summary: A library of tools that generate summaries of the data contained in scientific data files
Home-page: https://github.com/materials-data-facility/scythe
License: Apache
Author: Materials Data Facility
Author-email: materialsdatafacility@uchicago.edu
Requires-Python: >=3.8.0,<3.11
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Provides-Extra: all
Provides-Extra: ase
Provides-Extra: crystal-structure
Provides-Extra: csv
Provides-Extra: dft
Provides-Extra: electron-microscopy
Provides-Extra: file
Provides-Extra: image
Provides-Extra: tdb
Provides-Extra: xml
Requires-Dist: Pillow (>=9.0.1,<10.0.0) ; extra == "image" or extra == "all"
Requires-Dist: ase (>=3.19,<3.20) ; extra == "ase" or extra == "crystal-structure" or extra == "all"
Requires-Dist: dfttopif (>=1.1.0,<2.0.0) ; extra == "dft" or extra == "all"
Requires-Dist: hyperspy (>=1.4.1,<2.0.0) ; extra == "electron-microscopy" or extra == "all"
Requires-Dist: llvmlite (>=0.38.0,<0.39.0)
Requires-Dist: mdf-toolbox (>=0.5.3,<0.6.0)
Requires-Dist: numba (>=0.55,<0.56)
Requires-Dist: pandas (>=1.4.2,<2.0.0)
Requires-Dist: pycalphad (>=0.10.0,<0.11.0) ; extra == "tdb" or extra == "all"
Requires-Dist: pymatgen (>=2022.3.24,<2023.0.0) ; extra == "crystal-structure" or extra == "all"
Requires-Dist: python-magic (>=0.4.15,<0.5.0) ; extra == "file" or extra == "all"
Requires-Dist: stevedore (>=3.5.0,<4.0.0)
Requires-Dist: tableschema (>=1,<2) ; extra == "csv" or extra == "all"
Requires-Dist: xmltodict (>=0.12.0,<0.13.0) ; extra == "xml" or extra == "all"
Project-URL: Repository, https://github.com/materials-data-facility/scythe
Description-Content-Type: text/markdown

# Scythe

[![Build Status](https://github.com/materials-data-facility/Scythe/workflows/Build%20Status/badge.svg)](https://github.com/materials-data-facility/Scythe/actions/workflows/test-suite-and-docs.yml)
[![Documentation](https://img.shields.io/badge/-Documentation-blue?style=flat&logo=bookstack&labelColor=grey&logoColor=white)](https://materials-data-facility.github.io/Scythe)
[![Coverage Status](https://codecov.io/gh/materials-data-facility/Scythe/branch/master/graph/badge.svg)](https://codecov.io/gh/materials-data-facility/Scythe)
[![GitHub last commit](https://img.shields.io/github/last-commit/materials-data-facility/Scythe)](https://github.com/materials-data-facility/Scythe/commits/master)
[![PyPI version](https://badge.fury.io/py/scythe-extractors.svg)](https://badge.fury.io/py/scythe-extractors)
[![GitHub contributors](https://img.shields.io/github/contributors/materials-data-facility/Scythe)](https://github.com/materials-data-facility/Scythe/graphs/contributors)

Scythe is a library of tools that generate summaries of the data contained in scientific data files.
The goal of Scythe is to provide a shared resources of these tools ("extractors") to avoid duplication of effort between the many emerging materials databases.
Each extractor is designed to generate the sum of all data needed by each of these databases with a uniform API so that specific projects can write simple adaptors for their needs.

## Installation

Install using an up-to-date version of `pip` on version 3.8 or higher of Python:

```bash
pip install scythe-extractors
```

Each specific extractor module has its own set of required libraries.
Given that some modules have extensive dependencies, we do not install all of them automatically.
You can install them either module-by-module using the pip "extras" installation (e.g., 
`pip install scythe-extractors[image]"`),
or install all extractors with 
`pip install scythe-extractors[all]"`.

## Development/Contribution

If you wish to develop new features using Scythe, please consult the 
[Contributor Guide](https://materialsio.readthedocs.io/en/latest/contributor-guide.html) that will
walk you through installing [Poetry](https://python-poetry.org/) and the Scythe dependencies.

## Documentation

* Complete documentation for Scythe is on [Read the Docs](https://materialsio.readthedocs.io/en/latest/).
* [List of Available Extractors](https://materialsio.readthedocs.io/en/latest/extractors.html)

## Support 

This work was performed in partnership with [Citrine Informatics](https://citrine.io/). 
This was also performed under financial assistance award 70NANB14H012 from U.S. Department of Commerce, National Institute of Standards and Technology as part of the Center for Hierarchical Material Design (CHiMaD).
This work was also supported by the National Science Foundation as part of the Midwest Big Data Hub under NSF Award Number: 1636950 "BD Spokes: SPOKE: MIDWEST: Collaborative: Integrative Materials Design (IMaD): Leverage, Innovate, and Disseminate".

