.. _GeneralTransformedSpace:


Input transformation
--------------------


An input transformation allows to transform a parameter space input another parameter space. The transformation is defined by a list of parameters spanning the new parameter space.

.. _ActiveLearning.trans.name:


name (str)
""""""""""
   The name of the transformation under which it can be addressed by other transformations or surrogates. 

   Default: ``'transformed_space'``

.. _ActiveLearning.trans.input:


input (str)
"""""""""""
   The name of the input transformation. A transformation can either transform the original parameter space or another transformed parameter space. 

   Default: If no input is specified, the original parameter space is taken as input.

.. _ActiveLearning.trans.parameters:


parameters (list[dict])
"""""""""""""""""""""""
   A list of parameters that spans the new parameter space. 

   Default: ``[]``
   Each element of the list must be a dict. The dict entry ``type`` specifies the type of the element. The remaining entries  specify its properties. In the following, all possible  list element types are described:

      **Expression parameter** (type ``'expression'``): The parameter is described by a general mathematical expression depending on the names of the input parameters (either from the design space and environment or from the input of the  transformation that the parameter belongs to.      
      
      See :ref:`expression configuration <ExpressionParameter>` for details.

      **Mapping parameter** (type ``'mapping'``): The parameter allows for mapping the value of discrete or categorial parameters to other values. For example, one can map material names to physical properties of the material such that a surrogate is better able to predict the behaviour of a material based on existing data for materials with similar properties.      
      
      See :ref:`mapping configuration <MappingParameter>` for details.

      **Expression parameter** (type ``'copy'``): The parameter copies the value of an input parameter.      
      
      See :ref:`copy configuration <CopyParameter>` for details.

.. toctree::
   :maxdepth: 100 
   :hidden:
   
   ExpressionParameter
   MappingParameter
   CopyParameter