Metadata-Version: 2.4
Name: edsmapplotter
Version: 0.2.1
Summary: A Python tool for automating EDS/EDX heatmap generation from microscopy data
Author-email: Fabio Dossi <fabio.dossi@example.com>
License: MIT
Project-URL: Homepage, https://github.com/fdossi/EDSMapPlotter
Project-URL: Repository, https://github.com/fdossi/EDSMapPlotter
Project-URL: Documentation, https://github.com/fdossi/EDSMapPlotter/blob/main/README.md
Project-URL: Bug Tracker, https://github.com/fdossi/EDSMapPlotter/issues
Keywords: EDS,EDX,microscopy,SEM,heatmap,materials-science
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: License :: OSI Approved :: MIT License
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: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas>=1.3.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: matplotlib>=3.3.0
Requires-Dist: Pillow>=8.0.0
Provides-Extra: gui
Requires-Dist: tkinterdnd2>=0.3.0; extra == "gui"
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# EDSMapPlotter

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/fdossi/EDSMapPlotter/blob/main/EDSMapPlotter_Colab.ipynb)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17741072.svg)](https://doi.org/10.5281/zenodo.17741072)
![License](https://img.shields.io/github/license/fdossi/EDSMapPlotter)
![Release](https://img.shields.io/github/v/release/fdossi/EDSMapPlotter)

**EDSMapPlotter** é uma ferramenta open-source para automatizar a geração de mapas a partir de dados brutos (CSV) de Espectroscopia de Energia Dispersiva (EDS/EDX).

O software converte matrizes numéricas (arquivos `.csv` exportados de microscópios SEM) em imagens de alta resolução (300 DPI) prontas para publicação científica.

---

## 🚀 Como Usar

### Opção A: Executar na Nuvem (Google Colab)
Não requer instalação. Ideal para uso rápido ou em computadores sem Python configurado.
1. Clique no selo **"Open in Colab"** acima.
2. Faça upload dos seus CSVs.
3. Baixe os mapas gerados automaticamente.

### Opção B: Instalação via PyPI (Recomendado)
Instale diretamente do Python Package Index:
```bash
pip install edsmapplotter
```

Execute o programa:
```bash
edsmapplotter
```

### Opção C: Instalação Local (Desenvolvedor)
Para usar a interface gráfica (GUI) com suporte a arrastar-e-soltar no Windows/Linux/Mac:

1. Instale as dependências:
   ```bash
   pip install -r requirements.txt
   ```

2. Execute o script:
   ```bash
   python EDSMapPlotter.py
   ```

## Funcionalidades

**Processamento em Lote**: Arraste dezenas de arquivos CSV e converta todos de uma vez.

**Detecção Automática de Elementos**: O script lê o nome do arquivo (ex: Area1_Fe.csv) e nomeia o gráfico corretamente ("Fe").

**Visualização**: Suporte a múltiplos mapas de cores (Viridis, Inferno, Blues, Reds, etc.).

**Alta Qualidade**: Exportação fixa em 300 DPI.

## Formato de Entrada
O software espera arquivos .csv contendo apenas a matriz de intensidades (sem cabeçalhos/headers de texto), que é o padrão de exportação de muitos softwares de microanálise.

## Citação

Se utilizar esta ferramenta em sua pesquisa, por favor cite:

Dossi, F. (2025). *EDSMapPlotter: A Python tool for EDS map visualization* (Version v0.2.1) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.17741072
