inewave 1.7.4__py3-none-any.whl → 1.8.0__py3-none-any.whl

inewave/__init__.py

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

inewave/newave/__init__.py

@@ -1,5 +1,14 @@
 # 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
@@ -46,13 +55,13 @@ from .term import Term  # noqa
 from .vazoes import Vazoes  # noqa
 from .vazpast import Vazpast  # noqa
 from .volref_saz import VolrefSaz  # noqa
-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 .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

inewave/newave/avl_cortesfpha_nwv.py

@@ -11,6 +11,8 @@ 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):
     """
@@ -44,3 +46,11 @@ class AvlCortesFpha(ArquivoCSV):
         :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/newave/avl_desvfpha_s.py

@@ -5,6 +5,8 @@ from cfinterface.files.blockfile import BlockFile
 from typing import Optional, TypeVar
 import pandas as pd  # type: ignore
 
+from warnings import warn
+
 
 class AvlDesvFphaS(BlockFile):
     """
@@ -18,6 +20,11 @@ class AvlDesvFphaS(BlockFile):
     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
 

inewave/newave/avl_desvfpha_v_q.py

@@ -5,6 +5,8 @@ from cfinterface.files.blockfile import BlockFile
 from typing import Optional, TypeVar
 import pandas as pd  # type: ignore
 
+from warnings import warn
+
 
 class AvlDesvFphaVQ(BlockFile):
     """
@@ -18,6 +20,11 @@ class AvlDesvFphaVQ(BlockFile):
     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
 

inewave/newave/eco_fpha.py

@@ -5,6 +5,8 @@ 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):
     """
@@ -39,3 +41,11 @@ class EcoFpha(ArquivoCSV):
         :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/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/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/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/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/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/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/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()

inewave/newave/modelos/adterm.py

@@ -18,6 +18,13 @@ class BlocoUTEAdTerm(Section):
     Bloco com os despachos antecipados das UTEs por patamar.
     """
 
+    __slots__ = [
+        "__linha_ute",
+        "__linha_despachos",
+        "__cabecalhos",
+        "__numero_patamares",
+    ]
+
     FIM_BLOCO = " 9999"
 
     def __init__(self, previous=None, next=None, data=None) -> None:

inewave/newave/modelos/agrint.py

@@ -25,6 +25,8 @@ class BlocoGruposAgrint(Section):
     grupos.
     """
 
+    __slots__ = ["__linha", "__cabecalhos"]
+
     FIM_BLOCO = " 999"
 
     def __init__(self, previous=None, next=None, data=None) -> None:

inewave/newave/modelos/arquivos.py

@@ -11,6 +11,8 @@ class BlocoNomesArquivos(Section):
     entrada do NEWAVE `arquivos.dat`.
     """
 
+    __slots__ = ["__linha"]
+
     FIM_BLOCO = " 9999"
 
     def __init__(self, previous=None, next=None, data=None) -> None:

inewave/newave/modelos/avl_cortesfpha_nwv.py

@@ -13,6 +13,8 @@ class TabelaAvlCortesFpha28(TabelaCSV):
     UHEs do modelo NEWAVE.
     """
 
+    __slots__ = []
+
     BEGIN_PATTERN = "-----;-----;--------------;"
 
     LINE_MODEL = Line(
@@ -51,6 +53,8 @@ class TabelaAvlCortesFpha(TabelaCSV):
     UHEs do modelo NEWAVE.
     """
 
+    __slots__ = []
+
     BEGIN_PATTERN = "----;----;--------------;-------;"
 
     LINE_MODEL = Line(

inewave/newave/modelos/avl_desvfpha_s.py

@@ -14,6 +14,8 @@ class TabelaAvlDesvFphaS(Block):
     vazão vertida (S).
     """
 
+    __slots__ = ["__linha"]
+
     BEGIN_PATTERN = "-----;--------------;--------;"
 
     COLUMN_NAMES = [

inewave/newave/modelos/avl_desvfpha_v_q.py

@@ -14,6 +14,8 @@ class TabelaAvlDesvFphaVQ(Block):
     volume armazenado e vazão turbinada (V-Q).
     """
 
+    __slots__ = ["__linha"]
+
     BEGIN_PATTERN = "-----;--------------;------;"
 
     COLUMN_NAMES = [

inewave/newave/modelos/blocos/tabelacsv.py

@@ -11,6 +11,8 @@ class TabelaCSV(Block):
     a partir de um modelo de linha, para arquivos de saída do NEWAVE.
     """
 
+    __slots__ = []
+
     BEGIN_PATTERN = "-----;------;"
     LINE_MODEL = Line([])
     COLUMN_NAMES: List[str] = []

inewave/newave/modelos/blocos/versaomodelo.py

@@ -11,6 +11,8 @@ class VersaoModelo(Block):
     título do arquivo.
     """
 
+    __slots__ = []
+
     BEGIN_PATTERN = r"CEPEL: NEWAVE"
     END_PATTERN = ""
 
@@ -34,6 +36,8 @@ class VersaoModeloLibs(Block):
     título do arquivo.
     """
 
+    __slots__ = []
+
     BEGIN_PATTERN = r"NEWAVE -"
     END_PATTERN = ""
 

inewave/newave/modelos/cadic.py

@@ -26,6 +26,8 @@ class BlocoCargasAdicionais(Section):
     e por subsistema.
     """
 
+    __slots__ = ["__linha_subsis", "__linha_cargas", "__cabecalhos"]
+
     FIM_BLOCO = " 999"
 
     def __init__(self, previous=None, next=None, data=None) -> None:

inewave/newave/modelos/caso.py

@@ -10,6 +10,8 @@ class NomeCaso(Section):
     entrada do NEWAVE `caso.dat`.
     """
 
+    __slots__ = ["__linha"]
+
     def __init__(self, previous=None, next=None, data=None) -> None:
         super().__init__(previous, next, data)
         self.__linha = Line([LiteralField(40, 0)])
@@ -43,6 +45,8 @@ class CaminhoGerenciadorProcessos(Section):
     no NEWAVE, contido no arquivo `caso.dat`.
     """
 
+    __slots__ = ["__linha"]
+
     def __init__(self, previous=None, next=None, data=None) -> None:
         super().__init__(previous, next, data)
         self.__linha = Line([LiteralField(120, 0)])

inewave/newave/modelos/clast.py

@@ -22,6 +22,8 @@ class BlocoUTEClasT(Section):
     e por subsistema.
     """
 
+    __slots__ = ["__linha", "__cabecalhos", "__numero_anos_planejamento"]
+
     FIM_BLOCO = " 9999"
 
     def __init__(self, previous=None, next=None, data=None) -> None:

inewave/newave/modelos/confhd.py

@@ -13,6 +13,8 @@ class BlocoConfUHE(Section):
     no arquivo do NEWAVE `confhd.dat`.
     """
 
+    __slots__ = ["__linha_uhe", "__cabecalhos"]
+
     def __init__(self, previous=None, next=None, data=None) -> None:
         super().__init__(previous, next, data)
         self.__linha_uhe = Line(

inewave/newave/modelos/conft.py

@@ -12,6 +12,8 @@ class BlocoConfUTE(Section):
     no arquivo do NEWAVE `conft.dat`.
     """
 
+    __slots__ = ["__linha_ute", "__cabecalhos"]
+
     def __init__(self, previous=None, next=None, data=None) -> None:
         super().__init__(previous, next, data)
         self.__linha_ute = Line(

inewave/newave/modelos/cortes.py

@@ -9,6 +9,20 @@ class SecaoDadosCortes(Section):
     Registro com os cortes da FCF.
     """
 
+    __slots__ = [
+        "__tabela_int",
+        "__numero_coeficientes",
+        "__tabela_float",
+        "__tamanho_registro",
+        "__numero_total_cortes",
+        "__codigos_rees",
+        "__codigos_uhes",
+        "__codigos_submercados",
+        "__ordem_maxima_parp",
+        "__numero_patamares_carga",
+        "__lag_maximo_gnl",
+    ]
+
     def __eq__(self, o: object) -> bool:
         if not isinstance(o, SecaoDadosCortes):
             return False

inewave/newave/modelos/cortesh.py

@@ -11,6 +11,26 @@ class SecaoDadosCortesh(Section):
     arquivo cortesh.dat
     """
 
+    __slots__ = [
+        "data" "__df_ultimo_corte_por_estagio",
+        "__df_dados_submercado",
+        "__df_dados_uhes",
+        "__tamanho_segundo_registro",
+        "__tamanho_terceiro_registro",
+        "__tamanho_quarto_registro",
+        "__tamanho_quinto_registro",
+        "__tamanho_sexto_registro",
+        "__tamanho_setimo_registro",
+        "__tamanho_oitavo_registro",
+        "__tamanho_nono_registro",
+        "__tamanho_decimo_registro",
+        "__tamanho_decimo_primeiro_registro",
+        "__tamanho_decimo_segundo_registro",
+        "__tamanho_decimo_terceiro_registro",
+        "__tamanho_decimo_quarto_registro",
+        "__df_ultimo_corte_por_estagio",
+    ]
+
     REGISTER_SIZE = 46080
 
     def __init__(self, previous=None, next=None, data=None) -> None:

inewave/newave/modelos/curva.py

@@ -21,6 +21,8 @@ class BlocoConfiguracoesPenalizacaoCurva(Section):
     existente no arquivo do NEWAVE `curva.dat`.
     """
 
+    __slots__ = ["__linha", "__cabecalhos"]
+
     def __init__(self, previous=None, next=None, data=None) -> None:
         super().__init__(previous, next, data)
         self.__linha = Line(

inewave/newave/modelos/cvar.py

@@ -19,6 +19,8 @@ class BlocoValoresConstantesCVAR(Block):
     Bloco com valores dos parâmetros ALFA e LAMBDA constantes.
     """
 
+    __slots__ = ["__linha", "__cabecalhos"]
+
     BEGIN_PATTERN = "VALORES CONSTANTE NO TEMPO"
     END_PATTERN = ""