# Ansys Python Manager

## Ansys Python Manager 介紹

Python 雖是開源的軟體 (授權是使用 MIT License <mark style="color:orange;">(註)</mark> ) 其資源豐富，不論是相關模組或是安裝，網路可以找到非常多的資料。但太多的管道和資訊，對於初階使用者要安裝 Python 還是會有許多困擾。

{% hint style="info" %}
MIT License 是一種開源軟件許可證，其中 "MIT" 代表麻省理工學院（Massachusetts Institute of Technology），允許重新使用軟件，並在其基礎上創建衍生軟件，包括商業使用，而無需支付版權費用。MIT 許可證亦是一種寬鬆的開源許可證，常用於許多開源軟體項目，包括一些使用 Python 編寫的項目，允許開發者在合理的使用條件下自由地使用和修改軟件。

MIT許可證的主要特點：

1. **允許再授權：** 使用 MIT 許可證的軟件可以被任何人以任何形式（開源或專有）再授權，而且不需要經過原作者的同意。
2. **無保證責任：** MIT 許可證下的軟件是按“原樣”提供，沒有任何形式的保證。即使是原作者也不對軟件的使用負責。
3. **保留版權聲明：** MIT 許可證要求在軟件的所有副本或重要部分中包含原始版權聲明和許可證條款。
4. **免責聲明：** MIT 許可證明確免除了軟件的任何形式的損壞賠償責任。

MIT License的文字簡短且條款清晰，這也是其被廣泛使用的原因之一。它鼓勵軟體的自由和開放的使用，有助於促進技術的共享和創新。
{% endhint %}

<mark style="background-color:orange;">針對 Python 資源，Ansys 在 2023 年提供 Ansys Python Manager 給使用者免付費安裝。</mark>提供正確的 Python版本與模組資源，使用者再也不必花費時間在網路上繞路或迷路了。軟件的安裝路徑請參考 [Ansys Python Manager](https://github.com/ansys/python-installer-qt-gui/releases/tag/v0.2.5) 連結，使用者進入 GitHub 網頁後就能下載。如圖2-5。

<figure><img src="https://content.gitbook.com/content/VirLUs8eTD53aDCy3tN3/blobs/Pa3lriOWlL2su4nygIjo/image.png" alt=""><figcaption><p>圖2-5</p></figcaption></figure>

## Ansys Python Manager 安裝說明

程式下載執行後，內容有三個區塊頁面，分別是 Install Python, Create virtual environments, 與 Manage Python environments。

* [x] 在第一區先執行 Install Python。用戶能自己選取慣用的版本安裝。
* [x] 接續，在第二區創造虛擬環境<mark style="color:orange;">(註)</mark>，因為 Python 是開源軟體，軟體版本眾多，所以 Ansys 貼心的免費釋出 Ansys Python Manger 提供虛擬安裝，方便後面安裝其他版本使用。

{% hint style="info" %} <mark style="color:blue;">虛擬環境可以提供使用者依不同需求在虛擬空間中安裝不同版本的 Python 與其模組，能更更輕鬆的維護和管理程式。當開發者想要嘗試新模組或功能時，又擔心會影響以前的專案，這時，虛擬環境就是很好用的工具。</mark>
{% endhint %}

<figure><img src="https://content.gitbook.com/content/VirLUs8eTD53aDCy3tN3/blobs/0G7QeTjxvKCbcti8qNSH/image.png" alt=""><figcaption><p>圖2-6</p></figcaption></figure>

* [x] 於第三區，先安裝 default package，裡面已經整理好許多常用的模組，例如 Pandas, Numpy, Matplotlib...等工具<mark style="color:orange;">(註)</mark>。最後來到選單底部，選擇欲安裝的 PyAnsys 模組，筆者這邊安裝 PyAEDT。

{% hint style="info" %} <mark style="color:blue;">Ansys Python Manger 裡面包含 pytz, tzdata, threadpoolctl, six, pyparsing, pillow, packaging, numpy, kiwisolver, joblib, fonttools, cycler, scipy, python-dateutil, contourpy, scikit-learn, pandas, matplotlib.. 等常用模組，如果有其他需求，可以再自行用 pip 加裝。例如在 cmd 中</mark> <mark style="color:green;">pip install openpyxl</mark><mark style="color:blue;">。</mark>
{% endhint %}

* [x] 完成後，建議把目前的 Python 路徑加入 Windows 環境變數中。當我們將 Python 路徑添加到 Windows 環境中，是為了確保系統能夠在不必每次都指定完整路徑的情況下找到並使用 Python 解釋器和相關指令。

<figure><img src="https://content.gitbook.com/content/VirLUs8eTD53aDCy3tN3/blobs/tvGIApvGcliLrqHA2GoN/image.png" alt=""><figcaption><p>圖2-7</p></figcaption></figure>

## Path in Windows

將 Python 路徑添加到 Windows 環境中的一些原因：

* [ ] <mark style="color:blue;">**全局可訪問性**</mark><mark style="color:blue;">：</mark>當使用者將 Python 路徑添加到環境中，使用者可以從命令提示字元或PowerShell的任何目錄中訪問 Python 及其相關套件。這意味著使用者可以從任何位置運行Python腳本和指令，而無需每次都導航到 Python 安裝目錄。
* [ ] <mark style="color:blue;">**簡化執行**</mark><mark style="color:blue;">：</mark>如果沒有添加 Python 路徑，使用者需要每次運行 Python 腳本或執行 Python 指令時，指定完整的 Python 可執行檔路徑。通過添加路徑到環境，使用者可以直接使用 "python" 後跟腳本名稱或指令來執行 Python。
* [ ] <mark style="color:blue;">**與其他工具整合**</mark><mark style="color:blue;">：</mark>一些開發工具、構建系統和第三方庫可能依賴於從系統環境中訪問 Python。通過添加 Python 到環境中，使用者可以實現與這些工具的無縫整合，使開發和執行更加順暢。
* [ ] <mark style="color:blue;">**他人使用方便**</mark><mark style="color:blue;">：</mark>如果與他人共享使用者的代碼或腳本，將 Python 的路徑設置在環境中，將減少他們的設置複雜性。他們不需要手動配置 Python 路徑來運行使用者的代碼。

## Integrated Development Environment

IDE 如前節的介紹，是開發編譯器的縮寫，他的原文意思是整合開發環境 (Integrated Development Environment)。為了方便，在完成上面安裝步驟後，建議至安裝的虛擬資料夾中把 IDE 做捷徑，後面呼叫使用可以更為方便，如圖2-8。筆者使用的是 Spyder 編譯器。

<figure><img src="https://content.gitbook.com/content/VirLUs8eTD53aDCy3tN3/blobs/Qm7YjySlkRkmUXB6GJ3U/image.png" alt=""><figcaption><p>圖2-8</p></figcaption></figure>

{% hint style="info" %}
PyAnsys的授權條款，同樣屬於MIT License。其授權條款可以參考 [PyAnsys License](https://github.com/ansys/pyansys)。
{% endhint %}

## 安裝確認

安裝完成後，請先確認Python IDE主程式是否能正常開啟。而模組部分，可以用以下兩個方法確認是否有成功安裝PyAED或其他的模組。一個是在IDE中，鍵入

`import pyaedt`&#x20;

`print(pyaedt.__version__)`

來確認是否安裝成功及安裝的版本。

<figure><img src="https://2798179147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVirLUs8eTD53aDCy3tN3%2Fuploads%2FdI8tZYyhJkQakNYAYwDh%2Fimage.png?alt=media&#x26;token=af0bb6e5-c79b-4632-b6ad-67d615b97be0" alt="" width="563"><figcaption><p>圖2-9</p></figcaption></figure>

一是在 Command Prompt 中鍵入

`pip list`

做安裝模組的確認。

<figure><img src="https://2798179147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVirLUs8eTD53aDCy3tN3%2Fuploads%2FyKMi3SfueS3sJ0ozIhMy%2Fimage.png?alt=media&#x26;token=98562fbe-203b-4b20-b866-ef70f0ad7b61" alt="" width="501"><figcaption><p>圖2-10</p></figcaption></figure>