Observer

General

The simulation output can be controlled in the XML file using filters, except when the simulink model is used. The filters are executed serially from the first filter to the last one.

Filters are added in an <Observer> element inside the <Configuration> element. The <Observer> element can contain the elements <Electrical>, <Thermal> and <Aging>. Filters for the three parts of the model are added in the appropriate element.

CSV filter

The CSV filter generates a CSV file that uses the following format:

#Time; Elementnr; Voltage; Current; Power; SOC
#s; Number ; Voltage / V; Current / A; Power / W; SOC / %

• Time: current simulation time in seconds
• Elementnr: number of the electrical element
• Voltage: Voltage in Volt
• Current: Current in Ampere
• Power: Thermal dissipation power in Watt
• SOC: State of charge in %

XML Tag	Type	Default value	Explanation
printHeader	bool	true	determines if a header is included in the CSV file
Filename	string		filename of the CSV output

<Observer>
    <Filter4 class="CSVFilter">
        <Filename>sanyo.csv</Filename>
        <printHeader>true</printHeader>
    </Filter4>
</Observer>

STDOut filter

The STDOut filter writes values to the standard outpt.

<Observer>
    <Filter3 class="StdoutFilter"/>
</Observer>

Decimation filter

The decimation filter can be used to prevent too much output data. Data is only passed on to the next filter in the chain if a certain amount of time has passed since the last data point.

<Observer>
    <Filter2 class="DecimateFilter">
        <TimeDelay>
            0.1
        </TimeDelay>
    </Filter2>
</Observer>

Matlab filter

Data is stored in matlab files (.mat files). The files are compressed and use much less disc space than CSV files. The maximum number of samples in one file can be controlled with the attribute "maxSampleSize".

<Observer>
    <Filter1 class="MatlabFilter">
        <Filename>
            sanyo.mat
        </Filename>
        <MaxSampleSize>
            10000
        </MaxSampleSize>
    </Filter1>
</Observer>

Example: Chain of filters

The following example shows a filter chain with matlab output, decimation, STDOut-Filter and CSV output. All simulation output is stored in the matlab output file. Afterwards the data is decimated so that the minimum time between two samples is 0.1 seconds. This data is then written to the standard output and saved in a CSV file.

<Observer>
    <Filter1 class="MatlabFilter">
        <Filename>
            sanyo.mat
        </Filename>
    </Filter1>

    <Filter2 class="DecimateFilter">
        <TimeDelay>
            0.1
        </TimeDelay>
    </Filter2>

    <Filter3 class="StdoutFilter"/>

    <Filter4 class="CSVFilter">
        <Filename>
            sanyo.csv
        </Filename>
        <printHeader>true</printHeader>
    </Filter4>
</Observer>