Dados das Usinas Hidrelétricas

As informações de usinas hidrelétricas no NEWAVE, localizadas no arquivos das LIBS que são indicados no indices.csv com as respectivas funcionalidades, são armazenados na classe:

class UsinasHidreletricas(data=<cfinterface.data.registerdata.RegisterData object>)[código fonte]

Armazena os dados de entrada do NEWAVE referentes aos dados das usinas hidrelétricas do problema.

estacao_bombeamento(codigo_estacao: int | None = None, nome_estacao: str | None = None, codigo_usina_origem: int | None = None, codigo_usina_destino: int | None = None, df: bool = False) → EstacaoBombeamento | List[EstacaoBombeamento] | DataFrame | None[código fonte]

Obtém registros que definem uma estação de bombeamento.

Parâmetros:

codigo_estacao (int | None) – código da estação associada

estacao_bombeamento_limites_periodo_patamar(codigo_estacao: int | None = None, data_inicio: datetime | None = None, data_fim: datetime | None = None, patamar: int | None = None, df: bool = False) → EstacaoBombeamentoLimitesPeriodoPatamar | List[EstacaoBombeamentoLimitesPeriodoPatamar] | DataFrame | None[código fonte]

Obtém registros que determinam os limites de bombeamento de uma estação por período e patamar.

Parâmetros:

  • codigo_estacao (int | None) – código da estação associada

  • data_inicio (datetime | None) – data de início da validade dos limites

  • data_fim (datetime | None) – data de fim da validade dos limites

  • patamar (int | None) – patamar de validade dos limites

estacao_bombeamento_submercado(codigo_estacao: int | None = None, codigo_submercado: int | None = None, df: bool = False) → EstacaoBombeamentoSubmercado | List[EstacaoBombeamentoSubmercado] | DataFrame | None[código fonte]

Obtém registros que relacionam estações de bombeamento e submercados.

Parâmetros:

  • codigo_estacao (int | None) – código da estação associada

  • codigo_submercado (int | None) – código do submercado associado

hidreletrica_curvajusante(codigo_usina: int | None = None, indice_familia: int | None = None, nivel_montante_referencia: float | None = None, df: bool = False) → HidreletricaCurvaJusante | List[HidreletricaCurvaJusante] | DataFrame | None[código fonte]

Obtém registros que cadastram uma família de curvas de jusante para uma usina hidrelétrica. Opcionalmente, o retorno pode ser transformado em um DataFrame, apenas para leitura das informações.

Parâmetros:

  • codigo_usina (int | None) – código que especifica a usina

  • indice_familia (int | None) – índice da família de polinômios

  • nivel_montante_referencia (float | None) – nível de montante de usina de jusante para cálculo da queda

  • df (bool) – ignorar os filtros e retornar todos os dados de registros como um DataFrame

Retorna:

Um ou mais registros, se existirem.

Tipo de retorno:

HidreletricaCurvaJusante | List[HidreletricaCurvaJusante] | None | DataFrame

hidreletrica_curvajusante_afogamentoexplicito_padrao(considera_afogamento: str | None = None, df: bool = False) → HidreletricaCurvaJusanteAfogamentoExplicitoPadrao | List[HidreletricaCurvaJusanteAfogamentoExplicitoPadrao] | DataFrame | None[código fonte]

Obtém registros que habilitam ou desabilitam a consideração do tratamento do afogamento explícito padrão.

Parâmetros:

considera_afogamento (str | None) – habilitação do afogamento

hidreletrica_curvajusante_afogamentoexplicito_usina(codigo_usina: int | None = None, considera_afogamento: str | None = None, df: bool = False) → HidreletricaCurvaJusanteAfogamentoExplicitoUsina | List[HidreletricaCurvaJusanteAfogamentoExplicitoUsina] | DataFrame | None[código fonte]

Obtém registros que habilitam ou desabilitam a consideração do tratamento do afogamento explícito por usina. Opcionalmente, o retorno pode ser transformado em um DataFrame, apenas para leitura das informações.

Parâmetros:

  • codigo_usina (int | None) – código que especifica a usina

  • considera_afogamento (str | None) – habilitação do afogamento

Retorna:

Um ou mais registros, se existirem.

Tipo de retorno:

HidreletricaCurvaJusante | List[HidreletricaCurvaJusante] | None | DataFrame

hidreletrica_curvajusante_polinomio(codigo_usina: int | None = None, indice_familia: int | None = None, numero_polinomios: int | None = None, df: bool = False) → HidreletricaCurvaJusantePolinomioPorPartes | List[HidreletricaCurvaJusantePolinomioPorPartes] | DataFrame | None[código fonte]

Obtém registros que cadastram uma família de curvas de jusante para uma usina hidrelétrica. Opcionalmente, o retorno pode ser transformado em um DataFrame, apenas para leitura das informações.

Parâmetros:

  • codigo_usina (int | None) – código que especifica a usina

  • indice_familia (int | None) – índice da família de polinômios

  • numero_polinomios (int | None) – número de polinômios da família

  • df (bool) – ignorar os filtros e retornar todos os dados de registros como um DataFrame

Retorna:

Um ou mais registros, se existirem.

Tipo de retorno:

HidreletricaCurvaJusantePolinomioPorPartes | List[HidreletricaCurvaJusantePolinomioPorPartes] | None | DataFrame

hidreletrica_curvajusante_polinomio_segmento(codigo_usina: int | None = None, indice_familia: int | None = None, indice_polinomio: int | None = None, limite_inferior_vazao_jusante: float | None = None, limite_superior_vazao_jusante: float | None = None, coeficiente_a0: float | None = None, coeficiente_a1: float | None = None, coeficiente_a2: float | None = None, coeficiente_a3: float | None = None, coeficiente_a4: float | None = None, df: bool = False) → HidreletricaCurvaJusantePolinomioPorPartesSegmento | List[HidreletricaCurvaJusantePolinomioPorPartesSegmento] | DataFrame | None[código fonte]

Obtém registros que cadastram os polinômios para cada família de curvas de jusante para uma usina hidrelétrica. Opcionalmente, o retorno pode ser transformado em um DataFrame, apenas para leitura das informações.

Parâmetros:

  • codigo_usina (int | None) – código que especifica a usina

  • indice_familia (int | None) – índice da família de polinômios

  • indice_polinomio (int | None) – índice do polinômio da família

  • limite_inferior_vazao_jusante (float | None) – limite inferior de vazão de jusante para janela de validade do polinômio

  • limite_superior_vazao_jusante (float | None) – limite superior de vazão de jusante para janela de validade do polinômio

  • coeficiente_a0 (float | None) – coeficiente de grau 0 do polinômio

  • coeficiente_a1 (float | None) – coeficiente de grau 1 do polinômio

  • coeficiente_a2 (float | None) – coeficiente de grau 2 do polinômio

  • coeficiente_a3 (float | None) – coeficiente de grau 3 do polinômio

  • coeficiente_a4 (float | None) – coeficiente de grau 4 do polinômio

  • df (bool) – ignorar os filtros e retornar todos os dados de registros como um DataFrame

Retorna:

Um ou mais registros, se existirem.

Tipo de retorno:

HidreletricaCurvaJusantePolinomioPorPartesSegmento | list[HidreletricaCurvaJusantePolinomioPorPartesSegmento] | None

hidreletrica_perda_hidraulica_grade(codigo_usina: int | None = None, df: bool = False) → HidreletricaPerdaHidraulicaGrade | List[HidreletricaPerdaHidraulicaGrade] | DataFrame | None[código fonte]

Obtém registros que determinam os valores de perda hidráulica de uma UHE em grade.

Parâmetros:

codigo_usina (int | None) – código da usina associada

hidreletrica_produtibilidade_especifica_grade(codigo_usina: int | None = None, df: bool = False) → HidreletricaProdutibilidadeEspecificaGrade | List[HidreletricaProdutibilidadeEspecificaGrade] | DataFrame | None[código fonte]

Obtém registros que determinam os valores de produtibilidade específica de uma UHE em grade.

Parâmetros:

codigo_usina (int | None) – código da usina associada

volume_referencial_periodo(codigo_usina: int | None = None, data_inicio: datetime | None = None, data_fim: datetime | None = None, df: bool = False) → VolumeReferencialPeriodo | List[VolumeReferencialPeriodo] | DataFrame | None[código fonte]

Obtém registros que definem o volume de referência por perídoo para cada usina hidrelétrica.

Parâmetros:

  • codigo_usina (int | None) – código da usina associada

  • data_inicio (datetime | None) – data de início da validade da referência

  • data_fim (datetime | None) – data de fim da validade da referência

volume_referencial_tipo_padrao(df: bool = False) → VolumeReferencialTipoPadrao | List[VolumeReferencialTipoPadrao] | DataFrame | None[código fonte]

Obtém registros que definem o tipo de volume de referência.

As informações existentes em cada um dos campos são armazenadas em modelos próprios para cada um.

class HidreletricaCurvaJusante(previous=None, next=None, data=None)[código fonte]
property codigo_usina: int | None

O código da usina hidrelétrica relacionada ao polinômio.

Retorna:

O código da usina

Tipo de retorno:

int | None

property indice_familia: int | None

O índice da família de polinômios.

Retorna:

O índice (sequencial).

Tipo de retorno:

int | None

property nivel_montante_referencia: float | None

O nível de montante da usina de jusante de referência.

Retorna:

O nível em metros

Tipo de retorno:

float | None

class HidreletricaCurvaJusantePolinomioPorPartes(previous=None, next=None, data=None)[código fonte]
property codigo_usina: int | None

O código da usina hidrelétrica relacionada ao polinômio.

Retorna:

O código da usina

Tipo de retorno:

int | None

property indice_familia: int | None

O índice da família de polinômios.

Retorna:

O índice (sequencial).

Tipo de retorno:

int | None

property numero_polinomios: int | None

O número de polinômios existentes na família.

Retorna:

O número de polinômios

Tipo de retorno:

int | None

class HidreletricaCurvaJusantePolinomioPorPartesSegmento(previous=None, next=None, data=None)[código fonte]
property codigo_usina: int | None

O código da usina hidrelétrica relacionada ao polinômio.

Retorna:

O código da usina

Tipo de retorno:

int | None

property coeficiente_a0: float | None

O coeficiente de grau 0 do polinômio.

Retorna:

O coeficiente de grau 0 do polinômio

Tipo de retorno:

float | None

property coeficiente_a1: float | None

O coeficiente de grau 1 do polinômio.

Retorna:

O coeficiente de grau 1 do polinômio

Tipo de retorno:

float | None

property coeficiente_a2: float | None

O coeficiente de grau 2 do polinômio.

Retorna:

O coeficiente de grau 2 do polinômio

Tipo de retorno:

float | None

property coeficiente_a3: float | None

O coeficiente de grau 3 do polinômio.

Retorna:

O coeficiente de grau 3 do polinômio

Tipo de retorno:

float | None

property coeficiente_a4: float | None

O coeficiente de grau 4 do polinômio.

Retorna:

O coeficiente de grau 4 do polinômio

Tipo de retorno:

float | None

property indice_familia: int | None

O índice da família de polinômios.

Retorna:

O índice (sequencial).

Tipo de retorno:

int | None

property indice_polinomio: int | None

O índice do polinômio da respectiva família.

Retorna:

O índice do polinômio

Tipo de retorno:

int | None

property limite_inferior_vazao_jusante: float | None

O limite inferior de vazão de jusante (defluência mais lateral) para janela de validade do polinômio.

Retorna:

O limite inferior de vazão de jusante

Tipo de retorno:

float | None

property limite_superior_vazao_jusante: float | None

O limite superior de vazão de jusante (defluência mais lateral) para janela de validade do polinômio.

Retorna:

O limite superior de vazão de jusante

Tipo de retorno:

float | None

class HidreletricaCurvaJusanteAfogamentoExplicitoUsina(previous=None, next=None, data=None)[código fonte]
property codigo_usina: int | None

O código da usina hidrelétrica relacionada ao polinômio.

Retorna:

O código da usina

Tipo de retorno:

int | None

property considera_afogamento: str | None

Habilitação do afogamento explícito.

Retorna:

O flag da habilitação.

Tipo de retorno:

str | None

class HidreletricaCurvaJusanteAfogamentoExplicitoPadrao(previous=None, next=None, data=None)[código fonte]
property considera_afogamento: str | None

Habilitação do afogamento explícito.

Retorna:

O flag da habilitação.

Tipo de retorno:

str | None

class EstacaoBombeamento(previous=None, next=None, data=None)[código fonte]
property bombeamento_maximo: float | None

O limite de capacidade de bombeamento da estação

Retorna:

O limite máximo

Tipo de retorno:

float | None

property codigo_estacao: int | None

O código da estação

Retorna:

O código da estação

Tipo de retorno:

int | None

property codigo_usina_destino: int | None

O código da usina de destino da estação.

Retorna:

O código da usina

Tipo de retorno:

int | None

property codigo_usina_origem: int | None

O código da usina de origem da estação.

Retorna:

O código da usina

Tipo de retorno:

int | None

property consumo_estacao: float | None

O consumo da estação de bomeamento

Retorna:

O consumo

Tipo de retorno:

float | None

property nome_estacao: str | None

O nome da estação de bomeamento

Retorna:

O nome como string.

Tipo de retorno:

str | None

class EstacaoBombeamentoSubmercado(previous=None, next=None, data=None)[código fonte]
property codigo_estacao: int | None

O código da estação

Retorna:

O código da estação

Tipo de retorno:

int | None

property codigo_submercado: int | None

O código do submercado da estação

Retorna:

O código do submercado

Tipo de retorno:

int | None

class EstacaoBombeamentoLimitesPeriodoPatamar(previous=None, next=None, data=None)[código fonte]

Registro que contém os limites de bombeamento de cada estação por período e patamar.

property codigo_estacao: int | None

O código da estação.

Retorna:

O código

Tipo de retorno:

int | None

property data_fim: datetime | None

A data de fim da validade dos limites da estação.

Retorna:

A data

Tipo de retorno:

datetime | None

property data_inicio: datetime | None

A data de início da validade dos limites da estação.

Retorna:

A data

Tipo de retorno:

datetime | None

property limite_inferior: float | None

O limite inferior para a estação.

Retorna:

O limite inferior

Tipo de retorno:

float | None

property limite_superior: float | None

O limite superior para a estação.

Retorna:

O limite superior

Tipo de retorno:

float | None

property patamar: int | None

O índice do patamar de validade dos limites.

Retorna:

O patamar

Tipo de retorno:

int | None

class HidreletricaProdutibilidadeEspecificaGrade(previous=None, next=None, data=None)[código fonte]
property altura_queda_liquida: float | None

A altura de queda líquida relativa à produbilidade.

Retorna:

A altura (m)

Tipo de retorno:

float | None

property codigo_usina: int | None

O código da usina

Retorna:

O código da usina

Tipo de retorno:

int | None

property produtibilidade_especifica: float | None

A produtibilidade específica da usina.

Retorna:

A produtibilidade em MW / (m^3/s / m)

Tipo de retorno:

float | None

property turbinamento: float | None

O turbinamento relativo à produtibilidade.

Retorna:

O turbinamento (m^3/s)

Tipo de retorno:

float | None

class HidreletricaPerdaHidraulicaGrade(previous=None, next=None, data=None)[código fonte]
property codigo_usina: int | None

O código da usina

Retorna:

O código da usina

Tipo de retorno:

int | None

property perda_hidraulica: float | None

A perda hidráulica em valores absolutos

Retorna:

A perda (m)

Tipo de retorno:

float | None

property turbinamento: float | None

O turbinamento relativo à produtibilidade.

Retorna:

O turbinamento (m^3/s)

Tipo de retorno:

float | None

class VolumeReferencialTipoPadrao(previous=None, next=None, data=None)[código fonte]
property tipo_referencia: int | None

O tipo de volume de referência adotado.

Retorna:

O tipo de volume

Tipo de retorno:

int | None

class VolumeReferencialPeriodo(previous=None, next=None, data=None)[código fonte]
property codigo_usina: int | None

O código da usina

Retorna:

O código

Tipo de retorno:

int | None

property data_fim: datetime | None

A data de fim da validade do volume de referência.

Retorna:

A data

Tipo de retorno:

datetime | None

property data_inicio: datetime | None

A data de início da validade do volume de referência.

Retorna:

A data

Tipo de retorno:

datetime | None

property volume_referencia: float | None

O volume de referência da usina.

Retorna:

O volume

Tipo de retorno:

float | None