Installation Guide Comphy is a Python framework provided as a package. This enables full control and advanced simulations with Comphy on both Windows and Linux operating systems. The Python package can be downloaded directly from the corresponding Comphy repository using git. Alternatively, for those unfamiliar with git, a compressed archive containing the package can be found in the Downloads section.

Before proceeding with this installation guide, please read the license terms.
Setting up a Python environment with Comphy Comphy can be downloaded from the corresponding Comphy repository, using git and installed using Python's default package manager pip. This section will guide you through the necessary steps to setup a Python environment with Comphy on Linux operating systems. Step 1: Install system compilers To build the required dependencies for Comphy you need to install the gnu compiler collection (gcc) on your system.
  • For Debian/Ubuntu distributions the gnu compiler collection can be installed by executing:
  • sudo apt install gcc g++ gfortran
  • For Fedora/CentOS distributions the gnu compiler collection can be installed by executing:
  • sudo yum install gcc gcc-c++ gcc-gfortran
Step 2: Download Comphy: Next we want to download Comphy. The recommended way to download Comphy is to clone the corresponding repository using git. To clone the repository open a shell and enter the following command, replacing </path/to/download/destination/> with the target path where you want to put the source code: git clone https://tea.iue.tuwien.ac.at/InstituteforMicroelectronics/Comphy </path/to/download/destination/> Step 3: Create virtual Python environment Next we will create a new virtual Python environment for Comphy. For this purpose, execute the following command, replacing </path/to/new/virtual/environment> with the preferred target directory where you want the new environment to be created: python -m venv </path/to/new/virtual/environment> Step 4: Activate Python environment Next, activate the created Python environment. You’ll need to use different syntax for activating the virtual environment depending on which command shell you’re using.
  • On Linux using the bash shell:
  • source </path/to/new/virtual/environment>/bin/activate
  • On Linux using the csh shell:
  • source </path/to/new/virtual/environment>/bin/activate.csh
Step 5: Ensure pip, setuptools, and wheel are up to date While pip alone is sufficient to install from pre-built binary archives, up-to-date copies of setuptools and wheel are required to ensure you can also install from source archives. To update to the latest version of setuptools and wheel enter the following command in the shell: python -m pip install --upgrade pip setuptools wheel Step 6: Install Comphy using pip Finally, Comphy can be installed in the activated Python environment using pip. The following command, builds the package into a wheel and installs the wheel, including all necessary dependencies: python -m pip install </path/to/download/destination/> Step 7: Check installation Finally, verify that the installation was successful by entering the following command in the shell: python -m pip list This command lists all packages installed in the current Python environment. If the installation was successful, you should see a entry for Comphy displaying the version number:
Package             Version
------------------- ------------------
attrs               22.1.0
certifi             2022.9.24
charset-normalizer  2.0.12
ComphyV3            3.0.0.1
cycler              0.11.0
Deprecated          1.2.13
dill                0.3.4
future              0.18.2
...                 ...