Source code for viiapackage.tools.reference_approach_tool.viia_reference_approach_tool

### ===================================================================================================================
###   REFERENCE APPROACH TOOL
### ===================================================================================================================
# Copyright ©VIIA 2025

### ===================================================================================================================
###    1. Import modules
### ===================================================================================================================

# General imports
from pathlib import Path
from sys import executable, version_info
from warnings import warn

# References for functions and classes in the rhdhv_fem package
from rhdhv_fem.tools.fem_dashboard_utils import fem_show_streamlit_dashboard


### ===================================================================================================================
###    2. Initialise reference approach tool
### ===================================================================================================================

def viia_reference_approach_tool():
    """
    This function will initialise and create the VIIA REFERENCE APPROACH TOOL in the browser.

    Input:
        - No input required.

    Output:
        - The reference approach tool is shown in the browser.
    """
    # Check python version, as we are experiencing issues with version 3.9.7
    version = version_info
    if version.major == 3 and version.minor == 9 and version.micro == 7:
        warn(
            "WARNING: The Python version that you use (3.9.7) might not work with the dashboard. If an error occur "
            "please install a different subversion of Python.")

    # Get location of interpreter
    interpreter = Path(executable)
    print(f"Used interpreter for the dashboard: {interpreter}.")

    # Get the location of the dashboard
    dashboard_location = Path(__file__).parent / 'ra_tool' / 'Home.py'

    # Show the dashboard
    fem_show_streamlit_dashboard(
        dashboard_location=dashboard_location, interpreter=interpreter, args=("--theme.base", "light"))

### ===================================================================================================================
###    3. End of script
### ===================================================================================================================