The goal of this documentation is to facilitate the understanding of TiGL for all the users. Depending of your objective you may be interested by different parts. Please find bellow some pointers that might help you.
Overview : An overview of TiGL and CPACSCreator
Installation , Tutorials , Python-Demo : To get your hand dirty
CPACSCreator GUI : CPACSCreator GUI (ex-TiGL Viewer) documentation
TiGL Library : Library and API overview and examples
CPACSCreator high level parameters : Definition of the height level parameters used by this framework
Module, Namespace, Data Structures, Files: API and class documentation generate by doxygen (close to the code source)
The goal of CPACSCreator framework is to facilitate the processing, the editing and the creation of the geometric data stored inside CPACS data sets.
CPACSCreator offers query functions for the geometry structure. These functions can be used for example to detect how many segments are attached to a certain segment, which indices these segments have, or how many wings and fuselages the current airplane configuration contains. This functionality is necessary because not only the modeling of simple wings or fuselages but also the description of quite complicated structures with branches or flaps is targeted.
Furthermore, the CPACSCreator offer functions to modify or to create CPACS geometries. These functions can be used for example to modify the wing sweep angle, to modify fuselage length, to create a wing from scratch, or to modify the orientation of a section. These functionalities are necessary to avoid the manual editing of CPACS xml file. The idea was to provide a friendly interface to CPACS geometrical data and to hide the complexity of the CPACS format. To do this a set of high level parameters was define. You can find the exact definition of these parameters here: CPACSCreator high level parameters .
The framework is release under Apache2 license. The developed library uses the Open Source software OpenCASCADE to represent the airplane geometry by B-spline surfaces in order to compute surface points and also to export the geometry in the IGES/STEP/STL/VTK format.
The CPACSCreator is the continuity of the original TiGL project (https://github.com/DLR-SC/tigl). Basically TiGL library was extended with functionalities to edit CPACS geometrical data. Editing features was also added to TiGL Viewer and TiGL Viewer becomes CPACSCreator. The idea is to integrate these new functionalities back into the orignal TiGL project once they are stable enough. To be clear about the nomenclature used in this documentation, we use TiGL to refer to the new TiGL library and original TiGL library to refer to current TiGL3 library.
CPACSCreator framework can be divided into two main blocks:
The TiGL library is a C++ library and is really the core of CPACSCreator framework. This library contains all the logic of the geometrical CPACS data manipulation. The library can be access by other program trough the TiGL API (limited functionalities) and trough the internal python API (full functionalities) for python program.
The CPACSCreator GUI is a graphical user interface (GUI) to view, edit and create CPACS geometries. The goal of CPACSCreator GUI is to have a friendly user interface so that aircraft designers can easily view and modify CPACS geometry. CPACSCreator GUI simply make function calls to the library each time an object is modify and has convenience features to edit the file as undo/redo feature and profiles database.
Here we will presented a not exhaustive list of the functionalities added by CPACSCreator in the TiGL project. These functionalities are, in general, accessible thought the Internal python API or though the CPACSCreator GUI.