繁體中文

Partition Simulation Tools

This repository contains tools for partitioning Ansys EDB projects and combining Touchstone files, now featuring a modern graphical user interface.

Features

• EDB Partitioning: Divides an Ansys EDB project based on specified criteria.
• Touchstone Combination: Merges multiple Touchstone files into a single file.
• Graphical User Interface (GUI): A user-friendly interface powered by pywebview for easier interaction.

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.10: The installation script strictly requires and will guide you to locate a Python 3.10 interpreter if not found in your system's PATH or among detected Ansys installations.
• Ansys Electronics Desktop (AEDT): Required for EDB partitioning functionality.

Installation

1. Open Command Prompt (CMD): Navigate to the project's root directory in Command Prompt.

2. Run the installation script:

   .\install.bat

   This script will perform the following actions:

   • Python 3.10 Detection: It first attempts to find a Python 3.10 interpreter.
     • It prioritizes Ansys bundled Python 3.10 installations (e.g., from ANSYSEM_ROOTXXX environment variables).
     • If not found, it checks your system's PATH for python.exe.
     • If still not found, it will prompt you to manually enter the full path to your python.exe (which must be version 3.10).
   • Python Virtual Environment Setup: It creates an isolated Python virtual environment (.venv) to manage project dependencies.
   • Dependency Installation: It installs uv (a fast Python package installer) within the virtual environment, and then uses uv to install all other required project dependencies including pyaedt, pyedb, pywebview, and scikit-rf.

   Upon successful completion, you will see an "Installation complete." message.

Usage

1. Open Command Prompt (CMD): Navigate to the project's root directory in Command Prompt.

2. Run the GUI application:

   .\run.bat

   A graphical user interface (GUI) window will appear with two main tabs:

   • EDB Partition Tab:

     • EDB Path: Use the "Browse..." button to select your .aedb project folder.
     • Ansys Version: Enter the Ansys EDB version you are using (e.g., 2024.1).
     • Run Partition: Click this button to start the partitioning process. Output will be shown in the log area. Upon completion, a prompt will ask if you want to open the output folder.

   • Combine Touchstone Tab:

     • Touchstone Files List: Use "Add Files..." to select multiple Touchstone files (.s*p). You can select multiple files at once. Use the "✖" button next to a file to remove it from the list.
     • Output Folder: Use the "Browse..." button to select the directory where the combined Touchstone file will be saved.
     • Ansys Version: Enter the Ansys EDB version (e.g., 2024.1). This version is used for internal processing.
     • Combine: Click this button to merge the selected Touchstone files. Output will be shown in the log area.

Development Notes

• The GUI is built using pywebview, which embeds a web-based UI (HTML, CSS, JavaScript) within a native desktop window.
• Python scripts (main.py, combine_touchstone.py) are executed as subprocesses by app.py, and their output is streamed to the GUI's log area.

License

This project is licensed under the MIT License - see the LICENSE file for details.