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. 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.
  • --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 caso; 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.1.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.1.0
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)

Table of built distributions (wheels) for sintetizador-novomodelo 0.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

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

Select from 2 files

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