aemo-to-tariff 0.1.0__tar.gz

aemo_to_tariff-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ian Connor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aemo_to_tariff-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.1
+Name: aemo_to_tariff
+Version: 0.1.0
+Summary: Convert spot prices from $/MWh to c/kWh for different networks and tariffs
+Author: Ian Connor
+Author-email: ian@powston.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+
+UNKNOWN

aemo_to_tariff-0.1.0/README.md

@@ -0,0 +1,22 @@
+# aemo_to_tariff
+
+This Python package converts spot prices from $/MWh to c/kWh for different networks and tariffs.
+
+## Installation
+
+```bash
+pip install aemo_to_tariff
+```
+
+## Usage
+
+```python
+from aemo_to_tariff import spot_to_tariff
+
+price_c_kwh = spot_to_tariff('2024-07-05 14:00', 'Energex', '6970', 100)
+print(price_c_kwh)
+```
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

aemo_to_tariff-0.1.0/aemo_to_tariff/__init__.py

@@ -0,0 +1,3 @@
+# aemo_to_tariff/__init__.py
+
+from .convert import spot_to_tariff

aemo_to_tariff-0.1.0/aemo_to_tariff/ausgrid.py

@@ -0,0 +1,29 @@
+# aemo_to_tariff/ausgrid.py
+from datetime import datetime
+from pytz import timezone
+
+def time_zone():
+    return 'Australia/Sydney'
+
+def convert(interval_time: datetime, tariff: str, rrp: float):
+    """
+    Convert RRP from $/MWh to c/kWh for Ausgrid.
+    
+    Parameters:
+    - interval_time (str): The interval time.
+    - network (str): The name of the network.
+    - tariff (str): The tariff code.
+    - rrp (float): The Regional Reference Price in $/MWh.
+    
+    Returns:
+    - float: The price in c/kWh.
+    """
+    interval_time = interval_time.astimezone(timezone(time_zone()))
+    rrp_c_kwh = rrp / 10
+    if tariff == 'N70':
+        return rrp_c_kwh + 14.40  # Todo: Update this value
+    else:
+        # Terrible approximation
+        slope = 1.037869032618134
+        intecept = 5.586606750833143
+        return rrp_c_kwh * slope + intecept

aemo_to_tariff-0.1.0/aemo_to_tariff/convert.py

@@ -0,0 +1,31 @@
+# aemo_to_tariff/convert.py
+
+from aemo_to_tariff.energex import convert as energex_convert
+from aemo_to_tariff.ausgrid import convert as ausgrid_convert
+from aemo_to_tariff.evoenergy import convert as evoenergy_convert
+
+def spot_to_tariff(interval_time, network, tariff, rrp, dlf=1.05905, mlf=1.0154):
+    """
+    Convert spot price from $/MWh to c/kWh for a given network and tariff.
+    
+    Parameters:
+    - interval_time (str): The interval time.
+    - network (str): The name of the network (e.g., 'Energex', 'Ausgrid', 'Evoenergy').
+    - tariff (str): The tariff code (e.g., '6970', '017').
+    - rrp (float): The Regional Reference Price in $/MWh.
+    - dlf (float): The Distribution Loss Factor.
+    - mlf (float): The Metering Loss Factor.
+    
+    Returns:
+    - float: The price in c/kWh.
+    """
+    adjusted_rrp = rrp * dlf * mlf
+    network = network.lower()
+    if network == 'energex':
+        return energex_convert(interval_time, tariff, adjusted_rrp)
+    elif network == 'ausgrid':
+        return ausgrid_convert(interval_time, tariff, adjusted_rrp)
+    elif network == 'evoenergy':
+        return evoenergy_convert(interval_time, tariff, adjusted_rrp)
+    else:
+        raise ValueError(f"Unknown network: {network}")

aemo_to_tariff-0.1.0/aemo_to_tariff/energex.py

@@ -0,0 +1,65 @@
+# aemo_to_tariff/energex.py
+from datetime import datetime
+from pytz import timezone
+
+def time_zone():
+    return 'Australia/Brisbane'
+
+NOUS = (0.02840, 0.15936, 0.03513)
+
+def daily():
+    return 32.757 + 15.500
+
+def peak_hours():
+    # Peak Energy 4pm-9pm every day
+    return [16, 17, 18, 19, 20]
+
+def peak_cost():
+    return 15.936
+
+def off_peak_hours():
+    # Off-peak Energy 9pm-4pm every day
+    return [10, 11, 12, 13, 14, 15]
+
+def off_peak_cost():
+    return 2.840
+
+def shoulder_hours():
+    # Not peak or off-peak
+    return [21, 22, 23, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+def shoulder_cost():
+    return 3.513
+
+def convert(interval_time: datetime, tariff: str, rrp: float):
+    """
+    Convert RRP from $/MWh to c/kWh for Evoenergy.
+    
+    Parameters:
+    - interval_time (str): The interval time.
+    - tariff (str): The tariff code.
+    - rrp (float): The Regional Reference Price in $/MWh.
+    
+    Returns:
+    - float: The price in c/kWh.
+    """
+    interval_time = interval_time.astimezone(timezone(time_zone()))
+    hour = interval_time.hour
+    rrp_c_kwh = rrp / 10
+    if tariff == '6970':
+        if hour in peak_hours():
+            price_c_kwh = peak_cost()
+        elif hour in shoulder_hours():
+            price_c_kwh = shoulder_cost()
+        elif hour in off_peak_hours():
+            price_c_kwh = off_peak_cost()
+        else:
+            price_c_kwh = off_peak_cost()
+        price_c_kwh += rrp_c_kwh
+    else:
+        # Terrible approximation
+        slope = 1.037869032618134
+        intecept = 5.586606750833143
+        return rrp_c_kwh * slope + intecept
+    
+    return price_c_kwh + rrp_c_kwh

aemo_to_tariff-0.1.0/aemo_to_tariff/evoenergy.py

@@ -0,0 +1,61 @@
+# aemo_to_tariff/evoenergy.py
+from datetime import datetime
+from pytz import timezone
+
+def time_zone():
+    return 'Australia/ACT'
+
+def daily():
+    return 32.757 + 15.500
+
+def peak_hours():
+    # Peak Energy 7am-9am and 5pm-9pm every day
+    return [7, 8, 17, 18, 19, 20]
+
+def peak_cost():
+    return 14.109
+
+def solar_soak_hours():
+    # Solar Soak Energy 11am-3pm every day
+    return [11, 12, 13, 14]
+
+def solar_soak_cost():
+    return 1.757
+
+def off_peak_hours():
+    # Off-peak Energy 9pm-7am, 9am-11am and 3pm-5pm every day
+    return [21, 22, 23, 9, 10, 15, 16]
+
+def off_peak_cost():
+    return 3.918
+
+def convert(interval_time: datetime, tariff: str, rrp: float):
+    """
+    Convert RRP from $/MWh to c/kWh for Evoenergy.
+    
+    Parameters:
+    - interval_time (str): The interval time.
+    - tariff (str): The tariff code.
+    - rrp (float): The Regional Reference Price in $/MWh.
+    
+    Returns:
+    - float: The price in c/kWh.
+    """
+    interval_time = interval_time.astimezone(timezone(time_zone()))
+    hour = interval_time.hour
+    rrp_c_kwh = rrp / 10
+    if tariff == '017':
+        if hour in peak_hours():
+            price_c_kwh = peak_cost()
+        elif hour in solar_soak_hours():
+            price_c_kwh = solar_soak_cost()
+        elif hour in off_peak_hours():
+            price_c_kwh = off_peak_cost()
+        else:
+            price_c_kwh = off_peak_cost()
+        return price_c_kwh + rrp_c_kwh
+    else:
+        # Terrible approximation
+        slope = 1.037869032618134
+        intecept = 5.586606750833143
+        return rrp_c_kwh * slope + intecept    

aemo_to_tariff-0.1.0/aemo_to_tariff.egg-info/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.1
+Name: aemo-to-tariff
+Version: 0.1.0
+Summary: Convert spot prices from $/MWh to c/kWh for different networks and tariffs
+Author: Ian Connor
+Author-email: ian@powston.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+
+UNKNOWN

aemo_to_tariff-0.1.0/aemo_to_tariff.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+setup.py
+aemo_to_tariff/__init__.py
+aemo_to_tariff/ausgrid.py
+aemo_to_tariff/convert.py
+aemo_to_tariff/energex.py
+aemo_to_tariff/evoenergy.py
+aemo_to_tariff.egg-info/PKG-INFO
+aemo_to_tariff.egg-info/SOURCES.txt
+aemo_to_tariff.egg-info/dependency_links.txt
+aemo_to_tariff.egg-info/requires.txt
+aemo_to_tariff.egg-info/top_level.txt
+test/test_convert.py

aemo_to_tariff-0.1.0/aemo_to_tariff.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aemo_to_tariff-0.1.0/aemo_to_tariff.egg-info/requires.txt

@@ -0,0 +1 @@
+pytz

aemo_to_tariff-0.1.0/aemo_to_tariff.egg-info/top_level.txt

@@ -0,0 +1 @@
+aemo_to_tariff

aemo_to_tariff-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

aemo_to_tariff-0.1.0/setup.py

@@ -0,0 +1,21 @@
+# setup.py
+
+from setuptools import setup, find_packages
+
+setup(
+    name='aemo_to_tariff',
+    version='0.1.0',
+    description='Convert spot prices from $/MWh to c/kWh for different networks and tariffs',
+    author='Ian Connor',
+    author_email='ian@powston.com',
+    license='MIT',
+    packages=find_packages(),
+    install_requires=[
+        'pytz',
+    ],
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+    ],
+)

aemo_to_tariff-0.1.0/test/test_convert.py

@@ -0,0 +1,68 @@
+# test/test_convert.py
+
+import unittest
+from datetime import datetime
+from aemo_to_tariff import spot_to_tariff
+
+class TestSpotToTariff(unittest.TestCase):
+
+    def test_energex_tariff_6970(self):
+        # Off peak
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Energex', '6970', 100, 1, 1), 22.84, 2)
+        
+        # Peak
+        interval_time = datetime.strptime('2024-07-05 17:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Energex', '6970', 100, 1, 1), 35.936, 2)
+        
+        #Shoulder
+        interval_time = datetime.strptime('2024-07-05 02:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Energex', '6970', 100, 1, 1), 23.51, 2)
+        
+        # With loss factor
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Energex', '6970', 200, 1.05, 1.01), 45.26)
+    
+    def test_energex_tariff_017(self):
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Energex', '017', 100, 1, 1), 15.965, 2)
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Energex', '017', 200, 1, 1), 26.343, 2)
+    
+    def test_ausgrid_tariff_6970(self):
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Ausgrid', '6970', 100, 1, 1), 15.965, 2)
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Ausgrid', '6970', 200, 1, 1), 26.343, 2)
+    
+    def test_ausgrid_tariff_017(self):
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Ausgrid', '017', 100, 1, 1), 15.965, 2)
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Ausgrid', '017', 200, 1, 1), 26.343, 2)
+    
+    def test_evoenergy_tariff_6970(self):
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Evoenergy', '6970', 100, 1, 1), 15.965, 2)
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Evoenergy', '6970', 200, 1, 1), 26.34, 2)
+    
+    def test_evoenergy_tariff_017(self):
+        # Off peak
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Evoenergy', '017', 100, 1, 1), 11.757, 2)
+        
+        # Peak
+        interval_time = datetime.strptime('2024-07-05 17:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Evoenergy', '017', 100, 1, 1), 24.109, 2)
+        
+        #Shoulder
+        interval_time = datetime.strptime('2024-07-05 02:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Evoenergy', '017', 100, 1, 1), 13.918, 2)
+
+        interval_time = datetime.strptime('2024-07-05 14:00+10:00', '%Y-%m-%d %H:%M%z')
+        self.assertAlmostEqual(spot_to_tariff(interval_time, 'Evoenergy', '017', 200), 23.264, 2)
+
+
+if __name__ == '__main__':
+    unittest.main()