Installation

Blackbox uses various packages for sample generation and many of them are only supported on Linux-based systems. Due to this dependency, Blackbox is limited to these systems only. The dependencies are divided into two categories:

  • MACH-Aero packages: MACH-Aero is a framework for performing aerodynamic shape optimization. It consists of various packages, some of which are used by Blackbox while generating samples. Below table outlines the requried packages:

    Package

    Version

    baseclasses

    1.7.0 or higher

    pyGeo

    1.12.2 or higher

    pyHyp

    2.6.0 or higher

    cgnsutilities

    ADflow

    2.7.4 or higher

    Please refer MACH-Aero’s installation page for more details about installing these packages.

  • Other packages: Other than MACH-Aero packages, Blackbox also requries following packages:

    Package

    Version

    prefoil

    2.0.0

    smt

    2.0.0 or higher

    psutil

    5.9.1 or higher

It is recommended to create a virtual environment for installing all the above packages. Follow below steps for installing Blackbox:

  • Clone or download the latest tagged release from Blackbox’s github repository.

  • Open the terminal and cd into the root of cloned/downloaded repository

  • Activate the virtual environment and run:

    pip install .