Metadata-Version: 2.4
Name: reva-coregistration
Version: 1.0.1
Summary: A Python package for image coregistration and coordinate transformation
Author-email: "Robert Toth, PhD" <robert.toth@thetatech.ai>
Maintainer-email: "Robert Toth, PhD" <robert.toth@thetatech.ai>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Theta-Tech-AI/reva-coregistration
Project-URL: Repository, https://github.com/Theta-Tech-AI/reva-coregistration
Project-URL: Documentation, https://github.com/Theta-Tech-AI/reva-coregistration#readme
Project-URL: Bug Tracker, https://github.com/Theta-Tech-AI/reva-coregistration/issues
Keywords: coregistration,image-processing,coordinate-transformation,medical-imaging
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
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: Topic :: Scientific/Engineering :: Image Processing
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.21.0
Requires-Dist: opencv-python>=4.5.0
Requires-Dist: opencv-contrib-python-headless>=4.5.0
Requires-Dist: Pillow>=8.0.0
Requires-Dist: pyvips>=2.1.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: scikit-learn>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0.0; extra == "dev"
Requires-Dist: pytest-cov>=2.0.0; extra == "dev"
Requires-Dist: black>=21.0.0; extra == "dev"
Requires-Dist: flake8>=3.8.0; extra == "dev"
Requires-Dist: mypy>=0.800; extra == "dev"
Dynamic: license-file

# Reva Coregistration

A Python package for image coregistration and coordinate transformation, specifically designed for medical imaging applications.

## Features

- **Image Coregistration**: Align images using landmark-based transformations
- **Coordinate Transformation**: Convert coordinates between different image spaces
- **Non-linear Warping**: Apply advanced warping techniques for precise alignment
- **Slice Management**: Handle multi-slice image data
- **Tile Processing**: Efficient processing of large images using tiling

## Installation

```bash
pip install reva-coregistration
```

## Quick Start

```python
from reva_coregistration import get_associated_coordinates

# Define landmarks for coregistration
landmarks = [
    {"target": {"x": 100, "y": 200}, "source": {"x": 150, "y": 250}},
    {"target": {"x": 300, "y": 400}, "source": {"x": 350, "y": 450}},
    # ... more landmark pairs
]

# Get associated coordinates
coordinates = get_associated_coordinates(
    x_percentage=0.5,
    y_percentage=0.3,
    source_image_width=1024,
    source_image_height=768,
    source_is_photograph=True,
    target_image_width=2048,
    target_image_height=1536,
    apply_nonlinear_warping=True,
    landmarks=landmarks
)

print(coordinates)
```

## Documentation

For detailed documentation, please visit the [project repository](https://github.com/yourusername/reva-coregistration).

## Development

To set up the development environment:

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

Run tests:
```bash
pytest
```

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request. 
