Metadata-Version: 2.4
Name: matminer
Version: 0.10.1
Summary: matminer is a library that contains tools for data mining in Materials Science
Author-email: Anubhav Jain <anubhavster@gmail.com>
Project-URL: Homepage, https://github.com/hackingmaterials/matminer
Project-URL: Documentation, https://hackingmaterials.lbl.gov/matminer/
Keywords: data mining,materials science,scientific tools
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Topic :: Other/Nonlisted Topic
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.23
Requires-Dist: requests~=2.31
Requires-Dist: pandas<3,>=1.5
Requires-Dist: tqdm~=4.66
Requires-Dist: pymongo~=4.5
Requires-Dist: scikit-learn~=1.3
Requires-Dist: sympy~=1.11
Requires-Dist: monty>=2023
Requires-Dist: pymatgen>=2023
Requires-Dist: scipy>=1.17.0
Provides-Extra: mpds
Requires-Dist: ujson; extra == "mpds"
Requires-Dist: jmespath; extra == "mpds"
Requires-Dist: httplib2; extra == "mpds"
Requires-Dist: ase; extra == "mpds"
Requires-Dist: jsonschema; extra == "mpds"
Provides-Extra: dscribe
Requires-Dist: dscribe~=2.1; extra == "dscribe"
Provides-Extra: mdfforge
Requires-Dist: mdf-forge; extra == "mdfforge"
Provides-Extra: aflow
Requires-Dist: aflow; extra == "aflow"
Provides-Extra: citrine
Requires-Dist: citrination-client; extra == "citrine"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-timeout; extra == "dev"
Requires-Dist: pytest-xdist; extra == "dev"
Requires-Dist: coverage; extra == "dev"
Requires-Dist: coveralls; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: pylint; extra == "dev"
Requires-Dist: sphinx; extra == "dev"
Provides-Extra: tests
Requires-Dist: matminer[aflow,citrine,describe,dev,mdfforge,mpds]; extra == "tests"
Dynamic: license-file

# <img alt="matminer" src="docs_rst/_static/matminer_logo_small.png" width="300">

[![testing](https://github.com/hackingmaterials/matminer/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/hackingmaterials/matminer/actions?query=workflow%3Atesting+branch%3Amain)
![python](https://img.shields.io/badge/Python-3.11+-blue.svg?logo=python&amp;logoColor=white)

matminer is a library for performing data mining in the field of materials science.

- **[Website (including documentation)](https://hackingmaterials.github.io/matminer/)**
- **[Examples Repository](https://github.com/hackingmaterials/matminer_examples)**
- **[Help/Support Forum](https://matsci.org/c/matminer/16)**
- **[Source Repository](https://github.com/hackingmaterials/matminer)**

matminer supports Python 3.11+.

#### Related packages:

- If you like matminer, you might also try [automatminer](https://github.com/hackingmaterials/automatminer).
- If you are interested in furthering development of datasets in matminer, you may be interested in [matbench](https://github.com/hackingmaterials/matbench).
- If you are looking for figrecipes, it is now in its [own repo](https://github.com/hackingmaterials/figrecipes).


#### Citation

If you find matminer useful, please encourage its development by citing the following paper in your research:
```
Ward, L., Dunn, A., Faghaninia, A., Zimmermann, N. E. R., Bajaj, S., Wang, Q.,
Montoya, J. H., Chen, J., Bystrom, K., Dylla, M., Chard, K., Asta, M., Persson,
K., Snyder, G. J., Foster, I., Jain, A., Matminer: An open source toolkit for
materials data mining. Comput. Mater. Sci. 152, 60-69 (2018).
```

Matminer helps users apply methods and data sets developed by the community. Please also cite the original sources, as this will add clarity to your article and credit the original authors:

- If you use one or more **datasets** accessed through matminer, check the dataset metadata info for relevant citations on the original datasets.
- If you use one or more **data retrieval methods**, check ``citations()`` method of the data retrieval class. This method will provide a list of BibTeX-formatted citations for that featurizer, making it easy to keep track of and cite the original publications.
- If you use one or more **featurizers**, please take advantage of the ```citations()``` function present for every featurizer in matminer.
