img-processing-sid 0.0.1
Pacote Python para processamento de imagens: combinação, transformação, leitura, salvamento e visualização.
Requires Python: >=3.7

# imageprocessingpackage

## Image Process Package

Pacote Python para processamento de imagens, incluindo funÃ§Ãµes de combinaÃ§Ã£o, transformaÃ§Ã£o, leitura, salvamento e visualizaÃ§Ã£o de imagens.

## Funcionalidades

- ComparaÃ§Ã£o de similaridade entre imagens (SSIM)
- TransferÃªncia de histograma entre imagens
- Redimensionamento de imagens
- Leitura e salvamento de arquivos de imagem
- VisualizaÃ§Ã£o de imagens e histogramas RGB

## InstalaÃ§Ã£o

Recomenda-se utilizar um ambiente virtual. Instale as dependÃªncias com:

```bash
pip install -r requirements.txt
```

## Exemplo de Uso

```python
from img_processing.processing.combination import find_difference, transfer_histogram
from img_processing.processing.transformation import resize_image
from img_processing.utils.io import read_image, save_image
from img_processing.utils.plot import plot_image, plot_result, plot_histogram

# Leitura de imagens
img1 = read_image('caminho/para/imagem1.png')
img2 = read_image('caminho/para/imagem2.png')

# ComparaÃ§Ã£o de similaridade
diff = find_difference(img1, img2)
plot_image(diff)

# TransferÃªncia de histograma
matched = transfer_histogram(img1, img2)
plot_result(img1, img2, matched)

# Redimensionamento
img_resized = resize_image(img1, 0.5)
plot_image(img_resized)

# Salvar imagem Redimensionada
save_image(img_resized, 'caminho/para/imagem_redimensionada.png')
```

## Estrutura do Projeto

- `img_processing/processing/combination.py`: FunÃ§Ãµes de comparaÃ§Ã£o e transferÃªncia de histograma
- `img_processing/processing/transformation.py`: FunÃ§Ã£o de redimensionamento
- `img_processing/utils/io.py`: Leitura e salvamento de imagens
- `img_processing/utils/plot.py`: VisualizaÃ§Ã£o de imagens e histogramas

## Testes com Imagens de Natureza

1. Adicione duas imagens de natureza (paisagens, florestas, etc) no formato PNG na pasta `images/` deste projeto, com os nomes:
    - `images/natureza1.png`
    - `images/natureza2.png`

2. Execute o script de teste:

    ```bash
    python test_natureza.py
    ```

3. O script irÃ¡:
    - Comparar as imagens e salvar `natureza_diff.png` (diferenÃ§a/semelhanÃ§a)
    - Transferir histograma e salvar `natureza_matched.png`
    - Redimensionar e salvar `natureza_resized.png`

4. Visualize os resultados usando as funÃ§Ãµes de plot do pacote ou abrindo os arquivos gerados na pasta `images/`.

Se nÃ£o houver imagens, consulte o arquivo `images/README.txt` para instruÃ§Ãµes de como obtÃª-las.

### SugestÃ£o de sites para baixar imagens livres de direitos autorais

- [Unsplash](https://unsplash.com/s/photos/nature)
- [Pixabay](https://pixabay.com/pt/images/search/natureza/)
- [Pexels](https://www.pexels.com/pt-br/procurar/natureza/)

Baixe as imagens desejadas, salve como `natureza1.png` e `natureza2.png` na pasta `images/` e siga os passos acima para rodar os testes.

## Autor

Sidnei Silva ([GitHub](https://github.com/sidneifs))

## LicenÃ§a

[MIT](https://choosealicense.com/licenses/mit/)