inewave 1.7.4__tar.gz → 1.8.0__tar.gz

inewave-1.8.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.1
+Name: inewave
+Version: 1.8.0
+Summary: Interface para arquivos do NEWAVE
+Home-page: https://github.com/rjmalves/inewave
+Author: Rogerio Alves
+Author-email: rogerioalves.ee@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: cfinterface>=1.6.0
+
+# inewave
+
+![tests](https://github.com/rjmalves/inewave/workflows/tests/badge.svg)  
+[![codecov](https://codecov.io/gh/rjmalves/inewave/branch/main/graph/badge.svg?token=R9WPQHQGKF)](https://codecov.io/gh/rjmalves/inewave)
+
+O `inewave` é um pacote Python para manipulação dos arquivos de entrada e saída do programa [NEWAVE](http://www.cepel.br/pt_br/produtos/newave-modelo-de-planejamento-da-operacao-de-sistemas-hidrotermicos-interligados-de-longo-e-medio-prazo.htm). O NEWAVE é desenvolvido pelo [CEPEL](http://www.cepel.br) e utilizado para os estudos de planejamento e operação do Sistema Interligado Nacional (SIN).
+
+O inewave oferece:
+
+- Meios para leitura dos arquivos de entrada e saída do NEWAVE e programas associados: NWLISTCF e NWLISTOP
+
+- Facilidades para estudo e análise dos dados utilizando DataFrames do pandas
+
+- Dados estruturados em modelos com o uso do paradigma de orientação a objetos (OOP)
+
+
+## Instalação
+
+O inewave é compatível com versões de Python >= 3.8.
+
+É possível instalar a versão distribuída oficialmente com pip:
+
+```
+python -m pip install inewave
+```
+
+É possível realizar a instalação da versão de desenvolvimento fazendo o uso do Git.
+
+```
+pip install git+https://github.com/rjmalves/inewave
+```
+
+## Documentação
+
+Guias, tutoriais e as referências podem ser encontrados no site oficial do pacote: https://rjmalves.github.io/inewave

inewave-1.8.0/inewave/__init__.py

@@ -0,0 +1,13 @@
+"""
+inewave
+=======
+
+inewave é um módulo em Python para manipulação dos arquivos de entrada
+e saída do NEWAVE.
+"""
+
+__version__ = "1.8.0"
+
+from . import newave  # noqa
+from . import nwlistcf  # noqa
+from . import nwlistop  # noqa

inewave-1.8.0/inewave/newave/__init__.py

@@ -0,0 +1,74 @@
+# Inclui os membros
+
+# Deprecated
+from .avl_cortesfpha_nwv import AvlCortesFpha  # noqa
+from .avl_desvfpha_s import AvlDesvFphaS  # noqa
+from .avl_desvfpha_v_q import AvlDesvFphaVQ  # noqa
+from .eco_fpha import EcoFpha  # noqa
+from .nwv_avl_evap import NwvAvlEvap  # noqa
+from .nwv_cortes_evap import NwvCortesEvap  # noqa
+from .nwv_eco_evap import NwvEcoEvap  # noqa
+
+from .abertura import Abertura  # noqa
+from .adterm import Adterm  # noqa
+from .agrint import Agrint  # noqa
+from .arquivos import Arquivos  # noqa
+from .bid import BID  # noqa
+from .cadic import Cadic  # noqa
+from .caso import Caso  # noqa
+from .clasgas import Clasgas  # noqa
+from .clast import Clast  # noqa
+from .confhd import Confhd  # noqa
+from .conft import Conft  # noqa
+from .curva import Curva  # noqa
+from .cvar import Cvar  # noqa
+from .dger import Dger  # noqa
+from .dsvagua import Dsvagua  # noqa
+from .eafpast import Eafpast  # noqa
+from .elnino import ElNino  # noqa
+from .ensoaux import ENSOAux  # noqa
+from .exph import Exph  # noqa
+from .expt import Expt  # noqa
+from .gee import GEE  # noqa
+from .ghmin import Ghmin  # noqa
+from .gtminpat import Gtminpat  # noqa
+from .hidr import Hidr  # noqa
+from .itaipu import Itaipu  # noqa
+from .manutt import Manutt  # noqa
+from .modif import Modif  # noqa
+from .newavetim import Newavetim  # noqa
+from .parp import Parp  # noqa
+from .parpvaz import Parpvaz  # noqa
+from .parpeol import Parpeol  # noqa
+from .patamar import Patamar  # noqa
+from .penalid import Penalid  # noqa
+from .perda import Perda  # noqa
+from .pmo import Pmo  # noqa
+from .re import Re  # noqa
+from .ree import Ree  # noqa
+from .sar import Sar  # noqa
+from .shist import Shist  # noqa
+from .selcor import Selcor  # noqa
+from .sistema import Sistema  # noqa
+from .tecno import Tecno  # noqa
+from .term import Term  # noqa
+from .vazoes import Vazoes  # noqa
+from .vazpast import Vazpast  # noqa
+from .volref_saz import VolrefSaz  # noqa
+from .fpha_cortes import FphaCortes  # noqa
+from .fpha_avl_desv_s import FphaAvlDesvS  # noqa
+from .fpha_avl_desv_v_q import FphaAvlDesvVQ  # noqa
+from .fpha_eco import FphaEco  # noqa
+from .evap_avl_desv import EvapAvlDesv  # noqa
+from .evap_cortes import EvapCortes  # noqa
+from .evap_eco import EvapEco  # noqa
+from .energiaf import Energiaf  # noqa
+from .energiab import Energiab  # noqa
+from .energias import Energias  # noqa
+from .enavazf import Enavazf  # noqa
+from .enavazb import Enavazb  # noqa
+from .engnat import Engnat  # noqa
+from .vazaof import Vazaof  # noqa
+from .vazaob import Vazaob  # noqa
+from .vazaos import Vazaos  # noqa
+from .vazinat import Vazinat  # noqa

inewave-1.8.0/inewave/newave/avl_cortesfpha_nwv.py

@@ -0,0 +1,56 @@
+from inewave.newave.modelos.blocos.versaomodelo import (
+    VersaoModelo,
+    VersaoModeloLibs,
+)
+from inewave.newave.modelos.avl_cortesfpha_nwv import (
+    TabelaAvlCortesFpha28,
+    TabelaAvlCortesFpha,
+)
+
+from inewave.newave.modelos.arquivoscsv.arquivocsv import ArquivoCSV
+from typing import Optional
+import pandas as pd  # type: ignore
+
+from warnings import warn
+
+
+class AvlCortesFpha(ArquivoCSV):
+    """
+    Arquivo com os cortes da função de produção para as UHEs
+    do NEWAVE.
+    """
+
+    BLOCKS = [VersaoModeloLibs, TabelaAvlCortesFpha]
+    VERSIONS = {
+        "28": [VersaoModelo, TabelaAvlCortesFpha28],
+        "28.16": [VersaoModeloLibs, TabelaAvlCortesFpha],
+    }
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - periodo (`int`)
+        - nome_usina (`str`)
+        - indice_corte (`int`)
+        - fator_correcao (`float`)
+        - rhs_energia (`float`)
+        - coeficiente_volume_util_MW_hm3 (`float`)
+        - coeficiente_vazao_turbinada_MW_m3s (`float`)
+        - coeficiente_vazao_vertida_MW_m3s (`float`)
+        - coeficiente_vazao_lateral_MW_m3s (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        return self._tabela()
+
+    def __init__(self, data=...) -> None:
+        warn(
+            "Esta classe é relativa a um arquivo que não é mais suportado."
+            + " Utilize a classe FphaCortes no lugar.",
+            DeprecationWarning,
+        )
+        super().__init__(data)

inewave-1.8.0/inewave/newave/avl_desvfpha_s.py

@@ -0,0 +1,66 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.avl_desvfpha_s import TabelaAvlDesvFphaS
+
+from cfinterface.files.blockfile import BlockFile
+from typing import Optional, TypeVar
+import pandas as pd  # type: ignore
+
+from warnings import warn
+
+
+class AvlDesvFphaS(BlockFile):
+    """
+    Arquivo com os desvios da função de produção no plano de
+    vazão vertida (S).
+    """
+
+    BLOCKS = [VersaoModelo, TabelaAvlDesvFphaS]
+    ENCODING = "iso-8859-1"
+
+    T = TypeVar("T")
+
+    def __init__(self, data=...) -> None:
+        warn(
+            "Esta classe é relativa a um arquivo que não é mais suportado."
+            + " Utilize a classe FphaAvlDesvS no lugar.",
+            DeprecationWarning,
+        )
+        super().__init__(data)
+        self.__df_completo: Optional[pd.DataFrame] = None
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - nome_usina (`str`)
+        - volume_armazenado_percentual (`float`)
+        - vazao_turbinada_m3s (`float`)
+        - vazao_vertida_m3s (`float`)
+        - desvio_percentual (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        if self.__df_completo is None:
+            tabelas = self.data.of_type(TabelaAvlDesvFphaS)
+            self.__df_completo = pd.DataFrame()
+            for t in tabelas:
+                self.__df_completo = pd.concat(
+                    [self.__df_completo, t.data], ignore_index=True
+                )
+        return self.__df_completo
+
+    @property
+    def versao(self) -> Optional[str]:
+        """
+        A versão do modelo utilizada para executar o caso.
+
+        :return: A versão do modelo
+        :rtype: str | None
+        """
+        b = self.data.get_blocks_of_type(VersaoModelo)
+        if isinstance(b, VersaoModelo):
+            return b.data
+        return None

inewave-1.8.0/inewave/newave/avl_desvfpha_v_q.py

@@ -0,0 +1,65 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.avl_desvfpha_v_q import TabelaAvlDesvFphaVQ
+
+from cfinterface.files.blockfile import BlockFile
+from typing import Optional, TypeVar
+import pandas as pd  # type: ignore
+
+from warnings import warn
+
+
+class AvlDesvFphaVQ(BlockFile):
+    """
+    Arquivo com os desvios da função de produção nos planos de
+    volume armazenado e vazão turbinada (V-Q).
+    """
+
+    BLOCKS = [VersaoModelo, TabelaAvlDesvFphaVQ]
+    ENCODING = "iso-8859-1"
+
+    T = TypeVar("T")
+
+    def __init__(self, data=...) -> None:
+        warn(
+            "Esta classe é relativa a um arquivo que não é mais suportado."
+            + " Utilize a classe FphaAvlDesvVQ no lugar.",
+            DeprecationWarning,
+        )
+        super().__init__(data)
+        self.__df_completo: Optional[pd.DataFrame] = None
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - nome_usina (`str`)
+        - volume_armazenado_percentual (`float`)
+        - vazao_turbinada_m3s (`float`)
+        - desvio_percentual (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        if self.__df_completo is None:
+            tabelas = self.data.of_type(TabelaAvlDesvFphaVQ)
+            tabelas_validas = [t.data for t in tabelas if t is not None]
+            self.__df_completo = pd.concat(
+                [t for t in tabelas_validas if isinstance(t, pd.DataFrame)],
+                ignore_index=True,
+            )
+        return self.__df_completo
+
+    @property
+    def versao(self) -> Optional[str]:
+        """
+        A versão do modelo utilizada para executar o caso.
+
+        :return: A versão do modelo
+        :rtype: str | None
+        """
+        b = self.data.get_blocks_of_type(VersaoModelo)
+        if isinstance(b, VersaoModelo):
+            return b.data
+        return None

inewave-1.8.0/inewave/newave/eco_fpha.py

@@ -0,0 +1,51 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.eco_fpha import TabelaEcoFpha
+
+from inewave.newave.modelos.arquivoscsv.arquivocsv import ArquivoCSV
+from typing import Optional
+import pandas as pd  # type: ignore
+
+from warnings import warn
+
+
+class EcoFpha(ArquivoCSV):
+    """
+    Arquivo com o eco da função de produção para as UHEs
+    do NEWAVE.
+    """
+
+    BLOCKS = [VersaoModelo, TabelaEcoFpha]
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - periodo (`int`)
+        - nome_usina (`str`)
+        - tipo (`int`)
+        - conv (`int`)
+        - alfa (`int`)
+        - rems (`int`)
+        - numero_pontos_vazao_turbinada (`int`)
+        - vazao_turbinada_minima (`float`)
+        - vazao_turbinada_maxima (`float`)
+        - numero_pontos_volume_armazenado (`int`)
+        - volume_armazenado_minimo (`float`)
+        - volume_armazenado_maximo (`float`)
+        - geracao_minima (`float`)
+        - geracao_maxima (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        return self._tabela()
+
+    def __init__(self, data=...) -> None:
+        warn(
+            "Esta classe é relativa a um arquivo que não é mais suportado."
+            + " Utilize a classe FphaEco no lugar.",
+            DeprecationWarning,
+        )
+        super().__init__(data)

inewave-1.8.0/inewave/newave/evap_avl_desv.py

@@ -0,0 +1,33 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.nwv_avl_evap import TabelaAvlEvap
+
+from inewave.newave.modelos.arquivoscsv.arquivocsv import ArquivoCSV
+from typing import Optional
+import pandas as pd  # type: ignore
+
+
+class EvapAvlDesv(ArquivoCSV):
+    """
+    Arquivo com a avaliação da evaporação linear do NEWAVE.
+    """
+
+    BLOCKS = [VersaoModelo, TabelaAvlEvap]
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - periodo (`int`)
+        - codigo_usina (`int`)
+        - nome_usina (`str`)
+        - volume_armazenado_hm3 (`float`)
+        - evaporacao_calculada_hm3 (`float`)
+        - evaporacao_modelo_hm3 (`float`)
+        - desvio_absoluto_hm3 (`float`)
+        - desvio_percentual (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        return self._tabela()

inewave-1.8.0/inewave/newave/evap_cortes.py

@@ -0,0 +1,34 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.nwv_cortes_evap import TabelaCortesEvap
+
+from inewave.newave.modelos.arquivoscsv.arquivocsv import ArquivoCSV
+from typing import Optional
+import pandas as pd  # type: ignore
+
+
+class EvapCortes(ArquivoCSV):
+    """
+    Arquivo com os cortes da evaporação linear do NEWAVE.
+    """
+
+    BLOCKS = [VersaoModelo, TabelaCortesEvap]
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - periodo (`int`)
+        - indice_usina (`int`)
+        - nome_usina (`str`)
+        - derivada_cota_area (`float`)
+        - derivada_volume_cota (`float`)
+        - volume_referencia_hm3 (`float`)
+        - evaporacao_referencia_hm3 (`float`)
+        - coeficiente_volume (`float`)
+        - rhs_volume (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        return self._tabela()

inewave-1.8.0/inewave/newave/evap_eco.py

@@ -0,0 +1,34 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.nwv_eco_evap import TabelaEcoEvap
+
+from inewave.newave.modelos.arquivoscsv.arquivocsv import ArquivoCSV
+from typing import Optional
+import pandas as pd  # type: ignore
+
+
+class EvapEco(ArquivoCSV):
+    """
+    Arquivo com o eco dos dados da evaporação linear do NEWAVE.
+    """
+
+    BLOCKS = [VersaoModelo, TabelaEcoEvap]
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - periodo (`int`)
+        - codigo_usina (`int`)
+        - nome_usina (`str`)
+        - volume_referencia_hm3 (`float`)
+        - evaporacao_referencia_hm3 (`float`)
+        - coeficiente_evaporacao_mm_mes (`int`)
+        - flag_evaporacao (`int`)
+        - evaporacao_linear (`int`)
+        - tipo_volume_referencia (`int`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        return self._tabela()

inewave-1.8.0/inewave/newave/fpha_avl_desv_s.py

@@ -0,0 +1,59 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.avl_desvfpha_s import TabelaAvlDesvFphaS
+
+from cfinterface.files.blockfile import BlockFile
+from typing import Optional, TypeVar
+import pandas as pd  # type: ignore
+
+
+class FphaAvlDesvS(BlockFile):
+    """
+    Arquivo com os desvios da função de produção no plano de
+    vazão vertida (S).
+    """
+
+    BLOCKS = [VersaoModelo, TabelaAvlDesvFphaS]
+    ENCODING = "iso-8859-1"
+
+    T = TypeVar("T")
+
+    def __init__(self, data=...) -> None:
+        super().__init__(data)
+        self.__df_completo: Optional[pd.DataFrame] = None
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - nome_usina (`str`)
+        - volume_armazenado_percentual (`float`)
+        - vazao_turbinada_m3s (`float`)
+        - vazao_vertida_m3s (`float`)
+        - desvio_percentual (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        if self.__df_completo is None:
+            tabelas = self.data.of_type(TabelaAvlDesvFphaS)
+            self.__df_completo = pd.DataFrame()
+            for t in tabelas:
+                self.__df_completo = pd.concat(
+                    [self.__df_completo, t.data], ignore_index=True
+                )
+        return self.__df_completo
+
+    @property
+    def versao(self) -> Optional[str]:
+        """
+        A versão do modelo utilizada para executar o caso.
+
+        :return: A versão do modelo
+        :rtype: str | None
+        """
+        b = self.data.get_blocks_of_type(VersaoModelo)
+        if isinstance(b, VersaoModelo):
+            return b.data
+        return None

inewave-1.8.0/inewave/newave/fpha_avl_desv_v_q.py

@@ -0,0 +1,58 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.avl_desvfpha_v_q import TabelaAvlDesvFphaVQ
+
+from cfinterface.files.blockfile import BlockFile
+from typing import Optional, TypeVar
+import pandas as pd  # type: ignore
+
+
+class FphaAvlDesvVQ(BlockFile):
+    """
+    Arquivo com os desvios da função de produção nos planos de
+    volume armazenado e vazão turbinada (V-Q).
+    """
+
+    BLOCKS = [VersaoModelo, TabelaAvlDesvFphaVQ]
+    ENCODING = "iso-8859-1"
+
+    T = TypeVar("T")
+
+    def __init__(self, data=...) -> None:
+        super().__init__(data)
+        self.__df_completo: Optional[pd.DataFrame] = None
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - nome_usina (`str`)
+        - volume_armazenado_percentual (`float`)
+        - vazao_turbinada_m3s (`float`)
+        - desvio_percentual (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        if self.__df_completo is None:
+            tabelas = self.data.of_type(TabelaAvlDesvFphaVQ)
+            tabelas_validas = [t.data for t in tabelas if t is not None]
+            self.__df_completo = pd.concat(
+                [t for t in tabelas_validas if isinstance(t, pd.DataFrame)],
+                ignore_index=True,
+            )
+        return self.__df_completo
+
+    @property
+    def versao(self) -> Optional[str]:
+        """
+        A versão do modelo utilizada para executar o caso.
+
+        :return: A versão do modelo
+        :rtype: str | None
+        """
+        b = self.data.get_blocks_of_type(VersaoModelo)
+        if isinstance(b, VersaoModelo):
+            return b.data
+        return None

inewave-1.8.0/inewave/newave/fpha_cortes.py

@@ -0,0 +1,40 @@
+from inewave.newave.modelos.blocos.versaomodelo import (
+    VersaoModeloLibs,
+)
+from inewave.newave.modelos.avl_cortesfpha_nwv import (
+    TabelaAvlCortesFpha,
+)
+
+from inewave.newave.modelos.arquivoscsv.arquivocsv import ArquivoCSV
+from typing import Optional
+import pandas as pd  # type: ignore
+
+
+class FphaCortes(ArquivoCSV):
+    """
+    Arquivo com os cortes da função de produção para as UHEs
+    do NEWAVE.
+    """
+
+    BLOCKS = [VersaoModeloLibs, TabelaAvlCortesFpha]
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - periodo (`int`)
+        - nome_usina (`str`)
+        - indice_corte (`int`)
+        - fator_correcao (`float`)
+        - rhs_energia (`float`)
+        - coeficiente_volume_util_MW_hm3 (`float`)
+        - coeficiente_vazao_turbinada_MW_m3s (`float`)
+        - coeficiente_vazao_vertida_MW_m3s (`float`)
+        - coeficiente_vazao_lateral_MW_m3s (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        return self._tabela()

inewave-1.8.0/inewave/newave/fpha_eco.py

@@ -0,0 +1,41 @@
+from inewave.newave.modelos.blocos.versaomodelo import VersaoModelo
+from inewave.newave.modelos.eco_fpha import TabelaEcoFpha
+
+from inewave.newave.modelos.arquivoscsv.arquivocsv import ArquivoCSV
+from typing import Optional
+import pandas as pd  # type: ignore
+
+
+class FphaEco(ArquivoCSV):
+    """
+    Arquivo com o eco da função de produção para as UHEs
+    do NEWAVE.
+    """
+
+    BLOCKS = [VersaoModelo, TabelaEcoFpha]
+
+    @property
+    def tabela(self) -> Optional[pd.DataFrame]:
+        """
+        A tabela de dados que está contida no arquivo.
+
+        - codigo_usina (`int`)
+        - periodo (`int`)
+        - nome_usina (`str`)
+        - tipo (`int`)
+        - conv (`int`)
+        - alfa (`int`)
+        - rems (`int`)
+        - numero_pontos_vazao_turbinada (`int`)
+        - vazao_turbinada_minima (`float`)
+        - vazao_turbinada_maxima (`float`)
+        - numero_pontos_volume_armazenado (`int`)
+        - volume_armazenado_minimo (`float`)
+        - volume_armazenado_maximo (`float`)
+        - geracao_minima (`float`)
+        - geracao_maxima (`float`)
+
+        :return: A tabela como um dataframe
+        :rtype: pd.DataFrame | None
+        """
+        return self._tabela()