Metadata-Version: 2.4
Name: vitallinkage
Version: 0.1.1
Summary: Linkage determinístico de alta performance para dados de saúde pública brasileiros
Project-URL: Repository, https://github.com/erikluancosta/vitallinkage_py
Author: Erik Luan Costa Santos, Arthur Lorenzi Almeida, Renato Azeredo Teixeira, Olivia Landi C. Guaranha
License: MIT
Keywords: datasus,linkage,record-linkage,saude-publica,sim,sinan
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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 :: Information Analysis
Requires-Python: >=3.9
Requires-Dist: polars>=1.0
Provides-Extra: dev
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# vitallinkage

Linkage determinístico de alta performance para dados de saúde pública brasileiros.

## Instalação

```bash
pip install vitallinkage
```

## Uso

```python
import polars as pl
from vitallinkage import iniciar_linkage, regras_linkage, meio_de_campo

df = pl.DataFrame({
    "nome":       ["Ana", "Ana", "Bruno"],
    "nascimento": ["2000-01-01", "2000-01-01", "1995-05-05"],
    "cns":        ["12345", None, "99999"],
})

# Passo 1: linkage inicial pela regra mais forte
df = iniciar_linkage(df, variaveis=["nome", "nascimento"])

# Passo 2: regras adicionais
df = regras_linkage(df, variaveis=["cns"], num_regra=2)
```

## Funções

| Função | Descrição |
|--------|-----------|
| `iniciar_linkage(df, variaveis)` | Primeira regra de linkage — gera `par_1` e `par_c1` |
| `regras_linkage(df, variaveis, num_regra)` | Regras adicionais — gera `par_cN` e atualiza `par_1` |
| `meio_de_campo(df, max_iter)` | Fechamento transitivo sobre `par_1`/`par_2` |

## Desenvolvimento

```bash
pip install -e ".[dev]"
pytest tests/ -v
```

## Build e publicação

```bash
pip install build twine
python -m build
twine upload dist/vitallinkage-0.1.0-py3-none-any.whl
```

## Autores

- Erik Luan Costa Santos
- Arthur Lorenzi Almeida
- Renato Azeredo Teixeira

## Licença

MIT
