Skip to content

cfsengineering/CEASIOMpy

Repository files navigation

Unittest Integration tests Codecov Codacy Badge Black code style License

⚠️ WARNING
LICENSE CHANGE NOTICE (2026): This project has transitioned from an open-source license to a Proprietary License. Use of this software is now restricted to evaluation and academic research; all commercial use, Cloud, or HPC deployment requires a separate agreement from CFSE. Please refer to the license.md file for full terms and contact information.

For the legacy open-source version, please refer to all [v1.x] versions.

CEASIOMpy

CEASIOMpy is an conceptual aircraft design environment which can be used to set up complex design and optimisation workflows for both conventional and unconventional aircraft configurations.

CEASIOMpy is mostly written in Python but it also depends on third-party libraries and software (like SU2 for the CFD calculation).

All input geometries are based on the open-standard format CPACS, a Common Parametric Aircraft Configuration Schema. It uses a parametric definition for air transportation systems which is developed by the German Aerospace Center DLR.

📜 CEASIOMpy is maintained by CFS Engineering.

📖 The Documentation of CEASIOMpy is integrated in this repository and can be read in documents like this one. Follow links to find the information that you are looking for.

Table of contents

Online Version (in development)

Visit: https://ceasiompy.com for an overview of what this repository has to offer.

Installation

Linux/macOS

On Linux/macOS, run the installer to set up the conda environment and optional tools (some scripts are still under development):

git clone https://github.com/cfsengineering/CEASIOMpy
cd CEASIOMpy
./scripts/install.sh
ceasiompy_run --g

For Windows users please use the online version at https://ceasiompy.com

Create Docker Container (Windows, Optional)

A video which explains how to install CEASIOMpy on Docker is now available! CEASIOMpy Docker Installation

Run CEASIOMpy

  • Run CEASIOMpy with a GUI to build the workflow

    If you run CEASIOMpy with the following command, you can build the workflow with a graphical user interface.

    ceasiompy_run --gui
  • For a list of all available commands

    If you want the list of all possible commands for ceasiompy:

    ceasiompy_run --help

Available modules

There are many different modules available in CEASIOMpy that can be combined to create different workflows.

Geometry and Mesh

Aerodynamics

Meta modules

Mission Analysis

Structure

Contributing

We welcome contributions from everyone. If you want to contribute to the development of CEASIOMpy, please read the document contributing.md.

More information

Upgrading environment

Sometimes deleting cache helps.

sudo find . -name "__pycache__" -type d -prune -exec rm -rf {} +
find . -name "*.pyc" -type f -delete

Or upgrading the environment.

conda env update -f environment.yml

How to Cite

This respository may be cited via BibTex as:

@software{ceasiompy2026,
  author = {CFS Engineering},
  title = {CEASIOMpy: Conceptual Aircraft Design and Optimization Framework},
  year = {2026},
  url = {https://github.com/cfsengineering/CEASIOMpy},
  note = {Proprietary License - Commercial/HPC use requires authorization.}
}

About

Aerodynamic multidisciplinary design and optimization framework. (Source-Available: Free for academic/evaluation; License required for Commercial/HPC/Cloud use.)

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors