edisgo.network.components.PotentialChargingParks
================================================

.. py:class:: edisgo.network.components.PotentialChargingParks(**kwargs)

   Bases: :py:obj:`BasicComponent`

   .. autoapi-inheritance-diagram:: edisgo.network.components.PotentialChargingParks
      :parts: 1


   Generic component

   Can be initialized with EDisGo object or Topology object. In case of
   Topology object component time series attributes currently will raise an
   error.



   .. py:property:: voltage_level

      Voltage level the component is connected to ('mv' or 'lv').

      :returns: Voltage level. Returns 'lv' if component connected to the low
                voltage and 'mv' if component is connected to the medium voltage.
      :rtype: :obj:`str`


   .. py:property:: grid

      Grid component is in.

      :returns: Grid component is in.
      :rtype: :class:`~.network.grids.Grid`


   .. py:property:: ags

      8-digit AGS (Amtlicher Gemeindeschlüssel, eng. Community Identification
      Number) number the potential charging park is in. Number is given as
      :obj:`int` and leading zeros are therefore missing.

      :returns: AGS number
      :rtype: int


   .. py:property:: use_case

      Charging use case (home, work, public or hpc) of the potential charging park.

      :returns: Charging use case
      :rtype: str


   .. py:property:: designated_charging_point_capacity

      Total gross designated charging park capacity in kW.

      This is not necessarily equal to the connection rating.

      :returns: Total gross designated charging park capacity
      :rtype: float


   .. py:property:: user_centric_weight

      User centric weight of the potential charging park
      determined by `SimBEV <https://github.com/rl-institut/simbev>`_.

      :returns: User centric weight
      :rtype: float


   .. py:property:: geometry

      Location of the potential charging park as
      :shapely:`Shapely Point object<points>`.

      :returns: Location of the potential charging park.
      :rtype: :shapely:`Shapely Point object<points>`.


   .. py:property:: nearest_substation

      Determines the nearest LV Grid, substation and distance.

      :returns:

                :obj:`int`
                    LV Grid ID
                :obj:`str`
                    ID of the nearest substation
                :obj:`float`
                    Distance to nearest substation
      :rtype: :obj:`dict`


   .. py:property:: edisgo_id


   .. py:property:: charging_processes_df

      Determines designated charging processes for the potential charging park.

      :returns: DataFrame with AGS, car ID, trip destination, charging use case
                (private or public), netto charging capacity, charging demand,
                charge start, charge end, potential charging park ID and charging point
                ID.
      :rtype: :pandas:`pandas.DataFrame<DataFrame>`


   .. py:property:: grid_connection_capacity


   .. py:property:: within_grid

      Determines if the potential charging park is located within the grid district.