PyELSSA 0.1.0__py3-none-any.whl

PyELSSA/gui/gui_main_page.py

@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+#=================================================================
+# Created by: Jieming Ye
+# Created on: Aug 2026
+# Last Modified: Aug 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.
+#=================================================================
+"""
+TBC
+"""
+#=================================================================
+# VERSION CONTROL
+# V1.0 (Jieming Ye) - Initial Version
+#
+#
+#=================================================================
+
+import tkinter as tk
+from tkinter import ttk
+from PyELSSA.gui.gui_base_frame import BasePage
+
+
+class SectionPage(BasePage):
+    page_title = ''
+    page_description = ''
+    page_actions = []
+    back_target = 'StartPage'
+
+    def __init__(self, parent, controller):
+        super().__init__(parent, controller)
+        self.build_page()
+
+    def build_page(self):
+        title = self.create_label(self.headframe, self.page_title, style='PageTitle.TLabel')
+        title.pack(anchor='center', pady=(0, 8))
+
+        if self.page_description:
+            description = self.create_label(self.headframe, self.page_description, style='PageText.TLabel', wraplength=860, justify='left')
+            description.pack(anchor='center', pady=(0, 8))
+
+        if self.page_actions:
+            actions_section = self.create_scrollable_section(self.contentframe, title='Available Actions', height=280)
+            for row, action in enumerate(self.page_actions):
+                text_label = ttk.Label(actions_section, text=action['label'], style='OptionText.TLabel', wraplength=620, justify='left')
+                text_label.grid(row=row, column=0, sticky='w', padx=(0, 8), pady=2)
+                action_button = self.create_button(actions_section, action['button'], lambda t=action['target']: self.set_target_page(t), style='Secondary.TButton')
+                action_button.grid(row=row, column=1, sticky='e', padx=(8, 0), pady=2)
+            actions_section.columnconfigure(0, weight=1)
+            actions_section.columnconfigure(1, weight=0)
+        else:
+            info = self.create_label(self.contentframe, 'This page is under development. Please check back later.', style='Info.TLabel', wraplength=860, justify='left')
+            info.pack(anchor='w', pady=(8, 12))
+
+        navigation = self.create_frame(padding=(0, 0))
+        self.create_button(navigation, 'Back to Home', lambda: self.controller.show_frame('StartPage')).pack(side='left', padx=6, pady=6)
+
+    def set_target_page(self, target_page):
+        self.controller.show_frame(target_page)
+
+
+class Page0(SectionPage):
+    page_title = 'TO BE DEVELOPED'
+    page_description = 'This page will be developed in the future. Use the home page to navigate to available workflows.'
+    back_target = 'StartPage'
+
+
+class PageOne(SectionPage):
+    page_title = 'ELSSA Model Preparation [Coming Soon...]'
+    page_description = 'Instruction: This page provides actions of creating ELSSA model, including create setup file and configuration file.'
+    'This also provides interface with VISION OSLO including creating of Multi-Train Profile (C-matrix) for ELSSA modelling.'
+    page_actions = [
+        {'label': 'ELLSA Setup File Creation (Classical). [In Dev]', 'button': 'Open', 'target': 'S01'},
+        {'label': 'ELSSA Configuration File Creation (Classical). [In Dev]', 'button': 'Open', 'target': 'S02'},
+        {'label': 'Multi-Train Profile (c-matrix) Creation from VISION OSLO. [In Dev]', 'button': 'Open', 'target': 'S03'},
+        {'label': 'Multi-Train Profile (c-matrix) Manipulation. [In Dev]', 'button': 'Open', 'target': 'S04'},
+        {'label': 'Provision for development', 'button': 'Open', 'target': 'S05'},
+    ]
+
+
+class PageTwo(SectionPage):
+    page_title = 'ELSSA Model Check and Validation [Coming Soon..]'
+    page_description = 'Instruction: This page provide checking of ELSSA model and generate visual plots as required. '
+    page_actions = [
+        {'label': 'Configuration Settings Plot. [In Dev]', 'button': 'Open', 'target': 'C01'},
+        {'label': 'ELSSA Model Setup File Plot. [In Dev]', 'button': 'Open', 'target': 'C02'},
+        {'label': 'ELSSA Model Connection Report. [In Dev]', 'button': 'Open', 'target': 'C03'},
+        {'label': 'ELSSA Model Rational Report. [In Dev]', 'button': 'Open', 'target': 'C04'},
+        {'label': 'Provision for development', 'button': 'Open', 'target': 'C05'},
+    ]
+
+
+class PageThree(SectionPage):
+    page_title = 'ELSSA Simulation Run [Coming Soon...]'
+    page_description = 'Instruction: This page provides multiple default operation condition. '
+    page_actions = [
+        {'label': 'Short Circuit Simulation (Current Model).', 'button': 'Open', 'target': 'F01'},
+        {'label': 'Multi Train Simulation (Current Model).', 'button': 'Open', 'target': 'F02'},
+        {'label': 'Load Bank Simulation (Current Model).', 'button': 'Open', 'target': 'F03'},
+        {'label': 'Harmonic Simulation. [In Dev]', 'button': 'Open', 'target': 'F04'},
+        {'label': 'Load Bank Simulation (Power Model). [In Dev]', 'button': 'Open', 'target': 'F05'},
+        {'label': 'Multi Train Simulation (Voltage Model). [In Dev]', 'button': 'Open', 'target': 'F06'},
+        {'label': 'Provision for development', 'button': 'Open', 'target': 'F07'},
+    ]
+
+
+class PageFour(SectionPage):
+    page_title = 'ELSSA Standard Plots [Coming Soon...]'
+    page_description = 'Instruction: This page provides standards plotting template for commonly used plotting.'
+    page_actions = [
+        {'label': 'Short-Circuit Default Plotting [In Dev]', 'button': 'Open', 'target': 'P01'},
+        {'label': 'Multi-Train Default Plotting [In Dev]', 'button': 'Open', 'target': 'P02'},
+        {'label': 'Report Style Default Plotting - Single Plot [In Dev]', 'button': 'Open', 'target': 'P03'},
+        {'label': 'Customised Plots in Standard Frame. [In Dev]', 'button': 'Open', 'target': 'P04'},
+        {'label': 'To be developed', 'button': 'Open', 'target': 'P05'},
+    ]
+
+class PageFive(SectionPage):
+    page_title = 'ELSSA Batch Operation [Coming Soon...]'
+    page_description = 'Instruction: This page provides unattended simulation of multiple operating scenarios.'
+    page_actions = [
+        {'label': 'Batch Simulation [In Dev]', 'button': 'Open', 'target': 'B01'},
+        {'label': 'Batch Plotting [In Dev]', 'button': 'Open', 'target': 'B02'},
+        {'label': 'To be developed', 'button': 'Open', 'target': 'B03'},
+    ]
+
+
+class PageSix(SectionPage):
+    page_title = 'ELSSA Customised Data Analysis [Coming Soon...]'
+    page_description = 'Instruction: This page generates mutiple excel datasheet based on simulation outcome.'
+    'User can use the data to carry out customised analysis.'
+    page_actions = [
+        {'label': 'All Data Extraction. [In Dev]', 'button': 'Open', 'target': 'P12'},
+        {'label': 'Short-Circuit Conductor Datasheet [In Dev]', 'button': 'Open', 'target': 'P09'},
+        {'label': 'Multi-Train Conductor Datasheet [In Dev]', 'button': 'Open', 'target': 'P10'},
+        {'label': 'Lumped Impedance Anlaysis [In Dev]', 'button': 'Open', 'target': 'P14'},
+        {'label': 'To be developed', 'button': 'Open', 'target': 'P15'},
+    ]

PyELSSA/gui/gui_start.py

@@ -0,0 +1,424 @@
+#
+# -*- coding: utf-8  -*-
+#=================================================================
+# Created by: Jieming Ye
+# Created on: Aug 2026
+# Last Modified: Aug 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.
+#=================================================================
+"""
+Main GUI window and Manual Bar
+
+"""
+#=================================================================
+# VERSION CONTROL
+# V1.0 (Jieming Ye) - Initial Version
+#
+#
+#=================================================================
+
+# Third Party
+import tkinter as tk
+from tkinter import filedialog, ttk
+from tkinter import font as tkfont
+from tkinter import filedialog
+from tkinter import messagebox
+import os
+import webbrowser
+import subprocess
+import threading
+import queue
+from functools import partial
+from urllib.parse import quote
+
+# Internal imports
+from PyELSSA import configuration
+from PyELSSA.gui.gui_base_frame import BasePage
+from PyELSSA.shared_contents import SharedVariables, SharedMethods
+
+
+# Commonly accessed frames to preload
+PRELOAD_FRAMES = {
+    'PageOne', 'PageTwo', 'PageThree', 'PageFour', 'PageFive', 'PageSix'
+}
+
+# Lazy imports for frames
+def import_frames():
+    from PyELSSA.gui.gui_main_page import Page0, PageOne, PageTwo, PageThree, PageFour, PageFive, PageSix
+    from PyELSSA.gui.gui_sub_frame import (
+        P01, P02, P03, P04, P05, P06, P07, P08, P09, P10, P11, P12, P13, P14, P15, P16, P17
+    )
+
+    return {
+        'Page0': Page0, 'PageOne': PageOne, 'PageTwo': PageTwo, 'PageThree': PageThree,
+        'PageFour': PageFour, 'PageFive': PageFive, 'PageSix': PageSix,
+        'P01': P01, 'P02': P02, 'P03': P03, 'P04': P04, 'P05': P05, 'P06': P06,
+        'P07': P07, 'P08': P08, 'P09': P09, 'P10': P10, 'P11': P11, 'P12': P12,
+        'P13': P13, 'P14': P14, 'P15': P15, 'P16': P16, 'P17': P17,
+    }
+
+
+class SampleApp(tk.Tk):
+    def __init__(self, *args, **kwargs):
+        tk.Tk.__init__(self, *args, **kwargs)
+
+        # Set initial window size and make it resizable
+        # self.geometry("700x500")
+        # self.resizable(True, True)
+
+        self.title_font = tkfont.Font(family='Helvetica', size=18, weight="bold")
+        self.sub_title_font = tkfont.Font(family='Helvetica', size=12, weight="bold")
+        self.big_text_font = tkfont.Font(family='Helvetica', size=10, weight="bold")
+        self.text_font = tkfont.Font(family='Helvetica', size=10)
+        self.title('ELSSA on Python')
+        
+        # add shared string variable of current work directory
+        self.working_directory = tk.StringVar()
+        self.working_directory.set(os.getcwd())
+
+        # Setup the container
+        container = tk.Frame(self)
+        container.pack(side="top", fill="both", expand=True)
+        container.grid_rowconfigure(0, weight=1)
+        container.grid_columnconfigure(0, weight=1)
+
+        self.frames = {}
+        self._frame_classes = None  # Will store frame classes when needed
+        self._container = container
+        self._preload_queue = queue.Queue()
+
+        # Initialize only the start page
+        frame = StartPage(parent=container, controller=self)
+        self.frames["StartPage"] = frame
+        frame.grid(row=0, column=0, sticky="nsew")
+
+        self.show_frame("StartPage")
+        self._setup_menu()
+        
+        # Start preloading common frames after a short delay
+        self.after(100, self._start_preloading)
+
+    def _start_preloading(self):
+        """Start background thread to preload common frames."""
+        def preload_worker():
+            try:
+                if self._frame_classes is None:
+                    self._frame_classes = import_frames() # import the frame classes
+                
+                for page_name in PRELOAD_FRAMES:
+                    if page_name not in self.frames and page_name in self._frame_classes:
+                        frame_class = self._frame_classes[page_name]
+                        # Queue the frame creation to be done in the main thread
+                        self._preload_queue.put((page_name, frame_class))
+                        # Process one frame at a time in the main thread
+                        self.after(0, self._process_preload_queue)
+            except Exception as e:
+                print(f"Preloading warning: {e}")
+
+        thread = threading.Thread(target=preload_worker)
+        thread.daemon = True
+        thread.start()
+
+    def _process_preload_queue(self):
+        """Process queued frame creation in the main thread."""
+        try:
+            while not self._preload_queue.empty():
+                page_name, frame_class = self._preload_queue.get_nowait()
+                if page_name not in self.frames:
+                    frame = frame_class(parent=self._container, controller=self)
+                    self.frames[page_name] = frame
+                    frame.grid(row=0, column=0, sticky="nsew")
+                    frame.grid_remove()  # Hide the frame
+        except queue.Empty:
+            pass
+        except Exception as e:
+            print(f"Frame creation warning: {e}")
+
+    def _setup_menu(self):
+        # define the top bar menu
+        menu = tk.Menu(self)
+        self.config(menu=menu)
+        
+        # sub-menu 1 = filemenu
+        filemenu = tk.Menu(menu)
+        menu.add_cascade(label='File', menu=filemenu)
+        filemenu.add_command(label='Open File', command=lambda: self.open_file_dialog())
+        filemenu.add_separator()
+        filemenu.add_command(label='Select Working Directory', command=lambda: self.set_working_directory())
+        filemenu.add_separator()
+        filemenu.add_command(label='Ulti: Clean Simulation Folder', command=lambda: self.clean_simulation_folder())
+        filemenu.add_separator()
+        filemenu.add_command(label='Exit', command=self.quit)
+
+        # submeanu 3 osop configuration
+        osopmenu = tk.Menu(menu)
+        menu.add_cascade(label='ELSSA Version', menu = osopmenu)
+
+        self.config_var = tk.IntVar()
+        last_config = configuration.read_configuration_file_variable(key = "elssa_version")
+        if not last_config:
+            last_config = SharedVariables.elssa_version
+            configuration.reset_configuration_file_varible(key = "elssa_version")
+        else:
+            last_config = int(last_config)
+        self.config_var.set(last_config)  # set to last configuration
+        SharedVariables.elssa_version = last_config
+        
+        osopmenu.add_radiobutton(label='PyELSSA RN-1 (Beta)', variable=self.config_var, value=1, command=lambda: self.elssa_option_action(1))
+        # osopmenu.add_radiobutton(label='RyELSSA RN-2 (Coming Soon)', variable=self.config_var, value=2, command=lambda: self.elssa_option_action(2))
+        # osopmenu.add_radiobutton(label='RyELSSA RN-3 (Coming Soon)', variable=self.config_var, value=3, command=lambda: self.elssa_option_action(3))
+
+        # sub menu4 dataset configuration
+        datamenu = tk.Menu(menu)
+        menu.add_cascade(label='Database',menu = datamenu)
+
+        self.dataset_var = tk.IntVar()
+        last_config_dataset = configuration.read_configuration_file_variable(key = "database_location")
+        if not last_config_dataset:
+            last_config_dataset = SharedVariables.used_database_path
+            configuration.reset_configuration_file_varible(key = "database_location")
+        else:
+            last_config_dataset = int(last_config_dataset)
+        
+        if last_config == 2:
+            SharedVariables.used_database_path = SharedVariables.database_path_user
+        else:
+            SharedVariables.used_database_path = SharedVariables.database_path_default
+        
+        self.dataset_var.set(last_config_dataset)
+        datamenu.add_radiobutton(label='Default', variable=self.dataset_var, value=1, command=lambda: self.data_option_action(1))
+        datamenu.add_radiobutton(label='Customised', variable=self.dataset_var, value=2, command=lambda: self.data_option_action(2))
+        datamenu.add_separator()
+        datamenu.add_command(label='(Cust) Go to data library', command=lambda: self.open_data_library())
+        datamenu.add_command(label='(Cust) Restore single data file', command=lambda: self.restore_data_to_default(singlefile=True))
+        datamenu.add_command(label='(Cust) Restore all data file', command=lambda: self.restore_data_to_default(singlefile=False))
+        datamenu.add_command(label='Default library forced refresh', command=lambda: configuration.update_database_library())
+
+        # sub-menu 2 = helpmenu
+        helpmenu = tk.Menu(menu)
+        menu.add_cascade(label='Help', menu = helpmenu)
+
+        # helpmenu.add_command(label='Help Document (Internal ONLY)',command =  lambda: AzureWorkflow.open_file_from_sharepoint('VISION-OSLO Extension User Guide.pdf'))
+        # helpmenu.add_separator()
+        helpmenu.add_command(label='Report PyELSSA Issue (Internal ONLY)',command =  lambda: webbrowser.open(SharedVariables.issue_online))
+        # helpmenu.add_command(label='Report VISION OSLO Issue (Internal ONLY)',command =  lambda: webbrowser.open(SharedVariables.vo_issue_online))
+        helpmenu.add_separator()
+        # helpmenu.add_command(label='Support: View BHTPBANK library (Internal ONLY)', command=lambda: webbrowser.open(SharedVariables.bhtpbank_central_library))
+        # helpmenu.add_separator()
+        helpmenu.add_command(label='Support for External User (External)',command=self.email_external_support)
+        helpmenu.add_separator()
+        helpmenu.add_command(label='Help - Email to Support',command=self.email_external_support)
+        helpmenu.add_separator()
+        helpmenu.add_command(label='About',command = self.show_about_popup)
+
+    def show_frame(self, page_name):
+        '''Show a frame for the given page name'''
+        # Create the frame if it doesn't exist
+        if page_name not in self.frames:
+            if self._frame_classes is None:
+                self._frame_classes = import_frames()
+            
+            frame_class = self._frame_classes.get(page_name)
+            if frame_class:
+                frame = frame_class(parent=self._container, controller=self)
+                self.frames[page_name] = frame
+                frame.grid(row=0, column=0, sticky="nsew")
+        
+        # Show the requested frame
+        frame = self.frames[page_name]
+        frame.grid()  # Ensure the frame is shown
+        frame.tkraise()
+
+    def elssa_option_action(self, version):
+        """Handle elssa version selection."""
+        if version == 1:
+            SharedVariables.osop_version = 1
+            SharedMethods.print_message("WARNING: PyELSSA RN-1 is selected.","33")
+        elif version == 2:
+            SharedVariables.osop_version = 2
+            SharedMethods.print_message("WARNING: PyELSSA RN-2 is selected.","33")
+        elif version == 3:
+            SharedVariables.osop_version = 3
+            SharedMethods.print_message("WARNING: PyELSSA RN-3 is selected.","33")
+        else:
+            SharedMethods.print_message("ERROR: Invalid PyELSSA revision selected.","31")
+        # set the configuration file
+        configuration.set_configuration_file_variable(key = "elssa_version", value = version)
+    
+    def data_option_action(self, choice):
+        if choice == 1:
+            SharedVariables.used_database_path = SharedVariables.database_path_default
+            SharedMethods.print_message(f"WARNING: Database path set to '{SharedVariables.database_path_default}'.","33")
+        elif choice == 2:
+            SharedVariables.used_database_path = SharedVariables.database_path_user
+            SharedMethods.print_message(f"WARNING: Database path set to '{SharedVariables.used_database_path}'.","33")
+        else:
+            SharedMethods.print_message("ERROR: Invalid database configuration selected.","31")
+        # set the configuration file
+        configuration.set_configuration_file_variable(key = "database_location", value = choice)
+    
+    
+    def email_external_support(self):
+        to = "traction.power@networkrail.co.uk"
+        subject = "Support Requested: ELSSA on Python"
+        body = "Hello,\n\nPlease describe your issue here.\n\nRegards,"
+        
+        mailto_link = f"mailto:{to}?subject={quote(subject)}&body={quote(body)}"
+        webbrowser.open(mailto_link)
+
+    def show_about_popup(self):
+        about_popup = tk.Toplevel(self)
+        about_popup.title("About-Copyright")
+
+        about_text = f"PyELSSA (ELSSA on Python), version {SharedVariables.installed_version}"
+        about_font = tkfont.Font(family='Helvetica', size=11, weight="bold")
+        about_label = tk.Label(about_popup, text=about_text, font = about_font, padx=10, pady=10)
+        about_label.pack()
+
+        info_text = "This is Developed by Jieming Ye.\n"\
+            "Copyright (c) 2026 [Jieming Ye, Engineering Services].\n"\
+            f"Link Validate: {SharedVariables.lastupdate}.\n"\
+            "License: OSNCL V1.0.\n"\
+            "For Support Please Consult 'traction.power@networkrail.co.uk'"
+        #info_label = tk.Message(about_popup, text=info_text, aspect = 800, padx=10, pady=10)
+        info_label = tk.Label(about_popup, text=info_text, padx=10, pady=10, justify="left")
+        info_label.pack()
+
+        # Center the popup window on the screen
+        about_popup.geometry("+%d+%d" % (self.winfo_rootx() + self.winfo_width() // 2 - about_popup.winfo_reqwidth() // 2,
+                                         self.winfo_rooty() + self.winfo_height() // 2 - about_popup.winfo_reqheight() // 2))
+
+    
+    # Create a function to be called when the "Open" menu option is clicked
+    def open_file_dialog(self):
+        initial_dir = os.getcwd()  # Get the current working directory
+        file_path = filedialog.askopenfilename(title="Select a file",initialdir=initial_dir)
+        if file_path:
+            print(f"Selected file: {file_path}")
+            SharedMethods.print_message("WARNING: DO NOT EXIT THE PROGRAME BEFORE SAVING THE OPENED FILE.","33")
+            self.open_file(file_path)
+
+    def open_file(self, file_path):
+        try:
+            subprocess.Popen(['start', '', file_path], shell=True,close_fds=True)
+        except Exception as e:
+            SharedMethods.print_message(f"ERROR: Error opening the selected file with default app: {e}","31")
+
+    # open the file explorer to select the working directory
+    def set_working_directory(self):
+        initial_dir = os.getcwd()
+        print(f"Current working directory:\n{initial_dir}")
+        directory_path = filedialog.askdirectory(title="Select Working Directory", initialdir=initial_dir)
+        if directory_path:
+            os.chdir(directory_path)
+            SharedVariables.current_path = directory_path
+            self.working_directory.set(directory_path)
+            SharedMethods.print_message(f"WARNING: Working directiory set to:\n{directory_path}","33")
+    
+    # open the data library folder
+    def open_data_library(self):
+        try:
+            if os.path.exists(SharedVariables.database_path_user):
+                os.startfile(SharedVariables.database_path_user)
+            else:
+                SharedMethods.print_message(f"ERROR: Data library folder not found at:\n{SharedVariables.database_path_user}","31")
+        except Exception as e:
+            SharedMethods.print_message(f"ERROR: Error opening data library folder: {e}","31")
+
+    # restore all files to default
+    def restore_data_to_default(self,singlefile=False):
+        if singlefile:
+            # open file dialog asking user the select the file and get the file name
+            initial_dir = SharedVariables.database_path_user
+            file_path = filedialog.askopenfilename(title="Select Data File to Restore",initialdir=initial_dir)
+            if file_path:  # only if user actually picked a file
+                filename = os.path.basename(file_path)
+                configuration.update_database_library([filename],library=1)
+        else:
+            # add a pop up confirmation ok small window to confirm
+            confirm = messagebox.askyesno(
+                "WARNING: CONFIRM UPDATE",
+                "This action CANNOT be redo.\n\n"
+                "Are you sure to CONTINUE??"
+            )
+            if confirm:
+                try:
+                    configuration.update_database_library(library=1)
+                except Exception as e:
+                    SharedMethods.print_message(f"ERROR: {str(e)}", "31")
+
+    def clean_simulation_folder(self):
+        confirm = messagebox.askyesno(
+                "WARNING: CONFIRM DELETE",
+                "WARNING: Ensure correct working directory set.\n\n"
+                "This action will delete all files except the model and CANNOT be redo.\n\n"
+                "Are you sure to CONTINUE??"
+            )
+            
+        if confirm:
+            try:
+                SharedMethods.clean_up_simulation_folder()
+            except Exception as e:
+                SharedMethods.print_message(f"ERROR: {str(e)}", "31")
+            
+            
+class StartPage(BasePage):
+    def __init__(self, parent, controller):
+        super().__init__(parent, controller)
+        self.build_page()
+
+    def build_page(self):
+        title = self.create_label(self.headframe, 'PyELSSA (ELSSA on Python)', style='PageTitle.TLabel')
+        title.pack(anchor='center', pady=(0, 6))
+
+        subtitle = self.create_label(
+            self.headframe,
+            'ELSSA: Electrification System Simulation Analysis [Multi-Conductor Simulation Tool]',
+            style='PageText.TLabel',
+            wraplength=820,
+            justify='center'
+        )
+        subtitle.pack(anchor='center', pady=(0, 16))
+
+        overview_section = self.create_section(self.contentframe, title='Quick Start')
+        overview_section.columnconfigure(0, weight=1)
+        overview_section.columnconfigure(1, weight=1)
+
+        nav_cards = [
+            ('Model Prepare (In Dev)', 'Prepare ELSSA models and configuration data.', 'PageOne'),
+            ('Model Check (In Dev)', 'Check ELSSA model rational and generate user report.', 'PageTwo'),
+            ('Run Simulation (In Dev)', 'Run ELSSA simulation in user selected mode.', 'PageThree'),
+            ('Standard Plots (In Dev)', 'Plot standard plots in Engineering Services template.', 'PageFour'),
+            ('Batch Process (In Dev)', 'Run multiple simulation scenarios unattended.', 'PageFive'),
+            ('Result Analysis (In Dev)', 'Generate Excel data for customised plotting.', 'PageSix'),
+        ]
+
+        for index, (label_text, hint, target) in enumerate(nav_cards):
+            row = index // 2
+            col = index % 2
+            card = self.create_section(overview_section, title=label_text, padding=(12, 10), pack=False)
+            card.grid(row=row, column=col, sticky='nsew', padx=2, pady=2)
+            # self.create_label(card, label_text, style='PageSubtitle.TLabel').pack(anchor='w', pady=(0, 8))
+            self.create_label(card, hint, style='OptionText.TLabel', wraplength=360, justify='left').pack(anchor='w', pady=(0, 8))
+            self.create_button(card, label_text, lambda t=target: self.button_callback(t), style='Action.TButton').pack(anchor='w')
+
+        status_section = self.create_section(self.contentframe, title='Status')
+        self.create_label(status_section, f'Version {SharedVariables.installed_version} — {SharedVariables.copyright}', style='SmallText.TLabel').pack(anchor='w', pady=2)
+        self.create_label(status_section, f'Note: {SharedVariables.status_note}', style='SmallText.TLabel').pack(anchor='w', pady=2)
+
+        self.footerframe.columnconfigure(1, weight=1)
+        self.create_label(self.footerframe, 'Current Folder:', style='PageText.TLabel').grid(row=0, column=0, sticky='w', padx=5, pady=6)
+        ttk.Label(self.footerframe, textvariable=self.controller.working_directory, style='PageText.TLabel', wraplength=780, justify='left').grid(row=0, column=1, sticky='w', padx=5, pady=6)
+
+    def button_callback(self, target_page):
+        self.controller.show_frame(target_page)
+    
+# programme running
+if __name__ == '__main__':
+    app = SampleApp()
+    app.mainloop()