Pular para o conteúdo

Artefatos dos modelos hidrelétricos

training/hydro_models.json resume os modelos de produção e de evaporação em uso.

O diretório hydro_models/ contém os três arquivos que seguem training/hydro_models.json. Cada um só é gravado quando tem linhas — planos da FPHA ajustados, modelos de evaporação ou, com exports.fpha_deviation_points definido como true, pontos de desvio —, e o diretório não existe quando nenhum é gravado.


Contagens agregadas dos modelos de produção e de evaporação, detalhamento por hidrelétrica para toda usina que usa um modelo de produção FPHA e a lista das usinas sem capacidade de turbinamento (uma usina com FPHA calculada, ou com FPHA pré-calculada sem linhas de hiperplanos). O arquivo também lista as hidrelétricas cujo turbinamento é congelado em algum estágio do estudo, ou cujo mínimo de vazão turbinada ou de geração o PL não aplica. Sempre gravado.

Metodologia: Modelos de função de produção hidrelétrica

Objeto de primeiro nível:

NomeTipoAnulávelUnidadeDescrição
n_constantintegerNão—Número de usinas hidrelétricas com produtibilidade constante em todos os estágios: usinas cujas entradas de modelo de produção não selecionam nenhum modelo FPHA e usinas sem capacidade de turbinamento (uma usina com FPHA calculada, ou com FPHA pré-calculada sem linhas de hiperplanos), modeladas com produtibilidade zero e listadas em no_turbine_capacity.
n_fphaintegerNão—Número de usinas hidrelétricas com hiperplanos da FPHA pré-calculados ou calculados em pelo menos uma entrada de modelo de produção; uma usina sem capacidade de turbinamento (uma usina com FPHA calculada, ou com FPHA pré-calculada sem linhas de hiperplanos) é contada em n_constant.
total_planesintegerNão—Soma de n_planes sobre fpha_details: os hiperplanos de cada usina com FPHA no primeiro estágio do estudo.
fpha_detailsarrayNão—Detalhamento por hidrelétrica de cada usina contada em n_fpha (veja abaixo).
no_turbine_capacityarrayNão—Usinas que solicitam FPHA (uma usina com FPHA calculada, ou com FPHA pré-calculada sem linhas de hiperplanos) cujos max_turbined_m3s ou max_generation_mw declarados as deixam sem capacidade de turbinamento, em ordem crescente de hydro_id; sempre presente ([] quando não há nenhuma); cada uma também é contada em n_constant (veja abaixo).
frozen_turbiningarrayNão—Hidrelétricas com uma célula (usina, barramento) sem capacidade de turbinamento em algum patamar de um estágio do estudo, ou com um mínimo que o PL não aplica (Mínimo e máximo da usina), em ordem crescente de hydro_id; sempre presente ([] quando não há nenhuma) (veja abaixo).
n_evaporationintegerNão—Número de usinas hidrelétricas com modelo de evaporação linearizado.
n_no_evaporationintegerNão—Número de usinas hidrelétricas sem modelo de evaporação.
n_user_supplied_refintegerNão—Número de usinas com evaporação que usaram volumes de referência fornecidos pelo usuário.
n_default_midpoint_refintegerNão—Número de usinas com evaporação que usaram a referência padrão no ponto médio.

Campos de fpha_details[]:

NomeTipoAnulávelUnidadeDescrição
fpha_details[].hydro_idintegerNão—Identificador da entidade usina hidrelétrica.
fpha_details[].namestringNão—Nome legível da usina hidrelétrica.
fpha_details[].sourcestringNão—Origem dos hiperplanos da usina: "precomputed_hyperplanes" ou "computed_from_geometry".
fpha_details[].n_planesintegerNão—Número de hiperplanos da usina no primeiro estágio do estudo (0 quando esse estágio usa produtibilidade constante).

Campos de no_turbine_capacity[]:

NomeTipoAnulávelUnidadeDescrição
no_turbine_capacity[].hydro_idintegerNão—Identificador da entidade usina hidrelétrica.
no_turbine_capacity[].namestringNão—Nome legível da usina hidrelétrica.

Campos de frozen_turbining[]:

NomeTipoAnulávelUnidadeDescrição
frozen_turbining[].hydro_idintegerNão—Identificador da entidade usina hidrelétrica.
frozen_turbining[].namestringNão—Nome legível da usina hidrelétrica.
frozen_turbining[].no_capacity_stage_idsarrayNão—Ids inteiros de estágios do estudo, em ordem crescente, em que nenhuma célula (usina, barramento) da usina tem capacidade de turbinamento em qualquer patamar.
frozen_turbining[].partial_capacity_stage_idsarrayNão—Ids inteiros de estágios do estudo, em ordem crescente e disjuntos de no_capacity_stage_ids, em que algumas, mas não todas, as combinações (célula, patamar) têm capacidade de turbinamento.
frozen_turbining[].dropped_floorsarrayNão—Mínimos que o PL não aplica (veja abaixo).

Campos de frozen_turbining[].dropped_floors[]:

NomeTipoAnulávelUnidadeDescrição
frozen_turbining[].dropped_floors[].stage_idintegerNão—Id do estágio do estudo.
frozen_turbining[].dropped_floors[].block_idintegerNão—Id do patamar dentro do estágio.
frozen_turbining[].dropped_floors[].floorstringNão—O mínimo descartado: "min_turbined_m3s" ou "min_generation_mw".
frozen_turbining[].dropped_floors[].levelstringNão—Se o mínimo é o da própria usina ou o de um grupo de unidades: "plant" ou "unit_group".
frozen_turbining[].dropped_floors[].hydro_unit_group_idintegerSim—Id do grupo de unidades; nulo exatamente quando level é "plant".
frozen_turbining[].dropped_floors[].bus_idintegerSim—O barramento do grupo de unidades; nulo exatamente quando level é "plant".
frozen_turbining[].dropped_floors[].valuenumberNãom³/s ou MWMínimo resolvido, sempre > 0, na unidade de floor.
frozen_turbining[].dropped_floors[].reasonstringNão—"no_capacity" (a usina ou o grupo de unidades não tem capacidade de turbinamento no patamar) ou "commissioning" (a usina está em pré-enchimento ou em fase de enchimento no estágio).

dropped_floors é ordenado por stage_id, block_id, level, hydro_unit_group_id e, por fim, floor. Um registro "plant" aparece onde o mínimo da própria usina é positivo e a usina não pode produzir no patamar; um registro "unit_group" aparece onde o mínimo do grupo é positivo e a usina não pode produzir ali, ou o próprio grupo não tem capacidade.


Coeficientes dos hiperplanos da FPHA ajustados para toda hidrelétrica cujo ajuste calculado produziu planos na execução corrente, com linhas apenas para os estágios que selecionam a FPHA; uma usina sem capacidade de turbinamento (uma usina com FPHA calculada, ou com FPHA pré-calculada sem linhas de hiperplanos) não tem nenhuma. O esquema é idêntico ao do arquivo de entrada system/fpha_hyperplanes.parquet: 11 colunas, todas com os mesmos nomes, tipos e anulabilidade.

Metodologia: Modelos de função de produção hidrelétrica

NomeTipoAnulávelUnidadeDescrição
hydro_idInt32Não—ID da usina hidrelétrica
stage_idInt32Sim—Estágio ao qual o plano se aplica. null = válido para todos os estágios
plane_idInt32Não—Índice do plano dentro desta hidrelétrica (e estágio)
gamma_0Float64NãoMWTermo independente (MW), sem escalonamento
gamma_vFloat64NãoMW/hm³Coeficiente de volume (MW/hm³)
gamma_qFloat64NãoMW/(m³/s)Coeficiente de vazão turbinada (MW por m³/s)
gamma_sFloat64NãoMW/(m³/s)Coeficiente de vertimento (MW por m³/s)
kappaFloat64Sim—Fator de correção. Assume 1.0 quando ausente ou nulo.
valid_v_min_hm3Float64Simhm³Mínimo da faixa de volume em que este plano é válido (hm³)
valid_v_max_hm3Float64Simhm³Máximo da faixa de volume em que este plano é válido (hm³)
valid_q_max_m3sFloat64Simm³/sVazão turbinada máxima em que este plano é válido (m³/s)

Em um arquivo gravado, toda linha tem stage_id e kappa igual a 1.0; as três colunas valid_* são null. O arquivo é gravado de forma atômica (por meio de renomeação de um .tmp), com as linhas na ordem canônica das hidrelétricas e, em seguida, na ordem de estágio e de plano; o carregador de entrada as ordena por (hydro_id, stage_id, plane_id). Ele pode ser usado diretamente como uma futura entrada source: "precomputed", copiando-o para system/fpha_hyperplanes.parquet. Uma usina sem capacidade de turbinamento (uma usina com FPHA calculada, ou com FPHA pré-calculada sem linhas de hiperplanos) não tem linhas no arquivo e não precisa de nenhuma: copiado para system/, o arquivo recarrega o ajuste tal como está, e a usina volta a ser resolvida com produtibilidade zero, listada em no_turbine_capacity; toda outra usina com FPHA precisa de linhas.

Veja Arquivos de modelos de produção — system/fpha_hyperplanes.parquet para as definições completas das colunas e as restrições de validade.


Gravado quando alguma usina hidrelétrica tem modelo de evaporação. Contém os coeficientes de evaporação ajustados para todas as usinas que têm evaporação, indexados por (hydro_id, stage_id). As linhas com stage_id = null são os valores padrão por hidrelétrica.

Metodologia: Formulação do PL

Seis colunas:

NomeTipoAnulávelUnidadeDescrição
hydro_idInt32Não—Identificador da usina hidrelétrica
stage_idInt32Sim—Estágio; null = valor padrão da hidrelétrica, aplicável a todos os estágios
intercept_m3sFloat64Nãom³/sTermo independente da evaporação (m³/s)
volume_slope_m3s_per_hm3Float64Não(m³/s)/hm³Coeficiente angular em relação ao volume (m³/s por hm³)
reference_volume_hm3Float64Nãohm³Volume de referência usado na linearização (hm³)
sourceUtf8Não—Rótulo de origem do cálculo (p. ex., "default_midpoint" ou "user_supplied")

Gravado apenas quando exports.fpha_deviation_points: true está definido no config.json. Contém uma linha por ponto da grade (hydro, stage, V, Q) com vertimento = 0, registrando quão bem o conjunto de planos da FPHA ajustado aproxima a função de produção exata em cada ponto amostral. É opcional porque pode ser grande (uma linha por combinação de pontos da grade para cada estágio com FPHA de uma usina com FPHA calculada; um estágio dessa usina que usa outro modelo de produção não tem linhas).

Metodologia: Modelos de função de produção hidrelétrica

Oito colunas:

NomeTipoAnulávelUnidadeDescrição
hydro_idInt32Não—Identificador da usina hidrelétrica
stage_idInt32Sim—Estágio. Anulável no esquema; sempre preenchido na saída gravada.
vFloat64Nãohm³Ponto amostral de volume (hm³)
qFloat64Nãom³/sPonto amostral de vazão turbinada (m³/s)
fph_exactFloat64NãoMWValor da função de produção exata neste ponto (V, Q), limitado ao max_generation_mw da usina (MW)
fpha_fittedFloat64NãoMWAproximação FPHA ajustada neste ponto (V, Q) (MW)
deviationFloat64NãoMWResíduo com sinal fpha_fitted − fph_exact (MW); positivo = envoltória ajustada acima da superfície exata
relativeFloat64Não—|deviation| relativo à geração exata máxima da grade (adimensional, ≥ 0); 0 quando o máximo da grade ≤ 0

Os valores são uma função pura da geometria e da configuração — o arquivo é reproduzível quando emitido e nunca entra no hash de paridade.