From 0f803a3484dcf23885a2f1474f7065acf1d9d674 Mon Sep 17 00:00:00 2001 From: LukasK13 Date: Mon, 6 Jul 2020 17:28:59 +0200 Subject: [PATCH] Developer documentation updated --- docs/source/developer/class_diagram.pdf | Bin 0 -> 126622 bytes docs/source/developer/decorator_pattern.pdf | Bin 0 -> 52262 bytes .../developer/developer_documentation.rst | 144 +++++++++++++++++- 3 files changed, 136 insertions(+), 8 deletions(-) create mode 100644 docs/source/developer/class_diagram.pdf create mode 100644 docs/source/developer/decorator_pattern.pdf diff --git a/docs/source/developer/class_diagram.pdf b/docs/source/developer/class_diagram.pdf new file mode 100644 index 0000000000000000000000000000000000000000..fd7bdb863e11d511f8212d790bdc42c662155c32 GIT binary patch literal 126622 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 M5Jo{kWgV6O0zVt74FCWD literal 0 HcmV?d00001 diff --git a/docs/source/developer/decorator_pattern.pdf b/docs/source/developer/decorator_pattern.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a7f98d75132d8089193657ff8083507113c63099 GIT binary patch literal 52262 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 literal 0 HcmV?d00001 diff --git a/docs/source/developer/developer_documentation.rst b/docs/source/developer/developer_documentation.rst index 2714354..3a29060 100644 --- a/docs/source/developer/developer_documentation.rst +++ b/docs/source/developer/developer_documentation.rst @@ -1,15 +1,143 @@ -************************************ +*********************** Developer Documentation -************************************ +*********************** + +The following section provides detailed information on the the software architecture and on the possibilities to extend ESBO-ETC. +The source code of ESBO-ETC and this documentation can be found on the `IRS Gitea-server `_. + +.. note:: + In the following, methods of the source code may be mentioned without details on the required parameters or the return values. Please refer to the :ref:`api` for details. -============================ Project Structure -============================ +================= + +This project is structured into several folders as shown below. The three main folders are ``docs``, which contains the documentation, +``esbo_etc`` containing all source files and ``tests``, where all tests are located. + +:: + + root + ├── docs Documentation files + │ └── source Source files of the documentation + │ ├── configuration Configuration chapter of the documentation + │ ├── developer Developer chapter of the documentation + │ └── usage Usage chapter of the documentation + ├── esbo_etc Source code of ESBO-ETC + │ ├── classes Contains all classes of the source code + │ │ ├── optical_component Contains all class files of the optical components + │ │ ├── psf Contains all class files to model the different types of PSF + │ │ ├── sensor Contains all class files of the sensors + │ │ └── target Contains all class files of the targets + │ ├── lib Contains all library functions + │ └── esbo-etc.py This is the main file to run the application + └── tests Contains all tests + ├── data Necessary data for all tests + ├── optical_component Tests of the optical components + ├── psf Tests of the different PSF implementations + ├── sensor Tests of all sensors + └── target Tests of all targets + +Software Architecture +===================== + +For modelling the radiation transportation, the `decorator pattern `_ and the +`factory method pattern `_ were used as shown in the figure below. + +.. figure:: decorator_pattern.pdf + :alt: Decorator Pattern + :width: 100% + + The decorator pattern used for the radiation transportation. + +The radiation transportation pipeline consists always of a single target emitting the signal radiation. +This target may be encapsulated by multiple optical components which manipulate the radiation by either adding their own background radiation or by decreasing the transmitted radiation. +The outermost part of the radiation transportation pipeline is formed by some kind of sensor component, detecting the radiation. +The quality of the detected signal can then be determined by calculating the signal to noise ration (SNR). + +.. figure:: class_diagram.pdf + :alt: Class Diagram + + Class diagram of the software architecture. + +Radiant Interface +----------------- + +In order to implement the aforementioned radiation transportation pipeline, a sophisticated software architecture has been designed. +As shown in the class diagram, the class ``IRadiant`` forms the backbone of the structure. +This interface class defines the two methods ``calcSignal()`` and ``calcBackground()`` and therefore the basic layout of all decorated classes. +All targets and optical components implement this interface in oder to allow the cascading calculation of the signal and background fluxes. +For both targets and optical components exists an abstract superclass which implements the required interface. This allows the actual +classes to focus on the initialization and calculation of their own properties, ignoring the implementation of the interface. + + + +Target +------ + +The abstract class ``ATarget`` implements the interface provided by ``IRadiant`` and provides the abstract method ``checkConfig()`` which is used to check the relevant parts of the configuration file for this component. +All available target types must inherit from ``ATarget`` and therefore must implement the method ``checkConfig()``. +As the superclass ``ATarget`` implements the interface provided by ``IRadiant``, the compatibility to the radiation transportation pipeline is ensured. +All subclasses therefore only set up a ``SpectralQty``-object containing the emitted radiation and call the constructor of ``ATarget``. + +Optical Component +----------------- + +The abstract class ``AOpticalComponent`` implements the interface provided by ``IRadiant`` and thereby the two methods ``calcSignal()`` and ``calcBackground()``. +This includes the treatment of central obstruction of the components as well as transmittance / reflectance coefficients. +Additionally, ``AOpticalComponent`` provides the two methods ``propagate()`` for handling the propagation of incoming radiation through the optical component and ``ownNoise()`` for calculating the background radiation contribution of this component. +The two function may be overwritten by the subclasses, if a custom implementation is necessary. +Otherwise, the parameters ``transreflectivity`` and ``noise`` of the constructor method will be used for the calculations. +In order to check the relevant parts of the configuration file for this component, the class provides the abstract method ``checkConfig()`` which has to be implement by all subclasses. + +According to the restrictions above, subclasses of ``AOpticalComponent`` can be implemented in two possible ways: either by providing the parameters ``transreflectivity`` and ``noise`` to the constructor of the superclass or by implementing the two methods ``propagate()`` and ``ownNoise()``. + +Hot Optical Component +^^^^^^^^^^^^^^^^^^^^^ + +The abstract class ``AHotOpticalComponent`` extends the abstract superclass ``AOpticalComponent`` by implementing the method ``ownNoise()`` assuming grey body radiation in order to model optical components with a thermal background contribution. +This has the consequence, that every subclass of ``AHotOpticalComponent`` must implement the method ``propagate()``, which handles to propagation of the signal and backgroudn radiation through the component. +Like ``AOpticalComponent``, the class ``AHotOpticalComponent`` provides the abstract method ``checkConfig()`` for checking the configuration file. + +Sensor +------ + + -============================ Classes -============================ +======= + +All spectral quantities used for calculations, e.g. spectral flux densities, spectral reflectances, etc., are handled as ``SpectralQty``-objects, which support operations like additions, substractions, multiplications, divisions, etc. +Additionally, ESBO-ETC uses Astropy-units for all calculations in order to avoid any conversion errors. +The class ``Entry`` is used to represent the tags of the XML-configuration file. -============================ Extending ESBO-ETC -============================ +================== + +ESBO-ETC can be easily extended by adding new optical components or a new detector component. + +Adding Targets +-------------- + + + +Adding Optical Components +------------------------- + +Extending ESBO-ETC by a new optical component consists of two tasks. + +First of all, the new optical component class has to be implemented in a separate file in the *classes*-folder. +The new class must inherit from the abstract class ``AOpticalComponent`` or, in case of an optical component with thermal emission, from the abstract class ``AHotOpticalComponent`` and implement all abstract methods. +In case of a cold optical component, the new class must implement the method ``checkConfig()`` and call the constructor of the super class. +In case of a hot optical component, the new class must implement the method ``checkConfig()`` as well as the method ``propagate()`` and call the constructor of the super class. + +The method ``checkConfig()`` is used for checking the XML-configuration file and accepts as parameter the corresponding part of the configuration as ``Entry``-object. +In case of an configuration error, the method must return the corresponding error message. + +The method ``propagate()`` is used to model the propagation of incoming radiation through the optical component. +Therefore, this method receives as parameter the incoming radiation as ``SpectralQty``-object and must return the manipulated radiation as ``SpectralQty``-object. + +The second task consists of + +Adding Detector Components +-------------------------- +