Interface de Programação para o NEWAVE

Versão: 1.14.0

Data: 09/06/2026

Apresentação

• Módulo de interface para o programa NEWAVE

Geral

• Instalação
  • Instalando com pip
  • Instalando com uv
  • Instalando a versão de desenvolvimento
  • Verificando a instalação
• Tutorial
• Exemplos
• Como contribuir?
  • O framework cfinterface e a modelagem de arquivos
  • Diretrizes de modelagem para o módulo inewave
  • Configuracao do ambiente e procedimentos de qualidade

Guias

• Arquitetura do inewave
  • Visão Geral
  • Framework cfinterface
  • Estrutura de Módulos
  • Mecanismo de Lazy Import
  • Convenções de Nomenclatura
  • Fluxo de Dados
• Guia de Desempenho
  • Visão Geral de Desempenho
  • Tempos de Importação
  • Tempos de Leitura
  • Otimização para Processamento em Lote
  • Suite de Benchmarks
  • Limitações Conhecidas
• Perguntas Frequentes (FAQ)
  • Instalação
  • Uso Geral
  • Compatibilidade com Versões do NEWAVE
  • Resolução de Problemas
  • Desempenho

Referência

• NEWAVE
  • Arquivo do Caso (caso.dat)
  • Arquivos do Caso (arquivos.dat)
  • Dados Gerais (dger.dat)
  • Configurações do Mecanismo de Aversão (cvar.dat)
  • Despacho Antecipado de Térmicas (adterm.dat)
  • Agrupamentos de Intercâmbios (agrint.dat)
  • Cargas Adicionais (c_adic.dat)
  • Curva de Segurança dos Armazenamentos (curva.dat)
  • Restrições Elétricas (re.dat)
  • Reservatórios Equivalentes de Energia (ree.dat)
  • Subsistemas ou Submercados de Energia (sistema.dat)
  • Penalidades (penalid.dat)
  • Patamares de Carga (patamar.dat)
  • Acompanhamento do Programa (pmo.dat)
  • Cabeçalho das Séries Forward (forwarh.dat)
  • Dados das Séries Forward (forward.dat)
  • Cabeçalho dos Cortes (cortesh.dat)
  • Coeficientes dos Cortes (cortes.dat)
  • Tempos de Execução (newave.tim)
  • Configurações das Hidrelétricas (confhd.dat)
  • Configurações das Termelétricas (conft.dat)
  • Configurações das Classes Térmicas (clast.dat)
  • Expansões das Hidrelétricas (exph.dat)
  • Expansões das Termelétricas (expt.dat)
  • Modificações das Hidrelétricas (modif.dat)
  • Geração Hidráulica Mínima por Usina (ghmin.dat)
  • Manutenção das Termelétricas (manutt.dat)
  • Outros Usos da Água (dsvagua.dat)
  • Tendência Hidrológica (vazpast.dat)
  • Tendência Hidrológica por REE (eafpast.dat)
  • Cadastro das Hidrelétricas (hidr.dat)
  • Vazões Históricas por Posto (vazoes.dat)
  • Séries Históricas para a Simulação Final (shist.dat)
  • Parâmetros da Seleção de Cortes (selcor.dat)
  • Parâmetros da Eliminação de Cortes (eliminacao_cortes.dat)
  • Acompanhamento do modelo PAR(p) (parp.dat)
  • Acompanhamento do modelo PAR(p) - Usinas Eólicas (parpeol.dat)
  • Acompanhamento do modelo PAR(p) Individualizado (parpvaz.dat)
  • Séries Sintéticas de Energia das Simulações Forward (energiafXXX.dat)
  • Séries Sintéticas de Energia da Backward (energiabXXX.dat)
  • Séries Sintéticas de Energia das Simulação Final (energias.dat)
  • Séries Sintéticas Agregadas de Energia das Simulações Forward (enavazfXXX.dat)
  • Séries Sintéticas Agregadas de Energia da Backward (enavazbXXX.dat)
  • Séries Históricas de Energia (engnat.dat)
  • Séries Sintéticas de Vazão das Simulações Forward (vazaofXXX.dat)
  • Séries Sintéticas de Vazão da Backward (vazaobXXX.dat)
  • Séries Sintéticas de Vazão das Simulação Final (vazaosXXX.dat)
  • Séries Históricas de Vazão Incremental (vazinat.dat)
  • Volume de Referência Sazonal (volref_saz.dat)
  • Avaliação da Evaporação Linear (nwv_avl_evap.csv)
  • Cortes da Evaporação Linear (nwv_cortes_evap.csv)
  • Eco dos Dados da Evaporação Linear (nwv_eco_evap.csv)
  • Eco dos Dados da FPHA (eco_fpha.dat)
  • Avaliação dos Cortes da FPHA (avl_cortesfpha_nwv.dat)
  • Avaliação dos Desvios da FPHA no Plano S (avl_desvfpha_s.dat)
  • Avaliação dos Desvios da FPHA no Plano V-Q (avl_desvfpha_v_q.dat)
• NWLISTCF
  • Arquivos do Caso (arquivos.dat)
  • Arquivo do Caso (caso.dat)
  • Estados Visitados pelo NEWAVE (estados.rel)
  • Dados Gerais (nwlistcf.dat)
  • Cortes da Função de Custo Futuro (nwlistcf.rel)
• NWLISTOP
  • Dados Gerais do NWLISTOP (nwlistop.dat)
  • Custos de Violação de Restrições RHQ para o SIN (cviol_rhq_sin.out)
  • Custos de Violação de Restrições RHQ (cviol_rhq.out)
  • Custos de Violação de Restrições RHV para o SIN (cviol_rhv_sin.out)
  • Custos de Violação de Restrições RHV (cviol_rhv.out)
  • Consumo de Energia no Bombeamento (cbomb.out)
  • Consumo de Energia no Bombeamento para o SIN (cbombsin.out)
  • Custos de Déficit (cdefx.out)
  • Custos de Déficit para o SIN (cdefsin.out)
  • Custos de Violação de Restrições Elétricas (cviol_eletrica.out)
  • Custos de Violação de Restrições Elétricas para o SIN (cviol_eletricasin.out)
  • Custos Marginais (cmargx.out)
  • Custos Marginais Médios (cmargx-med.out)
  • Custos Totais de Operação (coper.out)
  • Custos Futuros (custo_futuro.out)
  • Corte de Geração Eólica (corteolm001.out)
  • Custos de Geração Térmica (ctermx.out)
  • Custos de Geração Térmica para o SIN (ctermsin.out)
  • Déficit (defx.out)
  • Déficit para o SIN (defsin.out)
  • Violação de Restrições Elétricas (viol_eletrica.out)
  • Violação de Restrições Elétricas para o SIN (viol_eletricasin.out)
  • Violação das Restrições de Vazão Mínima por UHE (viol_vazmin.out)
  • Retirada de água por UHE (vretiradauh.out)
  • Violação da FPHA por UHE (viol_fpha.out)
  • Violação das LPP de Turbinamento Máximo por REE (viol_lpp_tbmax00x.out)
  • Violação das LPP de Turbinamento Máximo por Submercado (viol_lpp_tbmaxm00x.out)
  • Violação das LPP de Turbinamento Máximo para o SIN (viol_lpp_tbmaxsin.out)
  • Violação das LPP de Defluência Máxima por REE (viol_lpp_dfmax00x.out)
  • Violação das LPP de Defluência Máxima por Submercado (viol_lpp_dfmaxm00x.out)
  • Violação das LPP de Defluência Máxima para o SIN (viol_lpp_dfmaxsin.out)
  • Violação das Restrições de Turbinamento Máximo por UHE (viol_turbmax00x.out)
  • Violação das Restrições de Turbinamento Mínimo por UHE (viol_turbmin00x.out)
  • Violação das Restrições de Vazão Máxima por UHE (viol_vazmax00x.out)
  • Desvio Positivo da Evaporação por Usina (viol_pos_evapx.out)
  • Desvio Negativo da Evaporação por Usina (viol_neg_evapx.out)
  • Desvio Positivo da Retirada de Água por Usina (viol_pos_vretiruh.out)
  • Desvio Negativo da Retirada de Água por Usina (viol_neg_vretiruh.out)
  • Energia Afluente por REE (eafx.out)
  • Energia Afluente por Submercado (eafmx.out)
  • Energia Afluente Bruta por REE (eafbx.out)
  • Energia Afluente Bruta por Submercado (eafbmx.out)
  • Energia Afluente Bruta para o SIN (eafbsin.out)
  • Energia Armazenada Final por REE (earmfx.out)
  • Energia Armazenada Final por Submercado (earmfmx.out)
  • Energia Armazenada Final para o SIN (earmfsin.out)
  • Energia Armazenada Final Percentual por REE (earmfpx.out)
  • Energia Armazenada Final Percentual por Submercado (earmfpmx.out)
  • Energia Armazenada Final Percentual para o SIN (earmfpsin.out)
  • Energia de Desvio Controlável por REE (edesvc.out)
  • Energia de Desvio Controlável por Submercado (edesvcm.out)
  • Energia de Desvio Controlável para o SIN (edesvcsin.out)
  • Energia Evaporada por REE (evapo.out)
  • Energia Evaporada por Submercado (evapom.out)
  • Energia Evaporada para o SIN (evaporsin.out)
  • Vertimento de Reservatórios por REE (evertx.out)
  • Vertimento de Reservatórios por Submercado (evertmx.out)
  • Vertimento de Reservatórios para o SIN (evertsin.out)
  • Excesso de Energia (excesx.out)
  • Excesso de Energia para o SIN (excessin.out)
  • Valores de Restrições RHV (form_rhq.out)
  • Valores de Restrições RHV (form_rhv.out)
  • Folga da Restrição de Geração Eólica por Submercado (fteolmx.out)
  • Folga da Restrição de Geração Eólica para o SIN (fteolsin.out)
  • Geração Eólica Total por Usina (geolx.out)
  • Geração Eólica Total por Submercado (geolmx.out)
  • Geração Eólica Total para o SIN (geolsin.out)
  • Geração Hidráulica Controlável por REE (ghidrx.out)
  • Geração Hidráulica Controlável por Submercado (ghidrmx.out)
  • Geração Hidráulica Controlável para o SIN (ghidrsin.out)
  • Geração Hidráulica por Usina (ghiduhx.out)
  • Geração Hidráulica Máxima por Usina com FPHA (ghmax_fpha.out)
  • Geração Hidráulica Máxima por Usina com FPH Constante (ghmax_fphc.out)
  • Geração Hidráulica Exata por Usina (gh_fphexat.out)
  • Geração Hidráulica Máxima por REE (ghmax.out)
  • Geração Hidráulica Máxima com Restrições Elétricas por REE (ghmaxr.out)
  • Geração Hidráulica Máxima por Submercado (ghmaxmx.out)
  • Geração Hidráulica Máxima com Restrições Elétricas por Submercado (ghmaxmr.out)
  • Geração Hidráulica Máxima para o SIN (ghmaxsin.out)
  • Geração Hidráulica Máxima com Restrições Elétricas para o SIN (ghmaxrsin.out)
  • Geração Hidráulica Total por REE (ghtotx.out)
  • Geração Hidráulica Total por Submercado (ghtotmx.out)
  • Geração Hidráulica Total para o SIN (ghtotsin.out)
  • Geração Térmica por Classe Térmica (gtert00x.out)
  • Geração Térmica Total por Submercado (gttotx.out)
  • Geração Térmica Total para o SIN (gttotsin.out)
  • Cota de jusante por UHE (hmont.out)
  • Cota de jusante por UHE (hliq.out)
  • Cota de montante por UHE (hmont.out)
  • Intercâmbio entre Submercados (int00x00y.out)
  • Violação da Restrição CAR por REE (invade00x.out)
  • Violação da Restrição CAR por Submercado (invadem00x.out)
  • Médias SIN (MEDIAS-SIN.CSV)
  • Médias por Submercado (MEDIAS-MERC.CSV)
  • Médias por REE (MEDIAS-REE.CSV)
  • Médias por Usina Hidrelétrica (MEDIAS-USIH.CSV)
  • Médias por Usina Termelétrica (MEDIAS-USIT.CSV)
  • Médias por Estação Elevatória (MEDIAS-USIE.CSV)
  • Médias por Restrição Elétrica Especial (MEDIAS-REP.CSV)
  • Médias por Restrição Hidráulica de Vazão (MEDIAS-RHQ.CSV)
  • Médias por Restrição Hidráulica de Volume (MEDIAS-RHV.CSV)
  • Mercado Líquido por Submercado (mercl.out)
  • Mercado Líquido para o SIN (merclsin.out)
  • Meta de Energia de Vazão Mínima por REE (mevmin00x.out)
  • Meta de Energia de Vazão Mínima por Submercado (mevminm00x.out)
  • Meta de Energia de Vazão Mínima para o SIN (mevminsin.out)
  • Vertimento Fio d’Água por REE (perdfx.out)
  • Vertimento Fio d’Água por Submercado (perdfmx.out)
  • Vertimento Fio d’Água para o SIN (perdfsin.out)
  • Valor da Água por Usina (pivarmx.out)
  • Valor da Água Incremental por Usina (pivarmincr.out)
  • Vazão Afluente por Usina (qafluhx.out)
  • Vazão Incremental por Usina (qincruh.out)
  • RHS das LPP de Defluência Máxima por REE (rhslppdf00x.out)
  • RHS das LPP de Turbinamento Máximo por REE (rhslpptb00x.out)
  • Valor da Água por REE (valor_aguax.out)
  • Volume Armazenado por Usina (varmuhx.out)
  • Volume Armazenado Percentual por Usina (varmpuhx.out)
  • Vazão Bombeada por Estação (qbomb.out)
  • Desvio de água por UHE (qdesviouh.out)
  • Velocidade do Vento por Usina (ventox.out)
  • Vazão Vertida por Usina (qvertuhx.out)
  • Vertimento Turbinável Fio d’Água por REE (verturbx.out)
  • Vertimento Turbinável Fio d’Água por Submercado (verturbmx.out)
  • Vertimento Turbinável Fio d’Água para o SIN (verturbsin.out)
  • Violação da Meta de Energia de Vazão Mínima por REE (viol_evmin00x.out)
  • Violação da Meta de Energia de Vazão Mínima por Submercado (viol_evminm00x.out)
  • Violação da Meta de Energia de Vazão Mínima para o SIN (viol_evminsin.out)
  • Violação da Meta de Geração Hidráulica Mínima por REE (viol_ghminx.out)
  • Violação da Meta de Geração Hidráulica Mínima por Submercado (viol_ghminmx.out)
  • Violação da Meta de Geração Hidráulica Mínima para o SIN (viol_ghminsin.out)
  • Violação da Meta de Geração Hidráulica Mínima por Usina (viol_ghminuh.out)
  • Violação de Restrições RHQ (viol_rhq.out)
  • Violação de Restrições RHV (viol_rhv.out)
  • Energia de Enchimento de Volume Morto por REE (vmort00x.out)
  • Energia de Enchimento de Volume Morto por Submercado (vmortm00x.out)
  • Energia de Enchimento de Volume Morto para o SIN (vmortsin.out)
  • Vazão Turbinada por Usina (qturuhx.out)
  • Volume Evaporado por Usina (vevapuhx.out)
• LIBS
  • Dados de Usinas Eólicas
  • Dados de Restrições
  • Dados das Usinas Hidrelétricas

Índice