sintetizador-novomodelo
Programa auxiliar para realizar a síntese de dados de saída do NOVOMODELO em arquivos de texto ou banco de dados.
As sínteses seguem o mesmo modelo unificado de dados do sintetizador-decomp: os arquivos e as colunas têm os mesmos nomes e tipos, de modo que as ferramentas que leem a síntese de um caso DECOMP leem também a de um caso NOVOMODELO.
Instalação
A instalação pode ser feita diretamente via uv:
$ uv pip install .
A síntese da política (cortes de Benders) depende das bindings novomodelo-python, que exigem Python >= 3.12. Elas são instaladas pelo extra politica:
$ uv pip install ".[politica]"
Sem o extra, os comandos politica e completa registram um aviso e não geram CORTES_COEFICIENTES, CORTES_VARIAVEIS nem METADADOS_POLITICA; as demais sínteses não são afetadas.
Para desenvolvimento local com todas as dependências:
$ git clone https://github.com/rjmalves/sintetizador-novomodelo
$ cd sintetizador-novomodelo
$ uv sync --all-extras --dev
Modelo Unificado de Dados
As saídas são geradas em formato Parquet e podem ser lidas com pandas ou Polars:
import pandas as pd
df = pd.read_parquet("sintese/CMO_SBM.parquet")
import polars as pl
df = pl.read_parquet("sintese/CMO_SBM.parquet")
Comandos
O sintetizador-novomodelo é uma aplicação CLI, executada no diretório do caso. Ele lê as saídas do NOVOMODELO em ./output/ e escreve a síntese em ./sintese/:
$ cd meu-caso
$ sintetizador-novomodelo completa
> 2026-11-06 19:00:02,830 INFO: # Realizando síntese COMPLETA #
> 2026-11-06 19:00:02,831 INFO: Caso: /home/usuario/meu-caso
> 2026-11-06 19:00:02,831 INFO: Saídas do modelo: /home/usuario/meu-caso/output
> 2026-11-06 19:00:02,831 INFO: Diretório de síntese: /home/usuario/meu-caso/sintese
...
> 2026-11-06 19:00:22,815 INFO: # Fim da síntese (19.98 s) #
| Comando | Descrição |
|---|---|
completa |
sistema → execução → cenários → operação → política |
sistema [VARIAVEIS...] |
dados do sistema |
execucao [VARIAVEIS...] |
dados da execução |
cenarios [VARIAVEIS...] |
dados dos cenários |
operacao [VARIAVEIS...] |
dados da operação |
politica [VARIAVEIS...] |
cortes de Benders da política |
limpeza |
apaga o diretório de síntese |
Sem VARIAVEIS, cada comando sintetiza tudo o que suporta. As variáveis aceitam curingas (sintetizador-novomodelo operacao "EARM*"). No completa, as variáveis de cada categoria são passadas pelas opções --sistema, --execucao, --cenarios, --operacao e --politica, que podem ser repetidas.
Opções:
--formato:PARQUET(padrão) ouCSV.--saida-modelo: diretório com as saídas do NOVOMODELO, relativo ao caso (padrãooutput).--codigos:sequencial(padrão, código =id + 1) ouoriginais(código =id). Todos os comandos, excetolimpeza. Ver Diferenças em relação ao sintetizador-decomp.--processadores: aceita por compatibilidade com o sintetizador-decomp (operacaoecompleta).
Variáveis de ambiente:
DIRETORIO_SINTESE: diretório de escrita (padrãosintese, relativo ao caso; aceita caminho absoluto). É criado se não existir.FORMATO_SINTESE: sobrescrito por--formato.CODIGOS_ENTIDADES:sequencial(padrão) ouoriginais; sobrescrito por--codigos. Um valor inválido encerra o comando com erro, sem sintetizar.
Arquivos produzidos
| Categoria | Arquivos |
|---|---|
| sistema | EST, PAT, SBM, UTE, CVU, UHE, METADADOS_SISTEMA |
| execução | PROGRAMA, VERSAO, TITULO, CONVERGENCIA, TEMPO, CUSTOS, INVIABILIDADES, METADADOS_EXECUCAO |
| cenários | PROBABILIDADES, METADADOS_CENARIOS |
| operação | sínteses abaixo, ESTATISTICAS_OPERACAO_{SIN,SBM,UHE,UTE,SBP}, METADADOS_OPERACAO |
| política | CORTES_COEFICIENTES, CORTES_VARIAVEIS, METADADOS_POLITICA |
Em CORTES_COEFICIENTES, o lag depende do tipo_coeficiente:
- tipo 4 (
GTER, geração térmica antecipada): o estado é a geração comprometida em MW, sem patamar (patamar= 0); olagé o deslocamento do estágio de entrega (interval_startdoentity_manifest) em relação ao estágio do corte, no eixo formado pelos estágios destages.jsonseguidos dos depost_study_stages.json. Sem esse calendário, ou com a data de entrega ausente, olagé o posto da data de entrega por térmica (1..k). - tipo 7 (
QINC) e tipo 8 (QDEF): olagé o subíndice do NOVOMODELO (tipo 8: 1..k). - demais tipos:
lag= 0.
Sínteses da operação:
CMO_SBM- custos:
CTER_UTE,CTER_SIN,COP_SIN,CFU_SIN - energia armazenada e percentual, inicial e final:
EARM{I,F}_{SBM,SIN},EARP{I,F}_{SBM,SIN} - geração:
GTER_{SBM,SIN,UTE},GHID_{UHE,SBM,SIN},GUNS_{SBM,SIN} - energia natural afluente:
ENAA_{SBM,SIN} - mercado e déficit:
MER_{SBM,SIN},MERL_{SBM,SIN},DEF_{SBM,SIN} - volumes:
VARP{I,F}_UHE,VARM{I,F}_{UHE,SBM,SIN} - vazões:
Q{INC,AFL,DEF,TUR,VER,RET,EVP,DES}_UHE - energia vertida:
EVER{,T,NT}_{UHE,SBM,SIN} - intercâmbio:
INT_SBP,INTL_SBP
INVIABILIDADES é omitido (com aviso) quando a simulação não tem violações. Um caso completo gera 82 arquivos: os 97 do sintetizador-decomp menos os 15 de REE e ENAC.
Diferenças em relação ao sintetizador-decomp
-
Códigos de entidade:
codigo_usina,codigo_submercado,codigo_submercado_de,codigo_submercado_para, ocodigodeINVIABILIDADESe oindice_entidadedeCORTES_COEFICIENTESdependem de--codigos(ouCODIGOS_ENTIDADES):sequencial(padrão): código =id + 1do NOVOMODELO. Os códigos originais do DECOMP não são recuperados.originais: código =iddo NOVOMODELO. Só faz sentido quando o caso convertido manteve os códigos do DECOMP como ids (ex.: FURNAS id 6, submercado FC id 11); então os Parquet podem ser cruzados por código com os do sintetizador-decomp. Em um caso com ids sequenciais a partir de 0, gera códigos começando em 0.
Posições (
estagio,cenario,patamar,no,indice_corte,lag,iteracao) não mudam. REE continua ausente em ambos os modos. -
Sem REE: o NOVOMODELO não tem reservatório equivalente. Não são gerados
REE,ESTATISTICAS_OPERACAO_REEnem os arquivos*_REE. A colunacodigo_reedas tabelas de usinas hidrelétricas é mantida, toda nula (Int64), ereeemUHEé uma string nula. -
Sem ENAC:
ENAC_SBMeENAC_SINnão têm equivalente no NOVOMODELO. -
Agregação por submercado: cada usina é atribuída ao barramento principal dos seus grupos geradores (
unit_groups). A exceção éGHID_SBM, que soma a geração por barramento (simulation/hydro_bus_generation). Como o DECOMP credita a energia armazenada a submercados a jusante via REE,EARM*_SBMpode diferir do DECOMP por submercado, embora os totais do SIN coincidam. -
INT_SBP.limite_inferioréfloat64(int64no DECOMP). -
Sínteses calculadas a partir dos dados de entrada (★):
| Arquivo | Dados de entrada usados | Cálculo |
|---|---|---|
VARM{I,F}_UHE, VARM*_SBM/SIN |
hydros.json reservoir.min/max_storage_hm3, barramento principal (unit_groups) |
volume útil = armazenamento − mínimo físico; soma por barramento |
VARP{I,F}_UHE |
reservoir.min/max_storage_hm3 |
100·útil/(max−min), exclui fio d'água |
EARM{I,F}_SBM/SIN |
reservoir.*, barramento principal |
MWh ÷ 730 → MWmes; limite superior = EARMmax |
EARP{I,F}_SBM/SIN |
reservoir.* + produtividade acumulada integrada (saída) |
100·ΣEARM/ΣEARMmax |
ENAA_SBM/SIN |
barramento principal | soma por barramento |
QAFL_UHE |
hydros.json downstream_id |
incremental + desviada + defluência média de montante |
QRET_UHE |
constraints/hydro_bounds.water_withdrawal_m3s |
alvo + violação pos − neg |
QVER_UHE (limites) |
constraints/hydro_bounds.min/max_spillage_m3s |
bloco > estágio > padrão |
EVERT/EVERNT/EVER_* |
limite superior de turbinamento (dict/bounds ou hydros.json) |
divisão turbinável/não turbinável × produtividade |
GTER_SBM/SIN |
thermals.json bus_id |
soma por barramento |
GUNS_SBM/SIN, MERL_SBM/SIN |
non_controllable_sources.json bus_id |
soma por barramento; carga − NCS |
INT_SBP |
lines.json (origem/destino, capacidade), constraints/line_bounds |
duas direções por linha; limites por direção |
CVU |
thermals.json cost_per_mwh, constraints/thermal_bounds.cost_per_mwh |
CVU por estágio com sobrescrita |
PAT, EST, patamar 0 de todas as sínteses por patamar |
stages.json |
média ponderada por horas |
PROBABILIDADES e pesos das estatísticas |
stages.json policy_graph |
probabilidade de transição por nó |
GTER_UTE, QTUR/QDEF_UHE, VARM (limites) |
hydros.json/thermals.json (fallback de dict/bounds) |
limites por estágio/bloco |
dict/bounds = output/training/dictionaries/bounds.parquet.
Documentação e CI
A documentação (Sphinx, com galeria de exemplos) é publicada no GitHub Pages: https://rjmalves.github.io/sintetizador-novomodelo/. Para o primeiro deploy, ative o Pages em Settings → Pages com a origem "GitHub Actions". Para gerar localmente: uv run sphinx-build -W -b html docs/source docs/build.
Os workflows em .github/workflows/ rodam lint, mypy, testes (Python 3.11 a 3.14) e a build da documentação. O envio de cobertura ao Codecov e a publicação no PyPI estão desativados (comentados nos workflows) até configurar o secret CODECOV_TOKEN e o environment pypi (trusted publishing). Os testes de integração são pulados no CI, pois dependem do caso real local.
Metadata
Release files for sintetizador-novomodelo 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sintetizador_novomodelo-0.1.0.tar.gz | 723.1 kB | With provenance | Details for sintetizador_novomodelo-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sintetizador_novomodelo-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for sintetizador_novomodelo-0.1.0-py3-none-any.whl |
Total release size: 785.3 kB
Release files / sintetizador_novomodelo-0.1.0.tar.gz
| Download URL | sintetizador_novomodelo-0.1.0.tar.gz |
|---|---|
| Size | 723.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ee1573fbd40da488678ee4c48f4c8c75cc3f625d566ce9222ade0fb764badf37
|
|
BLAKE2b-256 checksum How to use checksums |
601f7794019744a44f6a802558865d810e3f5f67bd6cbf0315f99fb488260953
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.
Transparency logRelease files / sintetizador_novomodelo-0.1.0-py3-none-any.whl
| Download URL | sintetizador_novomodelo-0.1.0-py3-none-any.whl |
|---|---|
| Size | 62.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
13d52124c5658e2a4d4c5712cfc56caedfc0ac2ac4e3e37a349cf470858ea2d4
|
|
BLAKE2b-256 checksum How to use checksums |
eef8a9e55f33132b35390683c514f136d8cb7c88d30d31589593266eb3251ac5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.
Transparency logSecurity for sintetizador-novomodelo 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for sintetizador_novomodelo-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.