There are three levels on which you can configure the way the different outputs in the simulator file are modeled.
Default behavior, all outputs modeled
If no Outputs tag is defined in the configuration file, all outputs are modeled and evaluated with the measure specified by the plan or the run. Complex outputs are modeled directly. The default error function is rootRelativeSquareError.m.
Default behavior, selected outputs modeled
To change this default behavior, you must specify an <Outputs> tag in the Run configuration. Inside you specify an <Output> tag for each output you want to model. As an example, the Academic2DTwice example has two outputs: 'out' and 'outinverse'. If you only want to model 'outinverse' you specify:
<Outputs> <Output name="outinverse" /> </Outputs>
If on the other hand you want to model both you can delete the <Outputs> tag all together and fall back to the default behavior, or you can put:
<Outputs> <Output name="out" /> <Output name="outinverse" /> </Outputs>
Custom behavior for each output
If you also want to change or fine-tune the behavior of the toolbox for each output separately, you can add subelements to each Output tag to customize the toolbox for that particular output. This allows you to use different sample selectors and/or model builders for each output, change the default measure, or combine multiple measures.
Several examples of valid Output configurations can be found commented in default.xml.
Here is an example of an output configuration for the Academic2DTwice test function:
<Outputs> <Output name="out"> <SequentialDesign>lola</SequentialDesign> <Measure type="CrossValidation" target=".01" errorFcn="meanSquareError" use="on" /> <ModelBuilder>lssvmps</ModelBuilder> </Output> <Output name="outinverse"> <SequentialDesign>delaunay</SequentialDesign> <Measure type="CrossValidation" target=".05" errorFcn="maxRelativeError" use="on" /> <Measure type="MinMax" /> </Output> </Outputs>
This configuration models the first Output named "out" using the CrossValidation measure (using the meanSquareError function, and a target of 0.1) with the LOLA sample selector to select new samples. It builds models for this output using the lssvmps model builder. The second output, named "outinverse", uses CrossValidation in combination with the MinMax measure, and uses the delaunay sample selector to select new samples for this output. It builds models using the model builder defined higher up in the xml hierarchy. As you can see, you can add multiple measures to one Output, so that each measure has something to say in deciding the accuracy of the models. However, you can only select one SequentialDesign or odelBuilder.
For information on how multiple measures are handled and the configuration options of each measure, see Measures.
By default, a complex output is treated as such and is passed in its original form to all the components of the toolbox. However, some components, do not support complex numbers directly and are therefore incompatible with the default setting (they will give an error). In order to get these components to work with complex outputs, the outputs will have to be pre-processed. This is done by changing the complexHandling attribute of the Output. There are 3 valid values for this attribute:
- complex: Complex outputs are treated as is. Will not work with components in the aforementioned list.
- split: Complex numbers are split in real and imaginary parts, and each part is modeled separately. This means that two models will be built, and the toolbox will have twice the work it would normally have. Also any correlation between the real and imaginary part is lost.
- real: Only the real part of the complex number is modeled, the imaginary part is discarded.
- imaginary: Only the imaginary part of the complex number is modeled, the real part is discarded. The imaginary part is treated as one real output.
- modulus: The modulus of the complex number is modeled instead of the original number. Since the modulus is a real number, it can be modeled using all the components available.
A full-blown example for the InductivePosts test function that uses all the options mentioned in this article can be found below:
<!-- Model outputs S11 and S12 using the LOLA sample selector (overwrites the beforementioned setting). Uses cross-validation for model evaluation. Both complex outputs are treated as two separate real numbers with no relation to each other, resulting in total in 4 reals that will be modeled for these two complex outputs. --> <Output name="S11,S12" complexHandling="real"> <SequentialDesign>lola</SequentialDesign> <Measure type="CrossValidation" target=".01" /> </Output> <!-- Model output S12 as a complex number using the error sample selector. Models are evaluated using the ValidationSet measure. The CrossValidation accuracy of the model is also calculated for comparison purposes, but isn't used in the modeling algorithm. --> <Output name="S12" complexHandling="complex"> <SequentialDesign>error</SequentialDesign> <ModelBuilder>svmps</ModelBuilder> <Measure type="ValidationSet" target=".05" /> <Measure type="CrossValidation" target=".05" use="off" /> </Output> <!-- Model the modulus of complex output S22 using cross-validation and the default model builder and sample selector. --> <Output name="S22" complexHandling="modulus"> <Measure type="CrossValidation" target=".05" /> </Output>
See the page Running#Models_with_multiple_outputs.