Automatically Generate Reports

本節，筆者演示如何在 AEDT 2023R2 版本中，自動生成報告圖片，以及如何運用 PyAEDT 直接生成PPT投影片報告以及使用 AnsysReport 模組來產生 PDF 報告。

現代企業中，研發部門的角色日益受到重視。研發部門的目標是推動創新、改進產品和服務，並提供公司在市場競爭中的優勢。然而，研發團隊通常需要處理龐大的數據和資訊，以進行有效的決策和應對不斷變化的市場需求。在這種情況下，自動化報告功能成為研發部門不可或缺的利器。本節介紹 PyAEDT 的方式來達成這個工具，讀者亦可以參考下一張節，筆者另用 IronPython 製作「One-Click Report Generator」。

PyAEDT Automatically Generate PowerPoint Reports

在 2023R2 版本中，新增了一項強大的功能，允許直接執行 CPython 檔案。通過點選 "Run PyAEDT Script" 按鈕並指定檔案，可以藉由 Script 實現許多工作的自動化運行。

圖2-13

如圖2-14所示的動畫中，筆者演示了使用 PyAEDT 的模組自動匯出模擬的 3D 圖和結果圖檔。一次可以將 Project 的 Maxwell Designs 全部輸出產生報告。

圖2-14

內容的範例筆者把 Maxwell 相關模型與報告圖輸出到了 「D:\Reports_Photo\」。其 PPTX 的內容如圖2-15所示。

圖2-15

以往耗時的整理報告工作，現在可以透過 PyAEDT 迅速完成，它能自動整理成 PPTX 投影片的形式，亦或是 Excel (註)或其他報告格式。這樣用戶再進行一些後製加工後，就能輕鬆完成一份模擬報告，大大節省了製作報告的時間。這是一項令人非常興奮的功能，讓用戶能夠更加高效地利用 Ansys AEDT 2023R2 版本進行設計工作。透過自動化報告功能，研發部門能更好地應對市場挑戰，推動企業持續發展。

下面一節，筆者將介紹另一種自動產生報告的工具，不同於 PyAEDT，是由 Iron Python 程式開發，請讀者可以往下面章節觀看內容。

自動化應用章節，最後的範例是使用 Excel 報告形式。

Python-PPTX

在本節介紹的Coding中，筆者有使用了Python-PPTX的模組來做PowerPoint 文件的創建。

python-pptx 模組是一個 Python 函式庫，允許使用者程式化地創建和修改 PowerPoint 文件（.pptx）。透過使用這個庫，您可以自動化 PowerPoint 演示文稿的創建和編輯過程，無需手動在 PowerPoint 軟體中操作。這對於需要大量生成或修改演示文稿的情況特別有用。

下面是 python-pptx 的一些主要功能介紹：

• 創建演示文稿：可以從頭開始創建一個新的 PowerPoint 文件，或者基於現有的模板。

• 編輯幻燈片：添加、刪除或修改演示文稿中的幻燈片。

• 處理文本：在幻燈片中添加文本框，編輯文本的內容、樣式、字體、大小等。

• 插入圖像和圖表：可以將圖像、圖表或其他媒體添加到幻燈片中。

• 佈局和設計：控制幻燈片的佈局和設計，例如設置幻燈片的背景、顏色和主題。

• 保存和導出：完成編輯後，可以將演示文稿保存為 .pptx 文件。

使用 python-pptx，您可以將數據和圖表動態集成到演示文稿中，這對於自動生成報告或展示業務分析結果等場景非常有用。

PDF Generate using AnsysReport

PDF（Portable Document Format）是一種文件格式也是流行已久的報告格式，由Adobe於1993年創建，旨在實現文檔的跨平台共享，無論在哪種作業系統上，文件都能保持一致的格式與外觀。PDF文件可以包含文本、字型、格式設置、顏色和圖形，這些都是獨立於應用程式軟體、硬體和作業系統的。PDF非常適合於文件發布、傳送和數位印刷的格式，其具有跨平台性、格式保持性、互動性、安全性、壓縮性等優點。

Ansys PyAEDT 中也有內建自動產生PDF報告的模組。可以使用 from pyaedt.generic.pdf import AnsysReport 來使用此模組。

例如以下是筆者此模組來製作HFSS CPW模擬的報告程式碼，(下面的程式碼省略了CPW的模擬部分)：

# Export PDF

from pyaedt.generic.pdf import AnsysReport
import os

report = AnsysReport()
report.aedt_version = "2023R2"
report.template_name = "AnsysTemplate"
report.project_name = "CPW_PyAEDT"
report.design_name = "CPW"
report.create()
report.add_page_break()
report.add_chapter("Chapter 1")
report.add_sub_chapter("Description")
cpw_description = """
Coplanar Waveguide (CPW) is a type of electrical planar transmission line used for conveying microwave-frequency signals. It consists of a single conducting strip separated by narrow gaps from two ground planes on either side, all on the same substrate plane. This structure allows for simple manufacturing and easy integration with other circuit components.

Advantages of CPW include:
- Support for quasi-TEM wave propagation and various modes, suitable for a wide range of applications such as high-frequency circuits and antennas.
- Low radiation loss and high power handling capabilities.
- Ease of adaptation to form components like couplers, filters, and resonators.

CPW's planar nature facilitates the integration of active and passive devices directly onto the same substrate, making it a popular choice in modern RF and microwave circuit design.


"""
print(cpw_description)

report.add_text(cpw_description)
report.add_text("Using HFSS Simulation.", bold=True, italic=True)
report.add_empty_line(2)
report.add_page_break()
report.add_chapter("Chapter 2")
report.add_sub_chapter("Charts")
report.add_image(os.path.join(project_dir, "SParam.jpg"), width=20, caption="S-Parameters")
report.add_table("MyTable", [["x", "y"], ["0", "1"], ["2", "3"], ["10", "20"]])
report.add_section()
report.add_chart([0, 1, 2, 3, 4, 5], [10, 20, 4, 30, 40, 12], "Freq", "Val", "MyTable")
report.add_toc()
report.save_pdf(project_dir, "report_example.pdf")

轉出後的PDF檔案，會如圖2-16~18所示。

圖2-16

圖2-17

圖2-18