Pular para o conteúdo

Arquivos de penalidades

Esta página documenta o penalties.json, que contém os valores padrão globais dos custos de penalidade, e os quatro arquivos constraints/penalty_overrides_*.parquet, que substituem valores padrão individuais para uma entidade em um estágio. As substituições compartilham o diretório constraints/ com os arquivos de limites descritos em Arquivos de restrições. O Resumo dos arquivos associa cada arquivo do caso à sua página, e as Convenções estabelecem as regras comuns a todos eles.

Todos os arquivos de substituição de penalidades usam armazenamento esparso. Só são necessárias linhas para os pares (entity_id, stage_id) em que a penalidade difere do valor padrão da entidade ou do valor padrão global. Todo valor de substituição deve ser finito. turbined_cost (usina hidrelétrica) e curtailment_cost (fonte não despachável) devem ser >= 0.0, como seus valores padrão de penalties.json; todo outro valor de substituição deve ser estritamente positivo (> 0.0).


Metodologia: Sistema de penalidades

Valores padrão globais dos custos de penalidade, usados quando não há substituição no nível da entidade. As quatro seções são obrigatórias. Todo custo escalar obrigatório deve ser estritamente positivo (> 0.0), com duas exceções validadas como >= 0.0: o custo de regularização turbined_cost das usinas hidrelétricas (um custo de turbinamento 0.0 — sem penalidade sobre a vazão turbinada — é válido) e non_controllable_source.curtailment_cost (um custo 0.0 torna o corte de geração gratuito). Os custos opcionais, hydro.inflow_nonnegativity_cost e os quatro custos direcionais de evaporação e de retirada de água, são lidos sem verificação de faixa. Os segmentos de déficit não podem ser vazios, devem ter custos estritamente crescentes e o depth_mw do último segmento deve ser null (ilimitado).

NomeTipoObrigatórioPadrãoUnidadeDescrição
busobjectSim——Valores padrão das penalidades dos barramentos.
bus.deficit_segmentsarraySim——Patamares de custo de déficit, lineares por partes
bus.deficit_segments[].depth_mwnumber | nullNão—MWProfundidade do segmento (MW); null para o último segmento, ilimitado
bus.deficit_segments[].costnumberSim—R$/MWhCusto por MWh de déficit neste patamar de custo (R$/MWh)
bus.excess_costnumberSim—R$/MWhCusto por MWh de injeção em excesso (R$/MWh)
lineobjectSim——Valores padrão das penalidades das linhas.
line.exchange_costnumberSim—R$/MWhCusto por MWh de intercâmbio entre barramentos (R$/MWh)
hydroobjectSim——Valores padrão das penalidades das usinas hidrelétricas.
hydro.spillage_costnumberSim—R$/(m³/s·h)Penalidade de vertimento
hydro.turbined_costnumberSim—R$/(m³/s·h)Custo de regularização da vazão turbinada (aplicado a todas as usinas hidrelétricas)
hydro.diversion_costnumberSim—R$/(m³/s·h)Penalidade da vazão desviada
hydro.storage_violation_below_costnumberSim—R$/hm³Penalidade por violação do armazenamento mínimo
hydro.filling_target_violation_costnumberSim—R$/hm³Penalidade por violação da meta de enchimento
hydro.turbined_violation_below_costnumberSim—R$/(m³/s·h)Penalidade por violação da vazão turbinada mínima
hydro.outflow_violation_below_costnumberSim—R$/(m³/s·h)Penalidade por violação da vazão defluente total mínima
hydro.outflow_violation_above_costnumberSim—R$/(m³/s·h)Penalidade por violação da vazão defluente total máxima
hydro.generation_violation_below_costnumberSim—R$/MWhPenalidade por violação da geração mínima
hydro.fpha_violation_costnumberSim—R$/MWhPenalidade por violação do plano da FPHA: o preço da geração acima de um plano da FPHA, por MW e por hora
hydro.evaporation_violation_costnumberSim—R$/(m³/s·h)Penalidade simétrica por violação da evaporação
hydro.evaporation_violation_pos_costnumber | nullNão—R$/(m³/s·h)Substituição opcional para evaporação acima da meta; prevalece sobre evaporation_violation_cost no sentido positivo. Omitida = valor simétrico
hydro.evaporation_violation_neg_costnumber | nullNão—R$/(m³/s·h)Substituição opcional para evaporação abaixo da meta; prevalece sobre evaporation_violation_cost no sentido negativo. Omitida = valor simétrico
hydro.water_withdrawal_violation_costnumberSim—R$/(m³/s·h)Penalidade simétrica por violação da retirada de água
hydro.water_withdrawal_violation_pos_costnumber | nullNão—R$/(m³/s·h)Substituição opcional para retirada acima da meta; prevalece sobre water_withdrawal_violation_cost no sentido positivo. Omitida = valor simétrico
hydro.water_withdrawal_violation_neg_costnumber | nullNão—R$/(m³/s·h)Substituição opcional para retirada abaixo da meta; prevalece sobre water_withdrawal_violation_cost no sentido negativo. Omitida = valor simétrico
hydro.inflow_nonnegativity_costnumber | nullNão—R$/(m³/s·h)Custo opcional da correção da afluência nos métodos penalty e truncation_with_penalty, não usado em truncation e none. Omitido = padrão 1000.0
non_controllable_sourceobjectSim——Valores padrão das penalidades das fontes não despacháveis.
non_controllable_source.curtailment_costnumberSim—R$/MWhPenalidade de corte de geração (curtailment) (R$/MWh); >= 0.0

Exemplo:

{
"$schema": "https://docs.modelossetoreletrico.org.br/schemas/penalties.schema.json",
"bus": {
"deficit_segments": [
{ "depth_mw": 500.0, "cost": 7000.0 },
{ "depth_mw": null, "cost": 7500.0 }
],
"excess_cost": 100.0
},
"line": { "exchange_cost": 2.0 },
"hydro": {
"spillage_cost": 0.01,
"turbined_cost": 0.05,
"diversion_cost": 0.1,
"storage_violation_below_cost": 10000.0,
"filling_target_violation_cost": 6000.0,
"turbined_violation_below_cost": 500.0,
"outflow_violation_below_cost": 500.0,
"outflow_violation_above_cost": 500.0,
"generation_violation_below_cost": 1000.0,
"fpha_violation_cost": 85000.0,
"evaporation_violation_cost": 5000.0,
"water_withdrawal_violation_cost": 1000.0
},
"non_controllable_source": { "curtailment_cost": 0.005 }
}

Metodologia: Sistema de penalidades

NomeTipoObrigatórioPadrãoUnidadeDescrição
bus_idInt32Sim——ID do barramento
stage_idInt32Sim——ID do estágio
excess_costFloat64Não—R$/MWhSubstituição do custo de injeção em excesso (R$/MWh)

Observação: os segmentos de déficit dos barramentos não variam por estágio. Apenas excess_cost pode ser substituído por estágio para os barramentos.


Metodologia: Sistema de penalidades

NomeTipoObrigatórioPadrãoUnidadeDescrição
line_idInt32Sim——ID da linha de transmissão
stage_idInt32Sim——ID do estágio
exchange_costFloat64Não—R$/MWhSubstituição do custo de intercâmbio (R$/MWh)

Metodologia: Sistema de penalidades

NomeTipoObrigatórioPadrãoUnidadeDescrição
hydro_idInt32Sim——ID da usina hidrelétrica
stage_idInt32Sim——ID do estágio
spillage_costFloat64Não—R$/(m³/s·h)Substituição da penalidade de vertimento (R$/(m³/s·h))
turbined_costFloat64Não—R$/(m³/s·h)Substituição do custo de turbinamento (R$/(m³/s·h)); >= 0.0
diversion_costFloat64Não—R$/(m³/s·h)Substituição da penalidade de desvio (R$/(m³/s·h))
storage_violation_below_costFloat64Não—R$/hm³Substituição da penalidade por violação do armazenamento mínimo (R$/hm³)
filling_target_violation_costFloat64Não—R$/hm³Substituição da penalidade por violação da meta de enchimento (R$/hm³)
turbined_violation_below_costFloat64Não—R$/(m³/s·h)Substituição da penalidade por violação da vazão turbinada mínima (R$/(m³/s·h))
outflow_violation_below_costFloat64Não—R$/(m³/s·h)Substituição da penalidade por violação da vazão defluente mínima (R$/(m³/s·h))
outflow_violation_above_costFloat64Não—R$/(m³/s·h)Substituição da penalidade por violação da vazão defluente máxima (R$/(m³/s·h))
generation_violation_below_costFloat64Não—R$/MWhSubstituição da penalidade por violação da geração mínima (R$/MWh)
fpha_violation_costFloat64Não—R$/MWhSubstituição da penalidade por violação do plano da FPHA (R$/MWh)
evaporation_violation_costFloat64Não—R$/(m³/s·h)Substituição da penalidade simétrica por violação da evaporação (R$/(m³/s·h)). O valor do estágio também define os dois custos direcionais de evaporação do estágio, exceto em um sentido que a linha defina em sua própria coluna. Ver Custos direcionais de evaporação e de retirada de água.
evaporation_violation_pos_costFloat64Não—R$/(m³/s·h)Substituição da penalidade por evaporação acima da meta (R$/(m³/s·h))
evaporation_violation_neg_costFloat64Não—R$/(m³/s·h)Substituição da penalidade por evaporação abaixo da meta (R$/(m³/s·h))
water_withdrawal_violation_costFloat64Não—R$/(m³/s·h)Substituição da penalidade simétrica por violação da retirada de água (R$/(m³/s·h)). O valor do estágio também define os dois custos direcionais de retirada do estágio, exceto em um sentido que a linha defina em sua própria coluna. Ver Custos direcionais de evaporação e de retirada de água.
water_withdrawal_violation_pos_costFloat64Não—R$/(m³/s·h)Substituição da penalidade por violação da retirada de água, retirada acima da meta (R$/(m³/s·h))
water_withdrawal_violation_neg_costFloat64Não—R$/(m³/s·h)Substituição da penalidade por violação da retirada de água, retirada abaixo da meta (R$/(m³/s·h))
inflow_nonnegativity_costFloat64Não—R$/(m³/s·h)Substituição da penalidade de não negatividade da afluência (R$/(m³/s·h)); usada nos métodos penalty e truncation_with_penalty

Metodologia: Sistema de penalidades

NomeTipoObrigatórioPadrãoUnidadeDescrição
ncs_idInt32Sim——ID da fonte não despachável
stage_idInt32Sim——ID do estágio
curtailment_costFloat64Não—R$/MWhSubstituição da penalidade de corte de geração (R$/MWh); >= 0.0