Metadata-Version: 2.4
Name: pixelmatrix-core
Version: 0.1.0
Summary: Lightweight pixel and matrix operations for image processing
Author-email: Oleg Simic <olegsimic07@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/olegsimic/pixelmatrix-core
Project-URL: Documentation, https://github.com/olegsimic/pixelmatrix-core#readme
Project-URL: Repository, https://github.com/olegsimic/pixelmatrix-core
Project-URL: Issues, https://github.com/olegsimic/pixelmatrix-core/issues
Keywords: pixel,matrix,image,numpy,processing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Requires-Dist: Pillow>=9.0.0
Requires-Dist: scipy>=1.7.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Provides-Extra: cloud
Requires-Dist: google-api-python-client>=2.0.0; extra == "cloud"
Requires-Dist: google-auth>=2.0.0; extra == "cloud"
Dynamic: license-file

# PixelMatrix Core

Lightweight pixel and matrix operations for image processing in Python.

## Installation

```bash
pip install pixelmatrix-core
```

## Features

- Load and manipulate images as NumPy matrices
- Common image transforms (rotate, flip, resize, crop)
- Image analysis (histogram, contrast, entropy)
- Cross-platform system utilities

## Quick Start

```python
from imageanalysis import ImageMatrix, rotate, histogram

# Load an image
img = ImageMatrix.from_file("photo.jpg")

# Apply transformations
rotated = rotate(img.data, 45)

# Analyze
hist = histogram(img.data)
print(f"Mean intensity: {img.mean()}")
```

## API Reference

### ImageMatrix

```python
img = ImageMatrix.from_file("image.png")
img = ImageMatrix.from_array(numpy_array)

# Properties
img.shape      # Image dimensions
img.channels   # Number of color channels

# Methods
img.to_grayscale()
img.normalize()
img.save("output.png")
```

### Transforms

```python
from imageanalysis import rotate, flip_horizontal, flip_vertical, resize, crop

rotated = rotate(matrix, angle=90)
flipped_h = flip_horizontal(matrix)
flipped_v = flip_vertical(matrix)
resized = resize(matrix, width=800, height=600)
cropped = crop(matrix, x=10, y=10, width=100, height=100)
```

### Analysis

```python
from imageanalysis import histogram, mean_intensity, contrast, entropy

hist = histogram(matrix)
mean = mean_intensity(matrix)
cont = contrast(matrix)
ent = entropy(matrix)
```

## License

MIT License
