PyELSSA 0.1.0__py3-none-any.whl

PyELSSA/shared_msazure_api.py

@@ -0,0 +1,469 @@
+#=================================================================
+# Created by: Jieming Ye
+# Created on: June 2026
+# Last Modified: June 2026
+#=================================================================
+# Copyright (c) 2026 [Jieming Ye]
+#
+# This Python source code is licensed under the 
+# Open Source Non-Commercial License (OSNCL) v1.0
+# See LICENSE for details.
+#=================================================================
+"""
+Microsoft Graph API related functions
+
+"""
+#=================================================================
+# VERSION CONTROL
+# V1.0 (Jieming Ye) - Initial Version
+#=================================================================
+# Set Information Variable
+# N/A
+#=================================================================
+
+import os
+import shutil
+import subprocess
+import msal
+import requests
+import urllib.parse
+import tempfile
+
+from PyELSSA.shared_contents import SharedVariables, SharedMethods
+
+class AzureCloudID:
+    TENANT_ID = "c22cc3e1-5d7f-4f4d-be03-d5a158cc9409"
+    CLIENT_ID = "cd44fee0-76ce-422f-af29-386036f0eac5"
+    GRAPH_BASE = "https://graph.microsoft.com/v1.0"
+    AUTHORITY = f"https://login.microsoftonline.com/{TENANT_ID}"
+
+    # Delegated scopes for interactive/public-client login
+    SCOPES_RW = ["https://graph.microsoft.com/Sites.ReadWrite.All"]
+    # App-only scopes for confidential client login
+    SCOPES_APP = ["https://graph.microsoft.com/.default"]
+
+    PUBLIC_APP = None
+    CONFIDENTIAL_APP = None
+    ACCESS_TOKEN_CACHE = None
+
+    SECRET_KEY = "GraphAPISecret.key"
+
+    # ---- SharePoint details ----
+    SHAREPOINT_HOST = "networkrail.sharepoint.com"  # Network Rail Host Base
+    SITE_PATH = "/sites/NRDDTDNS"                   # e.g. /sites/Engineering
+
+    DOC_LIBRARY = "Documents"
+    MANUAL_PATH = "05 - Traction Power Modelling/04 - Vision Oslo/04 - VISION OSLO Extension Tool/VISION-OSLO Extension User Guide A09.pdf"
+    BHTPBANK_PATH = "05 - Traction Power Modelling/02 - Asset Data/07 - Rolling Stock/01 - Master BHTPBANK Library"
+    ELSSA_CORE_PATH = "00 - E and P Systems Team/zz_DO_NOT_CHANGE - CONFIDENTIAL_ACCESS/PyELSSA_DO_NOT_CHANGE/Latest_Core"
+
+    APP = None # internal ms api holding within the python process
+
+class AzureWorkflow:
+    # open document file from sharepoint
+    @staticmethod
+    def open_file_from_sharepoint(filename):
+        # create a temp directory and download the file there
+        temp_dir = tempfile.gettempdir()
+        temp_file = os.path.join(temp_dir, filename)
+
+        online_library = AzureCloudID.DOC_LIBRARY
+        online_file = AzureCloudID.MANUAL_PATH
+
+        try:
+            AzureWorkflow.download_tdns_sharepoint_file(online_library,online_file,temp_file)
+        except Exception as e:
+            SharedMethods.print_message(f"ERROR: Error acuqiring the manual: {e}","31")
+            SharedMethods.print_message(f"ERROR: Ensure all errors are cleared in sequence...","31")
+            return
+        
+        try:
+            subprocess.Popen(['start', '', temp_file], shell=True,close_fds=True)
+        except Exception as e:
+            SharedMethods.print_message(f"ERROR: Error opening file with default app: {e}","31")
+            return
+        return
+    
+    @staticmethod
+    def _read_secret():
+        secret_file = os.path.join(SharedVariables.configuration_path, AzureCloudID.SECRET_KEY)
+        if not os.path.isfile(secret_file):
+            SharedMethods.print_message(f"ATTENTION: ESDD advanced user could request secret token via email to 'traction.power@networkrail.co.uk'.", "33")
+            return None
+        try:
+            with open(secret_file, 'r') as file:
+                secret = file.read().strip()
+            return secret if secret else None
+        except Exception as e:
+            SharedMethods.print_message(f"WARNING: Failed to read secret file. {e}", "33")
+            return None
+    
+    @staticmethod
+    def _get_confidential_app():
+        secret = AzureWorkflow._read_secret()
+        if not secret:
+            return None
+        try:
+            if AzureCloudID.CONFIDENTIAL_APP is None:
+                AzureCloudID.CONFIDENTIAL_APP = msal.ConfidentialClientApplication(
+                    AzureCloudID.CLIENT_ID,
+                    authority=AzureCloudID.AUTHORITY,
+                    client_credential=secret
+                )
+            return AzureCloudID.CONFIDENTIAL_APP
+        except Exception as e:
+            SharedMethods.print_message(f"WARNING: Failed to initialise confidential client. {e}", "33")
+            return None
+
+    @staticmethod
+    def _acquire_confidential_token():
+        app = AzureWorkflow._get_confidential_app()
+        if app is None:
+            return None
+        try:
+            result = app.acquire_token_for_client(scopes=AzureCloudID.SCOPES_APP)
+        except Exception as e:
+            SharedMethods.print_message(f"WARNING: Confidential login failed. {e}", "33")
+            return None
+
+        if result and "access_token" in result:
+            SharedMethods.print_message("INFO: Access token acquired using confidential client.", "32")
+            return result["access_token"]
+
+        SharedMethods.print_message(f"WARNING: Confidential token error: {result.get('error')} | {result.get('error_description')}.","33")
+        SharedMethods.print_message(f"\nWARNING: Please report screenshot back via 'Help - Email to Support' action...\n","33")
+        return None
+    
+    @staticmethod
+    def _get_public_app():
+        if AzureCloudID.PUBLIC_APP is None:
+            AzureCloudID.PUBLIC_APP = msal.PublicClientApplication(
+                AzureCloudID.CLIENT_ID,
+                authority=AzureCloudID.AUTHORITY
+            )
+        return AzureCloudID.PUBLIC_APP
+
+    @staticmethod
+    def _acquire_public_token():
+        app = AzureWorkflow._get_public_app()
+
+        # Try silent token first
+        try:
+            accounts = app.get_accounts()
+            if accounts:
+                result = app.acquire_token_silent(
+                    AzureCloudID.SCOPES_RW,
+                    account=accounts[0]
+                )
+                if result and "access_token" in result:
+                    SharedMethods.print_message("INFO: Access token acquired silently using public client.", "32")
+                    return result["access_token"]
+        except Exception as e:
+            SharedMethods.print_message(f"WARNING: Silent token acquisition failed. {e}", "33")
+
+        # Interactive fallback
+        try:
+            SharedMethods.print_message(f"ATTENTION: Please sign in via system brower in two minutes. (Application awaiting for two minutes)...", "33")
+            result = app.acquire_token_interactive(
+                scopes=AzureCloudID.SCOPES_RW,
+                timeout=120
+            )
+        except Exception as e:
+            SharedMethods.print_message(f"ERROR: Interactive login failed. {e}", "31")
+            return None
+
+        if result and "access_token" in result:
+            SharedMethods.print_message("INFO: Access token acquired interactively using public client.", "32")
+            return result["access_token"]
+
+        SharedMethods.print_message(f"ERROR: Public token error: {result.get('error')} | {result.get('error_description')}","31")
+        return None
+
+    @staticmethod
+    def get_access_token():
+        # 1) Try confidential client first
+        token = AzureWorkflow._acquire_confidential_token()
+        if token:
+            AzureCloudID.ACCESS_TOKEN_CACHE = token
+            return token
+
+        # 2) Fall back to public client flow
+        token = AzureWorkflow._acquire_public_token()
+        if token:
+            AzureCloudID.ACCESS_TOKEN_CACHE = token
+            return token
+
+        return False
+
+    def graph_get(url, token, **kwargs):
+        headers = kwargs.pop("headers", {})
+        headers["Authorization"] = f"Bearer {token}"
+        response = requests.get(url, headers=headers, **kwargs)
+        response.raise_for_status()
+        return response
+
+    def download_tdns_sharepoint_file(online_library,online_file,output_file):
+        token = AzureWorkflow.get_access_token()
+        if not token:
+            SharedMethods.print_message(f"ERROR: Authorisation Fail...","31")
+            return False
+        # 1) Resolve site ID
+        # GET /sites/{hostname}:/{server-relative-path}
+        site_url = f"{AzureCloudID.GRAPH_BASE}/sites/{AzureCloudID.SHAREPOINT_HOST}:{AzureCloudID.SITE_PATH}"
+        site_resp = AzureWorkflow.graph_get(site_url, token)
+        site = site_resp.json()
+        site_id = site["id"]
+        print(f"Site: {AzureCloudID.SITE_PATH} -- ID: {site_id}")
+
+        # 2) Get all drives (document libraries) in the site
+        # GET /sites/{site-id}/drives
+        drives_url = f"{AzureCloudID.GRAPH_BASE}/sites/{site_id}/drives"
+        drives_resp = AzureWorkflow.graph_get(drives_url, token)
+        drives = drives_resp.json()["value"]
+
+        drive = next((d for d in drives if d["name"] == online_library), None)
+        if not drive:
+            SharedMethods.print_message(f"Library '{online_library}' not found. Available: {[d['name'] for d in drives]}","31")
+        drive_id = drive["id"]
+        print(f"Drive: {online_library} -- ID: {drive_id}")
+
+        # 3) Resolve the file by path relative to the library root
+        # GET /drives/{drive-id}/root:/{item-path}
+        encoded_path = urllib.parse.quote(online_file)
+        item_url = f"{AzureCloudID.GRAPH_BASE}/drives/{drive_id}/root:/{encoded_path}"
+        item_resp = AzureWorkflow.graph_get(item_url, token)
+        item = item_resp.json()
+        item_id = item["id"]
+        print(f"Item: {online_file} -- ID: {item_id}")
+
+        # 4) Download file content
+        # GET /drives/{drive-id}/items/{item-id}/content
+        download_url = f"{AzureCloudID.GRAPH_BASE}/drives/{drive_id}/items/{item_id}/content"
+        print("Downloading in process...")
+        with requests.get(
+            download_url,
+            headers={"Authorization": f"Bearer {token}"},
+            stream=True,
+            allow_redirects=True
+        ) as r:
+            r.raise_for_status()
+            with open(output_file, "wb") as f:
+                for chunk in r.iter_content(chunk_size=8192):
+                    if chunk:
+                        f.write(chunk)
+
+        print(f"Downloaded to: {output_file}")
+        
+        return True
+
+
+    def download_tdns_sharepoint_folder(online_library, online_folder, local_folder, delete_extra_local=False):
+        """
+        Download all files from a SharePoint folder (and subfolders) into a local folder.
+
+        Parameters
+        ----------
+        online_library : str
+            SharePoint document library name, e.g. "Documents"
+        online_folder : str
+            Folder path relative to the library root, e.g. "FolderA/SubFolderB"
+            Use "" or "/" for the library root.
+        local_folder : str
+            Local destination folder.
+        delete_extra_local : bool
+            If True, remove local files/folders that do not exist in SharePoint,
+            making the local folder a mirror of the online folder.
+
+        Returns
+        -------
+        bool
+            True if successful, False otherwise.
+        """
+
+        token = AzureWorkflow.get_access_token()
+        if not token:
+            SharedMethods.print_message("ERROR: Authorisation Fail...", "31")
+            return False
+
+        session = requests.Session()
+        session.headers.update({"Authorization": f"Bearer {token}"})
+
+        try:
+            # 1) Resolve site ID
+            # GET /sites/{hostname}:/{server-relative-path}
+            site_url = f"{AzureCloudID.GRAPH_BASE}/sites/{AzureCloudID.SHAREPOINT_HOST}:{AzureCloudID.SITE_PATH}"
+            site_resp = AzureWorkflow.graph_get(site_url, token)
+            site_resp.raise_for_status()
+            site = site_resp.json()
+            site_id = site["id"]
+            print(f"Site {AzureCloudID.SITE_PATH} -- ID: {site_id}")
+
+            # 2) Get all drives (document libraries) in the site
+            # GET /sites/{site-id}/drives
+            drives_url = f"{AzureCloudID.GRAPH_BASE}/sites/{site_id}/drives"
+            drives_resp = AzureWorkflow.graph_get(drives_url, token)
+            drives_resp.raise_for_status()
+            drives = drives_resp.json().get("value", [])
+
+            drive = next((d for d in drives if d["name"] == online_library), None)
+            if not drive:
+                SharedMethods.print_message(
+                    f"Library '{online_library}' not found. Available: {[d['name'] for d in drives]}",
+                    "31"
+                )
+                return False
+
+            drive_id = drive["id"]
+            print(f"Drive {online_library} -- ID: {drive_id}")
+
+            # Normalise online folder
+            online_folder = (online_folder or "").strip("/").strip()
+
+            # 3) Resolve folder item ID
+            if online_folder == "":
+                # Library root
+                folder_item_id = "root"
+                print(f"Using library root folder")
+            else:
+                # IMPORTANT: preserve "/" so the path stays hierarchical
+                encoded_folder = urllib.parse.quote(online_folder, safe="/")
+                folder_url = f"{AzureCloudID.GRAPH_BASE}/drives/{drive_id}/root:/{encoded_folder}"
+                folder_resp = AzureWorkflow.graph_get(folder_url, token)
+                folder_resp.raise_for_status()
+                folder_item = folder_resp.json()
+
+                if "folder" not in folder_item:
+                    SharedMethods.print_message(f"Path '{online_folder}' exists but is not a folder.","31")
+                    return False
+
+                folder_item_id = folder_item["id"]
+                print(f"Folder {online_folder} -- ID: {folder_item_id}")
+
+            # Ensure local root exists
+            os.makedirs(local_folder, exist_ok=True)
+
+            # Keep track of downloaded relative paths so we can optionally delete extra local files
+            remote_relative_paths = set()
+
+            def list_children(drive_id, item_id):
+                """
+                Get all children for a folder, including pagination.
+                """
+                if item_id == "root":
+                    url = f"{AzureCloudID.GRAPH_BASE}/drives/{drive_id}/root/children"
+                else:
+                    url = f"{AzureCloudID.GRAPH_BASE}/drives/{drive_id}/items/{item_id}/children"
+
+                items = []
+                while url:
+                    resp = session.get(url)
+                    resp.raise_for_status()
+                    data = resp.json()
+                    items.extend(data.get("value", []))
+                    url = data.get("@odata.nextLink")
+
+                return items
+
+            def download_file_by_item_id(drive_id, item_id, local_path):
+                """
+                Download one file and overwrite if it already exists.
+                """
+                download_url = f"{AzureCloudID.GRAPH_BASE}/drives/{drive_id}/items/{item_id}/content"
+                print(f"Downloading: {local_path}")
+
+                os.makedirs(os.path.dirname(local_path), exist_ok=True)
+
+                with session.get(download_url, stream=True, allow_redirects=True) as r:
+                    r.raise_for_status()
+                    with open(local_path, "wb") as f:
+                        for chunk in r.iter_content(chunk_size=8192):
+                            if chunk:
+                                f.write(chunk)
+
+            def walk_and_download(current_item_id, current_local_folder, current_relative_folder=""):
+                """
+                Recursively walk SharePoint folder and download all files/subfolders.
+                """
+                children = list_children(drive_id, current_item_id)
+
+                for item in children:
+                    item_name = item["name"]
+                    item_id = item["id"]
+
+                    # Build relative path for tracking/mirroring
+                    if current_relative_folder:
+                        relative_path = f"{current_relative_folder}/{item_name}"
+                    else:
+                        relative_path = item_name
+
+                    relative_path_norm = relative_path.replace("\\", "/")
+
+                    if "folder" in item:
+                        # Subfolder
+                        next_local_folder = os.path.join(current_local_folder, item_name)
+                        os.makedirs(next_local_folder, exist_ok=True)
+
+                        remote_relative_paths.add(relative_path_norm + "/")
+                        walk_and_download(item_id, next_local_folder, relative_path_norm)
+
+                    elif "file" in item:
+                        # File
+                        local_file_path = os.path.join(current_local_folder, item_name)
+                        download_file_by_item_id(drive_id, item_id, local_file_path)
+                        remote_relative_paths.add(relative_path_norm)
+
+                    else:
+                        print(f"Skipping unknown item type: {relative_path_norm}")
+
+            print("Downloading folder contents...")
+            walk_and_download(folder_item_id, local_folder)
+
+            if delete_extra_local:
+                print("Deleting extra local files/folders not found online...")
+
+                # Walk local tree bottom-up so folders can be removed after files
+                for root, dirs, files in os.walk(local_folder, topdown=False):
+                    for file_name in files:
+                        full_path = os.path.join(root, file_name)
+                        rel_path = os.path.relpath(full_path, local_folder).replace("\\", "/")
+                        if rel_path not in remote_relative_paths:
+                            print(f"Removing local extra file: {full_path}")
+                            os.remove(full_path)
+
+                    for dir_name in dirs:
+                        full_dir = os.path.join(root, dir_name)
+                        rel_dir = os.path.relpath(full_dir, local_folder).replace("\\", "/") + "/"
+                        if rel_dir not in remote_relative_paths:
+                            print(f"Removing local extra folder: {full_dir}")
+                            shutil.rmtree(full_dir, ignore_errors=True)
+
+            print(f"Download complete. Local folder: {local_folder}")
+            return True
+
+        except requests.HTTPError as e:
+            SharedMethods.print_message(f"ERROR: HTTP ERROR: {str(e)}", "31")
+            try:
+                resp_text = e.response.text
+                print(resp_text)
+            except Exception:
+                pass
+            return False
+
+        except Exception as e:
+            SharedMethods.print_message(f"ERROR: {str(e)}", "31")
+            return False
+
+
+if __name__ == "__main__":
+    print("TBC")
+    LIBRARY_NAME = "Documents"             # e.g. Documents or Shared Documents
+    FILE_PATH_IN_LIBRARY = "05 - Traction Power Modelling/04 - Vision Oslo/04 - VISION OSLO Extension Tool/VISION-OSLO Extension User Guide A09.pdf"
+    LOCAL_OUTPUT = "Manual.pdf"
+
+    AzureWorkflow.download_tdns_sharepoint_file(LIBRARY_NAME,FILE_PATH_IN_LIBRARY,LOCAL_OUTPUT)
+
+    # AzureWorkflow.download_tdns_sharepoint_folder(
+    #     online_library="Documents",
+    #     online_folder="05 - Traction Power Modelling/02 - Asset Data/07 - Rolling Stock/01 - Master BHTPBANK Library",
+    #     local_folder=r"C:\Users\JYe1\Downloads\tractiontest"
+    # )

pyelssa-0.1.0.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: PyELSSA
+Version: 0.1.0
+Summary: This is 'ELSSA in Python' package owned by Network Rail Infrastructure Limited.
+License: Open Source Non-Commercial License (OSNCL) v2.0
+License-File: LICENSE
+Author: Jieming Ye
+Author-email: Jieming.Ye@networkrail.co.uk
+Requires-Python: >=3.10
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: psutil
+Requires-Dist: scipy
+Requires-Dist: tk
+Project-URL: Homepage, https://pypi.org/project/PyELSSA/
+Description-Content-Type: text/markdown
+
+# ELSSA_python
+ELSSA (Electrification System Simulation Analysis) was written in Matlab. The last supporting Matlab version is 2014a which is out of official support for a fairly long time.
+Some of the source file is p coded (encrypted) which makes the support extremly difficult.
+
+This repository looks to mordenlize the software suite to a new era, giving the technology involvement in the last decade.
+
+The code will be rewritten from scratch in Python aiming for better user interface and program maintenance.
+
+## ELSSA Python Migration Plan
+- Phase 1: Reverse engineering the p coded section.
+- Phase 2: Replicate the ELSSA Matlab functionality.
+- Phase 3: Enhance the tool package and user interface. 
+
+
+## ELLSA Matlab
+Please refer to: https://github.com/NR-ESTractionPower/ELSSA_matlab
+
+

pyelssa-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+PyELSSA/__init__.py,sha256=7_2h1M-IR8oVQlfeJ9byqKqDcmtCYDWQzZRUoJ-QWmY,956
+PyELSSA/configuration.py,sha256=cvtpvz-0lerODKOFjkH-y8VjmG5xJWH0z42taq7eeJ8,13726
+PyELSSA/data/TestFile.txt,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+PyELSSA/data/TestFile1.csv,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+PyELSSA/data/TestFile2.csv,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+PyELSSA/gui/gui_base_frame.py,sha256=RMhsrJ2S6ZDmc88DdKknX0-0fOJA_3ve6CDFfGpvvds,9185
+PyELSSA/gui/gui_main_page.py,sha256=aitWGd1BdNpErlFvN335vADOxHSi7gHNCmduFkkTRRs,7510
+PyELSSA/gui/gui_start.py,sha256=UiJ1e3OQHkuzVZiyvujm9vlDu5kyYlO6dOdjJtx0DBk,20734
+PyELSSA/gui/gui_sub_frame.py,sha256=VRC_cVnIAM1-HofmD4Fdo65jultjzpl_1ETfGjfzDtM,22579
+PyELSSA/licensing.py,sha256=6s-VnUqg7pQZ1QMcKxpVySrkZrXP8RWuZL1Sd1e_WXM,9088
+PyELSSA/master.py,sha256=4Xlq1JmMtHeDdbmyDKuTG7pf8Z76RdBBaZhOawk6ZVo,2756
+PyELSSA/release_update.py,sha256=iEk-L7LMwoYD7_Ia-vOrY9G_w-B7RpuuYB5Ya-Frek8,2162
+PyELSSA/shared_contents.py,sha256=GDlQuypmtdP7SaVhfus-xZpfTLPmmIOuxxKVT-sJ9Rw,21630
+PyELSSA/shared_msazure_api.py,sha256=34V2ka68ASvO93BTdQH_Zpi57P3k124b6-BPavagUKI,20025
+pyelssa-0.1.0.dist-info/licenses/LICENSE,sha256=WRXXPQ74IB1kCBAbJBgciruEL10LYdL7z29TUatP1Lc,4580
+pyelssa-0.1.0.dist-info/METADATA,sha256=1DY7Qmwd2hUew8K1RxCH4AAHVYF_2BPyECzCzJ3y11Q,1728
+pyelssa-0.1.0.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+pyelssa-0.1.0.dist-info/RECORD,,

pyelssa-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.3.1
+Root-Is-Purelib: true
+Tag: py3-none-any

pyelssa-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,88 @@
+Copyright (c) 2026 [Jieming Ye, Engineering Services Design]
+
+Open Source Non-Commercial License (OSNCL) v2.0
+
+                                            Preamble
+The purpose of this license is to ensure that the software remains free for non-commercial use, while also ensuring 
+that any modifications to the software are made publicly available. Commercial use of this software is not allowed 
+without prior written permission from the original author(s).
+
+The precise terms and conditions for copying, distribution, and modification follow.
+
+                                       TERMS AND CONDITIONS
+Section 0: Definitions
+
+“This License” refers to version 2.0 of the Open Source Non-Commercial License.
+“The Software” refers to the Python package and all associated files, including but not limited to source code, 
+documentation, and configuration files, distributed under this License.
+“Modification” means any work derived from or based on the Software, such as bug fixes, enhancements, or other 
+alterations to the original work.
+"E&P Team" refers to the E&P team under Engineering Services, Route Services, Network Rail Infrastructure Ltd, 
+structured at September 2024.
+“You” refers to the individual or entity using, modifying, or distributing the Software.
+
+“Public Distribution” refers to the act of making any modifications of the Software available to the general 
+public.
+
+Section 1: Source Code and Modifications
+
+1.1 You may modify the Software and distribute your modified version, provided that:
+You make the source code of the modified version available to the public under the same terms as this License.
+The modified version must be clearly marked to indicate that changes have been made, including the date of changes.
+
+1.2 All modifications must be publicly available, in a manner that makes them easily accessible, such as posting 
+on a public repository (e.g., GitHub, GitLab).
+
+Section 2: Non-Commercial Use
+
+2.1 You may use, distribute, and modify the Software for non-commercial purposes only, including:
+Personal projects.
+Educational purposes.
+Research purposes.
+
+2.2 Commercial use of the Software is prohibited unless you have received explicit, prior written permission 
+from the original author(s).
+
+2.3 If you wish to make commercial use of the Software, including any modifications, you must contact the original 
+author(s) to seek permission and negotiate terms for such use.
+
+Section 3: Conveying Modified Source Code
+
+3.1 If you modify the Software, you must:
+Ensure that the modifications are licensed under this License.
+Make the modified source code publicly available.
+Provide information in any modified version about the changes made, including a notice stating the date of the 
+modification and who made the changes.
+
+Section 4: Conveying Non-Source Forms
+
+4.1 You may convey non-source forms of the Software, such as compiled binaries, provided that:
+You also provide access to the corresponding source code.
+The source code is made available under the same terms as this License.
+
+Section 5: Commercial Use Exception
+
+5.1 Commercial use of the Software or any modified versions is strictly prohibited unless permission is granted 
+in writing by the original author(s). For commercial inquiries, please contact [Traction.Power@networkrail.co.uk].
+
+5.2 Commercial use of the Software or any modified versions is allowed by [E&P Team] without any restriction.
+
+Section 6: No Warranty
+
+6.1 There is no warranty for the Software, to the extent permitted by applicable law. The Software is provided 
+“as is” without warranty of any kind, either expressed or implied, including but not limited to the implied 
+warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and 
+performance of the Software is with you.
+
+6.2 In no event, unless required by law or agreed to in writing, shall the author(s) be liable for any damages, 
+including any general, special, incidental, or consequential damages arising from the use or inability to use the 
+Software.
+
+Section 7: Termination
+
+7.1 You may not propagate or modify the Software except as expressly provided under this License. Any attempt 
+otherwise to propagate or modify the Software is void and will automatically terminate your rights under this 
+License.
+
+7.2 However, parties who have received copies, or rights, from you under this License will not have their 
+licenses terminated so long as they remain in full compliance.