Contents

2 Introduction

3 Keyboard shortcuts, mouse gestures

4 Features

5 Data handling

5.1 Open / Add / Replace FileSet

5.2 Delete FileSet

5.3 Drag and drop, paste clipboard

5.4 File update

5.5 Check files

5.6 Delete data

5.7 (Data) Info

5.8 View / edit comment

6 Channels

6.1 Add / Delete

6.2 Select / Search channel

6.3 Channel configuration

6.4 Color

6.5 Range

6.6 Show / hide

6.7 Shift

6.8 Style channels automatically

6.9 Channel info

6.10 Rename

6.11 Channel wizard

6.12 Analyze

6.13 Show calculated channels

6.14 Split at marks

6.15 Create mark indication channel

7 View

7.1 Main view

7.2 Overview

7.3 GPS view

7.3.1 GPS vert./horz. view ranges

7.3.2 GPS data outlier handling

7.4 Tabs

7.5 Snapshot

8 Cursors

9 Marks

9.1 Add mark

9.2 Delete mark(s)

9.3 Configure marks

9.4 Cut / Extend options

9.5 Invert marks

9.6 Import marks

9.7 Automatic mark creation

9.7.1 Split equally

9.7.2 Classify

9.7.3 Ramp / step detection

9.7.4 Logical mark detection

9.8 Section optimization

9.8.1 Optimization methods

9.8.2 Optimization proceeding

10 Annotations

10.1 Add annotation

10.2 Select annotation

10.3 Delete annotation

10.4 Edit annotation

11 Templates

11.1 Save template

11.2 Load template

11.3 LastTemplate

11.4 Cleanup

11.5 Restrictions

12 Save data

12.1 Save session

12.2 Save to file

12.3 Copy (to clipboard)

13 Present, print, organize

13.1 Copy to clipboard, print

13.2 Window handling

14 General information

g

SGE DataArtist – User Manual

www.sge-ing.de – Version 14.07.2017 06:30

2 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 like loading data and calculated channels please refer to the SGE Circus documentation.

SGE Circus documentation

This user manual can be found using the ?-menu of the DataArtist window or using the F1 button. A collection of examples and tutorials can also be found in menu.

Additionally videos and tutorials are available on the internet.

SGE Circus videos

3 Keyboard shortcuts, mouse gestures

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 + 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

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 complete 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

Cursor

Space

Cursor on / off

Ctrl + space

Insert new cursor

Esc

Delete cursor

Shift + 1..9

Set active cursor

← →

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

Channels

Ins

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

Ctrl + Ins

Insert 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 the FileSet that correlates to the selected channel...

Enter

Mouse double click

Channel range set.
Common 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 axis of the selected channel

Ctrl + Shift + h

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

Esc

Unselect all channels

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...

Shift + a

Select annotation...

Enter

Edit selected annotation...

Del

Delete selected annotation...

Undo / Redo

F1

Show manual...

Ctrl + z

Undo (views, marks)

Ctrl + y

Redo (views, marks)

4 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

5 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"

5.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 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.

5.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).

5.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.

5.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.

5.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 of a FileSet must be located in the same directory.

5.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.

5.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.

The data can be copied to the clipboard.

5.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 loaded files will be overwritten with the input.

6 Channels

6.1 Add / Delete

You can add channels to a single FileSet (Ins) or to all FileSets at once (Ctrl + 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 channels 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.

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.

6.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.

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. Use * as a wildcard character.

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

6.3 Channel configuration

Various display options can be modified using the channel configuration dialog (F4). The input can be saved in and loaded from a file to allow quick access to commonly used settings. Also quick access to the latest setting is available in the Data menu.

6.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).

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 all FileSets

The option “Color all FileSets” will automatically color all channels of all FileSets > 1 accordingly to the color of the corresponding channels of FileSet 1. 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.

6.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 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 axis.

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

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 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.



6.6 Show / hide

Channel can be hided in the graphical view (Ctrl + h). 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 axis (Shift + h).

6.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.

6.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 group 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.

6.9 Channel info

If a channel is selected you can get information regarding its values and axis by the channel info (Ctrl + i). Some statistical values of the currently visible part of the channel, min, max, mean, std values and curve fits are displayed. This allows quick determination of e.g. gradients, mean values and standard deviations.

The display of this dialog may last long in case of channels with big data amounts. Adjust the visible area accordingly before requesting this info.

6.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". The replacement is case sensitive and done in the order of lines from top to bottom. If the corresponding check box is set the strings are interpreted as regular expression.

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

6.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.

You can choose between the following methods:

You can decide to which part(s) of the data you want to apply the method. This can be the whole file or sections of it defined by marks. You can set the parts of the data that does not apply to the sections to NaN what makes them invisible.

Using the corresponding input fields you can select which channels to apply the filter/method and how to handle the source channels after creating the new 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.

6.12 Analyze

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

6.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.

6.14 Split at marks

This feature allows to split the selected channel to multiple channels. It can be useful to overlay sections of one or all channels without loading multiple FileSets.

The split borders are taken from the existing marks. If no channel in selected all channels will get split. It will be asked if the channels to create should get moved to the beginning of the x-axis.

6.15 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.

7 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.

7.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 window title and axes labels can be modified using the following dialog.

Some display options are available using the corresponding menu items:

7.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 “Fehler: Referenz nicht gefunden“ 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.

7.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. 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).

Overview and GPS view are configured using the following dialog.

7.3.1 GPS vert./horz. view ranges

Like the overview the GPS view is scaled automatically by default. As an option you may specify user defined ranges using the configuration dialog. This will be remembered as a preference and re enabled when you select the same channels again. You can also enter “auto” or just “a” for automatically scaling to match the data range or you could enter “geo” or just “g” to scale automatically equal in both directions to display geographical dimensions. This should be the preferred choice when displaying GPS data.

Both ranges will be set to “geo” automatically if you specify only one to be “geo” because either none or both directions must be “geo”. The ranges will also be set to “geo” automatically if a range does not include any data of the GPS data channel.

7.3.2 GPS data outlier handling

Implausible data like 0 may disturb the GPS view. Use the check box “Remove GPS data outliers” to automatically remove implausible data. If in some cases automatic removal may not work satisfyingly. There additional options to remove outliers are available. You may define “GPS vert./horz. plausible limits” to remove data exceeding these limits.

The limits will be removed automatically if they do not include any data of the GPS data channel.

7.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.

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.

7.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.

8 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 from the master cursor besides their own values.

In case of multiple cursors the master can be set by clicking the cursor line, double clicking the numeric window or by using keyboard shortcuts (Shift + 1..9).

To remove the selected 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 to the cursor positions (Shift+space) if exactly two cursors are present.

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 resized on the left and right end using the mouse to create space for the cursor if these should not overlay the main view.

9 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.

9.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.

9.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).

All criteria entered must apply for a mark to be deleted. It is also possible to delete all existing marks.

9.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.

9.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.

9.5 Invert marks

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

9.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.

9.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.

9.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. 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.

9.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.

The vector must be written in valid syntax.

Examples:

To avoid creation of multiple marks at the classes borders due to a toggling signal a minimum demanded mark length can be defined. Marks shorter than this axis length will be skipped.

9.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:

9.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:

9.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.

9.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:

9.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.

10 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).

10.1 Add annotation

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).

10.2 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.

10.3 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.

10.4 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.

11 Templates

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

11.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 whether to save all tabs or only the active one.

11.2 Load template

You can load a template directly after you started the DataArtist or when you already loaded data (Shift + t). Depending on the number of existing tabs as well as the number of tabs inside the template you may be asked some options.





In case multiple tabs already exist you will be asked whether to load the entire template (and replace all existing tabs) or to load only the active tab. In this case all other tabs remain unchanged.

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.

11.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.

11.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.

11.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.

12 Save data

12.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.

12.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).

Options:

12.3 Copy (to clipboard)

The data of the selected channel or all channels can be copied to the clipboard (Ctrl + c). The format of the clipboard content will be suitable to paste into a spreadsheet software. The decimal separator used for copy actions can be set in the SGE Circus preferences – by default the operating system setting is used. Copying big amounts of data may last long and exceed the capabilities available.

Sections to copy

Choose the sections to copy the data to clipboard from.

Interpolation mode

At the axis positions to copy some channels may not contain values. This might happen e.g. because of different data acquisition rates. You can decide how to proceed in this case.

Include axis

The axis values can be added to the copied data.

Copy all channels

If enabled the data of all channels will be copied. Otherwise only the marked channel will be copied.

13 Present, print, organize

13.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.

13.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.

14 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).

SGE Ingenieur GmbH – www.sge-ing.de

Copyright 2011-2017. All rights reserved.