Metadata-Version: 2.4
Name: solidstatetools
Version: 0.0.1
Summary: Basic tools for materials and solid state science
Author-email: Guillaume Nadal <guillaume.nadal13@gmail.com>
License: MIT
Keywords: materials,solid state,crystal
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.25
Requires-Dist: scipy>=1.11
Requires-Dist: matplotlib>=3.8
Requires-Dist: pandas>=2.1
Requires-Dist: sympy>=1.12


# **SolidStateTools**

**SolidStateTools** is an open-source Python toolkit for **solid-state physics** and **materials science**.
It provides streamlined tools for:

* **Crystal structure analysis**
* **Lattice and plane projections**
* **Electronic band-structure calculations**
* **Visualization utilities for solid-state materials**

Whether you work on semiconductors, crystalline materials, or computational materials research, **SolidStateTools** offers a unified and extensible environment.

---

##  Features

###  **Crystal Structure Analysis**

* Load, parse, and manipulate standard structure formats (CIF, POSCAR, JSON…)
* Compute symmetry, coordination, distances, angles
* Generate primitive and conventional cells
* Apply transformations (strain, rotation, supercells)

###  **Lattice & Plane Projections**

* Miller-indexed plane projection tools
* 2D and 3D lattice visualization
* Real-space and reciprocal-space coordinate transforms
* Projection along arbitrary crystallographic directions

###  **Band Diagram Calculations**

* Build k-paths from high-symmetry points
* Compute simplified electronic band structures
* Import band data from external DFT codes
* Automatic plotting and formatting

###  **Visualization Tools**

* 2D plotting of planes, band diagrams, and projections
* 3D interactive crystal structure viewers
* Publication-ready figures (Matplotlib-based)

---

##  Installation

```bash
pip install solidstatetools
```

Or from source:

```bash
git clone https://github.com/SemiconductorsLaboratory/solidstatetools.git
cd solidstatetools
pip install -e .
```

---

##  Quick Start

### Load a structure and inspect it

```python
import solidstatetools.crystal
```
---

##  Documentation

Full documentation is available at:

*Add link here once you publish docs*

It includes tutorials for:

* structure transformations
* band diagram generation
* crystallographic plane analysis
* visualization examples

---

##  Benchmarks & Validation

The methods and algorithms implemented in **SolidStateTools** follow standard treatments used in solid-state physics and materials science.
Comparison notebooks with VASP, Quantum ESPRESSO, and pymatgen outputs will be included.

---

##  Contributing

Contributions are welcome — bug fixes, new features, documentation improvements, and more.

To contribute:

```bash
git clone https://github.com/SemiconductorsLaboratory/solidstatetools.git
git checkout -b my-feature
# make changes
pytest
```

Please open a pull request once your feature is ready.

---

##  License

... License.

---

##  Acknowledgements

This project is inspired by common workflows in materials science and solid-state physics, aiming to provide a unified and intuitive toolkit.

---
