Cadastro de Hidrelétricas (hidr.dat)

O cadastro das usinas hidrelétricas do DESSEM é armazenado na classe:

class Hidr(data: Any = Ellipsis)

Armazena os dados de entrada do DESSEM referentes ao cadastro das usinas hidroelétricas.

Suporta os dois formatos do arquivo binário: o formato com registros de 792 bytes (coeficientes dos polinômios volume-cota e cota-área em 32 bits) e o formato com registros de 832 bytes (coeficientes em 64 bits). Na leitura, o formato é detectado automaticamente pelo tamanho do arquivo, que corresponde a 320 ou 600 registros em um dos dois tamanhos, podendo ser forçado com version="f32" ou version="f64". A escrita é feita sempre no mesmo formato lido, a menos que seja feita uma conversão explícita com converte_tamanho_registro().

property cadastro: DataFrame

Obtém a tabela com os dados cadastrais existentes no arquivo binário.

• nome_usina (str): nome da usina (12 caracteres)

• posto (int): posto de vazão natural da usina

• submercado (int): submercado da usina

• empresa (int): agente responsável pela usina

• codigo_usina_jusante (int): posto à jusante da usina

• desvio (float): TODO

• volume_minimo (float): volume mínimo da usina (hm3)

• volume_maximo (float): volume máximo da usina (hm3)

• volume_vertedouro (float): volume do vertedouro da usina (hm3)

• volume_desvio (float): TODO

• cota_minima (float): cota mínima da usina (m)

• cota_maxima (float): cota máxima da usina (m)

• a[0-4]_volume_cota (float): coeficientes do polinômio volume-cota

• a[0-4]_cota_area (float): coeficientes do polinômio cota-área

• evaporacao_[JAN..DEZ] (float): coeficientes de evaporação (mm)

• numero_conjuntos_maquinas (int): número de conjuntos de máquinas

• maquinas_conjunto_[1-5] (int): máquinas por conjunto

• potencia_nominal_conjunto_[1-5] (float): potência das máquinas (MWmed)

• queda_nominal_conjunto_[1-5]: alturas nominais de queda por conjunto (m)

• vazao_nominal_conjunto_[1-5]: vazões nominais por conjunto (m3/s)

• produtibilidade_especifica (float): produtibilidade específica

• perdas (float): perdas da usina

• numero_polinomios_jusante (int): número de polinômios de jusante

• a[0-4]_jusante_[1-6] (float): coeficientes de cada polinjus

• referencia_jusante_[1-6] (float): coeficientes do polinjus de referência

• canal_fuga_medio (float): cota média do canal de fuga (m)

• influencia_vertimento_canal_fuga (int): TODO (0 ou 1)

• fator_carga_maximo (float): TODO (%)

• fator_carga_minimo (float): TODO (%)

• vazao_minima_historica (float): vazão mínima da usina (m3/s)

• numero_unidades_base (int): TODO

• tipo_turbina (int): TODO

• representacao_conjunto (int): TODO

• teif (float): TODO (%)

• ip (float): TODO (%)

• tipo_perda (int): TODO

• data (str): DD-MM-AA

• observacao (str): observação qualquer sobre a usina

• volume_referencia (float): TODO (hm3)

• tipo_regulacao (str): D, S ou M

Retorna:

A tabela com os dados cadastrais

Tipo de retorno:

List[pd.DataFrame]

converte_tamanho_registro(precisao: str) → None

Converte os registros do arquivo para o formato com o tamanho de registro dado, de modo que a próxima escrita seja feita neste formato. A conversão de 832 para 792 bytes implica em perda de precisão nos coeficientes dos polinômios volume-cota e cota-área.

Parâmetros:

precisao – A precisão dos coeficientes dos polinômios (‘f32’ ou ‘f64’)

classmethod read(content: str | bytes, *args: Any, version: str | None = None, **kwargs: Any) → Hidr

Read from a file path or buffer. version selects a component set from VERSIONS without mutating the class.

property tamanho_registro: int

O tamanho em bytes dos registros do arquivo: 792 para o formato com coeficientes dos polinômios em 32 bits ou 832 para o formato em 64 bits.

Retorna:

O tamanho do registro em bytes

Tipo de retorno:

int