Skip to main content

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 (ou fora dele, com --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) ou CSV.
  • --caso: diretório do caso, relativo ao diretório atual ou absoluto (padrão: o diretório atual). Permite rodar a síntese de fora do caso, por exemplo quando ele está numa subpasta: sintetizador-novomodelo completa --caso meu-caso. A síntese continua sendo escrita em ./sintese/, relativo ao diretório atual. Todos os comandos, exceto limpeza.
  • --saida-modelo: diretório com as saídas do NOVOMODELO, relativo ao caso (padrão output).
  • --codigos: sequencial (padrão, código = id + 1) ou originais (código = id). Todos os comandos, exceto limpeza. Ver Diferenças em relação ao sintetizador-decomp.
  • --processadores: aceita por compatibilidade com o sintetizador-decomp (operacao e completa).

Variáveis de ambiente:

  • DIRETORIO_SINTESE: diretório de escrita (padrão sintese, relativo ao diretório atual, que é o caso quando --caso não é usado; aceita caminho absoluto). É criado se não existir.
  • FORMATO_SINTESE: sobrescrito por --formato.
  • CODIGOS_ENTIDADES: sequencial (padrão) ou originais; 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); o lag é o deslocamento do estágio de entrega (interval_start do entity_manifest) em relação ao estágio do corte, no eixo formado pelos estágios de stages.json seguidos dos de post_study_stages.json. Sem esse calendário, ou com a data de entrega ausente, o lag é o posto da data de entrega por térmica (1..k).
  • tipo 7 (QINC) e tipo 8 (QDEF): o lag é 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, o codigo de INVIABILIDADES e o indice_entidade de CORTES_COEFICIENTES dependem de --codigos (ou CODIGOS_ENTIDADES):

    • sequencial (padrão): código = id + 1 do NOVOMODELO. Os códigos originais do DECOMP não são recuperados.
    • originais: código = id do 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_REE nem os arquivos *_REE. A coluna codigo_ree das tabelas de usinas hidrelétricas é mantida, toda nula (Int64), e ree em UHE é uma string nula.

  • Sem ENAC: ENAC_SBM e ENAC_SIN nã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*_SBM pode diferir do DECOMP por submercado, embora os totais do SIN coincidam.

  • INT_SBP.limite_inferior é float64 (int64 no 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.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sintetizador-novomodelo 0.2.0
File Size Uploaded Provenance Actions
sintetizador_novomodelo-0.2.0.tar.gz 724.0 kB With provenance Details for sintetizador_novomodelo-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sintetizador-novomodelo 0.2.0
File Interpreter ABI Platform Actions
sintetizador_novomodelo-0.2.0-py3-none-any.whl Python 3 none any Details for sintetizador_novomodelo-0.2.0-py3-none-any.whl

Total release size: 786.4 kB

Release files / sintetizador_novomodelo-0.2.0.tar.gz

Download URL sintetizador_novomodelo-0.2.0.tar.gz
Size 724.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5a6571457b0f9cf8f9c2ba89817766188a1e71e1298dc23667e777feac8a42fb
BLAKE2b-256 checksum
How to use checksums
f05d6dabbd77c5cf251f0a99f2532cab4977a27c26f24185fcc38f0fa8660b3f
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 17, 2026.

Transparency log

Release files / sintetizador_novomodelo-0.2.0-py3-none-any.whl

Download URL sintetizador_novomodelo-0.2.0-py3-none-any.whl
Size 62.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0856c54123e49ed6b1c2c149e6135581a9c0216b26117d8b242684f2a845640d
BLAKE2b-256 checksum
How to use checksums
774f6d0b76e4cff9123f4f356f0df4ab6f0ff2d965e68970e4f21ecc64e523ea
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 17, 2026.

Transparency log

Security for sintetizador-novomodelo 0.2.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.

Select from 2 files

Attestation for sintetizador_novomodelo-0.2.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 17, 2026.

Transparency log

A 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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page