Metadata-Version: 2.4
Name: semcod
Version: 0.1.14
Summary: A Python package for musical string manipulation and analysis
Author-email: Tom Sapletta <tom@sapletta.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/semcod/regen
Project-URL: Documentation, https://github.com/semcod/regen#readme
Project-URL: Repository, https://github.com/semcod/regen.git
Project-URL: Bug Tracker, https://github.com/semcod/regen/issues
Keywords: music,audio,harp,sound,synthesis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.19.0
Requires-Dist: soundfile>=0.10.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: flake8>=3.8; extra == "dev"
Requires-Dist: mypy>=0.800; extra == "dev"
Requires-Dist: goal>=2.1.0; extra == "dev"
Requires-Dist: costs>=0.1.20; extra == "dev"
Requires-Dist: pfix>=0.1.60; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=4.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=0.5; extra == "docs"
Dynamic: license-file

# Harp


## AI Cost Tracking

![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.13-brightgreen) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fdeep%2Fdeep-v4-pro-lightgrey)

This project uses AI-generated code. Total cost: **$0.1307** with **10** AI commits.

Generated on 2026-06-29 using [openrouter/deep/deep-v4-pro](https://openrouter.ai/models/openrouter/deep/deep-v4-pro)

---

A Python package for musical string manipulation and analysis, particularly focused on harp-like string instruments and their properties.

## Features

- Musical note and frequency conversion utilities
- String vibration modeling
- Harp instrument simulation
- Audio analysis tools for string instruments

## Installation

```bash
pip install harp
```

## Quick Start

```python
from harp import Harp, note_to_frequency, frequency_to_note

# Convert between notes and frequencies
freq = note_to_frequency('A4')
note = frequency_to_note(440.0)

# Create a harp with standard tuning
harp = Harp(num_strings=47)
harp.tune_to_standard()

# Play a note
harp.pluck_string(0, velocity=0.8)
```

## Development

Install in development mode:

```bash
git clone https://github.com/yourusername/harp.git
cd harp
pip install -e .[dev]
```

This package uses modern Python packaging with `pyproject.toml`. No `setup.py` file is required.

Run tests:

```bash
pytest
```

## License

Licensed under Apache-2.0.
