Metadata-Version: 2.4
Name: piezod
Version: 0.8.1
Summary: Modeling and optimization of piezoresistive and piezoelectric sensors and actuators
Project-URL: Homepage, http://microsystems.stanford.edu/piezod
Project-URL: Repository, https://github.com/MicrosystemsLab/PiezoD
Author: Joseph C. Doll
License-Expression: GPL-3.0-or-later
Keywords: MEMS,cantilever,optimization,piezoelectric,piezoresistive,sensor
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.12
Requires-Dist: addcopyfighandler>=2.0.0
Requires-Dist: matplotlib>=3.4.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: scipy>=1.7.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: ty>=0.0.14; extra == 'dev'
Description-Content-Type: text/markdown

# piezod

Modeling and optimization of piezoresistive and piezoelectric sensors and actuators.

## Installation

```bash
pip install piezod
```

For development:

```bash
git clone https://github.com/MicrosystemsLab/PiezoD.git
cd PiezoD/python
uv sync
```

## Usage

```python
from piezod import CantileverEpitaxy

# Create cantilever and set geometry
c = CantileverEpitaxy()
c.l = 300e-6  # length: 300 um
c.w = 44e-6   # width: 44 um
c.t = 89e-9   # thickness: 89 nm
c.fluid = "water"

# Calculate properties
print(f"Stiffness: {c.stiffness() * 1e3:.3f} mN/m")
print(f"Resonant frequency: {c.omega_vacuum_hz() / 1e3:.1f} kHz")
freq_hz, Q = c.omega_damped_hz_and_Q()
print(f"Damped frequency: {freq_hz / 1e3:.1f} kHz, Q = {Q:.1f}")
```

Run the example:

```bash
uv run python examples/quickstart.py
```

## Development

Install dependencies:

```bash
uv sync
```

Run tests:

```bash
uv run pytest
```

Lint and format:

```bash
uvx ruff check src tests --fix && uvx ruff format src tests
```

Type check:

```bash
uvx ty check src
```

## Documentation

See the main project documentation at [microsystems.stanford.edu/piezod](http://microsystems.stanford.edu/piezod).

## Citation

If you use piezod in your research, please cite:

> Joseph C. Doll, Sung-Jin Park and Beth L. Pruitt
> Design optimization of piezoresistive cantilevers for force sensing in air and water
> Journal of Applied Physics 106.6 (2009): 064310-064310.

## License

GPL-3.0-or-later
