Formulações específicas por equipamento
Objetivo
Seção intitulada “Objetivo”Este capítulo detalha as restrições do PL para cada tipo de equipamento no Novo Modelo. Enquanto a Visão geral da modelagem dos elementos do sistema descreve o que é cada elemento e suas variáveis de decisão, este capítulo contém as restrições matemáticas detalhadas que regem o comportamento de cada tipo de equipamento dentro do PL. A ordem de leitura é: Visão geral da modelagem dos elementos do sistema → este capítulo → Formulação do PL.
Para as definições de variáveis e conjuntos de índices, consulte Convenções de notação. Para as restrições de produção hidrelétrica especificamente, consulte Modelos de função de produção hidrelétrica.
Para a visão por entidade deste capítulo, veja Usinas termelétricas, Fontes não despacháveis, Usinas elevatórias, Linhas e intercâmbios e Contratos de energia.
1. Usinas termelétricas
Seção intitulada “1. Usinas termelétricas”1.1 Termelétricas convencionais
Seção intitulada “1.1 Termelétricas convencionais”Cada usina termelétrica tem um custo marginal por MWh gerado, , e uma coluna de geração por patamar, .
Variáveis de decisão:
- = geração da termelétrica no patamar (MW)
Restrições:
Limites de geração:
Ambos os limites são restrições rígidas, sem variáveis de folga — o despacho térmico é diretamente controlável (ao contrário do hidrelétrico, que depende de afluências exógenas). Os limites e podem variar por estágio e por patamar.
Contribuição para a função objetivo:
2. Linhas de transmissão
Seção intitulada “2. Linhas de transmissão”Variáveis de decisão:
- = fluxo direto (origem → destino)
- = fluxo reverso (destino → origem)
Limites:
Contribuição para o balanço de carga:
No barramento de origem:
No barramento de destino:
O PL de despacho não tem perdas: os dois sentidos de fluxo entram nos balanços dos barramentos com coeficiente ±1. As perdas de transmissão são uma grandeza informada, calculada após a resolução, , em que é a eficiência informada da linha (Convenções de notação). Consulte a Visão geral da modelagem dos elementos do sistema para o modelo de rede.
Contribuição para a função objetivo:
3. Contratos de importação/exportação
Seção intitulada “3. Contratos de importação/exportação”Cada contrato é unidirecional — ou é um contrato de importação, ou de exportação.
Variáveis de decisão:
- = potência despachada do contrato no patamar
Limites:
Contribuição para o balanço de carga:
No barramento conectado:
- Contratos de importação (): (potência que entra no sistema)
- Contratos de exportação (): (potência que sai do sistema)
Contribuição para a função objetivo:
Como os preços de importação () são positivos e os de exportação são negativos, esse único somatório soma naturalmente os custos de importação e subtrai a receita de exportação. O sinal do preço é independente do sinal no balanço de carga: uma coluna de importação injeta e tem preço positivo (custo); uma coluna de exportação retira e tem preço negativo (receita).
Piso take-or-pay e ciclo de vida. Um limite inferior não nulo é uma obrigação rígida do tipo take-or-pay: o PL deve despachar pelo menos ao preço do contrato, mesmo quando houver oferta mais barata. Os limites e o preço podem variar, cada um, por estágio e, opcionalmente, por patamar. Fora de sua janela de operação (Visão geral da modelagem dos elementos do sistema §1), a coluna do contrato é fixada em zero. Um contrato não tem estado: não possui variável de estado e não contribui para os cortes de Benders.
4. Usinas elevatórias
Seção intitulada “4. Usinas elevatórias”As usinas elevatórias transferem água de um reservatório de origem para um reservatório de destino, consumindo potência elétrica no processo. O sentido origem-destino é uma escolha de modelagem (tipicamente para cima / contra a cascata); a formulação não exige nenhuma relação particular de cotas.
Variáveis de decisão:
- = vazão bombeada na usina elevatória no patamar (m³/s)
Limites:
Ambos os limites são restrições rígidas e podem variar por estágio e, opcionalmente, por patamar. Fora de sua janela de operação (Visão geral da modelagem dos elementos do sistema §1), a coluna de vazão da usina elevatória é fixada em zero, de modo que ela não transfere água nem consome potência.
Consumo de potência:
em que é a taxa de consumo de potência (MW por m³/s).
Impacto no balanço hídrico:
A vazão bombeada sai do reservatório da usina de origem e entra no da usina de destino, convertida em volume pelo fator de conversão do patamar , sendo a duração do patamar em horas:
- Em um estágio cronológico, patamar : no balanço hídrico do patamar da usina de origem e no da usina de destino.
- Em um estágio paralelo, cada usina tem uma única linha por estágio: na da origem e na do destino.
Esses são os sinais da variação de armazenamento; na linha com todos os termos de Formulação do PL §4, os mesmos termos aparecem no lado esquerdo com os sinais opostos.
Impacto no balanço de carga:
No barramento conectado: (potência consumida)
Contribuição para a função objetivo: nenhuma
5. Usinas hidrelétricas
Seção intitulada “5. Usinas hidrelétricas”As restrições hidrelétricas são as mais complexas do sistema. Em vez de duplicá-las aqui, a formulação hidrelétrica está dividida em dois capítulos:
- Balanço hídrico, defluência, limites de armazenamento e restrições flexíveis: consulte Formulação do PL §4 (balanço hídrico), §6 (restrições de geração), §7 (restrições de defluência), §8 (limites das variáveis), §9 (penalidades por violação de restrições).
- Modelos de função de produção (produtibilidade constante, FPHA): consulte Modelos de função de produção hidrelétrica.
Uma usina declara um ou mais grupos de unidades geradoras, cada um em seu próprio barramento; grupos que compartilham um barramento formam uma célula (usina, barramento), e a vazão turbinada e a geração são acompanhadas por célula, e não por usina — armazenamento, vertimento e desvio permanecem por usina. Os limites de vazão turbinada e de geração (§8 e §6 da Formulação do PL) são compostos por célula a partir dos grupos de unidades que a integram; uma usina com um único barramento tem exatamente uma célula, e toda fórmula se reduz à forma em nível de usina.
Para as variáveis de decisão hidrelétricas e seu significado físico, consulte a Visão geral da modelagem dos elementos do sistema §5.
6. Fontes de geração não despacháveis
Seção intitulada “6. Fontes de geração não despacháveis”As fontes não despacháveis (parques eólicos, usinas solares, pequenas centrais hidrelétricas a fio d’água) têm uma geração disponível que o solver toma como dada: sorteada por cenário a partir do modelo de disponibilidade da fonte, quando houver (Geração de cenários §5.4), e, caso contrário, a geração disponível do estágio. O solver só pode reduzir a geração abaixo do montante disponível — não pode despachar acima do que a natureza oferece.
Variáveis de decisão:
- = geração da fonte não despachável no patamar
Limites (rígidos):
em que é a capacidade instalada, a razão de disponibilidade do estágio e do cenário (Visão geral da modelagem dos elementos do sistema §6) e o fator de patamar do patamar ( quando não informado); uma fonte de geração compulsória (must-run) tem ; uma fonte sem disponibilidade estocástica usa a geração disponível de seu estágio — a capacidade instalada, salvo se o estágio a definir — no lugar de .
Contribuição para o balanço de carga:
No barramento conectado: (geração injetada)
Contribuição para a função objetivo:
O PL precifica o corte de geração (curtailment) como uma recompensa sobre a geração despachada. O termo é igual à penalidade de corte de geração menos a constante : leva às mesmas decisões e, por isso, o objetivo do estágio pode ser negativo. Uma fonte de geração compulsória contribui com a constante .
O custo de corte de geração é uma penalidade de regularização (Categoria 3 no Sistema de penalidades), análoga ao custo de vertimento de uma usina hidrelétrica — o corte de geração descarta energia disponível “gratuita”.
Implementação no Novo Modelo
Seção intitulada “Implementação no Novo Modelo”A metodologia acima define as restrições do PL de cada tipo de equipamento; as abas abaixo mostram como a interface do software Novo Modelo configura, alimenta e informa os resultados dos quatro tipos de elemento que têm arquivos de configuração próprios — termelétricas, contratos, usinas elevatórias e fontes não despacháveis.
Os arquivos system/thermals.json, system/energy_contracts.json,
system/pumping_stations.json e system/non_controllable_sources.json do Novo Modelo
definem os quatro tipos de equipamento que têm configuração de elemento
dedicada neste capítulo. As equações alimentadas por esses campos estão nas
seções acima.
Data de início de operação comum
Seção intitulada “Data de início de operação comum”Usinas termelétricas, fontes não despacháveis, usinas elevatórias e contratos de energia
têm todos um campo obrigatório operational_start_date:
| Campo | Tipo | Descrição |
|---|---|---|
operational_start_date | string (data ISO-8601) | Data de calendário (YYYY-MM-DD) em que a entidade passa a constar do histórico operacional do cadastro. Serve à rastreabilidade e à chave de ordenação canônica (operational_start_date, id) (ver Convenções de notação) — é independente da janela de operação abaixo: não condiciona a entrada em operação, e a janela não é derivada dela. |
Janela de operação comum
Seção intitulada “Janela de operação comum”Usinas termelétricas, linhas, contratos, usinas elevatórias e fontes não despacháveis têm todos o mesmo par opcional de campos:
| Campo | Tipo | Descrição |
|---|---|---|
entry_stage_id | integer ou null | Índice do estágio em que a entidade entra em operação (inclusive). null significa que a entidade está disponível desde o estágio 0. |
exit_stage_id | integer ou null | Índice do estágio em que a entidade é desativada. A janela de operação é semiaberta [entry_stage_id, exit_stage_id): a entidade está ativa até exit_stage_id - 1 e, a partir de exit_stage_id, suas colunas são fixadas em [0, 0]. null significa que a entidade nunca é desativada. |
Fora de sua janela, as colunas de decisão de uma entidade permanecem no PL, mas
são fixadas em zero: ela não injeta potência, não retira potência, não movimenta água
e não consome potência do barramento. Um entry_stage_id posterior ao último estágio do estudo é aceito: a entidade
fica então fora de operação durante todo o estudo. Ver Visão geral da modelagem dos elementos do sistema §1
para o enunciado metodológico comum — as §3–4 da metodologia acima tratam de como a
janela interage com os limites take-or-pay dos contratos e com a vazão bombeada.
system/thermals.json — Cadastro de usinas termelétricas
Seção intitulada “system/thermals.json — Cadastro de usinas termelétricas”As unidades termelétricas são definidas em system/thermals.json. O objeto de nível superior tem
uma única chave "thermals", que contém um array de objetos de unidade:
{ "thermals": [ { "id": 0, "name": "UTE1", "bus_id": 0, "operational_start_date": "1998-03-01", "cost_per_mwh": 5.0, "generation": { "min_mw": 0.0, "max_mw": 15.0 } }, { "id": 1, "name": "Angra 1", "bus_id": 0, "operational_start_date": "1985-01-01", "entry_stage_id": null, "exit_stage_id": null, "cost_per_mwh": 50.0, "generation": { "min_mw": 0.0, "max_mw": 657.0 }, "anticipated_config": { "lead_stages": 2 } } ]}Somente id, name, bus_id, operational_start_date, cost_per_mwh e
generation são obrigatórios; entry_stage_id, exit_stage_id e
anticipated_config são opcionais.
Campos principais
Seção intitulada “Campos principais”| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | integer | Sim | Identificador único não negativo. |
name | string | Sim | Nome legível da usina. Usado nos arquivos de saída, nas mensagens de validação e no log. |
bus_id | integer | Sim | Identificador do barramento elétrico no qual a geração desta unidade é injetada. Deve corresponder a um id em buses.json. |
operational_start_date | string (data ISO-8601) | Sim | Data de calendário (YYYY-MM-DD) em que a unidade passa a constar do histórico operacional do cadastro — ver Data de início de operação comum acima. |
cost_per_mwh | number | Sim | Custo variável unitário (CVU) de geração, em reais por MWh. Deve ser não negativo. |
Limites de geração
Seção intitulada “Limites de geração”O bloco generation define os limites de geração, armazenados internamente como
min_generation_mw / max_generation_mw na entidade e impostos como os
limites rígidos de geração da §1.1 da metodologia em todo PL de estágio.
"generation": { "min_mw": 0.0, "max_mw": 657.0 }| Campo | Tipo | Descrição |
|---|---|---|
min_mw | number | Geração elétrica mínima, em MW. Um valor não nulo constitui geração mínima (inflexibilidade): o solver deve despachar pelo menos esse montante sempre que a unidade estiver em operação (sujeito à ressalva sobre a relaxação contínua da §1.1 da metodologia). |
max_mw | number | Geração elétrica máxima (capacidade instalada), em MW. |
Limites e custo variáveis por estágio são fornecidos via constraints/thermal_bounds.parquet,
que aceita linhas esparsas (thermal_id, stage_id) contendo qualquer combinação de
min_generation_mw, max_generation_mw e cost_per_mwh, opcionalmente restritas a um patamar
por meio de uma coluna opcional block_id. Um valor que a linha de um patamar deixa nulo
vem da linha do estágio, e um valor que nenhuma linha define vem do valor-base da
entidade. Uma linha com block_id em uma termelétrica que declare anticipated_config é rejeitada
de imediato, já que o compromisso entregue é limitado em um único estágio.
Configuração de antecipação de despacho (anticipated_config)
Seção intitulada “Configuração de antecipação de despacho (anticipated_config)”O bloco opcional anticipated_config marca uma termelétrica como de despacho antecipado,
associando a antecedência por usina descrita em Visão geral da modelagem dos elementos do sistema §4. A antecedência é dada em exatamente uma de duas formas mutuamente exclusivas — um número de estágios ou uma duração física:
"anticipated_config": { "lead_stages": 2 }"anticipated_config": { "lead_time_hours": 720.0 }| Campo | Tipo | Descrição |
|---|---|---|
lead_stages | integer | Número de estágios de antecipação de despacho, independente do calendário. Um valor 2 significa que o compromisso para o estágio t deve ser decidido no estágio t - 2. Deve ser >= 1. |
lead_time_hours | number | Antecedência física de despacho, em horas; deve ser finita e > 0. O compromisso de cada estágio de entrega é decidido no estágio que contém o instante situado uma antecedência antes do fim do estágio de entrega (um instante sobre a fronteira entre estágios pertence ao estágio anterior); uma entrega cujo instante é igual ou anterior ao início do estudo é decidida antes do estudo. Quando o instante cai dentro do próprio estágio de entrega, a entrega não é antecipada: a usina é despachada como termelétrica comum nesse estágio, e a preparação do estudo registra um aviso indicando a usina e o estágio. |
Fornecer ambas as chaves, ou nenhuma delas, é um erro de carga. Uma antecedência que ultrapassa o horizonte do estudo — lead_stages maior que o número de estágios, ou lead_time_hours maior que a soma do horizonte — é rejeitada na carga, a menos que a antecedência da usina alcance um estágio pós-estudo declarado (ambos os modos de antecedência são condicionados da mesma forma): tal compromisso é entregue além do horizonte, seja ele decidido no estudo ou antes dele. Sem um estágio pós-estudo a alcançar, a usina nunca poderia entregar dentro do horizonte do estudo, e a antecedência além do horizonte é rejeitada. Uma antecedência lead_time_hours grosseira o bastante para que um estágio de decisão decida mais de um estágio de entrega é rejeitada na preparação do estudo; uma antecedência lead_stages nunca produz essa situação. Ver Fronteira pós-estudo e estudos encadeados e post_study_stages.json para a fronteira contra a qual uma entrega pós-horizonte é precificada.
Uma usina com antecipação também declara, em past_anticipated_commitments de
initial_conditions.json, todo compromisso que decidiu antes do estudo
(Visão geral da modelagem dos elementos do sistema §4,
“Compromissos decididos antes do estudo”). Cada entrada é uma janela datada,
ancorada na entrega — uma potência comprometida em MW mantida constante em
[start_date, end_date):
{ "past_anticipated_commitments": [ { "thermal_id": 2, "start_date": "2025-11-01", "end_date": "2025-12-01", "value_mw": 0.0 } ]}| Campo | Tipo | Descrição |
|---|---|---|
thermal_id | integer | Identificador de uma termelétrica com antecipação (deve conter anticipated_config). |
start_date | string (data ISO-8601) | Início da janela de compromisso (inclusive). |
end_date | string (data ISO-8601) | Fim da janela de compromisso (exclusive); deve ser posterior a start_date. |
value_mw | number | Potência comprometida em MW, mantida constante ao longo da janela. |
As janelas de uma usina devem cobrir exatamente todo estágio de entrega que a usina decidiu antes
do estudo — cobertura 1.0, sem lacunas nem sobreposições. Esses estágios podem estar
de qualquer lado do horizonte: os estágios de entrega iniciais dentro do estudo, e
quaisquer estágios pós-horizonte em que seja entregue um compromisso decidido antes do estudo
(para o termo equivalente em outras ferramentas de planejamento, ver o
Glossário). Uma janela nunca pode cobrir um estágio que o próprio estudo
decide, e nenhuma janela pode atravessar
o fim do horizonte — divida-a nesse ponto em uma janela dentro do estudo e outra pós-estudo. Um
trecho sem compromisso programado também exige uma janela explícita com potência 0.0,
em vez de uma lacuna a ser inferida. A forma como cada value_mw é verificado quanto aos limites
depende de onde caem os estágios de entrega de sua janela. Em uma janela que cobre um ou
mais estágios de entrega dentro do estudo, o value_mw de cada estágio coberto e em operação
é verificado contra a faixa de geração resolvida desse estágio —
o [min_mw, max_mw] de base, restringido por qualquer sobrescrita de estágio/patamar de constraints/thermal_bounds.parquet
— dentro da tolerância de viabilidade do solver. Uma janela puramente
pós-horizonte (que não cobre nenhum estágio do estudo) verifica, em vez disso, cada
value_mw contra os limites estáticos [min_mw, max_mw] da usina, com a mesma
tolerância. Um value_mw fora da faixa de seu estágio é um erro de carga, pois,
caso contrário, a igualdade de entrega do PL nesse estágio não poderia ser satisfeita. Os
valores comprometidos são custos irrecuperáveis: uma janela dentro do estudo inicializa a posição do anel de despacho antecipado (commitment ring slot) de seu
estágio de entrega no primeiro estágio, e a
linha de retirada desse estágio fixa nele a geração da usina;
uma janela pós-horizonte não ocupa nenhuma posição do anel de despacho antecipado e, quando uma fronteira é carregada, sua contribuição
de estado é incorporada uma única vez, na carga, ao termo independente de todo corte de
fronteira. Nenhuma das duas entra na função objetivo do estudo, e uma janela pós-horizonte é reproduzida em
sua data real de entrega em anticipated/fixed_deliveries.parquet.
Entregas pós-horizonte
Seção intitulada “Entregas pós-horizonte”Uma termelétrica com antecipação cuja antecedência entrega após o horizonte do estudo tem duas formas de declaração, conforme quem decide o compromisso:
- Decidido no estudo, entregue após o horizonte — limitado e custeado exclusivamente
por uma célula
thermal_bounds[]empost_study_stages.json({thermal_id, post_study_stage_index, cost_per_mwh, min_mw, max_mw}), uma por estágio pós-estudo alcançado. O estudo decide os MW; a célula fornece seu preço e sua capacidade. - Decidido antes do estudo, entregue após o horizonte — uma janela
past_anticipated_commitments(acima) que se estende além do fim do horizonte.
Uma decisão dentro do estudo é cobrada em sua coluna de decisão ao cost_per_mwh
de sua célula thermal_bounds[], descontado a partir do estágio de entrega, e a
fronteira carregada precifica o compromisso transportado para o estado terminal; sem
policy.boundary declarado em config.json,
a preparação do estudo avisa que a entrega é precificada com valor terminal nulo. Um
compromisso decidido antes do estudo é custo irrecuperável: seu combustível não entra em nenhuma função objetivo e,
com uma fronteira carregada, sua contribuição de estado entra nos termos independentes dos
cortes de fronteira. Sem fronteira, uma janela pós-horizonte com potência não nula
gera o mesmo aviso na preparação; uma janela totalmente nula não gera nenhum. Ver
Fronteira pós-estudo e estudos encadeados para a
formulação e Formato do caso para
o formato dos arquivos.
Restrição de compromissos via restrições genéricas
Seção intitulada “Restrição de compromissos via restrições genéricas”A variável de decisão do compromisso antecipado pode ser referenciada em uma restrição
genérica por meio da expressão anticipated_decision(N), onde N é o
id da termelétrica — por exemplo, para limitar o nível em MW comprometido em cada estágio
de decisão:
{ "constraints": [ { "id": 1, "name": "cap_ant_t1", "expression": "anticipated_decision(2) <= 400.0", "slack": { "enabled": false } } ]}Ver Restrições genéricas para a linguagem completa de definição — expressões nomeadas, a grade de ativação e folga bilateral.
anticipated_decision(N) deve referenciar uma termelétrica que contenha um bloco
anticipated_config — referenciar uma termelétrica sem antecipação é um erro
fatal de carga. thermal_generation(N) em uma termelétrica com antecipação é aceito,
mas sinalizado com um aviso de ambiguidade semântica, pois essa expressão lê a
geração entregue por patamar, e não o compromisso antecipado.
Regras de validação na carga
Seção intitulada “Regras de validação na carga”| Regra | Classe de Erro | Descrição |
|---|---|---|
| Integridade da referência ao barramento | Erro de referência | Todo bus_id deve corresponder a um id em buses.json. |
| Custo não negativo | Erro de esquema | cost_per_mwh deve ser não negativo. |
| Ordenação dos limites de geração | Viabilidade física | min_mw deve ser <= max_mw. |
| Validade da antecedência | Viabilidade física | Quando anticipated_config está presente, lead_stages deve ser >= 1; um lead_stages acima do número de estágios do estudo, ou um lead_time_hours acima da soma das horas do horizonte, é rejeitado, a menos que a antecedência alcance um estágio pós-estudo declarado. |
| Cobertura das janelas de compromisso | Erro de referência | As janelas past_anticipated_commitments de toda termelétrica com antecipação devem cobrir exatamente todo estágio de entrega que a usina decidiu antes do estudo (cobertura 1.0, sem lacunas nem sobreposições) — tanto os estágios iniciais dentro do estudo quanto os estágios pós-horizonte decididos antes do estudo —, nunca um estágio que o próprio estudo decide, e nenhuma janela pode atravessar o fim do horizonte. |
| Referência à termelétrica do compromisso | Erro de referência | O thermal_id de toda entrada de past_anticipated_commitments deve referenciar uma termelétrica com antecipação. |
| Limites do valor comprometido | Viabilidade física | O value_mw de cada janela de past_anticipated_commitments deve estar dentro da faixa de geração resolvida de todo estágio de entrega coberto (cobertura dentro do estudo) ou dos limites estáticos [min_mw, max_mw] da usina (puramente pós-horizonte), dentro da tolerância do solver. Ver Códigos de erro. |
| Limites de entrega pós-estudo | Erro de referência | Todo estágio pós-estudo alcançado pela antecedência de uma termelétrica com antecipação deve ter uma célula thermal_bounds[] correspondente em post_study_stages.json, e todo estágio pós-estudo coberto por uma janela de compromisso decidido antes do estudo deve ser coberto com cobertura 1.0. Ver Códigos de erro para os modos exatos de falha. |
system/non_controllable_sources.json — Cadastro de fontes não despacháveis (NCS)
Seção intitulada “system/non_controllable_sources.json — Cadastro de fontes não despacháveis (NCS)”As fontes não despacháveis (eólica, solar, pequenas hidrelétricas a fio d’água) são definidas
em system/non_controllable_sources.json:
{ "non_controllable_sources": [ { "id": 0, "name": "Wind Farm A", "bus_id": 1, "operational_start_date": "2015-06-01", "max_generation_mw": 100.0 } ]}| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | integer | Sim | Identificador único. |
name | string | Sim | Nome legível da fonte. |
bus_id | integer | Sim | Barramento no qual a geração desta fonte é injetada. |
operational_start_date | string (data ISO-8601) | Sim | Data de calendário (YYYY-MM-DD) em que a fonte passa a constar do histórico operacional do cadastro — ver Data de início de operação comum acima. |
max_generation_mw | number | Sim | Capacidade instalada, em MW. Escala a disponibilidade estocástica descrita na §6 da metodologia e não limita a geração disponível. |
allow_curtailment | boolean | Não | Padrão true (sujeita a corte de geração). Defina false para fontes de geração compulsória (must-run) que fixam a geração na disponibilidade realizada em todos os cenários — ver Visão geral da modelagem dos elementos do sistema §6 para quando isso é necessário (por exemplo, totais agregados de NCS já abatidos). |
curtailment_cost | number ou null | Não | Sobrescrita, no nível da entidade, de non_controllable_source.curtailment_cost em penalties.json; finito e >= 0. |
A razão de disponibilidade vem de scenarios/non_controllable_stats.parquet
(ou de scenarios/external_ncs_scenarios.parquet no esquema external), e
os fatores por patamar, de scenarios/non_controllable_factors.json; uma fonte sem
modelo de disponibilidade obtém a geração disponível de seu estágio em
constraints/ncs_bounds.parquet, ou max_generation_mw onde nenhuma linha se aplica — ver
a aba Entradas e Saídas.
system/pumping_stations.json — Cadastro de usinas elevatórias
Seção intitulada “system/pumping_stations.json — Cadastro de usinas elevatórias”{ "pumping_stations": [ { "id": 0, "name": "Bombeamento Serra da Mesa", "bus_id": 10, "operational_start_date": "2010-09-15", "source_hydro_id": 3, "destination_hydro_id": 5, "consumption_mw_per_m3s": 0.5, "flow": { "min_m3s": 0.0, "max_m3s": 150.0 } } ]}| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | integer | Sim | Identificador único. |
name | string | Sim | Nome legível da usina elevatória. |
bus_id | integer | Sim | Barramento do qual a potência elétrica é consumida. |
operational_start_date | string (data ISO-8601) | Sim | Data de calendário (YYYY-MM-DD) em que a usina elevatória passa a constar do histórico operacional do cadastro — ver Data de início de operação comum acima. |
source_hydro_id | integer | Sim | Usina hidrelétrica de cujo reservatório a água é retirada (ver §4 da metodologia). Deve ser diferente de destination_hydro_id — uma usina elevatória que modele uma autotransferência (mesmo id dos dois lados) é um erro de carga, pois se anularia silenciosamente em uma linha de balanço hídrico enquanto ainda consumiria potência. A janela [entry_stage_id, exit_stage_id) da usina elevatória deve estar contida nos estágios em que tanto a usina hidrelétrica de origem quanto a de destino estão em operação (Operating) (não antes da entrada, não na saída nem depois dela, e não em fase de enchimento (Filling)); caso contrário, o caso é rejeitado (BusinessRuleViolation em system/pumping_stations.json), com um erro por lado infrator indicando o primeiro estágio nessa condição. Linhas de pumping_bounds com valor zero não satisfazem a regra. |
destination_hydro_id | integer | Sim | Usina hidrelétrica em cujo reservatório a água é injetada (ver §4 da metodologia). |
consumption_mw_per_m3s | number | Sim | Taxa de consumo de potência, em MW por m³/s (§4 da metodologia). |
flow.min_m3s / flow.max_m3s | number | Sim | Limites da vazão bombeada, em m³/s (§4 da metodologia). |
Limites variáveis por estágio são fornecidos via constraints/pumping_bounds.parquet,
que aceita linhas esparsas (pumping_station_id, stage_id) contendo min_m3s e/ou
max_m3s, opcionalmente restritas a um patamar por meio de uma coluna opcional block_id;
na ausência de linhas, valem os valores-base da entidade.
system/energy_contracts.json — Cadastro de contratos
Seção intitulada “system/energy_contracts.json — Cadastro de contratos”{ "contracts": [ { "id": 0, "name": "Importação Argentina", "bus_id": 5, "operational_start_date": "2005-01-01", "type": "import", "price_per_mwh": 200.0, "limits": { "min_mw": 0.0, "max_mw": 1000.0 } }, { "id": 1, "name": "Exportação Uruguai", "bus_id": 6, "operational_start_date": "2020-04-01", "type": "export", "entry_stage_id": 1, "exit_stage_id": 60, "price_per_mwh": -150.0, "limits": { "min_mw": 0.0, "max_mw": 500.0 } } ]}| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | integer | Sim | Identificador único. |
name | string | Sim | Nome legível do contrato. |
bus_id | integer | Sim | Barramento no qual a potência contratada é injetada ou retirada. |
operational_start_date | string (data ISO-8601) | Sim | Data de calendário (YYYY-MM-DD) em que o contrato passa a constar do histórico operacional do cadastro — ver Data de início de operação comum acima. |
type | string | Sim | "import" ou "export" — define o sinal no balanço de carga e o pertencimento ao conjunto de importação/exportação da §3 da metodologia. |
price_per_mwh | number | Sim | Preço do contrato, em reais por MWh. Positivo para importações (custo), negativo para exportações (receita) — ver §3 da metodologia. |
limits.min_mw / limits.max_mw | number | Sim | Limites de despacho, em MW. Um min_mw não nulo é o piso rígido take-or-pay. |
Limites e preço variáveis por estágio são fornecidos via
constraints/contract_bounds.parquet, que aceita linhas esparsas
(contract_id, stage_id) contendo qualquer combinação de min_mw,
max_mw e price_per_mwh, opcionalmente restritas a um patamar por meio de uma
coluna opcional block_id; na ausência de linhas, valem os valores-base da entidade.
Como o cost_per_mwh das termelétricas, o price_per_mwh dos contratos admite variação por patamar:
o caminho de custos da simulação de um estudo respeita uma sobrescrita de preço por patamar.
Este é um índice, restrito ao tema, dos arquivos envolvidos com termelétricas, contratos, usinas elevatórias e fontes não despacháveis — nomeia cada arquivo e sua função, sem repetir seus esquemas campo a campo. A referência exaustiva, campo a campo, do diretório do caso e das saídas pertence às páginas Formato do caso e Formato de saída.
Entradas
Seção intitulada “Entradas”| Arquivo | Função |
|---|---|
system/thermals.json | Cadastro das usinas termelétricas — campos principais, limites de geração e anticipated_config opcional (veja a aba Configurar). |
system/energy_contracts.json | Cadastro dos contratos — sentido, preço, limites de despacho e janela de vigência (entrada em operação/desativação). |
system/pumping_stations.json | Cadastro das usinas elevatórias — UHE de origem/destino, taxa de consumo e limites de vazão. |
system/non_controllable_sources.json | Cadastro das NCS — capacidade instalada, indicador de corte de geração (curtailment) e custo específico. |
constraints/thermal_bounds.parquet | Substituições esparsas, por (termelétrica, estágio), de min_generation_mw, max_generation_mw e cost_per_mwh, com eixo opcional por patamar (veja a aba Configurar). |
constraints/pumping_bounds.parquet | Substituições esparsas, por (usina elevatória, estágio), de min_m3s/max_m3s, com eixo opcional por patamar (veja a aba Configurar). |
constraints/ncs_bounds.parquet | Geração disponível, por (ncs_id, stage_id), de uma fonte sem modelo estocástico de disponibilidade, no lugar de seu max_generation_mw; uma fonte com linhas em scenarios/non_controllable_stats.parquet, ou que amostra de scenarios/external_ncs_scenarios.parquet sob o esquema external, ignora suas linhas (Formulações específicas por equipamento §6). |
scenarios/non_controllable_factors.json / scenarios/non_controllable_stats.parquet | Fatores determinísticos por patamar ou estatísticas estocásticas de disponibilidade das NCS. |
constraints/contract_bounds.parquet | Substituições esparsas, por (contrato, estágio), de min_mw, max_mw e price_per_mwh, com eixo opcional por patamar nos três (veja a aba Configurar). |
initial_conditions.json (past_anticipated_commitments) | Compromissos de despacho que cada termelétrica com antecipação decidiu antes do estudo, com entrega dentro ou além do horizonte (elementos do sistema §4). |
constraints/generic_constraint_bounds.parquet | O intervalo bilateral (bound_lower/bound_upper) que também serve como grade de ativação das restrições genéricas — uma linha por célula (constraint_id, stage_id[, block_id]), incluindo qualquer expressão anticipated_decision(N). |
Para o esquema completo, campo a campo, de cada arquivo acima, consulte a página de referência Formato do caso.
| Arquivo | Função |
|---|---|
simulation/thermals/ | Resultados de despacho por (estágio, patamar, termelétrica) — geração, custo e (para usinas com antecipação) is_anticipated, anticipated_committed_mw, anticipated_decision_mw. |
simulation/contracts/ | Resultados de despacho por (estágio, patamar, contrato) — power_mw, energy_mwh, price_per_mwh, total_cost, operative_state_code. O custo dos contratos tem sua própria coluna contract_cost em simulation/costs/. |
simulation/pumping_stations/ | Resultados de vazão bombeada por (estágio, patamar, usina elevatória) e uma coluna pumping_cost sempre igual a 0: o bombeamento não tem custo na função objetivo, e sua potência entra no balanço do barramento (veja a aba Notas de implementação). |
simulation/non_controllables/ | generation_mw, available_mw, curtailment_mw, curtailment_cost por (estágio, patamar, fonte). |
simulation/costs/ | Decomposição do custo por estágio; o custo de combustível das termelétricas, o custo dos contratos e o custo do corte de geração contribuem cada um com sua própria coluna. |
generic_constraints/resolved_echo.parquet | A forma plana e expandida de cada restrição genérica que o solver efetivamente construiu — gravada sempre que o estudo tem restrições genéricas. Veja Restrições genéricas para o formato do eco resolvido. |
simulation/anticipated_lanes/ | Compromissos pós-horizonte que o estudo decide, uma linha por cenário e decisão no seu estágio de decisão; gravado apenas quando o estudo declara post_study_stages (esquema: Saídas da simulação). |
anticipated/fixed_deliveries.parquet | Eco, no nível da execução, de cada compromisso decidido antes do estudo e entregue além do horizonte (para o termo equivalente em outras ferramentas de planejamento, veja o Glossário); sem coluna de custo, pois esse combustível é custo afundado e não entra em nenhuma função objetivo (esquema e condições de gravação: Saídas da simulação). |
Para o esquema completo de saída (colunas, tipos, organização dos arquivos), consulte a página de referência Formato de saída.
Comportamento não normativo do software para usinas termelétricas, contratos, usinas elevatórias e NCS — o que o Novo Modelo faz em tempo de execução, além das equações acima. Esta aba remete ao corpo metodológico para as deduções, em vez de reproduzi-las.
Janela de operação: linhas de saída fora da janela
Seção intitulada “Janela de operação: linhas de saída fora da janela”Fora da sua janela de operação
(Janela de Operação Compartilhada) uma entidade
continua emitindo suas linhas de saída, zeradas em vez de ausentes, com o mesmo
operative_state_code de quando está em operação.
Contratos não têm estado
Seção intitulada “Contratos não têm estado”Um contrato de energia contribui com exatamente uma coluna do PL por patamar e por
sentido e não possui variável de estado — não faz parte da recursão de Bellman
e não contribui com nenhum termo para os cortes de Benders (Formulações específicas por equipamento §3). Essa é
uma diferença estrutural em relação às usinas hidrelétricas e às termelétricas com
antecipação de despacho, cujas variáveis de estado de armazenamento e do anel de despacho antecipado
(commitment ring) contribuem com um termo nos cortes. Um min_mw não nulo nos estágios
ativos de um contrato é um piso rígido do tipo take-or-pay: o PL deve despachar ao
menos essa quantidade ao preço do contrato, independentemente de alternativas mais
baratas em outros pontos do sistema. Todo o custo de contratos — o custo de
importação ou a receita (negativa) de exportação — tem coluna própria,
contract_cost, no detalhamento de custos por estágio de simulation/costs/, ao
lado de thermal_cost.
Usinas elevatórias não têm custo explícito na função objetivo
Seção intitulada “Usinas elevatórias não têm custo explícito na função objetivo”A variável de vazão de uma usina elevatória não tem termo direto na função objetivo (Formulações específicas por equipamento §4). O custo do bombeamento é inteiramente implícito: o bombeamento consome potência no barramento conectado, em proporção à vazão bombeada, e esse consumo é valorado pelo custo marginal do barramento naquele estágio e cenário — barato quando há excedente hidrelétrico ou renovável na margem, caro quando o despacho térmico define o preço. Por isso o bombeamento se concentra, por critério econômico, nos períodos de preço baixo, sem nenhum coeficiente de custo específico de bombeamento a ajustar.
Termelétricas com antecipação de despacho são a exceção à regra de “sem estado entre estágios” dos equipamentos
Seção intitulada “Termelétricas com antecipação de despacho são a exceção à regra de “sem estado entre estágios” dos equipamentos”Todos os demais tipos de equipamento deste capítulo não têm memória: seu despacho no
estágio t depende apenas dos limites e do preço do próprio estágio. Uma
termelétrica com antecipação de despacho (anticipated_config) é a única exceção —
seu compromisso de despacho, decidido em um estágio anterior ou antes do estudo, é
mantido como estado do anel de despacho antecipado até o seu estágio de entrega, no qual a
geração da usina deve cumpri-lo (Visão geral da modelagem dos elementos do sistema §4). A
expressão de restrição genérica anticipated_decision(N) permite ao autor do caso
impor diretamente um teto ou um piso a esse compromisso antecipado; referenciar com
essa expressão uma termelétrica sem antecipação é um erro fatal na carga, e
referenciar a geração por patamar de uma termelétrica com antecipação com
thermal_generation(N) é aceito, mas sinalizado, pois não lê o compromisso
antecipado.
Compromisso excessivo é rejeitado na carga do caso, não reconciliado a cada resolução
Seção intitulada “Compromisso excessivo é rejeitado na carga do caso, não reconciliado a cada resolução”O valor antecipado de um compromisso entregue é mantido como estado do anel de despacho antecipado; assim, no seu estágio de entrega, a linha de saída do ring (Aumento do espaço de estados §5) lê o valor calculado pelo solver — exato apenas até a tolerância de viabilidade do backend de PL, não exatamente. O Novo Modelo não executa nenhuma etapa de reconciliação a cada resolução. Em vez disso, o estado de saída é canonicalizado sobre seus limites admissíveis quando é lido de volta de cada resolução, e essa projeção é a identidade para um valor já dentro dos limites: um compromisso que se acomoda uma fração fora do seu teto é trazido de volta para dentro dos limites antes de ser propagado, de modo que o treinamento (training) prossegue normalmente em vez de apresentar um PL inviável espúrio. Esse é o único ponto de canonicalização na leitura de volta que a metodologia enuncia uma única vez — veja Algoritmo da PDDE §3.1 e Determinismo e rastreabilidade §3.
Um compromisso de fato além dos limites de geração da usina não é um artefato
do solver e não é absorvido por esse ajuste. Ele é detectado na carga do caso,
quando são validadas as janelas past_anticipated_commitments de
initial_conditions.json (veja a aba Configurar). Um value_mw fora dos limites
admissíveis em um estágio de entrega coberto é um erro nomeado de carga que
identifica a termelétrica, a janela problemática, o value_mw e os limites que ele
viola — e não um PL inviável sem explicação surgindo no meio da resolução. Veja
Códigos de erro para a classe da falha.
NCS com geração compulsória e a armadilha do desconto em dobro
Seção intitulada “NCS com geração compulsória e a armadilha do desconto em dobro”O indicador allow_curtailment: false fixa a coluna de geração de uma NCS na
disponibilidade realizada em todo cenário — uma igualdade de limites, e não apenas
um limite superior. Ele existe especificamente para montantes agregados de geração
não simulada (PCHs, biomassa, geração distribuída) que um modelo de origem já
abateu da carga antes de o PL de despacho ser executado: deixar um
agregado desse tipo sujeito a corte permite que o PL “corte” energia que nunca
esteve disponível separadamente para ser cortada, barateando silenciosamente o
despacho hidrotérmico em relação ao modelo de referência que se pretende
reproduzir. Usinas eólicas e solares individuais, para as quais o corte de geração
(curtailment) é uma escolha física e econômica real, usam o comportamento padrão,
sujeito a corte.
Referências cruzadas
Seção intitulada “Referências cruzadas”- Convenções de notação — definições de variáveis e conjuntos (, , , , , )
- Visão geral da modelagem dos elementos do sistema — descrição dos elementos, variáveis de decisão e conexões
- Formulação do PL — como as restrições dos equipamentos se integram ao PL montado; balanço hídrico (§4), restrições de geração (§6), limites das variáveis (§8)
- Modelos de função de produção hidrelétrica — restrições da função de produção específicas das hidrelétricas (constante, FPHA)
- Sistema de penalidades — taxonomia das penalidades, custos de regularização vs. de violação
- Variantes de formulação dos patamares — estrutura de patamares dentro da qual operam as restrições dos equipamentos
- Algoritmo da PDDE — algoritmo iterativo que resolve os subproblemas de estágio que contêm essas restrições dos equipamentos