Pular para o conteúdo

Arquivos de modelos de produção

Estes cinco arquivos, todos em system/, contêm as tabelas e configurações por usina que sustentam a geração hidrelétrica: geometria do reservatório, o modelo de produção usado em cada estágio, sobrescritas de produtibilidade energética, hiperplanos da FPHA pré-calculados e curvas de nível do canal de fuga. Cada linha ou entrada identifica uma usina de system/hydros.json por hydro_id. O Resumo dos arquivos associa cada arquivo do caso à sua página.


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

Curvas cota-área-volume (VHA) dos reservatórios das usinas hidrelétricas. Obrigatório para uma usina com FPHA calculada (source: "computed") e para uma usina que declara coeficientes de evaporation. Quando o arquivo contém alguma linha, toda usina com FPHA precisa de pelo menos 1 linha própria.

A tabela também é lida pelo avaliador da média na faixa útil (Modelos de função de produção hidrelétrica §4.3) para qualquer usina hidrelétrica, seja qual for seu modelo de geração, que tenha produtibilidade específica (o campo de entidade em system/hydros.json ou uma sobrescrita em system/hydro_energy_productivity.parquet). Para essa usina, uma tabela que não pode ser construída, ou uma queda equivalente média não positiva em um estágio sem valor de integrated_equivalent_productivity_mw_per_m3s em system/hydro_energy_productivity.parquet, faz o caso ser rejeitado em novomodelo validate (veja GenericConstraintValidationError). Elabore a tabela de modo que cubra de reservoir.min_storage_hm3 a reservoir.max_storage_hm3: quando a tabela é mais estreita, a média é calculada sobre a extensão da própria tabela.

4 colunas, todas não anuláveis; as linhas podem aparecer em qualquer ordem. As várias linhas de um mesmo hydro_id constituem, em conjunto, a curva VHA dessa usina.

NomeTipoObrigatórioPadrãoUnidadeDescrição
hydro_idInt32Sim——ID da usina hidrelétrica
volume_hm3Float64Sim—hm³Volume total do reservatório neste ponto (hm³). Não negativo e finito.
height_mFloat64Sim—mCota da superfície do reservatório para este volume (m). Não negativa e finita.
area_km2Float64Sim—km²Área do espelho d’água para este volume (km²). Não negativa e finita.

Validação: as quatro colunas devem estar presentes com os tipos corretos. volume_hm3, height_m e area_km2 devem ser não negativos e finitos. Em cada usina, volume_hm3 deve ser estritamente crescente, e height_m e area_km2, não decrescentes, cada um dentro de uma tolerância relativa.


Metodologia: Modelos de função de produção hidrelétrica · §2.8 Redução de hiperplanos semelhantes

Atribuição da função de produção por usina hidrelétrica. O arquivo precisa de uma entrada para cada usina cujo generation.model em system/hydros.json seja "fpha". Para qualquer outra usina, cada estágio do estudo obtém sua produtibilidade de exatamente uma fonte: productivity_mw_per_m3s aqui ou equivalent_productivity_mw_per_m3s em system/hydro_energy_productivity.parquet; assim, uma usina cuja produtibilidade é fornecida pelo arquivo Parquet para todos os estágios do estudo não precisa de entrada.

O arquivo contém um array "production_models". Cada entrada configura uma usina hidrelétrica e é identificada por um hydro_id único. Os resultados são carregados em ordem crescente de hydro_id, independentemente da ordem de declaração.

Estrutura de nível superior:

{
"$schema": "https://docs.modelossetoreletrico.org.br/schemas/production_models.schema.json",
"production_models": [ ... ]
}

fpha_plane_reduction (bloco opcional de nível superior). Irmão do array production_models — e não um campo por usina —, que reduz o conjunto de hiperplanos da FPHA calculada após o ajuste. Quando a chave está ausente, nenhuma redução é aplicada (desativado por padrão). É um objeto rotulado pela chave method; campos desconhecidos são rejeitados, de modo que um campo de tolerância pertencente ao outro método é rejeitado.

NomeTipoObrigatórioPadrãoUnidadeDescrição
fpha_plane_reductionobject | nullNão——Bloco opcional que reduz o conjunto de hiperplanos da FPHA calculada após o ajuste; ausente significa que nenhuma redução é aplicada.
fpha_plane_reduction.methodstringSim——Um de "angle", "distance". A string literal "angle" usa tolerance_deg; a string literal "distance" usa tolerance_pct e n_samples.
fpha_plane_reduction.tolerance_degnumberCondicional—°Obrigatório quando method é "angle". Tolerância de fusão em graus; finita e em [0.0, 90.0].
fpha_plane_reduction.tolerance_pctnumberCondicional—%Obrigatório quando method é "distance". Tolerância de distância (percentual); finita, >= 0.0.
fpha_plane_reduction.n_samplesintegerCondicional——Obrigatório quando method é "distance". Número de amostras; inteiro >= 1.
{
"production_models": [ ... ],
"fpha_plane_reduction": { "method": "angle", "tolerance_deg": 5.0 }
}

A forma distance é { "method": "distance", "tolerance_pct": 0.5, "n_samples": 64 }.

Campos de cada entrada por usina:

NomeTipoObrigatórioPadrãoUnidadeDescrição
production_models[].hydro_idintegerSim——ID da usina hidrelétrica. Deve ser único no arquivo.
production_models[].selection_modestringSim——Um de "stage_ranges", "seasonal". Como a variante do modelo é escolhida em cada estágio.

Modo stage_ranges. O modelo de cada estágio é determinado pelo primeiro intervalo [start_stage_id, end_stage_id] correspondente. end_stage_id pode ser null para indicar “até o fim do horizonte”.

NomeTipoObrigatórioPadrãoUnidadeDescrição
production_models[].stage_rangesarrayCondicional——Obrigatório quando selection_mode é "stage_ranges". Uma entrada por intervalo de estágios.
production_models[].stage_ranges[].start_stage_idintegerSim——Primeiro estágio (inclusive) ao qual esta entrada se aplica
production_models[].stage_ranges[].end_stage_idinteger | nullNão——Último estágio (inclusive); null ou ausente significa intervalo em aberto
production_models[].stage_ranges[].modelstringSim——Um de "constant_productivity", "fpha"; qualquer outro nome é rejeitado na carga
production_models[].stage_ranges[].fpha_configobject | nullNão——Fonte e configurações de ajuste de uma entrada "fpha"; veja os campos de configuração da FPHA abaixo. Em uma usina sem nenhuma entrada source: "computed", uma entrada "fpha" sem este campo lê as linhas de system/fpha_hyperplanes.parquet, como faz source: "precomputed"; em uma usina com alguma entrada desse tipo, é rejeitada (veja abaixo).
production_models[].stage_ranges[].reference_volumeobject | nullNão——Volume operativo de referência V_ref, irmão de fpha_config (não aninhado). Defina exatamente um entre volume_hm3 (absoluto, hm³, > 0.0) e percentile (fração da faixa operativa, [0.0, 1.0]); ambos ou nenhum é rejeitado. Ausente ⇒ a fração padrão válida para todo o caso. Aplica-se a qualquer usina, em qualquer modo de seleção. Veja os campos de volume de referência abaixo.
production_models[].stage_ranges[].productivity_mw_per_m3snumber | nullNão—MW/(m³/s)Finito e >= 0 quando presente (0 indica um estágio de indisponibilidade programada); rejeitado em "fpha". Opcional para constant_productivity — quando omitido, forneça o valor via system/hydro_energy_productivity.parquet. É exigida exatamente uma fonte por (hydro, stage); informar ambas é rejeitado na carga.

Modo seasonal. O modelo de um estágio é determinado por seu season_id. Os estágios cujo período sazonal não está listado usam default_model.

NomeTipoObrigatórioPadrãoUnidadeDescrição
production_models[].default_modelstringCondicional——Um de "constant_productivity", "fpha". Obrigatório quando selection_mode é "seasonal". Modelo substituto para os períodos sazonais não listados; não tem fpha_config
production_models[].seasonsarrayCondicional——Obrigatório quando selection_mode é "seasonal". Array de sobrescritas por período sazonal: season_id, model e, opcionalmente, fpha_config, reference_volume, productivity_mw_per_m3s

Campos de cada entrada production_models[].seasons[]:

NomeTipoObrigatórioPadrãoUnidadeDescrição
production_models[].seasons[].season_idintegerSim——Índice do período sazonal (a partir de 0, correspondente ao mapa de períodos sazonais de stages.json).
production_models[].seasons[].modelstringSim——Um de "constant_productivity", "fpha"; qualquer outro nome é rejeitado na carga
production_models[].seasons[].fpha_configobject | nullNão——Como production_models[].stage_ranges[].fpha_config.
production_models[].seasons[].fpha_config.sourcestringSim——Como production_models[].stage_ranges[].fpha_config.source.
production_models[].seasons[].fpha_config.volume_discretization_pointsinteger | nullNão——Como production_models[].stage_ranges[].fpha_config.volume_discretization_points.
production_models[].seasons[].fpha_config.turbine_discretization_pointsinteger | nullNão——Como production_models[].stage_ranges[].fpha_config.turbine_discretization_points.
production_models[].seasons[].fpha_config.spillage_discretization_pointsinteger | nullNão——Como production_models[].stage_ranges[].fpha_config.spillage_discretization_points.
production_models[].seasons[].fpha_config.max_planes_per_hydrointeger | nullNão——Como production_models[].stage_ranges[].fpha_config.max_planes_per_hydro.
production_models[].seasons[].fpha_config.fitting_windowobject | nullNão——Como production_models[].stage_ranges[].fpha_config.fitting_window.
production_models[].seasons[].fpha_config.turbined_fit_max_m3snumber | nullNão—m³/sComo production_models[].stage_ranges[].fpha_config.turbined_fit_max_m3s.
production_models[].seasons[].fpha_config.spillage_fit_max_m3snumber | nullNão—m³/sComo production_models[].stage_ranges[].fpha_config.spillage_fit_max_m3s.
production_models[].seasons[].fpha_config.fitting_window.volume_min_hm3number | nullNão—hm³Como production_models[].stage_ranges[].fpha_config.fitting_window.volume_min_hm3.
production_models[].seasons[].fpha_config.fitting_window.volume_max_hm3number | nullNão—hm³Como production_models[].stage_ranges[].fpha_config.fitting_window.volume_max_hm3.
production_models[].seasons[].fpha_config.fitting_window.volume_min_percentilenumber | nullNão——Como production_models[].stage_ranges[].fpha_config.fitting_window.volume_min_percentile.
production_models[].seasons[].fpha_config.fitting_window.volume_max_percentilenumber | nullNão——Como production_models[].stage_ranges[].fpha_config.fitting_window.volume_max_percentile.
production_models[].seasons[].reference_volumeobject | nullNão——Como production_models[].stage_ranges[].reference_volume.
production_models[].seasons[].reference_volume.volume_hm3number | nullNão—hm³Como production_models[].stage_ranges[].reference_volume.volume_hm3.
production_models[].seasons[].reference_volume.percentilenumber | nullNão——Como production_models[].stage_ranges[].reference_volume.percentile.
production_models[].seasons[].productivity_mw_per_m3snumber | nullNão—MW/(m³/s)Como production_models[].stage_ranges[].productivity_mw_per_m3s.

Campos de reference_volume (irmão opcional de fpha_config):

NomeTipoObrigatórioPadrãoUnidadeDescrição
production_models[].stage_ranges[].reference_volume.volume_hm3number | nullNão—hm³Volume de referência absoluto [hm³]; finito e > 0.0. Mutuamente exclusivo com percentile.
production_models[].stage_ranges[].reference_volume.percentilenumber | nullNão——Volume de referência como fração da faixa [V_min, V_max]; finito e em [0.0, 1.0]. Mutuamente exclusivo com volume_hm3.

O volume operativo de referência V_ref alimenta o nível de remanso da FPHA (nível de montante do reservatório de jusante) e a produtibilidade equivalente energética ρ_eq. É a fonte única de V_ref: quando ausente, usa-se a fração padrão válida para todo o caso.

Campos de fpha_config:

NomeTipoObrigatórioPadrãoUnidadeDescrição
production_models[].stage_ranges[].fpha_config.sourcestringSim——"precomputed" ou "computed"
production_models[].stage_ranges[].fpha_config.volume_discretization_pointsinteger | nullNão——Número de pontos da grade de volume, no mínimo 2; 1, ou uma faixa de volume de ajuste reduzida a um único ponto, seleciona o ajuste com volume único (fio d’água); ausente ou null usa 5
production_models[].stage_ranges[].fpha_config.turbine_discretization_pointsinteger | nullNão——Número de pontos da grade de vazão turbinada; no mínimo 2; ausente ou null usa 5
production_models[].stage_ranges[].fpha_config.spillage_discretization_pointsinteger | nullNão——Validado (>= 2); não acrescenta um eixo de vertimento ao ajuste — aceito para preservar a entrada em ida e volta (veja Modelos de função de produção hidrelétrica — Configurar); ausente ou null usa 5
production_models[].stage_ranges[].fpha_config.max_planes_per_hydrointeger | nullNão——Validado (>= 1); o ajuste mantém todas as facetas da envoltória superior e não as reduz a esse número; apenas fpha_plane_reduction reduz o conjunto (veja Modelos de função de produção hidrelétrica — Configurar); ausente ou null usa 10
production_models[].stage_ranges[].fpha_config.fitting_windowobject | nullNão——Restrição da faixa de volume para o cálculo dos hiperplanos; ausente ou null usa a faixa de armazenamento da usina, de min_storage_hm3 a max_storage_hm3, e cada limite definido é restrito a ela
production_models[].stage_ranges[].fpha_config.turbined_fit_max_m3snumber | nullNão—m³/sExtremo superior da faixa de vazão turbinada que um ajuste a partir da geometria amostra, a partir de 0; finito e > 0.0, caso contrário é rejeitado na carga; ausente ou null usa o max_turbined_m3s da usina
production_models[].stage_ranges[].fpha_config.spillage_fit_max_m3snumber | nullNão—m³/sExtremo superior da faixa de vertimento sobre a qual um ajuste a partir da geometria lê o coeficiente de vertimento de cada plano, a partir de 0; finito e > 0.0, caso contrário é rejeitado na carga; ausente ou null usa o dobro da média dos valores da usina em scenarios/inflow_history.parquet, ou o dobro de seu max_turbined_m3s quando essa média não é positiva ou a usina não tem histórico

source: "precomputed" significa que os hiperplanos são carregados de system/fpha_hyperplanes.parquet. source: "computed" significa que o Novo Modelo os deriva de system/hydro_geometry.parquet; nesse caso, hydro_geometry.parquet deve estar presente, e os planos calculados são gravados automaticamente em output/hydro_models/fpha_hyperplanes.parquet.

Uma usina com alguma entrada source: "computed" ajusta planos a partir de sua geometria em todo estágio cuja entrada selecione "fpha"; portanto, cada um desses estágios deve corresponder a uma entrada que tenha fpha_config. Uma entrada "fpha" sem ele, um período sazonal deixado a um default_model igual a "fpha" ou um estágio não coberto por nenhuma entrada é rejeitado na preparação do caso. Um estágio cuja entrada seleciona "constant_productivity" não tem planos, de modo que a usina pode usar FPHA calculada em alguns estágios e produtibilidade constante em outros — por exemplo, um productivity_mw_per_m3s igual a 0 em um estágio de indisponibilidade programada. Em uma usina com alguma entrada source: "computed", toda entrada "fpha" é ajustada a partir da geometria, qualquer que seja seu source, e as linhas de system/fpha_hyperplanes.parquet dessa usina não são lidas.

As faixas de ajuste turbined_fit_max_m3s e spillage_fit_max_m3s só são lidas quando os planos da usina são ajustados a partir da geometria; em uma usina sem nenhuma entrada source: "computed", são validadas e, de resto, ignoradas. Um turbined_fit_max_m3s pode ficar abaixo ou acima do max_turbined_m3s da usina: ele define apenas o eixo de vazão da grade de ajuste, e os limites de vazão turbinada do PL continuam sendo os da própria usina. O valor substituto do vertimento lê o max_turbined_m3s da usina, nunca turbined_fit_max_m3s (Modelos de função de produção hidrelétrica §2.6.1 e §2.7).

Campos de fitting_window. Os limites absolutos (volume_min_hm3, volume_max_hm3) e os limites percentuais (volume_min_percentile, volume_max_percentile) são mutuamente exclusivos para cada limite — defina no máximo um entre volume_min_hm3 e volume_min_percentile, e no máximo um entre volume_max_hm3 e volume_max_percentile.

NomeTipoObrigatórioPadrãoUnidadeDescrição
production_models[].stage_ranges[].fpha_config.fitting_window.volume_min_hm3number | nullNão—hm³Volume mínimo explícito para o ajuste (hm³)
production_models[].stage_ranges[].fpha_config.fitting_window.volume_max_hm3number | nullNão—hm³Volume máximo explícito para o ajuste (hm³)
production_models[].stage_ranges[].fpha_config.fitting_window.volume_min_percentilenumber | nullNão——Mínimo como fração (0–1) da faixa de armazenamento da usina, medida a partir de min_storage_hm3
production_models[].stage_ranges[].fpha_config.fitting_window.volume_max_percentilenumber | nullNão——Máximo como fração (0–1) da faixa de armazenamento da usina, medida a partir de min_storage_hm3

Exemplo — a usina 0 usa FPHA calculada nos estágios 0–24 e FPHA calculada em uma grade mais fina a partir do estágio 25:

{
"$schema": "https://docs.modelossetoreletrico.org.br/schemas/production_models.schema.json",
"production_models": [
{
"hydro_id": 0,
"selection_mode": "stage_ranges",
"stage_ranges": [
{
"start_stage_id": 0,
"end_stage_id": 24,
"model": "fpha",
"fpha_config": {
"source": "computed",
"volume_discretization_points": 7,
"turbine_discretization_points": 15
}
},
{
"start_stage_id": 25,
"end_stage_id": null,
"model": "fpha",
"fpha_config": {
"source": "computed",
"volume_discretization_points": 11,
"turbine_discretization_points": 21
}
}
]
}
]
}

Exemplo — a usina 5 usa FPHA no período sazonal 0 e produtibilidade constante em todos os demais períodos sazonais:

{
"production_models": [
{
"hydro_id": 5,
"selection_mode": "seasonal",
"default_model": "constant_productivity",
"seasons": [
{
"season_id": 0,
"model": "fpha",
"fpha_config": { "source": "precomputed" }
}
]
}
]
}

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

Sobrescritas opcionais, por usina e por estágio, para a camada de pré-processamento da conversão energética. Linhas com stage_id = NULL atuam como padrões por usina e se aplicam a todos os estágios não cobertos por uma linha específica de estágio. Cada coluna de sobrescrita atinge um conjunto diferente de consumidores:

  • equivalent_productivity_mw_per_m3s — substitui integralmente a ρ_eq do ponto de referência e, portanto, os rótulos calculados equivalent_productivity e accumulated_productivity e a coluna de saída da simulação equivalent_productivity_mw_per_m3s. Ela só atinge o valor médio na faixa útil para uma usina que não tem média própria a integrar (passo 3 da ordem de resolução): uma usina com geometria VHA e produtibilidade específica integra sua média mesmo quando esta coluna está definida.
  • integrated_equivalent_productivity_mw_per_m3s — define integralmente a produtibilidade média na faixa útil ρ̄_eq da própria usina para o estágio, para qualquer modelo de geração, e, portanto, a soma na cascata, os rótulos calculados integrated_equivalent_productivity / integrated_accumulated_productivity e max_stored_energy, as colunas de saída da simulação integrated_* e stored_energy_*. Use-a quando a convenção de energia armazenada do caso for diferente da integração da geometria da usina sobre sua faixa física.
  • specific_productivity_mw_per_m3s_per_m — a ρ_esp que multiplica a queda líquida na ρ_eq derivada da queda em ambos os avaliadores (o valor no ponto de referência de uma usina com FPHA; o valor médio na faixa útil de qualquer usina com geometria VHA) e o rótulo calculado specific_productivity. É resolvida por (hydro, stage) na ordem: linha específica do estágio → linha com stage_id = NULL → o specific_productivity_mw_per_m3s_per_m da entidade em system/hydros.json.
  • reference_outflow_m3s — atinge apenas o rótulo calculado reference_turbine. Não altera a queda líquida: os dois avaliadores sempre avaliam a queda no max_turbined_m3s da usina.
NomeTipoObrigatórioPadrãoUnidadeDescrição
hydro_idInt32Sim——Identificador da usina hidrelétrica
stage_idInt32 (anulável)Sim——Estágio; NULL significa “aplica-se a todos os estágios”
equivalent_productivity_mw_per_m3sFloat64 (anulável)Sim—MW/(m³/s)Sobrescrita direta de ρ_eq [MW/(m³/s)]; finita e >= 0.0 (0.0 indica indisponibilidade programada em um estágio que não usa o modelo "fpha")
reference_outflow_m3sFloat64 (anulável)Sim—m³/sSobrescrita de Q_ref [m³/s]; finita e >= 0.0
specific_productivity_mw_per_m3s_per_mFloat64 (anulável)Sim—MW/(m³/s)/mSobrescrita de ρ_esp [MW/(m³/s)/m]; finita e >= 0.0 (0.0 é aceito e anula a produtibilidade equivalente derivada da queda)
integrated_equivalent_productivity_mw_per_m3sFloat64 (anulável)Sim—MW/(m³/s)Sobrescrita da média na faixa útil ρ̄_eq [MW/(m³/s)]; finita e >= 0.0; NULL significa sem sobrescrita

Validação:

  • As seis colunas devem estar presentes; um arquivo sem qualquer uma delas é rejeitado. Uma coluna pode ser NULL em todas as linhas.
  • hydro_id não pode ser nulo.
  • equivalent_productivity_mw_per_m3s, quando definida, deve ser finita e >= 0.0; 0.0 é aceito; em um estágio que não usa o modelo "fpha", indica indisponibilidade programada.
  • reference_outflow_m3s, quando definida, deve ser finita e >= 0.0.
  • specific_productivity_mw_per_m3s_per_m, quando definida, deve ser finita e >= 0.0; 0.0 é aceito; anula a produtibilidade equivalente derivada da queda e não é um indicador de indisponibilidade programada.
  • integrated_equivalent_productivity_mw_per_m3s, quando definida, deve ser finita e >= 0.0.
  • Uma linha em que as quatro colunas de sobrescrita são NULL é aceita.
  • Pares (hydro_id, stage_id) duplicados são rejeitados na montagem do caso.
  • O volume operativo de referência V_ref é declarado por (plant, stage) por reference_volume em system/hydro_production_models.json; uma coluna reference_volume_hm3 neste arquivo é recusada na carga com a instrução de declarar reference_volume lá (Coluna Parquet desconhecida).

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

Coeficientes pré-calculados dos hiperplanos da FPHA para usinas configuradas com fpha_config.source: "precomputed". Quando ausente, apenas a fonte "computed" está disponível.

11 colunas; as linhas podem aparecer em qualquer ordem. Um stage_id nulo significa que o plano vale para todos os estágios da usina. Uma linha por hiperplano; é exigido pelo menos 1 plano por grupo (hydro_id, stage_id).

NomeTipoObrigatórioPadrãoUnidadeDescrição
hydro_idInt32Sim——ID da usina hidrelétrica
stage_idInt32 (anulável)Não——Estágio ao qual o plano se aplica. null = vale para todos os estágios
plane_idInt32Sim——Índice do plano dentro desta usina (e estágio)
gamma_0Float64Sim—MWCoeficiente independente (MW)
gamma_vFloat64Sim—MW/hm³Coeficiente de volume (MW/hm³). >= 0 (0 para uma usina a fio d’água).
gamma_qFloat64Sim—MW/(m³/s)Coeficiente de vazão turbinada (MW por m³/s). >= 0; os planos de cada estágio precisam de pelo menos um com > 0.
gamma_sFloat64Sim—MW/(m³/s)Coeficiente de vertimento (MW por m³/s). <= 0.
kappaFloat64 (anulável)Não1.0—Fator de correção aplicado apenas ao termo independente (gamma_0 é multiplicado por ele) em (0, 1]; padrão 1.0 quando ausente ou nulo.
valid_v_min_hm3Float64 (anulável)Não—hm³Mínimo da faixa de volume em que este plano é válido (hm³)
valid_v_max_hm3Float64 (anulável)Não—hm³Máximo da faixa de volume em que este plano é válido (hm³)
valid_q_max_m3sFloat64 (anulável)Não—m³/sVazão turbinada máxima em que este plano é válido (m³/s)

Validação: as colunas obrigatórias (hydro_id, plane_id, gamma_0, gamma_v, gamma_q, gamma_s) devem estar presentes com os tipos corretos. As colunas opcionais presentes também devem ter os tipos corretos. Toda linha deve ter gamma_v >= 0 e gamma_s <= 0 na carga e, uma vez que o arquivo contenha alguma linha, toda usina com FPHA que tenha capacidade de turbinamento, inclusive as com FPHA calculada, precisa de linhas nele (o ajuste calculado não as lê). Cada estágio em que uma usina opera com FPHA pré-calculada usa as linhas com seu stage_id ou, na falta delas, as linhas válidas para todos os estágios (stage_id nulo), e deve ter umas ou outras; cada linha usada por um estágio deve ter gamma_q >= 0 e kappa em (0, 1], com pelo menos uma com gamma_q > 0, na preparação do estudo. Um plano usado por um estágio com FPHA pré-calculada que fica abaixo de 0 MW com vazão turbinada nula, no armazenamento mínimo da janela de ajuste e no extremo superior da faixa de ajuste do vertimento, é aceito com um aviso de ModelQuality.

O arquivo produzido em output/hydro_models/fpha_hyperplanes.parquet (gravado quando se usa source: "computed") tem exatamente o mesmo esquema de 11 colunas. Ele é carregado sem edição como entrada pré-calculada: seu plano de teto horizontal (gamma_q = 0) é aceito, e uma usina sem capacidade de turbinamento não precisa de linhas.


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

Curvas opcionais de nível do canal de fuga, quárticas por partes, que substituem o modelo de canal de fuga no nível da entidade para qualquer usina que tenha linhas neste arquivo. Quando uma usina tem linhas aqui, o processo de cálculo da FPHA avalia seu nível de jusante a partir dessas curvas quárticas por partes — selecionando o segmento pela vazão defluente e interpolando entre as famílias de remanso no nível de referência do estágio da usina de jusante — em vez do modelo de canal de fuga declarado em hydros.json. As usinas sem linhas neste arquivo mantêm seu modelo de canal de fuga; o arquivo é inerte (ignorado silenciosamente) quando ausente do diretório do caso.

As linhas podem aparecer em qualquer ordem. Uma curva completa de uma família de remanso é formada por várias linhas que compartilham (hydro_id, family_id).

NomeTipoObrigatórioPadrãoUnidadeDescrição
hydro_idInt32Sim——Usina cujo canal de fuga é descrito
family_idInt32Sim——Índice da família dentro da usina (chave de agrupamento sequencial)
downstream_reference_level_mFloat64 (anulável)Sim—mNível de referência do reservatório de jusante que identifica esta família (m). null quando a usina tem uma única família e não depende de remanso.
segment_idInt32Sim——Índice do trecho dentro da família
outflow_min_m3sFloat64Sim—m³/sLimite inferior de validade do segmento (m³/s). Não negativo.
outflow_max_m3sFloat64Sim—m³/sLimite superior de validade do segmento (m³/s). Não negativo, >= outflow_min_m3s.
coefficient_0Float64Sim——Coeficiente de grau 0 do polinômio. Qualquer sinal.
coefficient_1Float64Sim——Coeficiente de grau 1 do polinômio. Qualquer sinal.
coefficient_2Float64Sim——Coeficiente de grau 2 do polinômio. Qualquer sinal.
coefficient_3Float64Sim——Coeficiente de grau 3 do polinômio. Qualquer sinal.
coefficient_4Float64Sim——Coeficiente de grau 4 do polinômio. Qualquer sinal.

A quártica é avaliada como coefficient_0 + coefficient_1*x + coefficient_2*x² + coefficient_3*x³ + coefficient_4*x⁴, em que x é a vazão defluente em m³/s. Coeficientes de grau mais alto são frequentemente negativos nos dados de origem; todos os sinais são aceitos.

Regras de validação:

  • As onze colunas devem estar presentes com os tipos listados acima.
  • outflow_min_m3s e outflow_max_m3s devem ser não negativos e finitos.
  • outflow_max_m3s >= outflow_min_m3s (segmentos não invertidos).
  • coefficient_0 a coefficient_4 devem ser finitos.
  • downstream_reference_level_m, quando não nulo, deve ser não negativo e finito.