Contents

1 Introduction

1.1 SGE Circus user manual

1.2 SGE CalcGuide user manual

1.3 SGE Circus videos (external)

2 Keyboard shortcuts, mouse gestures

3 Features

4 Data handling

4.1 Open / Add / Replace FileSet

4.2 Delete FileSet

4.3 Drag and drop, paste clipboard

4.4 File update

4.5 Check files

4.6 Delete data

4.7 (Data) Info

4.8 View / edit comment

5 Channels

5.1 Add / Delete

5.2 Select / Search channel

5.3 Channel configuration

5.4 Color

5.5 Range

5.6 Show / hide

5.7 Shift

5.8 Style channels automatically

5.9 Channel info

5.10 Rename

5.11 Channel wizard

5.12 Analyze

Histogram

FFT

MapArtist

5.13 Show calculated channels

5.14 Split channels

5.15 Reduce data

5.16 Create mark indication channel

6 View

6.1 Main view

6.2 Overview

6.3 GPS view

GPS lap step click

Overview / GPS options

6.4 Tabs

6.5 Snapshot

7 Cursors

8 Marks

8.1 Add mark

8.2 Delete mark(s)

8.3 Configure marks

8.4 Cut / Extend options

8.5 Invert marks

8.6 Import marks

8.7 Automatic mark creation

Split equally

Classify

Ramp / step detection

Logical mark detection

8.8 Section optimization

Optimization methods

Optimization proceeding

9 Annotations

9.1 Add annotation manually

9.2 Add annotations from file

9.3 Select annotation

9.4 Delete annotation

9.5 Edit annotation

10 Templates

10.1 Save template

10.2 Load template

10.3 LastTemplate

10.4 Cleanup

10.5 Restrictions

11 Save data

11.1 Save session

11.2 Save to file

11.3 Copy (to clipboard)

12 Present, print, organize

12.1 Copy to clipboard, print

12.2 Window handling

13 General information



SGE DataArtist – User Manual

www.sge-ing.de – Version 1.62.67 (2022-07-24 22:21)

1 Introduction

The SGE DataArtist is a tool to visualize and analyze measurement data. This manual contains information concerning specifically the SGE DataArtist only. The SGE DataArtist is part of the SGE Circus. For help topics regarding general features please refer to the corresponding documentation accessible using the links below.

1.1 SGE Circus user manual

The SGE Circus documentation makes available general information regarding data loading procedure, input handling, preferences, history and other topics concerning all tools.

1.2 SGE CalcGuide user manual

The SGE CalcGuide is a tool to implement calculation routines by creating graphical flow chart diagrams - included with all tools.

1.3 SGE Circus videos (external)

Videos and tutorials are available on the internet.


For information regarding the version dependent software changes please refer to the Release notes accessible using the corresponding menu item inside the SGE Circus.

2 Keyboard shortcuts, mouse gestures

Many functions are quickly accessible via keyboard shortcuts. For a list of available keyboard shortcuts, see the list below. In addition, the entries in the menus and context menus as well as the tooltips of the toolbar point to shortcuts.

Data Handling

Ctrl + Shift + o

Add FileSet... Multiple files will be appended to one FileSet.

Alt + Shift + o

Add FileSet quick... Just the files will be asked – the options will be maintained.

Shift + o

Add multiple FileSets... Multiple files will be opened as multiple FileSet comparison overlay.

Ctrl + o

Replace FileSet, Open first FileSet...

Alt + o

Replace FileSet quick... Just the files will be asked – the options will be maintained.

Ctrl + Del

Delete all channel(s) of one or multiple FileSet...

Ctrl + s

Save data...

Ctrl + Shift + s

Save session...

Ctrl + d

Delete data...

Ctrl + c

Copy data to clipboard

Ctrl + v

Paste files from clipboard into present session...

Ctrl + Shift + i

Data info

Ctrl + m

Edit file comment...

Template Handling

Shift + t

Open template...

Shift + s

Save template ...

Main View

+/-

Mouse left button drag

Ctrl + Mouse Wheel

Zoom in / out

Mouse double click into cursor value table

Center view to cursor

Shift+space

Zoom to cursors (if two cursors are present)

(Ctrl + ) ← →
(Ctrl + ) Pageup/down

Mouse right button drag

Mouse Wheel

Pan left / right

Ctrl + Pageup/down pans one axis unit and can be used to pan exactly one cycle if the axis is combustion cycles for indicating measurements.

Ctrl + r

Ctrl + F12

Reset axis view to cover entire file(s)

Mouse drag at left/right end of main view

Resize main view to create space for the cursor if these should not overlay the main view.

Ctrl + x

Set x-axis range...

Ctrl + shift + c

Copy window to clipboard..., Print window...

F5

Snapshot all artists

Overview

F6

Toggle overview

Ctrl + F6

Add / remove channel to / from overview

Shift + ← →

Focus section left / right

GPS view

+/-

Mouse left button drag

Ctrl + Mouse Wheel

Zoom in / out

Ctrl + r

Ctrl + F12

Reset axis view to cover entire file(s)

Cursor

Space

Cursor on / off

Ctrl + space

Insert new cursor

Esc

Delete cursor

Shift + 1..9, Mouse click

Set active cursor

Mouse double click into cursor value table

Center view to cursor

Shift+space

Zoom to cursors (if two cursors are present)

← →

Move cursor left / right

Ctrl + Shift + ← →

Move cursor left / right until next value change of selected channel

Ctrl + Shift + Up / Down

Move channel in cursor list

Alt + h

Toggle cursor options “Show hidden channels” and “Show only selected channel”.

Channels

Ins

Add channel(s) to the FileSet that correlates to the selected channel...

Ctrl + Shift + Ins

Add channel(s) to all FileSets. The selected channel dictates the FileSet whose channel list will be presented for channel selection.

Del

Delete channel(s)...

Ctrl + Del

Delete all channel(s) of one or multiple FileSet...

Enter

Mouse double click

Channel range set.
Common Y axes arrangement.

Ctrl + 0..9

Switch predefined ranges for selected channel (repeatedly)

Ctrl + Shift + 0,ß

Switch predefined ranges for all channels

Ctrl + +/-

Ctrl + Drag with right button pressed

Scale selected channel

Ctrl + Up / Down

Drag with right button pressed

Move selected channel up / down

Shift + enter

Color channel...

Shift + n

Next color

Ctrl + n

Previous color

Ctrl + h

Hide / show channel

Shift + h

Hide / show all channels sharing the common Y axes of the selected channel

Ctrl + Shift + h

Hide / show all channels sharing the FileSet of the selected channel

Esc

Unselect all channels

Ctrl + Mouse click

Add channel to the common Y axes of the currently selected channel. Show channel if hidden.

a..z0..9_-*

Select channel by uninterrupted typing of its name. Use * as wildcard character.

F2

Rename selected channel...

Ctrl + F2

Rename all channels using replacement patterns...

Ctrl + shift + x

Mouse right button drag*

Axis shift of channel(s)...

* When multiple FileSets loaded

Ctrl + Shift + Up / Down

Move channel in cursor list

Ctrl + F6

Add / remove channel to / from overview

F3

Select channel... Hide/show all other channels.

F4

Channel configuration utility (manual)...

Shift + F4

Channel styling utility (using patterns)...

Ctrl + f

Channel wizard (filter etc.)...

Ctrl + i

Channel info...

Shift + z

Toggle markers for selected channel or all if none is selected.

Ctrl + Shift + z

Toggle markers +lines for selected channel or all if none is selected.

Tabs

Ctrl + t

Add tab...

Ctrl/Shift + tab

Activate next/previous tab

Marks

Shift + Ins

Add mark...

Shift + Del

Delete mark(s)

Ctrl + Shift + Del

Delete marks by condition...

Shift + i

„Split equally“ mark creation...

Shift + c

„Classification split“ mark creation

Shift + r

„Ramp / step detection“ mark creation

Shift + l

„Logical“ mark creation

Shift + x

Cut / extend marks...

Ctrl + Shift + F4

Configure marks (color, transparency)...

Annotations

Ctrl+a

Toggle visibility of the annotations

Ctrl + Shift + a

Add annotation manually...

Alt + Shift + a

Add annotations from file...

Shift + a

Select annotation...

Enter

Edit selected annotation...

Del

Delete selected annotation...

Undo / Redo

F1

Show manual...

Shift+F1

Show keyboard shortcut manual...

Ctrl + z

Undo (views, marks)

Ctrl + y

Redo (views, marks)

3 Features

The main features of the SGE DataArtist are listed in this introduction. For details please see the following sections.

Data Import

Data Export

Session

Template

History

Display Configuration

Cursor

Marks

Annotations

Section Optimization

Data Processing

Measurement Information

Channel Information

Graphic Export

Data Exchange

4 Data handling

The data loading procedure is explained in the documentation of the SGE_Circus because as it is common to all tools. We recommend that you read that section first as useful features like sample reduction, logical load conditions, calculated channels are explained there.

SGE Circus documentation "Loading data"

4.1 Open / Add / Replace FileSet

When starting the DataArtist you will be immediately asked for files and channels to load. Data is organized in so called FileSets. A FileSet consists of one or more files. In the case of multiple files, the files are automatically sequenced. To be able to recognize the file borders, the channel “FileCnt” can be loaded, which displays them graphically and textually, if the text translation option is active in the cursor (Cursors).

The DataArtist can handle multiple FileSets. So when you already have loaded data and you choose to add another FileSet the data loading procedure is repeated and a second FileSet is created. The channels names are extended with “_F2” for second FileSet. If the second FileSet contains channels that are also loaded in the first FileSet they are put together on common Y axes and colored similarly.

Using drag and drop or pasting files enables to quickly load any number of files. See the following chapter for details.

FileSets can be shifted and synchronized. You can simply pick any channel of a FileSet with the right mouse button and drag it horizontally. After releasing the mouse button you can decide whether to shift all channels of this FileSet accordingly. Alternatively you can do a automatic synchronization (see below).

Several modes to add and replace data are supported.

After data loading process you are asked for some options.

You can also replace a FileSet (Ctrl + o). Just mark one channel of the FileSet and choose “Replace FileSet”. The channels and load data options are asked and prefilled with the information from the FileSet to replace. When replacing a FileSet while multiple Tabs exist sharing the same files you will be asked whether to replace the files for all Tabs.

To speed up data loading use the Add/Replace FileSet quick feature (Alt + o, Alt + Shift + o). Only the file(s) to load will be asked then. The options will be maintained. Therefore it is easy to replace or add files while keeping all display settings, calculated channels etc. In case a channel is selected its FileSet will dictate the options to use. In case no channel is selected (Esc) the first FileSet will be used when adding a new FileSet. To replace a FileSet a channel must be selected when multiple FileSets exist.

4.2 Delete FileSet

To delete all channels of the FileSet and therefore the entire FileSet use the corresponding menu item or keyboard shortcut (Ctrl + Del).

4.3 Drag and drop, paste clipboard

In addition to using the file load dialog, you can load sessions, templates and data files by using drag and drop or the clipboard. To do this, one or more files can be dragged directly to a DataArtist session or inserted via keyboard shortcut (Ctrl + v). It is also possible to copy files directly to the clipboard as well as strings containing the file names line by line.

Adding data files this way will create one or more new FileSets. Choose how to handle the file(s) to add. You can create a new FileSet or replace an existing one.

4.4 File update

If you already have loaded a FileSet and use the Replace functionality it is automatically checked for an update. This means that if in the directory of the currently loaded file exactly one file with the same ending exists that has a newer file date this one is proposed to be loaded directly without asking options.

4.5 Check files

The files the data was loaded from is remembered and will be used e.g. to prefill the dialogs when reloading data. They can also be displayed using the data info (Ctrl + Shift + i).

It may happen that files have been renamed or moved during the work or after reloading a session. Use the “Check files” option in this case to search the missing files and update their names and path automatically. Remember that sometimes it is not possible to find missing files. Especially all files must be located in the same directory. The option “Continue + Remember” allows you to save search results and apply them quickly next time without prompting. To reset these saved replacements, the software must be restarted or the corresponding option must be used when the message after automatic replacement is displayed.

4.6 Delete data

Data may also be deleted (Ctrl + d). This is mainly useful to reduce the size of session files to save or to avoid Out Of Memory errors when handling big amounts of data. Beneath deleting single channels (Del) or FileSets (Ctrl + Del) it is also possible to delete data e.g. inside/outside the actual view or inside/outside the marks.

Channels without remaining data will be deleted afterwards. Deleting data cannot be undone. Deleting data is not remembered in a template file. So loading a template from a session with data deleted will again load the complete data.

4.7 (Data) Info

You can display some information about the loaded data (Ctrl + Shift + i) like file names, comments, axes details, data loading history and calculated channels. This may be helpful to document the work done. In case of multiple loaded files you can also see the axis order of the files from this information.

Calculated channels will be shown by opening them in the CalcGuide. This is just for display purpose. Modifications done in the CalcGuide will be discarded. In order to be able to find calculated channels quickly but also to be able to view the sequence of the calculation, they are displayed unsorted and sorted.

The data can be copied to the clipboard.

4.8 View / edit comment

For some file formats (MDF, Keihin, 2D) editing of the file comments is supported (Ctrl + m). In case of multiple loaded files you will be asked which file to edit. You can also choose all and the comment of all files will be overwritten with the input.

An option allows you to decide whether the file date is to be updated or left unchanged.



5 Channels

5.1 Add / Delete

You can add channels to a single FileSet (Ins) or to all FileSets at once (Ctrl + Shift + Ins). The added channels will be loaded with the same settings (e.g. logical load condition) as the data already displayed. In case channels should be added to all FileSets the selected channel dictates the FileSet whose channels are presented for channel selection.

The FileSet to add the channels is displayed in the heading of the channel selection dialog.

When channels are added that are already loaded but are hidden they will be made visible.

It is also possible to delete single channels (Del) or all (Ctrl + Del) channels of the FileSet that correlates to the selected channel from the display. Deleted channels will also be removed from overview and GPS view. Deleting a FileSet (Ctrl + Del) offers additional options, e.g. to delete only empty, invalid or invisible channels. Since it also provides an option to select channels, it can also be used to delete only parts of a FileSet.

5.2 Select / Search channel

Exactly one channel can be selected at a time. The selected channel is underscored in the cursor and highlighted through a increased line width of its data curve.

To select a channel you can click to its data curve or its name in the cursor. You can also perform a long click to highlight and display the channel exclusively for a short time.

It is also possible to select a channel by uninterrupted typing of its name in lowercase letters. After stopping to type a matching channel will be searched and the first match will be selected and display exclusively for a short time. Use * as a wildcard character.

The state of exclusive channel display can be extended using the Shift key. After releasing the Shift key the previous state is restored.

Alternatively a channel may be selected using the corresponding menu item (F3).

5.3 Channel configuration

Various display options can be modified using the channel configuration dialog (F4). The input can be saved to and loaded from a file using the “Data” menu to allow quick access to commonly used settings. Also quick access to the latest configuration is available in the “Data” menu and an options to save the current configuration as a default for channels loaded at a later time. This way default configuration can be generated e.g. from an old session.

5.4 Color

Channel color

You can modify the color of each channel by a color selection dialog (Shift + enter) or quickly by switching to next / previous color (Shift + n, Ctrl + n). In case the channel is a scatter channel you will be asked for the color source channel instead of the color itself.

The colors are remembered as a preference for the channels names. So if channels are loaded at a later date the colors will be reused if the channels names are already registered.

Color FileSets

The option “Color all FileSets” will automatically color channels of multiple FileSets accordingly to the color of the corresponding channels of a master FileSet. To find corresponding channels the names must only differ after an underscore (gear → gear_F2, gear_Var1 → gear_Var2). The colors will get lighter with higher FileSet numbers. This way you can easily come to a clearly visible file comparison by coloring the first FileSet with strong colors and the choosing this option.

5.5 Range

A set of features is available to adjust the channels Y-ranges. The ranges are remembered as a preference for the channels names. So if channels are loaded at a later date the ranges will be reused if the channels names are already registered. If these ranges would lead to place the data loaded completely outside the screen range they will get discarded.

Range / common Y axes settings

The range and tick dimension of the y-axis can be set for each channel separately. Additionally multiple channels can be assigned to a common y-axis using the channel range dialog (Enter, Mouse double click to channel or cursor entry).

You can provide the limits only or the limits and the spacing. For the limits only enter them as numerical values separated by spaces. For limits and spacing enter a valid MATLAB vector syntax with colons. If the limits difference does not match a multiple of the spacing the max. limit is modified accordingly. The maximum limit can be lower than the minimum to create a reverse axis. Maximum and minimum limit must not be equal.

These Y-range and scaling can also be accessed by keyboard shortcuts or mouse gestures (Ctrl + +/-, Ctrl + Up / Down).

Examples:

You can alternatively choose from a list of predefined ranges. For example 2/5 means that the y-axis is split in 5 parts and the channel is placed in the 2nd one from the bottom. If "Smart range" in the menu is turned on the limits will be adjusted to some round values. These actions can also be accessed by keyboard shortcuts (Ctrl + 0..9, Ctrl + Shift + 0,ß). The selection in the predefined ranges field will only be considered if values for limits and spacing are not modified.

With the check boxes you can choose the channels that should use one common y-axis. Initially all channels sharing the axis of the selected channel are checked. When you check additional boxes these channels will be scaled to the axes of the already checked channels. If you uncheck boxes these channels are set to a separate (new) axis. If you uncheck multiple channels all of them will be set to one new common Y axis.

A common action for all channels can be performed to group all channels to one single common Y axis or to remove all common Y axes correlation and use separate axes for the single channels. When this option is used the checkboxes above will be ignored.

Additionally a channel can be added quickly to the common Y axis of the currently selected channel (Ctrl + Mouse click).

Range adjustment using mouse

The positioning and range setting can be done very easily using the mouse.

All operations refers to the selected channel. All channels of a common Y axis will be handled commonly.

Smart range setting

In the channel menu you can check a “Smart range” option. In this case the y-axis range is rounded to even values when using the predefined ranges or mouse actions.

Range adjustment using keyboard shortcuts

Several keyboard shortcuts are supported to quickly adjust the channels Y-ranges (Ctrl + 0..9, Ctrl + Shift + 0,ß, Ctrl + +/-, Ctrl + Up / Down). See “Keyboard shortcuts, mouse gestures“ for a full list of supported shortcuts.



5.6 Show / hide

Channel can be hided in the graphical view (Ctrl + h). Depending on the configuration of the cursor they are anyway listed in the cursor table to allow data evaluation.

It is also possible to hide/show all channels sharing a FileSet at once (Ctrl + Shift + h) or all channels sharing a common Y axis (Shift + h).

Additionally a hidden channel can be shown quickly by using Ctrl + Mouse click. Remember that this also adds the channel to the common Y axis of the currently selected channel.

5.7 Shift

You can shift one or all channels of a FileSet (Ctrl + shift + x, Mouse right button drag). This means that its axis values are modified with an offset. The mode can be absolute or relative. When relative is chosen the input value is added to the actual offset. When absolute is chosen, the actual value is ignored and the total offset is set to the input value. Shifting channels may also be done using the Channel Configuration dialog (F4).

This feature is e.g. helpful is you want to correct emission analyzer time offsets to synchronize emission channels to ECU measurement channels.

5.8 Style channels automatically

This feature (Shift + F4) will automatically style channels depending on search patterns related to the channel names. You can use rules to select channels relating to their names and apply colors, markers, line style, ranges and common Y axes settings.

Example:

Cyl1*mean :: 0 100 (From 0 to 100 with automatic spacing)

For limits and spacing enter a valid vector syntax with colons. If the limits difference does not match a multiple of the spacing the max. limit is modified accordingly. The maximum limit can be lower than the minimum to create a reverse axis. Maximum and minimum must not be equal.

Example:

Cyl1*mean :: 0 : 10 : 100 (From 0 to 100 with spaces of 10)

Cyl2*mean :: 100 : -10 : 0 (Reverse axis from 100 to 10 with spaces of 10)

For a relative range part enter the part and range separated by a /.

Example:

Cyl1*mean :: 1/4 (First quarter from the bottom)

Cyl2*mean :: 2/4 (Second quarter from the bottom)

Cyl3*mean :: 2-3/4 (Second to third quarter from the bottom)

Cyl4*mean :: 1/1 (Fill entire screen)

Cyl5*mean :: 1 (Fill entire screen)

For all assignments you can decide whether the string interpretation should be case sensitive and treated as a regular expression.

5.9 Channel info

If a channel is selected you can get information regarding its source, values and axis by the channel info (Ctrl + i). Some statistical values of the currently visible axis section of the channel, min, max, mean, std values and curve fits are displayed. This allows quick determination of e.g. the underlying data files, FileSet number, data gradients, mean values and standard deviations. The information is calculated from the channel data within the current x-axis range. Adjust the visible area accordingly before requesting this info to ensure to get the information desired. The display of this dialog may last long in case of channels with big data amounts.

Since the calculation can be time-consuming, there is the possibility to close the waiting bar. The data calculated until then will be displayed.

5.10 Rename

Channels are handled with the names loaded from the data files. For FileSets > 1 automatically extensions (_F2) are added.

You can rename the channels. Either individually when a channel is selected (F2) or using replacement patterns (Ctrl + F2).

The names must be unique within the loaded channels. If you need the name to agree with the ASAP MCD rules it must consist of a-zA-Z0-9[]_. only with a max. length of 32 characters.

When renaming the selected channel a dialog allows to modify the channel name and its unit.

When renaming the channels using replacement patterns they must be given one rule per line. The string to look for and the replacement are separated by two colons, like "EngineSpeed :: RPM". A special meaning have "<<" and ">>". In this case the replacement pattern is appended to the beginning (<<) or end (>>) of all channels of the selected FileSets. This is used to append without replacing. E.g. for FileSet1 channels - when no _F2 is available to replace.

Examples:

The replacement is case sensitive and done in the order of lines from top to bottom.

After the editing was done a message will inform about the channel name modification and allows to undo the changes.

5.11 Channel wizard

The channel wizard allows to create new channels by performing common tasks (like filtering, statistical evaluation, curve fitting) to the loaded channels.

Channels created by the wizard will not give reliable results when loading a template – especially when using logical load conditions. It is recommended to add the channels directly as calculated channels when loading the data if templates should be saved.

5.12 Analyze

The “Analyze” menu supplies some commonly used tasks to analyze the data of the selected channel.

5.12.1 Histogram

A 2D or 3D histogram view of one or two channels will be displayed. The histogram data can be exported to different graphics and data formats. The following options are available:



5.12.2 FFT

One or more FFT analysis of the actual selected channel data will be created. For the FFT to have a meaningful frequency axis the data of the channel to analyze must be sampled with constant frequency and the axis unit must be seconds. If this is not the case, the FFT will be calculated for an average sampling rate and you will be notified accordingly. If the source data deviates from this sampling rate or the axis unit is not seconds, you must interpret the frequency axis yourself.

5.12.3 MapArtist

Three channels of the loaded data can be send to the SGE MapArtist to create and visualize a map. The following options are available:

5.13 Show calculated channels

The loaded calculated channels can be displayed. You can only visualize the calculated channels here. To modify them you need to reload the FileSet and edit the calculation. In order to be able to find calculated channels quickly but also to be able to view the sequence of the calculation, they are displayed unsorted and sorted.

5.14 Split channels

Split channels to create individual channels for single sections of the data loaded. This makes it possible, for example, to conveniently superimpose individual sectors of the data loaded without loading multiple FileSets. Common use cases are the superposition of the single laps of a race track recording or the superposition of single combustions of a cylinder pressure indication recording.

The following example figures show the superposition of the single combustion cycles of a pressure indication recording. The split was done based on the marks set to cover the single combustions.

5.15 Reduce data

This function allows data reduction by removing data points so that a given tolerance is not exceeded. As many data points as possible will be removed without the reduced channel deviating more than this tolerance from the original one.

The following example figures show the reduction of a channel with a tolerance of 2%.

5.16 Create mark indication channel

If marks are existing you have the option to create a channel that will have a value of one inside the marks and zero outside. This channel can be used e.g. as a logical load condition according to the marks or to recreate the marks easily in a loaded template.

6 View

The DataArtist window has three main sections. The main view, the overview at the bottom and the GPS view at the right bottom. Overview and GPS view must be activated to be visible (F6).

Using tabs enables to create multiple views in parallel. See section “Tabs”for details.

6.1 Main view

The main view in the top section can be adjusted quickly by using mouse and keyboard shortcuts – e.g. zoom, unzoom (Mouse left button drag, +/-, Ctrl + Mouse Wheel) and panning (Mouse right button drag, (Ctrl + ) ← →, (Ctrl + ) Pageup/down). The view can also be reset to cover the whole axis range using shortcuts (Ctrl + F12, Ctrl + r).

It is also possible to adjust the view to the cursor positions (Shift+space) if exactly two cursors are present and to resize the main view on the left and right end using the mouse to create space for the cursor if these should not overlay the main view.

The display settings can be modified using the following dialog via the “Display settings” menu item.

Some display options are available using the corresponding menu items:

6.2 Overview

The overview (F6) always covers the whole horizontal axis range. If the main view shows only a section of it this is displayed in the overview by a white rectangle. The main view and this rectangle are linked. So you can zoom or pan in the main view and the overview rectangle will adjust or you can drag or extend the rectangle using the mouse and the main view will adjust.

Additional rectangles can be created and activated by dragging with the mouse inside the overview. This allows quick switching between main views. Deletion is done by double clicking them.

You can add any number of channels to the overview. By default each channel is scaled to fill the overview. In this case the overview does not allow any data value interpretation or comparison. Using the “Overview / GPS options“ enables you to apply a user defined range also for the overview. It is remembered as a preference and when the channel is used next time in the overview the user defined scale is applied. If you like to re enable the automatic scaling you could enter “auto” or just “a”.

To quickly create a big number or exactly defined overview sections you must first create marks and can then create overview sections from it.

6.3 GPS view

The GPS view is shown when the channels for Latitude and Longitude are set and the overview is enabled. These channels must already be loaded. Even if its called a GPS view it can be used as an all-purpose xy view to display the operating point. If cursors are activated the positions are marked in the GPS view. The actual main view range is indicated by a continuous line.

6.3.1 GPS lap step click

By clicking onto the GPS view the main view is centered to the GPS point clicked. In case the data consists of multiple sections with similar GPS data (e.g. laps on a race track) you can click several times to the same GPS position to jump between the sections (=laps).

6.3.2 Overview / GPS options

Overview and GPS view are configured using the following dialog.

6.4 Tabs

Using tabs enables to create multiple views in parallel.

Tabs can be added, copied, deleted, renamed and reordered using the corresponding menu item or the context menu. Use keyboard shortcuts to add (Ctrl + t) and activate tabs (Ctrl/Shift + tab) quickly.

The single tabs are fairly independent. The loaded data, axes ranges, marks, cursors, overview/GPS view configuration does not interfere. Central settings like e.g. font size, background color and cursor settings are shared by all tabs.

By activating the corresponding option the x-axis ranges will be synchronized. This means that the x-axis range is kept when activating another tab. Otherwise each tab maintains its own x-axis range. The option “Sync tab cursors” enables to synchronize the cursor positions of all tabs. If the corresponding option is activated the tab buttons will provide mouseover tooltips containing useful information like the files loaded.

When replacing a FileSet while multiple Tabs exist sharing the same files you will be asked whether to replace the files for all Tabs.

Tabs are also handled by sessions and templates.

6.5 Snapshot

If you work with multiple DataArtist instances in parallel you can quickly import the channels displayed from the other instances using snapshot functionality (F5). These snapshots are static. They cannot be modified and are printed with display resolution. Therefore you will not see all data point when zooming.

All instances of the DataArtist to use for snapshots must be started from the same SGE_Circus.

7 Cursors

Data cursors allow to analyze data quickly. Just click with the mouse into the axis area besides a channel and the first cursor will appear (Space). You can add any number of cursors (Ctrl + space). The selected cursor is the master. All other cursors display the differences (absolute, relative) from the master cursor besides their own values if activated in the cursor options.

In case of multiple cursors the master can be set by clicking the cursor line, clicking the cursor value table or by using keyboard shortcuts (Shift + 1..9). To center the view to a cursor double click into the cursor value table.

To remove the active cursor press Esc.

When moving a cursor with the mouse or the arrow keys you will get a cross cursor. If a channel is selected it is also possible to move the cursor with a keyboard shortcut to the next position where the value of the selected channel is changing (Ctrl + Shift + ← →).

It is possible to adjust the view (X-axis range) to the cursor positions (Shift+space) if exactly two cursors are present and to center the view to a cursor (Mouse double click into cursor value table).

The cursor can be configured regarding these options:

The channel order inside the cursor table can be modified by menu item or keyboard shortcut (Ctrl + Shift + Up / Down). The “Sorted” attribute will be automatically turned off in this case.

If the GPS view is activated all cursor positions are marked there.

The cursor table containing the channel names can be moved vertically using the mouse and between the left and right side by dragging it with the mouse to the other side. You will not see the horizontal movement until you moved the mouse completely to the other side. Additionally the main view can be indented on the left and right end using the mouse to create space for the cursor if these should not overlay the main view. Use the “Location inside diagram” option to determine whether the cursor text is located inside or outside the main view.

8 Marks

Marks define parts of the axis range. They are displayed as green rectangles covering the corresponding axis range in the main view. They are used to define sections for data analysis, saving and optimization. Marks can not overlay.

Marks can be created manually or automatically in several ways and using the mouse while Shift-key is pressed.

8.1 Add mark

A mark can be created by entering the x-axis start and end value of the mark (Shift + Ins). Alternatively draw a new mark with the mouse with Shift-key pressed in the main view.

8.2 Delete mark(s)

Marks can be deleted by using the menu item, a keyboard shortcut (Shift + Del) or dragging them outside the main view with the mouse while Shift-key is pressed or by definition of criteria depending on their length and axis positioning (Ctrl + Shift + Del).

8.3 Configure marks

You can configure the marks color and transparency for all or the selected marks (Ctrl + Shift + F4). You can decide whether so save the settings as a global preference.

8.4 Cut / Extend options

You can modify marks by cutting or extending them (Shift + x).

This can be used e.g. to cut transient sections at the start of the marks. As is is possible to move the mark borders in both directions it is also possible to completely move a mark by e.g. extending its start and cutting its end by the same value.

8.5 Invert marks

Using this option unmarked sections are marked and the existing marks are deleted.

8.6 Import marks

Marks can be imported from a data file. So if you have the mark start and end axis values in a file you can use this to quickly create marks. This is especially useful to recreate marks that were saved together with data to a file before.

8.7 Automatic mark creation

For all automatic mark creation procedures you can choose in which section you want to work.

You can also activate a section optimization. See below for details.

If marks already exist and you start a mark creation again, for some procedures you will be asked if you want to use level 2 settings. In this case the following dialogs for further marker creation will be handled separately to allow individual preassignment, history and storage.

8.7.1 Split equally

Each section to work on will be split equally into a number of new marks (Shift + i).

Zero has a special meaning: The sections are split into the single data points. If a channel is selected its data points will be used. If no channel is selected all data points of all channels will be used. This is e.g. useful if you want every single data point to be used in a optimization separately.

If you have a big number of data points you should turn off drawing marks in this case because it slows down the graphics. SeeSection optimization“ for details regarding this option.

8.7.2 Classify

This method creates marks using a channel and a classes vector (Shift + c). The channel will be used to determine splits when the value of the channel crosses of the classes vector values. So for example you can automatically set marks that classify the measurement into sections of 1000 1/min during an engine speed ramp. Additionally you can use the axis to create classified marks of a specified length.

Options:

8.7.3 Ramp / step detection

You can search areas in the measurement, where a channel has ramp or step characteristic (Shift + r). So for example you can extract the measured ramps in engine bench measurements omitting the warm up and stop engine areas. Or you can analyze ignition sweeps.

If you need more than one channel to identify steps insert a calculated channel that is the sum or product of all needed channels. Factors can help to adjust big differences in signal ranges. A helper function for this case is "multichannel_normalize". It can be passed any number of channels that will get scaled and multiplied. See the SGE_Circus calculated channel documentation for further information.

Options:

8.7.4 Logical mark detection

You can search in the data for sections where a logical condition is true (Shift + l). Logical mark detection is very fast compared to other methods. Using calculated channels to define the condition enables to perform complex mark detection.

Options:

8.8 Section optimization

Section optimization can be activated for every automatic mark detection method. This allows to determine the optimum of a section regarding one or multiple parameter channels. In this case the produced marks of a section are regarded as single points and an optimum point is estimated. With this function you can e.g. evaluate ignition sweeps or find the minimum fuel consumption for a operating point depending on injection and cam timing.

The result of a section optimization are then additional channels that contain for every section optimum values (*_opt) for parameter and optimization channel and the fitted values (*_fit) for the optimization channel for every mark. To save the result you can easily mark all optima with a logical condition.

For example to evaluate ignition sweeps the proceeding is the following:

First you do a mark creation (without section optimization) with one mark containing one operating point. So e.g. one mark covers the section of the measurement where engine speed and load are constant. During this section the ignition angle is varied.

Then you start a mark creation in the already existing operating point marks with criteria to mark the single ignition angles. During this mark creation activate the section optimization. Then you are asked to choose the settings for the optimization.

8.8.1 Optimization methods

Different methods to find the optimum are available. These differ in the number of dimensions (= number of parameter channels) and the method used to fit the data and determine the optimum.

1D polynomial fitting

You can choose one parameter channel (e.g. ignition angle). A polynomial curve (order can be chosen) is fitted to describe the relation between the parameter and the optimization channel to find the optimum value for the parameter. A polynomial curve generally does some kind of measure error compensation. This method is only useful if the data shape can be described by a polynomial.

The following additional options are asked for this optimization method:

Example "ignition sweeps":

Choose "torque" as optimization channel and "ign_angle" as parameter channel. Then "torque_opt" and "ign_angle_opt" will be created as new channels containing the optimum torque and corresponding ignition angle during the sweeps and NaN otherwise while "torque_fit" contains the fitted polynomial values for each mark. With the logical condition ~isnan("torque_opt") you can easily mark all optima to save them as statistical values.

1D cubic interpolation

This method works very similar to "1D polynomial fitting" but instead of the polynomial a cubic curve is used. This is useful if the data behavior cannot be described by a polynomial and has little measurement errors, because the fitted curve will always contain the measured points.

The following additional options are asked for this optimization method:

1D simple selection

From the marks of the section the best one is simply selected. No interpolation or fitting is done. Therefore the optimum will always be a member of the created marks and no optimum in between can be found.

The following additional options are asked for this optimization method:

2D map fitting

This method works similar to "1D cubic interpolation" but for two parameters. So two parameter channels are asked and a map is fitted to the data. From this map the optimum is chosen by cubic interpolation. Map creation can be influenced in various ways.

The following additional options are asked for this optimization method:

2D simple selection

This method works similar to "1D simple selection" but for two parameters. From the marks of the section the best one is simply selected. No interpolation or fitting is done. Therefore the optimum will always be a member of the created marks and no optimum in between can be found. A map fitted to the data points is displayed but only for visualization.

The following additional options are asked for this optimization method:

8.8.2 Optimization proceeding

The optimization is done separately for each section the mark creation is done in. Each optimization can be influenced by the user.

Depending on the “Graphical interface display time” setting a window will be shown temporarily for each optimization showing the data, fit and optimum. After the chosen time the window will disappear automatically without interaction. By pressing a key or clicking to the window the automatic proceeding will be disabled.

Using the menu or mouse the following actions can be performed:

During optimization the user will be asked whether to automatically save the windows to individual files.

9 Annotations

Annotations enable to highlight and notice events in the data loaded. The visibility of the annotations can be enabled or disabled for all annotations in common (Ctrl+a).

A textual listing of all annotation can be retrieved using the (Data) Info (Ctrl + i).

9.1 Add annotation manually

Different types of annotations are available as well as different reference types of the annotations (Ctrl + Shift + a).

The following figure shows examples of annotations.

Annotation types

Reference types

Reference means that each annotation is linked to either a channel at a specific axis value, or to an axis value independently from a channel or to the window. The reference type essentially influences the behavior of the annotation when e.g. the view is modified (e.g. zoom, axes ranges).

9.2 Add annotations from file

Annotations can also be created automatically from file events/comments (Alt + Shift + a). Some file formats (e.g. *.mf4) support to store event data. This can be for example trigger events or user pause comments. Depending on the type of event annotations of different types are generated.

In case identical annotations are already exist the annotations to load will be skipped.

Filter criteria

The filter criteria determine which annotations / events are taken from the files.

Display criteria

The display criteria determine which part of the available attributes is displayed for the annotations that will be loaded from file.

Options

Choose the sections to create annotations depending on the FileSets and the following axis options:

Additionally you can decide to delete all existing annotations before creating new ones from file.

9.3 Select annotation

The axis range can be adjusted quickly to show one or more specific annotations (Shift + a). Using the corresponding menu item you will be asked to select the annotations to show or search for them.

9.4 Delete annotation

Annotations can be deleted using the corresponding menu items or the keyboard if a annotation is selected.

In case of deleting channels the linked annotations will be deleted automatically.

9.5 Edit annotation

Some properties of the annotations can be modified. Using the corresponding menu item or double clicking the annotation leads to a dialog enabling to edit it.

10 Templates

Template files are used to restore data and view configuration efficiently. It is also possible to import *.xda configuration files.

10.1 Save template

Templates are data configuration and view configuration saved to a file. You can save a template from the DataArtist at any time (Shift + s). As this file only contains configuration information it will be much smaller than a session file. But this also means that you need the data files available to load a template. Template files are therefore not useful for data exchange or or long term storage as file path may change.

In case multiple tabs already exist you will be asked which tabs to save.

10.2 Load template

You can load a template directly after you started the DataArtist or when you already loaded data (Shift + t). Several options allow you to control the template loading process.





To load a template you can choose the file or access recently used templates from the menu directly. When data should be loaded and the data files are not available you will be asked to choose the files manually.

10.3 LastTemplate

Additionally to the manually saved templates a template gets saved every time you exit the DataArtist. These templates are available as “LastTemplate” list. So you can quickly access the configuration used. The name of the template hints to the configuration as it includes the file and channel number and an abbreviated name of the first data file opened.

10.4 Cleanup

The list of recently used templates is managed automatically. So entries are automatically removed when the underlying file was deleted. Additionally you can decide to remove entries you don't need any more. You will be asked if you only want to remove the entries or also want to delete the files.

10.5 Restrictions

Some restriction apply when using templates.

Generally it is recommended to test loading a saved template before the source window is closed if you use not standard configuration. In case of problems you can always save a session file.

11 Save data

11.1 Save session

The whole session including data can be stored as file (Ctrl + Shift + s). After re-opening the whole functionality can be used again immediately. Sessions also work with xy-view, wizard channels and special channel configuration (e.g. marker).

Session files can be opened the same way as data files or using the SGE Viewer.

Session files may get very large as they contain the loaded data. Consider using templates if you want to make views and setting available. But remember that using templates brings some restrictions. See the template section for details.

11.2 Save to file

You can use the DataArtist not only to view data. You can also save data to one or multiple files (Ctrl + s).

11.3 Copy (to clipboard)

Data can be transferred comfortably to the clipboard or an external text editor (Ctrl + c). In this way, parts of the data can be made visible very quickly or used outside the software. The format of the clipboard content is configurable will be suitable to paste into a spreadsheet software.

Copying big amounts of data may last long and exceed the capabilities available.

12 Present, print, organize

12.1 Copy to clipboard, print

Analyzing data often includes the need to present the results. Therefore the DataArtist makes it available to export the actual view into the clipboard or file formatted in a way that is suitable to be useful for different targets (Ctrl + shift + c).

This can be different sizes of clipboard content. "Email" and "Document" are specially sized to fit into a email or document software. "Email" creates a bitmap format while "Document" creates a vector format. Some paper formats are also available and all windows can be printed and saved to file in various formats.

The created window is configurable. So you can move elements like legend or cursor boxes. It is also possible to add lines, arrows, text boxes etc. to the window to explain or highlight.

During creation some options will be asked to define the base layout of the window.

After closing the window the content will be copied to clipboard and can be pasted / used in the target software.

12.2 Window handling

Since the SGE Circus offers to open a considerable number of windows an automatic window handling feature is implemented. Using the corresponding menu item enables to arrange all or a subset of the windows of the current session.

13 General information

Duplication, processing, distribution or any form of commercialization of the documents content beyond the scope of the copyright law shall require the prior written consent of the SGE Ingenieur GmbH. All trade and product names given in this document may also be legally protected even without special labeling (e.g. as a trademark).

The SGE Circus includes Third Party Software. For details please refer to the → SGE Circus documentation.

SGE Ingenieur GmbH – www.sge-ing.de

Copyright 2011-2022. All rights reserved.