edisgo.io.mviews_replacement.MviewsReplacement
==============================================

.. py:class:: edisgo.io.mviews_replacement.MviewsReplacement(engine)

   Replacement class for loading data from deprecated mviews.

   This class provides methods to query base tables directly instead of
   using materialized views, applying the same filter logic as the original
   mview definitions.


   .. py:attribute:: engine


   .. py:method:: get_conv_powerplant(scenario, version = None, preversion = 'v0.3.0', schema = 'data', table_name = 'ego_dp_conv_powerplant')

      Load conventional power plant data (replaces ego_dp_conv_powerplant_*_mview).

      This function replicates the logic from:
      - mviews.ego_dp_conv_powerplant_ego100_mview
      - mviews.ego_dp_conv_powerplant_nep2035_mview
      - mviews.ego_supply_conv_powerplant_ego100_mview
      - mviews.ego_supply_conv_powerplant_nep2035_mview

      :param scenario: Scenario name (e.g., 'NEP 2035', 'eGo 100', 'Status Quo')
      :type scenario: str
      :param version: Version string(s). If None, uses default versions for the scenario.
      :type version: str, optional
      :param preversion: Preversion filter
      :type preversion: str, default 'v0.3.0'
      :param schema: Database schema name ('data' or 'model_draft')
      :type schema: str, default 'data'
      :param table_name: Base table name (ego_dp_conv_powerplant or ego_dp_supply_conv_powerplant)
      :type table_name: str, default 'ego_dp_conv_powerplant'

      :returns: Conventional power plant data matching the mview criteria
      :rtype: pd.DataFrame



   .. py:method:: get_res_powerplant(scenario, version = None, preversion = 'v0.3.0', schema = 'data', table_name = 'ego_dp_res_powerplant')

      Load renewable power plant data (replaces ego_dp_res_powerplant_*_mview).

      This function replicates the logic from:
      - mviews.ego_dp_res_powerplant_ego100_mview
      - mviews.ego_dp_res_powerplant_nep2035_mview
      - mviews.ego_supply_res_powerplant_ego100_mview
      - mviews.ego_supply_res_powerplant_nep2035_mview

      :param scenario: Scenario name (e.g., 'NEP 2035', 'eGo 100', 'Status Quo')
      :type scenario: str
      :param version: Version string(s). If None, uses default versions.
      :type version: str, optional
      :param preversion: Preversion filter
      :type preversion: str, default 'v0.3.0'
      :param schema: Database schema name
      :type schema: str, default 'data'
      :param table_name: Base table name (ego_dp_res_powerplant or ego_dp_supply_res_powerplant)
      :type table_name: str, default 'ego_dp_res_powerplant'

      :returns: Renewable power plant data matching the mview criteria
      :rtype: pd.DataFrame



   .. py:method:: get_loadarea(version = 'v0.4.5', schema = 'data', table_name = 'ego_dp_loadarea')

      Load load area data (replaces ego_dp_loadarea_*_mview).

      This function replicates the logic from:
      - mviews.ego_dp_loadarea_v0_4_3_mview
      - mviews.ego_dp_loadarea_v0_4_5_mview

      :param version: Version string
      :type version: str, default 'v0.4.5'
      :param schema: Database schema name
      :type schema: str, default 'data'
      :param table_name: Base table name
      :type table_name: str, default 'ego_dp_loadarea'

      :returns: Load area data
      :rtype: pd.DataFrame



   .. py:method:: get_mv_griddistrict(version = 'v0.4.5', schema = 'data', table_name = 'ego_dp_mv_griddistrict')

      Load MV grid district data (replaces ego_dp_mv_griddistrict_*_mview).

      This function replicates the logic from:
      - mviews.ego_dp_mv_griddistrict_v0_4_3_mview
      - mviews.ego_dp_mv_griddistrict_v0_4_5_mview

      :param version: Version string
      :type version: str, default 'v0.4.5'
      :param schema: Database schema name
      :type schema: str, default 'data'
      :param table_name: Base table name
      :type table_name: str, default 'ego_dp_mv_griddistrict'

      :returns: MV grid district data
      :rtype: pd.DataFrame



   .. py:method:: load_mview_replacement(mview_name, scenario = None, version = None, **kwargs)

      Generic mview replacement loader based on mview name.

      This is a convenience function that automatically routes to the appropriate
      specific function based on the mview name pattern.

      :param mview_name: Name of the mview to replace (e.g., 'ego_dp_conv_powerplant_nep2035_mview')
      :type mview_name: str
      :param scenario: Scenario name (extracted from mview_name if not provided)
      :type scenario: str, optional
      :param version: Version string
      :type version: str, optional
      :param \*\*kwargs: Additional arguments passed to specific functions

      :returns: Data from the appropriate base table
      :rtype: pd.DataFrame

      :raises ValueError: If the mview_name pattern is not recognized

      .. rubric:: Examples

      >>> replacer = MviewsReplacement(engine)
      >>> data = replacer.load_mview_replacement(
      ...     'ego_dp_conv_powerplant_nep2035_mview')
      >>> data = replacer.load_mview_replacement(
      ...     'ego_supply_res_powerplant_ego100_mview')