Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Analysis Software
Manual
Issue 6.3
Manufacturer
iba AG
Koenigswarterstr. 44
90762 Fuerth
Germany
Contacts
This manual must not be circulated or copied, or its contents utilized and disseminated,
without our express written permission. Any breach or infringement of this provision will
result in liability for damages.
©iba AG 2014, All Rights Reserved
The content of this publication has been checked for compliance with the described
hardware and software. Nevertheless, deviations cannot be excluded completely so
that the full compliance is not guaranteed. However, the information in this publication
is updated regularly. Required corrections are contained in the following regulations or
can be downloaded on the Internet.
The current version is available for download on our web site http://www.iba-ag.com.
Protection note
Windows® is a label and registered trademark of the Microsoft Corporation. Other
product and company names mentioned in this manual can be labels or registered
trademarks of the corresponding owners.
Table of Contents
1 About this manual ........................................................................................... 12
1.1 Target group ..................................................................................................12
1.2 Notations .......................................................................................................12
1.3 Used symbols ................................................................................................13
2 Welcome to ibaAnalyzer – an overview ........................................................ 14
2.1 The ibaAnalyzer standard functions (not subject to license fees) ...................15
2.2 ibaAnalyzer functions subject to licensing ......................................................16
3 Operation and settings ................................................................................... 17
3.1 Starting ibaAnalyzer .......................................................................................17
3.1.1 Starting in Windows .......................................................................................17
3.1.2 Starting with command line ............................................................................17
3.1.2.1 Command line syntax ................................................................................................... 18
3.1.2.2 Using the postprocessing command ............................................................................ 19
3.1.2.3 Using the switches in the command line ...................................................................... 19
3.2 The screen.....................................................................................................25
3.2.1 Smart Docking ...............................................................................................25
3.2.2 Generating and moving tabs ..........................................................................27
3.2.3 Hide window manually ...................................................................................27
3.2.4 Hide window automatically .............................................................................28
3.2.5 Scale window automatically ...........................................................................29
3.3 The menu bar ................................................................................................30
3.3.1 The menu file .................................................................................................30
3.3.2 The database menu .......................................................................................32
3.3.3 The historical data menu................................................................................33
3.3.4 The edit menu................................................................................................34
3.3.5 The setup menu .............................................................................................35
3.3.6 The graph mode menu...................................................................................37
3.3.7 The file group menu .......................................................................................39
3.3.8 The view menu ..............................................................................................39
3.3.9 The help menu...............................................................................................41
3.4 The toolbar ....................................................................................................42
3.4.1 The tool bar ...................................................................................................42
3.4.2 Adjust tool bars ..............................................................................................43
3.5 Mouse and key commands ............................................................................45
3.5.1 Drag & Drop...................................................................................................45
3.5.2 Context menus ..............................................................................................45
3.5.3 Hotkeys .........................................................................................................46
3.5.4 Combined mouse and key operation..............................................................47
3.5.5 Tooltips ..........................................................................................................48
3.6 The signal tree window ..................................................................................49
3.6.1 "Signals" tab: tree of data file(s) and signals ..................................................49
Issue 6.3 i
Manual ibaAnalyzer
iv Issue 6.3
ibaAnalyzer Manual
Issue 6.3 v
Manual ibaAnalyzer
vi Issue 6.3
ibaAnalyzer Manual
Issue 6.3 ix
Manual ibaAnalyzer
Issue 6.3 xi
Manual ibaAnalyzer
1.2 Notations
In this manual the following notations are used:
Action Notation
Menu command Menu Logic diagram
Calling the menu command Step 1 – Step 2 – Step 3 – Step x
Example:
Select the menu Logic diagram - Add - New function
block.
12 Issue 6.3
ibaAnalyzer Manual
The non-observance of this safety information may result in an imminent risk of death
or severe injury:
From an electric shock!
Due to the improper handling of software products which are coupled to
input and output procedures with control function!
The non-observance of this safety information may result in a potential risk of death or
severe injury!
The non-observance of this safety information may result in a potential risk of injury or
material damage!
Note
A note specifies special requirements or actions to be observed.
Important note
Note if some special features must be observed, for example exceptions from the rule.
Tip
Tip or example as a helpful note or insider tip to make the work a little bit easier.
Other documentation
Reference to additional documentation or further reading.
Example
Configuration and application examples for a better understanding
Issue 6.3 13
Manual ibaAnalyzer
14 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 15
Manual ibaAnalyzer
Product Operation
ibaAnalyzer-DB Writing data and analysis files into databases
or retrieve them from databases
(MS SQL, MySQL, Access, Oracle,
DB2-UDB, other ODBC-DB)
ibaAnalyzer-DB-Analysis-Multiuser Mulit-user license for reading from databases
ibaAnalyzer-E-Dat Reading data from other file formats, e.g.
- CSV- (ASCII-)
- Vista Control
- EDAS and ibaPDA files before year 2000
ibaAnalyzer-DAT-Extractor Data extraction from an iba file into other
formats, e.g.
- dat (iba format)
- txt (csv, ASCII)
- COMTRADE (cfg)
- TDMS (NI format)
16 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 17
Manual ibaAnalyzer
One or more data files (datfilename), an analysis (pdofilename) and a switch parameter
(switch) can be included in the call of the program. The complete path and file names
must be entered for data files and analyses.
Instead of data files you can also enter HD query file names (.hdq).
Examples
(Program path for ibaAnalyzer: c:\programs\iba\ibaAnalyzer\...)
1. Start of ibaAnalyzer with three data files which are loaded at the same time:
...\ibaanalyzer.exe demo00.dat demo01.dat demo02.dat
2. Start with three data files and one analysis in order to have the data displayed
immediately in the required form:
...\ibaanalyzer.exe demo00.dat demo01.dat demo02.dat analyse1.pdo
18 Issue 6.3
ibaAnalyzer Manual
%f: Last data file, complete path and file name (e.g. d:\dat\pda001.dat)
%g: Last data file, only data file name (e.g. pda001.dat)
%h: Last data file, file name without suffix (e.g. pda001)
Tip
For regular and automated calls of ibaAnalyzer depending on the data file generation,
we recommend using the ibaDatCoordinator. Compared to the postprocessing, the
application free of charge offers higher ease of use as well as higher flexibility and
functional reliability.
Switch /reuse
If this switch is included in the program call, ibaAnalyzer starts, loads the specified data
files and, if applicable, displays the results as determined by an analysis. If another
program call with /reuse switches follows, the new data files and, if applicable, also a
new analysis are loaded into the existing instance of ibaAnalyzer with the old data
being overwritten. This means that the existing instance is reused. Opening of further
instances is prevented.
By automating this process, for example, e.g. by using the postprocessing command, it
is possible to permanently update an analysis display with the latest measuring data.
If ibaAnalyzer is started with the /reuse switch, a key button in the upper left corner of
the toolbar appears . Clicking this button stops the automatic update function, so
that you can take your time to view data. Clicking the button again re-enables the
update function.
Switch /append
This switch enables the appending of several data files specified in the call. These files
are then coherently shown one after another in the X direction. (An example is given
below).
In connection with the /sql switch, the results from database queries are appended to
each other.
Issue 6.3 19
Manual ibaAnalyzer
Switch /print
This switch ensures that the measuring data can be printed as a record or log in the
format defined in the selected analysis. The Windows default printer is used.
When the printing process is completed or after the print job has been triggered,
ibaAnalyzer is closed again. In the case of an error, however, ibaAnalyzer remains
open in order to display the error message. (An example is given below).
Switch /extract[:filename]
This switch can only be used in conjunction with the license for the database interface
(ibaAnalyzer DB-Extractor). The /extract switch means that ibaAnalyzer starts and
loads the specified data file. Thereafter, the measuring data is processed in accordance
with the specified analysis and extracted into a database. During this process, no
ibaAnalyzer window is opened on the screen, i.e. the extracting process takes place in
the background. The database connection must have been configured beforehand and
is part of the analysis. (An example is given below).
You may also extract the data into a file. In this case, the desired file name is to be
added as parameter. For extracting data into a file, a particular license is required
(ibaAnalyzer DAT-Extractor).
For further information, please also refer to Database interface (option), Page 408
and/or to the additional documentation.
Switch /report[:filename]
This switch will only be available with ibaAnalyzer version 3.52 and higher. With this
switch, ibaAnalyzer starts, loads a specified data file and performs an analysis in
accordance with the specified analysis rule. Thereafter, the integrated report generator
is started and the data is printed on the Windows default printer using a report layout
specified in the analysis rule if the [:filename] option was not used with the switch.
If the [:filename] switch option is used, the report can be written into a file rather than
being printed. The desired file type is determined by the file name extension. Many
customary formats are supported, including, for example, .pdf, .htm, .rtf, .tiff, .jpg, .xls,
etc. (an example is given below).
For further information, please also refer to Report generator, Page 386.
/sql:filename.sql[;sync:”syncFieldName”] switch
This switch will only be available with ibaAnalyzer version 3.57 and higher. Its use is
subject to the license for the database interface. This switch is used for database
queries. The :filename.sql argument can be used to transfer SQL statements as a basis
for the database query. The additional, optional [;sync:...] parameter can be used to
specify a grouping criterion for the query data.
For further information, please also refer to Database interface (option), Page 408
and/or to the additional documentation.
/trendsql:filename.sql[;sync:”syncFieldName”] switch
This switch is available with ibaAnalyzer version 5.10.0 and higher. Its use is subject to
the license for the database interface. Unlike the previous switch, it is used to query
info fields and/or computed columns from a database. The "filename.sql" parameter
can be used to transfer SQL statements as a basis for the database query.
20 Issue 6.3
ibaAnalyzer Manual
The query results, i.e. signals with measuring points from the time stamp column as
well as info fields and/or computed columns, are displayed in the "Trend query result"
branch and can be used in the analysis.
The "filename.sql" file must be a text file compliant with the SQL language as is
supported by the database specified in the analysis (.pdo) (e.g. Oracle SQL server,
DB2-UDB, etc.). You can load and execute this file by means of the trendquery builder.
Moreover, the execution of the SQL statement should lead to a result set with a time
stamp field and at least one numerical field. Moreover, the statement should contain a
sort ORDER BY clause on the time stamp.
Optionally, a synchronization field can be transferred with the "sync:" parameter for the
query.
Example:
C:\Program Files\iba\ibaAnalyzer\ibaanalyzer.exe c:\pdo_for_sql\
sql.pdo /trendsql:getlastcoil.sql
Further documentation
Detailed information on the database functions are contained in the ibaAnalyzer-DB
product manual.
Switch /overviewsql:filename.sql
This switch has the same function as the one described before. However, the result of
the trend query is not displayed in the signal tree, but in the "Overview" window or tab.
Switch /nominmax
This switch is available with ibaAnalyzer version 5.22.1 and higher. It starts ibaAnalyzer
without the buttons for minimizing and maximizing the program window.
Switch /autoreload
This switch is available with ibaAnalyzer version 5.22.2 and higher. It is used for
automatically and periodically reloading the data file(s) while they are still being written.
This function is equivalent to clicking the "Autoreload files" button.
For further information, please see the Online analysis chapter Online analysis,
Page 114
Issue 6.3 21
Manual ibaAnalyzer
Switch /loadnewfiles
This switch is available with ibaAnalyzer version 5.22.2 and higher. It is used for
automatically and periodically reloading the data file(s) while they are still being written.
The function is equivalent to clicking the "Automatically load new data files from
specified directory" button.
For further information, please see the Online analysis chapter Online analysis,
Page 114
Switch /dbPDO:AnalysisName
This switch is available with ibaAnalyzer version 5.13.1 and higher. It opens analyses
(*.pdo) which had been stored in a database. This database is created once and set in
the preferences, PDO database storage tab.
Only add the desired analysis name – as it was stored in the database – after the
colon.
Switch /filetree:conf.txt
This switch is available with ibaAnalyzer version 5.21.0 and higher. It starts ibaAnalyzer
with a predefined signal or file tree. Thus, several data files can be opened both on the
same level and appended to each other.
The desired configuration of the file tree has to be exported as text file (here conf.txt)
before. This file is transferred as parameter with the switch.
Information on the export/import of a file tree can be found in the chapter
Export/import file tree, Page 118
Switch /language
This switch is available from ibaAnalyzer version 6.0.0 and higher and only works in
combination with Windows versions Vista or higher. It starts ibaAnalyzer in the
specified language. If no language is specified, ibaAnalyzer starts in the system
language or in English.
At the moment, the following variants are available:
/english
/german
/french
/spanish
/russian
/chinese
22 Issue 6.3
ibaAnalyzer Manual
/loadnewfiles
/overviewsql
Combination
/autoreload
/nominmax
/trendsql
permissible
/append
/extract
/report
/reuse
or useful?
/print
/sql
/sql
/reuse YES
Issue 6.3 23
Manual ibaAnalyzer
Examples
(Program path for ibaAnalyzer: c:\programs\iba\ibaAnalyzer\...)
1. Start with three data files which are then coherently shown one after another in the
X direction. The analysis rule included in the call effects the immediate display of the
desired data.
...\ibaanalyzer.exe demo00.dat demo01.dat demo02.dat analyse3.pdo
/append
2. Start with one data file and one analysis with automatic print:
...\ibaanalyzer.exe datfile1.dat analyse2.pdo /print
3. Start with one data file and one analysis with data extraction:
...\ibaanalyzer.exe datfile1.dat DB_Extract.pdo /extract
4. Start with one data file and one analysis with report output on the printer:
...\ibaanalyzer.exe c:\samples\reportsample.dat
c:\samples\reportsample.pdo /report
5. Start with one data file and one analysis with report output as a pdf file:
...\ibaanalyzer.exe c:\samples\reportsample.dat
c:\samples\reportsample.pdo /report:c:\report\pdf\test.pdf
24 Issue 6.3
ibaAnalyzer Manual
Figure 2 shows the usual arrangement of the screen after the first start. ibaAnalyzer
version 6.0 and higher provides numerous adaptation options for individual design.
After installing ibaAnalyzer version 6.0 or higher, the screen is arranged as known from
previous versions.
Issue 6.3 25
Manual ibaAnalyzer
In the above figure, the report information tab was released from the compound of the
signal tree window and positioned on the window of the signal table. The indicators of
the main window (green) and of the partial window (red) appear.
Note
With video windows of ibaCapture-CAM or –HMI signals, proceed accordingly.
26 Issue 6.3
ibaAnalyzer Manual
You can change the tab order by means of drag & drop. Make sure not to leave the tab
area, as otherwise the window will be released again.
In order to reopen partial windows, select the View menu. All partial windows are listed
here. A checkmark in front of the names shows that a window is being displayed.
Check the box again if you want to reopen the window.
Issue 6.3 27
Manual ibaAnalyzer
If the window is to not automatically hide anymore, click again on the pin icon while the
window is open.
Depending on where the windows are docked, the tabs of the hidden windows are
displayed at the border of the main window.
28 Issue 6.3
ibaAnalyzer Manual
Figure 5: Making windows the same height: before (left) and after (right)
Issue 6.3 29
Manual ibaAnalyzer
Open Analysis
Browser-based opening of an existing analysis file (*.pdo).
Save Analysis
saves the current analysis.
Save Analysis as...
Saves the current analysis in an analysis file with a new name (browser-based).
Retrieve Analysis from Database...
Loads an analysis which had been stored in a database.
Store Analysis in Database…
Stores the current analysis in a database.
Analysis Password Protection...
Create, change or remove a password to save the analysis settings.
See also The analysis, Page 119
30 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 31
Manual ibaAnalyzer
Print Setup...
opens the Windows printer setup dialog.
See also Print function (hardcopy), Page 183
Report...
Opens the configuration dialog for the report generator. The report generator
offers substantially more options for the free, user-defined design and layout of
analysis reports than the simple print function.
See also Report generator, Page 386
Recent Analysis Files
This selection opens a list of the analysis files opened most recently in order to
facilitate the selecting and opening of files.
Recent Data Files
This selection opens a list of the data files opened most recently in order to facilitate
the selecting and opening of files.
Exit
Exit ibaAnalyzer
This menu is only available if the database interface option is enabled in the dongle
and if the corresponding DLL was registered.
Refer also to Database interface (option), Page 408 or the related additional
documentation
32 Issue 6.3
ibaAnalyzer Manual
New HD Query
This command opens the dialog for configuring a new HD query. After executing the
query, the result is displayed in the signal tree. Data files or former HD queries
available in the signal tree are replaced.
Add HD Query
This command opens the dialog for configuring a new HD query. After executing the
query, the result is displayed in the signal tree in addition to possibly existing data files
or former HD queries.
Replace File by HD Query
This command opens the dialog for configuring a new HD query. After executing the
query, the result replaces a data file or HD query having been marked in the signal tree
before.
Append HD Query
This command opens the dialog for configuring a new HD query. After executing the
query, the result is appended to the bottommost data file or HD query in the signal tree.
If one of several data files or HD queries in the signal tree was marked beforehand, the
result of the new HD query is attached to the checked file or HD query.
For further information on the HD query, please see chapter Query HD server, Page
215
Issue 6.3 33
Manual ibaAnalyzer
Undo / Redo
These two commands can be used to undo recent steps of user operations, e. g. the
deletion of an expression by accident. Vice versa, an undone step can be redone
again.
This function can be enabled or disabled in the preferences and/or graph settings,
Signal grid tab. Also, the number of operation steps in the undo stack can be set there.
See also Signal grid, Page 93
Copy
This command will copy the current contents of the recorder window, i.e. the visible
signal strips and signal tables, to the Windows clipboard. From there, it can be inserted
as HTML object in other Windows programs, e.g. in Word or Excel. In this way,
analyses can be used in other documents.
See also Documenting with HTML and graphic objects, Page 196
Paste
This command inserts the contents of the clipboard in the current ibaAnalyzer window.
If the "Copy" function was executed before, the "Insert" function adds the same signal
strips and table rows of the view again.
34 Issue 6.3
ibaAnalyzer Manual
Graph setup
The "Graph setup" menu gives access to the dialog for the different setting options
available for the signal strip currently marked. The dialog considers the settings (X axis,
Y axis, views, etc.) which are relevant for the graph in question. A change in current
graph settings does normally not lead to a change in preferences.
See also Preferences / graph settings, Page 71
Preferences
The dialog window for setting the preferences is opened under this menu item. The
preferences are the summary of major graph settings as well as some general settings.
The preferences are applied to a new analysis and/or to a new signal strip.
See also Preferences / graph settings, Page 71
Export / import Preferences
The current preferences can be exported and imported as *.ini file. In this way,
optimized preferences can be saved or made available to other users. When executing
these commands, path and file name of the ini file have to be entered and/or selected.
Further settings for the export and import of the preferences are to be done in the
"Preferences" dialog, "Export/import settings" tab.
See also Export/import settings, Page 99
Autoscale All
Clicking this menu item automatically scales all the signals displayed in the Y direction
on all strips displayed. The X axis is not affected by this operation, so that a zoomed
time section remains unchanged.
Issue 6.3 35
Manual ibaAnalyzer
Logical Expressions
This command opens the dialog for the logical signal definitions. It serves for the
definition of artificial or "virtual" signals. Furthermore, it is also possible to define
multi-dimensional signals (arrays) here.
See also Logical signal definitions, Page 172
Macro Design
This command opens the dialog for generating macros. By means of macros,
comprehensive computations and complex analysis functions can be encapsulated to
be able to handle them more easily and use them more than once.
See also Macros, Page 359
36 Issue 6.3
ibaAnalyzer Manual
Time based:
This means that the time axis is used as the X axis (default). From the time of
commencing the recording process (recorded in the data file) until the end of
recording. Switching between absolute time values (hh:mm:ss) and relative time
(0....n sec) is carried out in the strip setup.
Refer also to Time based and length based, Page 153
Length based: This command divides the X axis into length units (m) related
to the signal displayed. As a precondition for display, the signal to be presented
must have been converted from a time to a length basis, for example, by a
TimeToLength function.
Refer also to Conversion from time to length reference, Page 270
Issue 6.3 37
Manual ibaAnalyzer
X–Y
This presentation mode is only offered if a strip contains at least two signals. If
this mode is selected, the time or length axis is ignored and one signal is plotted
above the other. In this way, it is possible to show dependencies of one or more
signals on another signal. Using the mouse, the user selects the signal to be
plotted on the X axis and the signal to be plotted on the Y axis by arranging the
signals accordingly on the strip. The function is available for both time and length
based signals.
Refer also to X - Y, Page 154
Views
Standard View
The standard view is the default setting. It leads to a two-dimensional curve
presentation.
Refer also to Standard view, Page 158
2D Top View
Despite two-dimensional presentation, this view also offers information on a third
dimension in that a color code is used for displaying the amplitudes of the signals
measured. This view is particularly suitable for the presentation of profiles
(temperature, thickness, shape profiles, etc.).
Refer also to 2D top view, Page 158
3D Wire Frame
This view shows the signals measured as a three-dimensional mountain which
solely consists of lines which connect the samples to each other. The resolution
of this line mesh (B-Splines) can be varied in the setup for the 3D display
(preferences or graph setup).
Refer also to 3D wire frame, Page 164
3D Surface
This view offers a three-dimensional false-color presentation of the signals
measured. Different colors (as selected in the setup) are assigned to amplitudes
of the signals measured. The spaces between the signals measured can be
sharply separated or they can be displayed with smooth color transitions as
required. These preferences are also set in the 3D setup.
Refer also to 3D surface, Page 167
Markers…: Behind this item you’ll find the configuration dialog for markers.
Refer also to Markers, Page 199
Show Cross Profiles: This option is only available in the 2D top view. It enables
the activation or deactivation of the display of cross profiles.
Refer also to 2D top view, Page 158
38 Issue 6.3
ibaAnalyzer Manual
The menu items are only activated if a group of data files is opened.
Clear:
This menu command deletes the group of data files.
Next / Previous:
Loading the next or previous data file in the group relative to the file currently
loaded in the signal tree.
Slide show:
Starts and stops the automatic display of all the data files belonging to the group
of files (successively).
See also Defining groups of data files, Page 108 and Slide show, Page 114
Screen settings
Toolbar Setup:
This is where the dialog for adapting the toolbars can be opened in a manner
quite similar to the procedure in the MS programs.
Status Bar, Signal Tree, Signal Search, Signal Grid, Report Info, Analysis Tree,
Marker Grid Statistics Grid, Harmonic Markers Grid, Navigator and Overview:
These commands can be used to activate or deactivate (toggle) the
corresponding views in order to create more space for the curve display, for
Issue 6.3 39
Manual ibaAnalyzer
example. Since ibaAnalyzer version 6.0 the partial windows which had been
bound to certain areas as tabs before can now be placed and enabled
individually.The signal grid means the signal table.
Zoom functions
Zoom out
Each time this menu item is clicked, a zoom-in stage previously selected for a
display is reversed, so that a gradual zooming out is carried out. The command
concerns the graph currently marked as well as all other graphs having the same
X axis basis (time, length, FT).
Drill Down
This command is only available after a trend graph of an HD-Query has been
zoomed in. It provides for higher resolution measured data in the zoomed area by
reloading the data from the HD store. This leads to a smoother more realistic
graph.
40 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 41
Manual ibaAnalyzer
This toolbar contains all basic functions which can be grouped by different categories.
File functions (from left to right)
Analysis: 1 new - 2 open - 3 save (*.pdo)
42 Issue 6.3
ibaAnalyzer Manual
Filter editor
Open filter editor
Macro designer
Open macro designer
Reloading
Reload files
1 reload data file - 2 auto reload file(s) -
3 Automatically load new data files from specified directory
Locking
Key button
Disable /enable display overwrite (in "Reuse" mode only, refer to "Starting with
command line , Page 17")
Command tab
In the first tab, Commands , you can drag – as known from other Windows programs,
e. g. MS Office – commands from different categories to a toolbar using the mouse to
insert them there.
Issue 6.3 43
Manual ibaAnalyzer
As long as the Customize dialog is open, you can add or remove toolbar commands.
You remove toolbar commands by dragging them out of the toolbar using the mouse.
By doing so, you can also change the main toolbar, e. g. in order to remove commands
not being required.
Toolbars tab
In the Toolbars tab, you can define which toolbars to be shown or hidden.
Moreover, you can reset the toolbars to factory settings.
You can also create your own toolbars. Proceed as follows:
1. Click on <New...>
2. Enter a name for the toolbar and click <OK>.
3. A freely floating toolbar without commands occurs.
4. Drag the toolbar to the toolbar area using the mouse.
5. Then go to the Commands tab and drag the desired commands to the new toolbar
using the mouse.
Keyboard tab
In the Keyboard tab, you can assign key combinations to toolbar commands.
1. First, select the command category and then the command you want to assign
access keys to. If there already is an assignment, the access key is shown in the
field on the right.
2. Click on the "Press New Shortcut Key" field and press the desired keys.
3. Click on <Assign>.
Menu tab
In this tab, you can reset the menus to the factory settings and set the animation when
opening the menus. The differences regarding animation, however, are only noticeable
on close inspection, as this is very quick.
You can also set whether or not an open menu is to cast a drop shadow.
Options tab
In the Options tab, you can set whether quick info (tooltips) is to be activated on the
toolbar and with which contents.
You can also activate large icons.
44 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 45
Manual ibaAnalyzer
3.5.3 Hotkeys
Certain key combinations can be used instead of the mouse. In ibaAnalyzer, however,
these combinations are almost exclusively limited to the usual Windows functions.
Additional key combinations, if available, are also displayed in the quick info (tooltips).
If required, you can assign individual access keys via the menu View – Toolbar Setup...
– Keyboard tab.
46 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 47
Manual ibaAnalyzer
3.5.5 Tooltips
If you mouse over the buttons in the toolbar, a short description appears as is generally
the case in Windows programs (tooltip). If requested, you can also deactivate this
function in the View – Toolbar Setup... menu – Options tab.
If you mouse over the legend of a signal, a tooltip is displayed as well. You can
configure the content of the tooltip. The preferences and strip settings define the
contents to be displayed in the tooltip.
Available information which can be activated in the tooltip of the legend:
FFT prefix
Signal name
Signal unit
Comments 1 and 2
X values of markers 1 and 2
Difference between markers-X-values
Y values of markers 1 and 2
Differenece between markers-Y-values
Sampling period
How to configure the legend tooltips is described under Settings, in the chapter 2D
view, Page 82.
If you hide a signal strip in the recorder window, you can check to see the content of
the signal strip (signal names) by positioning the cursor above the triangle (downwards
arrow tip = signal strip is hidden).
Figure 14: Legend tooltip (left) and hidden graph tooltip (right)
48 Issue 6.3
ibaAnalyzer Manual
Note
Analogously, the following explanations also apply to the HD query results (historical
data).
In order to view the individual signals, click the small cross at a module icon.
Tip
If you hover the mouse over the signals, you’ll find the signal comments in the tooltip,
provided they have been configured in ibaPDA.
Issue 6.3 49
Manual ibaAnalyzer
a) b)
Figure 16: a) with module structure b) with linear numbering
The 1st picture a) shows the technological structure of the signals as determined in
ibaPDA, for example.
In the 2nd picture b), linear numbering was chosen in the context menu. All the signals
of a data file are listed consecutively without the module names. All that remains is the
change in analog and digital signals. The linear numbering option should be used if
many signals of the same type and belonging to the same technological process units
cover several modules, such as the 72 measuring zone values of a flatness measuring
roll. This is an advantage for creating arrays (logical signal definitions) for the
presentation of profiles. The data files shown in the above picture are opened in
ibaAnalyzer. The corresponding module and signal trees can be extended for every file.
Signal curves of the same signal in different data files can be displayed at the same
time and compared.
If data files are appended to each other, this looks as follows:
50 Issue 6.3
ibaAnalyzer Manual
The signal tree is available only once for the selection of signals because the signal
curves from the different files are shown one after another in the recorder window.
Note
Expressions which were created using the expression builder in the signal table,
"Signal definitions" tab (add signals), are not displayed in the signal tree window and
are lost when they themselves are removed from the signal table or when the signals
on which they are based are deleted. However, it is also possible to declare every
expression as a virtual signal via the logical signal definitions. Such an expression
then appears, just like the original signals, in the signal tree, but still forms a
permanent part of the analysis.
Issue 6.3 51
Manual ibaAnalyzer
Vector signals are displayed in the signal tree window within the expressions. They
consist of individual signals being grouped together (configuration ibaPDA version
6.19.0 and higher).
52 Issue 6.3
ibaAnalyzer Manual
Figure 21: 3D presentation of "A vector" (above) and the corresponding individual signals (below)
Vectors can also be created afterwards in ibaAnalyzer using the logical signal
definitions.
This context menu basically contains the familiar commands for data files as the file
menu (see The menu file , Page 30). Depending on where the mouse click is done,
reduced menus may appear.
Issue 6.3 53
Manual ibaAnalyzer
Menu commands referring to data files or HD queries usually apply to the file or HD
query in which the context menu was opened or which was marked at the time the
context menu was opened.
However, certain special features exist in addition:
Show signal
This command will cause the signal, which was right-clicked with the mouse, to be
displayed in a signal strip.
Show bits
This command – applied to an analog signal – will cause the display of all bits of the
analog signal as separate digital signals. Thus, digital information which has been
“packed” for transmission e. g. in a 16 bit integer can be displayed again as individual
signals.
This works for 32 bit floating point values, too.
Linear numbering, display modules
These functions are described in the preceding section of this chapter.
Show groups / individual files, .../ all files
These display options are only applicable if the signals have been grouped before in
the configuration of ibaPDA (or formerly in ibaScope). The signal-group-assignments
are stored in the data file.
"Show groups / individual files" displays the data files as the topmost structure level in
the signal tree window, with the pertinent signal groups being displayed below.
"Show groups / all files" displays the signal groups on the topmost structure level in the
signal tree window.
The benefit of this approach: It is possible to define signal groups which show the
signals necessary for a particular analytical purpose at a glance in the signal tree,
irrespective of their physical module assignment. This means that the information
concerning the technological affiliation does not necessarily have to be included in the
signal name as a precondition for identifying a signal.
Show length and timebased signals separately (ibaQDR-V6)
This option is only visible if a data file from an ibaQDR system with length-based and
time-based signals is opened. By checking this option, the nodes of the measuring
locations in the signal tree are divided into nodes for length-based signals (L) and
time-based signals (T). The nodes of the measuring locations with length-based signals
automatically receive the numbers x, the nodes of the measuring locations with
time-based signals receive the numbers x + 1. Precondition: an archiving profile with
length-based and time-based storage must have been used in the ibaQDR data
recording.
54 Issue 6.3
ibaAnalyzer Manual
Figure 23: ibaQDR data file: Option disabled (left) and enabled (right)
Issue 6.3 55
Manual ibaAnalyzer
Export
This command opens the configuration dialog for exporting the data files to other file
formats.
For more information, see chapter Exporting data, Page 186
56 Issue 6.3
ibaAnalyzer Manual
The "Report info" tab of the signal tree window – also called Info window – enables the
display of calculated characteristic values resulting from a measuring series.
The typestyle format (font, character size, color, etc.) can be defined by the user, so
that a very clear and easy-to-read display can be implemented. The values are
determined and made available via the dialog for the report generator.
Refer also to Report generator , Page 386
Figure 26: Signal tree window, "Report info" tab with image
Issue 6.3 57
Manual ibaAnalyzer
Moreover, further shortcuts e.g. to signals, expressions and markers may be added.
See also chapter Fast access to preferred analyses and more (analysis tree), Page
124
58 Issue 6.3
ibaAnalyzer Manual
The table shows all signals displayed in the recorder window. When a signal strip is
closed in the recorder window, the corresponding signals are also removed from the
table. It is also possible to only hide signals without actually deleting them, for example,
in order to create free space (deactivation of the checkbox in the "Show" column).
Moreover, new signals can be added (via context menu - Add signals). Saving the
configured expressions in a text file and / or configuring higher quantities of
expressions can be done by means of an import / export function.
Show column (display)
The boxes in this column can be used to select or deselect the display of signals. If a
line is not ticked off, the corresponding signal curve is hidden. However, the signal is
still loaded in the background, i.e. it is not lost. If none of the signals of a signal strip is
ticked off, the entire signal strip is hidden (however, not deleted). An option in the
context menu for signal definition also enables the hiding of table lines for which no
display is selected.
Signal name column
The signal names which are displayed here were taken from the data file. These
names can be changed as required, however, without any effect on the data file. New
names should be given to new or copied signals which are added to the table, and/or
for new expressions of all kinds. A change in name may also make sense if the original
signal names, for technical reasons, are very cryptic or strongly abbreviated, so that
nobody but insiders can understand them. Plain-text names are very helpful if the
analysis is to be documented (either via the clipboard or directly as a print).
Expression column
In the case of a normal signal, this column contains the distinct identification of the
signal which consists of a module number and a channel number. The module and
channel numbers of analog signals are separated by a colon (:), whilst a dot (.) is used
in the case of digital signals. Even if the signal name was changed, a signal with this
identification is still clearly identified. In the case of artificially generated signals (logical
Issue 6.3 59
Manual ibaAnalyzer
signal definitions) or other expressions, the formulas and logic functions are shown
here.
Comment 1 / Comment 2 columns
These columns may be enabled or hidden by the signal table settings. If the comments
have already been configured in ibaPDA, they are also stored in the data file and can
be displayed here.
If required, you may overwrite the existing comments or add new comments in
ibaAnalyzer.
Unit column
This column shows the physical unit taken from the data file. If no unit is entered here
or if new signals were generated in the signal definitions, the unit can be added
manually.
Color column
The current color of the pertinent curve is shown here. After clicking a color cell, the
color can be manually selected from a list of 16 colors.
Tip
By the way, if the content of a table cell is longer than the column’s width there is an
easy way to adjust the column width to the contents. Just place the mouse pointer
over the right border in the header of the column in question and make a double click.
The adjustment works in the reverse direction too.
Thickness
Here, you can adjust the thickness of the curve. After a mouse click in one of these
cells, you may choose from a list of 9 pens (1pt - 9pt).
a) b)
Figure 29: Kontextmenü Signal Definitionen, a) in der Tabelle b) außerhalb der Tabelle
As shown in above fig. a), the context menu also includes commands for duplicating
and removing signals. The command then refers to the signal in the table the context
menu was opened upon.
The context menus differ depending on where they are opened. A right click on a signal
row opens the menu as shown in fig. a). Beside the commands for adding, removing or
duplicating a signal, you will also find the item Create logical (signal definitions) here. A
mouse click on this item opens the dialog for logical signal definitions. The expression
and the signal name from the corresponding row are automatically entered as default
60 Issue 6.3
ibaAnalyzer Manual
values. Furthermore, an import and export function is available in the shortcut menu.
The context menu which opens when right-clicking on the table headers or in the empty
space below the table offers a reduced choice of items (fig. b).
Both menus offer the items Convert signal numbers into signal names and Convert
signal names into signal numbers. Applied to selected or all signals, the usual
[Module:Channel] names are replaced by the more descriptive signal names and vice
versa. A signal calculation (formula expression) may become more comprehensive but
longer as well.
Furthermore, the Settings dialog can be opened via the menu which offers additional
options to change the signal table. It is the same dialog like in the preferences or strip
settings.
See also Signal grid, Page 93
If you select the "Marker" tab, two vertical red rulers (X1 and X2) appear in the recorder
window. You can move these two rulers independently from each other using the
mouse. When pressing the <SHIFT> key while moving one of the two markers, the
other one follows in the same distance.
The signal table shows for each signal the X and Y values at the markers, as well as
the difference between the two markers in the X and Y directions. In this way, the
curves displayed can be easily measured and time sections can be determined.
Issue 6.3 61
Manual ibaAnalyzer
If the signal points are not visible (the curve section is not sufficiently enlarged), these
functions will not be supported.
The markers can be moved with the arrow buttons of the keyboard, too. The following
additional functions are applicable:
By using the left or right arrow buttons, only the X1 marker moves.
<Alt> + arrow button= only the X2 marker is moved
<Shift> + arrow button= both markers are moved simultaneously
<Ctrl> + arrow button = marker jumps from signal point to signal point
<Ctrl> + combination with <Alt> and/or <Shift> = as explained
Note
Under certain circumstances, with regard to key combinations, overlaps with other hot
keys can occur on the part of the operating system resulting in unexpected reactions.
In case of Windows 7, it is, e.g., recommended disabling the hot keys for the
“Graphics options“, as otherwise the complete desktop will be turned when pressing
<Ctrl>+<Alt>+cursor key. You can configure the settings by right-clicking on the
desktop:
62 Issue 6.3
ibaAnalyzer Manual
The context menu can be used to switch the display of the Y values to hexadecimal
values. This can be an interesting option if, for example, integer values are used for
transmitting binary control information. The bits which are set are identified more easily
in the hexadecimal presentation.
This table offers a quick overview of the most important statistical values, i.e. minimum,
maximum, average and standard deviation.
The red markers are also displayed when the "Statistics" tab is selected. They can now
be used to define a range to which the statistical functions are to be applied in the
signal table. The values entered in the min, max, average and std. dev. columns are
only applicable to the range between the two markers. When the marker position
changes, you can easily see that the values are calculated on an ongoing basis and
updated immediately.
This is hence a relatively simple way of determining mean values or
maximum/minimum values of parts of the measuring record and/or to single out freak
values, for example, at the beginning of measurement.
In this table, you will find the result values of the FFT for the main frequency Y(F) and
its harmonics for each signal which is presented in the recorder window on an FFT axis
(1/s or 1/length).
See also Harmonic markers, Page 200
Issue 6.3 63
Manual ibaAnalyzer
The "Navigator" tab always shows the complete contents of the data file for the signal
strip appearing in the first (topmost) position in the recorder window.
A red frame in the navigator window marks the range which can be seen in the current
recorder window. This is a helpful feature that improves orientation, in particular, when
the zoom function is used.
The zoom function can also be carried out using the red frame. Just move the cursor
on the red frame line until the cursor changes its shape to become a double arrow.
Then, keeping the mouse key depressed, reduce or enlarge the red frame.
If you click in the navigator's display area, the red frame will be placed in the center at
the point of the mouse click - if possible.
If more than one signal strip is opened in the recorder window, all those strips having
the same X mode as the topmost follow when zooming and moving on the X axis.
For the Y direction, this behavior is not designated.
By positioning the cursor within the red frame, you can move it over the curve. The
section shown in the signal strip is adjusted accordingly.
In some cases it may be useful to have a fixed X range of the frame. Therefore, the use
of the navigator X range snap function, which can be enabled by the context menu, is
recommended. (see chapter Using the navigator , Page 150 ).
The navigator window will never show an FFT presentation. But it may be used for
selection of the range of samples being taken into account for the FFT.
64 Issue 6.3
ibaAnalyzer Manual
The overview tab shows the results of trend queries from databases. For details and
explanations, please refer to the ibaAnalyzer-DB manual.
Issue 6.3 65
Manual ibaAnalyzer
Figure 37: Measured value with X axis modes Time, Frequency, Length and 1/length (from above)
The recorder window is the central area for value display. The signal strips form the
basic structural element within the recorder window. The program tries to arrange all
the signal strips in the visible area of the recorder window until a minimum strip height
is reached and scales them accordingly. If the number of strips becomes too large, a
scrollbar appears on the right margin.
It is also possible to manually change the height of a signal strip using the mouse. For
this purpose, move the cursor in the area of the lower margin of a strip near its header
bar until the cursor changes its shape to become a separation symbol (see picture
above). Then, keeping the mouse key pressed, increase or reduce the height of the
strip. Increasing the height is possible in the downward direction only, so that all the
strips above remain unaffected.
One or more signals can be presented in one strip. If several signals share the same
strip, they always have a common X axis and either a common or separate Y axis. (see
also Presenting signals , Page 137)
66 Issue 6.3
ibaAnalyzer Manual
a b
If several strips are displayed, one of them is the "active" one. "Active" here means that
a strip is selected (has focus) to which certain commands in the menus or on the
toolbar are then applicable, such as strip settings or automatic color assignment. The
shaded header bar (see picture a) marks the active strip.
(For more details on the X axis modes, please refer to X axis modes (reference axes) ,
Page 153)
The basic variable for the X axis (time, length, frequency or 1/length) can be separately
selected for each strip. Just click the small arrow button to the left of the Y axis and
select the basis (see the picture above). In the case of several strips with different basic
variables, there is only one general time axis, one length axis and/or one frequency
axis.
X and Y axes can be scaled (see X axis , Page 72 and Y axis , Page 77).
Tip
Clicking the small "X" in the upper left corner of a strip removes the strip and its
signals from the display. It is then no longer possible to display any expressions
derived therefrom which were generated in the signal table (signal definitions). In
order to hide a strip, click the small arrow on the right margin of the corresponding
strip.
Issue 6.3 67
Manual ibaAnalyzer
As you can see from the picture above, the context menu offers a selection of relevant
setting options for the strip in question. If it is a FFT display, more setting options are
available.
In the zoomed-in condition, commands for autoscrolling and zooming out are
additionally offered.
See also Setup, Page 71
The menu items
Export graph image to file...
Export graph image to clipboard...
Copy
Export...
are used for documentation purposes by copying or exporting the displayed signals.
For more information, please see the chapter Documenting with HTML and graphic
objects, Page 196
For further information, see chapter Exporting data, Page 186
In order to access the context menus for the axes, position the cursor right on the
particular axis.
For a detailed description of the axis settings, please refer to Setup , Page 71.
68 Issue 6.3
ibaAnalyzer Manual
Options in the context menu of the time axis (picture on the next page b):
Hours - minutes - seconds
Toggling between absolute and relative time display on the scale.
Synchronize data files with recording time
This option is important in the case of appended files. If this option is selected,
the signal curves are not necessarily appended to each other in direct
succession, but are rather arranged on the time axis in accordance with their time
stamp. In this way, it is possible to detect and show recording gaps between two
data files.
See also Appending data files, Page 110
Issue 6.3 69
Manual ibaAnalyzer
Figure 39: Status bar, cursor position for signal strip with time axis: relative time
Figure 40: Status bar, cursor position for signal strip with time axis: absolute time
Figure 41: Status bar, cursor position for signal strip: with lenght axis
Figure 42: Status bar, cursor position for signal strip: with frequency axis (FFT)
The 2D top view for profile presentations also displays the third dimension coordinate.
"y" in this case is the index coordinate, for example, the strip width, the position of the
temperature scanner or the zone number of a flatness measuring roll for the purposes
of a strip flatness presentation. "z" represents the value of the real measured signal
(e.g. thickness, temperature or shape).
The status bar can be shown or hidden in the View menu.
70 Issue 6.3
ibaAnalyzer Manual
3.10 Setup
3.10.1 Preferences / graph settings
There is generally no difference between the dialog window for the preferences and for
the strip settings. Only the number of tabs is different. This is why the following
explanations will be limited to the different intentions first. Thereafter, the setting
options will be explained on the basis of the dialogs for the preferences.
3.10.1.1 Preferences
Note
Formatting of numerical data such as time, date, etc., for example on the time axis, in
tables or in the export dialog, is based on the regional and language settings under
Windows.
Issue 6.3 71
Manual ibaAnalyzer
3.10.2 X axis
3.10.2.1 Time tab
Autoscale:
Default setting; the X axis is scaled in line with the recording time of the data file. If,
at the time a data file is already open, a signal from another data file is opened
covering a longer period of time, the time scale is adjusted in accordance with the
longer signal. At any given point in time, only one time axis can exist in an analysis
which is then applicable to all the time-based signal graphs.
Manual scale:
Fixed start and end scale values can be entered here instead of the autoscale
function. Moreover, you may define variable start and end values for the scales by
entering an expression instead of a constant in the corresponding fields. So you can
define scale limit values with respect to certain process parameters. In order to edit
the expression, just click on the fx button in the corresponding field and use the
expression builder (see Expression builder , Page 228). Irrespective of the length of
the signal in the data file, only the specified section is displayed. A hand symbol
(see below) displayed near the scale origin indicates that the manual scale option is
active.
72 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 73
Manual ibaAnalyzer
Autoscale:
Default setting; this is similar to the time axis, however, with the difference that the
X axis represents a length unit (m). If a length-related signal is generated in the
analysis, the length position of the last sample determines the end of the scale.
Similar to the time axis, only one length axis can exist for several length-related
signal strips, so that in this case, too, the length scale is determined by the longest
signal.
Manual scale:
Similar to the time axis, fixed start and end values can be entered here for the
length scale on the X axis. In this case, too, a hand symbol is displayed at the scale
origin in order to indicate that the manual scale mode is active.
signal, select "speed signal" and enter the name of a speed signal. Similar to the
TimeToLength or TimeToLengthL functions, ibaAnalyzer converts time and length to
position the cursor correctly.
If negative speed signals occur, these will be ignored. The same applies to invalid
or unused position signals.
Marker table
Meaning and usage according to the description provided under the Time tab (see
chapter above).
Autoscale in range:
Default setting; upper and lower limit values can be entered for the scaling of the
frequency axis (for FFT presentation) even for the autoscale mode. This makes
sense because the interesting frequency range is usually known when the FFT
presentation option is used.
Manual scale:
If the frequency range in which you are interested is to be further limited in order to
increase the resolution, manual scaling is possible here with fixed scale start and
end values. The hand symbol is displayed in this case, too, in order to show that the
manual scale mode is active.
For both options, the upper and lower limit can be entered either as constant values
or as expressions, with the expression enabling the user to configure the limits
depending on various conditions.
Logarithmic:
Check this option if you rather like to have a logarithmic scale on the X axis instead
Issue 6.3 75
Manual ibaAnalyzer
Figure 1: Difference between linear (above) and logarithmic (below) X-axis scaling
76 Issue 6.3
ibaAnalyzer Manual
3.10.3 Y axis
The Y axis settings are an exception to otherwise identical procedure that is applicable
to the preferences and strip settings. In the case of the preferences, only the basic
settings which are independent of the data files are offered (see picture "Preferences ,
Page 77"), whilst in the case of the strip settings (see "Strip settings , Page 78"), more
setting options are offered because ibaAnalyzer then has more information.
3.10.3.1 Preferences
Scaling mode
Autoscale:
This is the default setting; if one or more signals are displayed, the Y axis of the
strip is scaled in accordance with the smallest or largest of all occurring values.
Use scale definition from data file:
Already at the time of data acquisition using ibaPDA, it is possible to pre-set
measuring-range values in the module settings for each signal and to save these
pre-set ranges in the data file. If this option is selected, the measuring-range
limits are interpreted as scale start and end values.
Scientific notation
Auto:
Depending on the order of magnitude of the scale values (number of digits before
and behind the decimal point), ibaAnalyzer uses the scientific notation (decimal
powers) at the scales or not.
Always scientific:
Scale values in powers of 10
Never scientific:
Scale values always with digits before and behind the decimal point.
Show signal unit
If you enable this option, the measuring unit is written behind the scale values as
defined in the signal table.
Show zone margin in 2D top view
If you enable this option, the Y axis is scaled to the entire width incl. the empty
margins of the outer zones when autoscaling in 2D top view. This produces empty
Issue 6.3 77
Manual ibaAnalyzer
stripes, as the first and last presentable and interpolable value is in the center of the
zone.
For more information on zone settings, please refer to chapter Setting when using
zone widths, Page 162
Figure 49: Strip setting Y axis (example with three separate Y axes in one strip)
Scaling mode
Autoscale from data set:
refer to "Autoscale" under Preferences , Page 77
Use scale definition from data file:
refer to Preferences , Page 77
Manual scale:
This option can be used in order to set the start (min) and end (max) value of the
scale manually.
Add scale offset:
A scale offset value can be additionally chosen in conjunction with the manual
scale option. For this purpose, you can enter a fixed value in the box on the right.
This value is then used to offset the range defined by Min and Max on the Y axis.
A negative value shifts the scale range downwards, a positive value upwards.
However, a constant scale offset does not necessarily make sense, for example,
if the level of the values measured often varies from file to file. In such a case,
you can also define a variable scale offset to be calculated in any manner you
like; if necessary, even via the measured signals themselves. This is what the
button next to the input box is designed for. A click on this button opens the
78 Issue 6.3
ibaAnalyzer Manual
expression builder which you can then use to create any expressions the result of
which then gives the scale offset.
See also Expression builder, Page 228.
Manual grid:
Furthermore, it is also possible to divide the Y axis and/or the grid in a certain
manner in conjunction with the manual scale option. Two values must be entered
in the appropriate boxes for the manual grid:
Reference: The reference value is the basis for determining the position of the
grid. The reference value does not necessarily have to be identical to the
minimum or maximum value of the manual scale. It can be within or outside the
range determined by min and max. The reference value determines the place
where the first grid line appears.
Tick: The "Tick" value represents the step width of the grid lines. Based on the
reference value, grid lines and scale values are displayed at always the same
distance (tick mark).
For example, in order to divide the Y axis (and the grid) in steps of 1/16, enter
0.0625 for the tick mark value.
Note
ibaAnalyzer will nevertheless adjust the scale in order to optimize the display. This mainly
depends on the value range, i.e. on the min and max values. If the grid would become too
narrow, the grid lines are displayed at integral multiples of the tick value.
Issue 6.3 79
Manual ibaAnalyzer
With the settings for the Fast Fourier Transformation (FFT), the calculation basis and
the algorithms are selected which ibaAnalyzer uses for the FFT analysis if the FT mode
is selected for a strip in the display. Like with the other settings, default values can be
defined under Preferences , Page 77. However, if the FT mode is selected for a signal
strip, the FFT settings are also offered in the context of the strip settings and can be
adjusted individually. Which calculation mode or which evaluation window is selected
for the FFT function depends on the particular application. You can, however, easily try
out which calculation mode supplies the most sensible results.
Resolution
In this input box, you can set any resolution value between 128 and 131072 at intervals
of powers of two using the small arrow buttons. The larger the number, the finer and
denser the FT presentation, i.e. the more frequencies are considered in the range.
Mode
The mode settings determine what to calculate.
Power:
Calculation according to power; returns the square of the amplitude of the FFT
coefficients;
Amplitude:
Returns the amplitude of the FFT coefficients;
Any of the above two options can be combined with one of the following three options.
Absolute units:
returns power or amplitude on the FFT coefficients unaltered;
Normalized (linear):
normalizes the output relative to the estimated amplitude of the input signal or its
square respectively for the Amplitude or Power option;
80 Issue 6.3
ibaAnalyzer Manual
Normalized (db):
normalizes and returns result in dB
Window
Selection of the evaluation window for the FFT. The shape of the window indicates
which samples of a finite signal are weighted how strongly during FFT.
Rectangular:
All the samples of a signal – from the beginning to the end – are weighted
equally.
Bartlett, Blackman, Hamming, Hanning, Blackman-Harris:
Samples in the middle portion of the signal are weighted more strongly than the
samples at the margin (beginning, end).
Presentation
Line chart:
Presentation of the frequency amplitude values as a
simple "temperature curve".
Polygon (filled line chart):
Presentation of the frequency amplitude values as a
curve with a filled, color body (same as 2D presentation).
Bar chart:
Presentation of the frequency amplitude values as wide,
vertical bars, in each case at the corresponding
frequencies.
Discrete frequencies:
Presentation of the frequency amplitude values as vertical
lines at the corresponding frequencies.
Suppress DC component
If this option is activated, the DC component (frequency = 0) of a signal is exempted
from the FFT analysis.
Max. allowed computing time
If the measuring records are very long and/or contain a very large number of samples,
and if a high resolution was chosen in the FFT settings, it may well happen that the
calculation takes some time. This means that problems may occur in the case of
automated analyses parallel to fast-running processes. Here, the computing time can
be limited, however, as the case may be at the expense of precision.
Note
Note that the maximum frequency range which can be covered totals 500 Hz with a
sampling rate of 1000 Hz. ibaAnalyzer is capable of analyzing up to 25,000 samples
per second or 12500 Hz.
Issue 6.3 81
Manual ibaAnalyzer
3.10.5 2D view
This dialog is used to determine how the curves are to be presented in the
two-dimensional view. The default settings are "line chart" for analog values and
"polygon" for digital signals, being the variant of choice in most cases.
In the case of the filled line chart presentation, it may happen that the curves conceal
each other if several signals exist per strip. The "front" curve always belongs to the
signal occupying the bottommost position in the graph legend.
The Points only option presents the signal curves like a series of dots (one dot for each
sample) without the connecting lines.
More options:
Align signals with legend
This option applies to digital signals only. If it is activated, the digital signals are aligned
exactly at the height of the suitable signal legend.
Transparent legend background
Enabling this option will remove the background from the legend so that only the
characters are visible. This will cause a better visibility of the curve but may reduce
legibility of the legend text. Disabling this option will cause a background behind the
legend text. Since the background is also part of the so called information layer, you
can control its transparency and/or opacity with the parameter nearby. (see Formatting
the legend , Page 148)
Outlined legend texts
When activating this function (only possible when the "Transparent legend background"
option is activated at the same time), the legend is also shown, e.g., if it is not visible
due to an overlap with a curve having the same color. The outline of the text characters
is represented in contrasting color.
82 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 83
Manual ibaAnalyzer
%y1, %y2:
With these strings, the current signal value at the position of the marker 1 or 2
can be inserted in the suitable signal unit.
%dy:
With this string, the difference of the signal values at the positions of the markers
1 and 2 can be inserted in the suitable signal unit.
%s:
With this string, the time or length basis can be inserted with which the signals
were written in the data file. The time-based data is given in seconds (sec), the
length-based data in meters (m).
Using parameter strings for legend tooltip
Alternatively or in addition to the previous item, you can enter the same information in a
tooltip which becomes visible if the cursor is placed on the legend. You can thus decide
which information is always displayed in the legend and which is displayed in the
tooltip.
3.10.6 3D view
The mode of three-dimensional presentation can be configured in the setup dialog for
the 3D view. The three variants to be generally distinguished are as follows:
2D top view, multi-color
3D surface view, monochrome or multi-color
3D grid presentation, monochrome or multi-color
For a detailed description of presentation settings and options, please refer to:
2D top view, Page 158
3D wire frame, Page 164
3D surface, Page 167
84 Issue 6.3
ibaAnalyzer Manual
3.10.7 Colors
This dialog can be used to adjust the colors used for the user interface of the program
and for the curves. The colors are presented in separate sections for the screen and for
the hardcopy in order to enable optimizing the colors for the two different media. A dark
background may be suitable for the screen, but would need too much ink for the
hardcopy.
The pen colors define the 16 curve colors which are to be available during work with
ibaAnalyzer. The program uses these 16 colors in order to automatically adjust the
colors for the curves. The pen colors are also provided in the signal definition tab in the
signal table in the sequence shown here (line wise from the top to the bottom).
The background of the signal strips can be presented either with a non-varying color or
with a gradient. If 'gradient' is activated, the gradients can be independently selected by
double-clicking the rectangular boxes on the left and right-hand side of the color bar.
Moreover, the markers can be colored individually.
Tip
If you use ibaAnalyzer together with video recordings of ibaCapture-CAM or –HMI, the
different colors of the markers make it easier to identify the video marker.
Issue 6.3 85
Manual ibaAnalyzer
When activating the Transparently fill polygons... option, filled polygons are presented
transparently, grid lines and signals overlapping each other remain visible.
The choice for Font and color settings applies to both this tab and the Fonts tab. It
determines whether the "Preferences" settings made here are to be used or the
settings configured and saved in an analysis via "Properties".
This setup dialog can be used to adjust the fonts for the screen display (windows) and
for the hardcopy. All the fonts installed under Windows are available. Font, font size,
color and face can be defined for four areas of the user interface.
86 Issue 6.3
ibaAnalyzer Manual
In order to change a font, first click the desired area in the small window on the left,
then click the <Change font> button and finally change the font.
If you change the font in the "Preferences", activate the "Apply to analysis" option
before clicking <Apply> in order to see the changes in the current analysis.
3.10.9 Hardcopy
In the "Hardcopy" dialog window, you can define various attributes for a report/log
hardcopy.
Hardcopy settings
Choose between the two options depending on whether you generally prefer to use the
hardcopy settings as set in the preferences or rather the settings as stored in the
analysis file(s).
Header text
Three areas are provided for the head or top line of the subsequent expression: left,
right and center.
In the corresponding input boxes, you can enter any self-defined text or integrate
pictures, such as a company logo.
If you wish to use a picture file, you must enter the complete path and file name. By
means of the browser button, making an entry becomes much easier. Pictures
must be available in standard formats such as BMP, JPG, PNG etc.
Header height
The header height, i.e. the distance between the header bottom line and the upper
page margin, can be adapted to your specific needs. If you choose the "Automatic"
option for the header height, this will be adapted to the font height chosen or to the
picture to be integrated. If you choose the "in mm" option and enter a value in the input
box, this value will then determine the header height.
Issue 6.3 87
Manual ibaAnalyzer
When a picture is integrated into the header line, the program automatically adjusts the
picture dimensions to the previously selected header height. If the picture becomes too
small, you will have to increase the header height.
Header font selection button
By means of this button, you can determine the font to be used in the top line.
Graph height
The graph height values refer to the rendering of the signal strips (graphs) on the
hardcopy. The hardcopy function prints the current view of ibaAnalyzer, i.e. the curves
and the current tab of the signal table. If many signal strips were opened, ibaAnalyzer
tries to print as many of them as possible on the first page which may affect the
readability. You can avoid this by entering at this point a minimum height for the strips
and a maximum number of strips per page.
Finally, you can also choose the paper orientation and enable / disable the printing of
page numbers.
Orientation
For printout, you can specify the paper orientation (portrait and landscape format) or
print according to the default settings of the printer.
3.10.10 Miscellaneous
Metric unit
In this input box, you can enter the unit for the length axis for length-related
presentation, such as m, km, inch, mls. This is just a plain-text entry used for captioning
the X axis with a length-related presentation of a signal strip. This entry has no
influence on the calculation of the expressions in the analysis! In the case of systems
other than the metric system – for example, when using British or US units – the
appropriate conversion factors must be considered when programming the
expressions.
88 Issue 6.3
ibaAnalyzer Manual
Issue 6.3 89
Manual ibaAnalyzer
Note
Functions such as “resample“, “margin“ and “time“ can also lead to exhaustion of the
resources if parameters being too large are indicated. There is also a limit for these
functions, however, it cannot be disabled.
90 Issue 6.3
ibaAnalyzer Manual
3.10.11 Database
Issue 6.3 91
Manual ibaAnalyzer
You can use these settings in order to decide how the signals are to be normally
displayed in the signal tree after the start of ibaAnalyzer. You can also make this
selection at any time from the context menu in the signal tree window.
Show linear numbering:
All the signals of a data file are listed consecutively without the module names. All
that remains is the change in analog and digital signals. The linear numbering
option should be used if many signals of the same type and belonging to the
same technological process units cover several modules, such as the 72
measuring zone values of a flatness measuring roll. This is an advantage for
creating arrays (logical signal definitions) for the presentation of profiles.
Show modules:
In this case, the signals are shown in the module structure defined in ibaPDA, so
that the arrangement of the signals reflects the technological structure.
Show groups per file / ...over all files:
These display options are only applicable if the signals have been grouped
before in the configuration of ibaPDA (or formerly in ibaScope). The
signal-group-assignments are stored in the data file.
"Show groups per file" displays the data files as the topmost structure level in
the signal tree window, with the pertinent signal groups being displayed below.
"Show groups over all files" displays the signal groups on the topmost structure
level in the signal tree window.
Show length and timebased signals separately (ibaQDR-V6)
ibQDR-V6 enables you to store measured values in the product file both length-based
and time-based when storing data.
Usually, the signals of such an ibaQDR file are listed only one-fold in the ibaAnalyzer
signal tree. To show a signal on the length or time scale, select the corresponding type
of presentation in the recorder window.
If you enable this option, all signals existing in the data file with length and time
reference, incl. measuring point and module, are listed twice in the signal tree.
Use alternative info field for the displayed signal name
There are signal-specific info fields for every measured signal filled with information
depending on the configuration in the ibaPDA or ibaQDR system. Only if the
corresponding information was configured, the info fields will be available also in the
signal tree of the data file. The following figure shows an example of a signal for which
the comment fields 1 and 2 were also used.
The corresponding info fields are called $PDA_comment1 and $PDA_comment2.
92 Issue 6.3
ibaAnalyzer Manual
If the original signal name is incomprehensible or, e.g., another language is requested
(2nd comment), enable this option and specify the desired info field so that its content
instead of the signal name is displayed in the signal tree.
Figure 63: Using the $PDA_comment1 info field as signal name in the signal tree
Note
This setting only changes the display name of the signals as it is used in the signal
tree and in the legend of the signal strips. You do not change the signal reference as it
is, for example, used in expressions!
You can change the signal reference using the preferences, “Signal grid” tab.
This dialog offers multiple settings for configuration of the signal table (signal grid).
Issue 6.3 93
Manual ibaAnalyzer
94 Issue 6.3
ibaAnalyzer Manual
selection is carried out by means of the cursor or the mouse and the selected function /
signal is added to the expression with <Enter> or one mouse click.
Prefix the module name before the signal name
With this option, the name of the module is displayed in the signal strip and the signal
table in addition to the actual signal. This applies to signals being opened from the
signal or analysis tree as well as from the search dialog.
Figure 65: Setting for displaying the module name in the signal table and legend
If you use a lot of analyses (*.pdo files) and you do not want to store and manage them
in a file system, you are also able to store them in a database. This dialog is used for
configuration of the database connection and creation of the database table. The
settings in this dialog are completely independent from the database settings for
Issue 6.3 95
Manual ibaAnalyzer
extraction and query of measured data (ibaAnalyzer-DB). Saving the analyses to the
database will be done in the File menu.
Database System and Name
Select the database type from the combo box, i. e. choose between SQL, Oracle or
ODBC. Then enter a name of the database into the corresponding field.
Computer
Select the computer which is the database server. If it is the local computer, the same
where ibaAnalyzer is used, then click the “Local machine” radio button. If the database
server is a remote computer in the network, click the “Database server” radio button
and enter the computer name and the name of the database server in the field next to it
(e.g. MYCOMPUTER\SQLEXPRESS). You may use the button to browse the
network.
Authentication
Choose how the ibaAnalyzer-PC should login on the database. You could use either
the current user login (which has been used for ibaAnalyzer itself) or another user login
which had been created specifically for using the database. In the latter case, you
should enter the login information for username and password.
<Test database connection> button
At any time you may test the database connection by clicking on this button, i.e.
whether your entries and settings are correct and the network access is working.
Table
The analyses are stored in a table inside the database. You can enter a name for the
table in the corresponding field (overwrite the default name) and let create the table in
the database by clicking the <Create> button.
Note that the system always creates an empty table when clicking the button. Existing
tables with the same name will be overwritten.
96 Issue 6.3
ibaAnalyzer Manual
3.10.15 ibaCapture
HMI:
Replace path:
Enable this option if the video files are generally stored at a different location than
previously used by ibaCapture. For example, if you have copied the video files
manually to another drive or computer. Enter the requested path in the input box and/or
use the browser (button ).
Issue 6.3 97
Manual ibaAnalyzer
CAM:
Ignore server name in .dat file and load video files from:
For video playback, ibaAnalyzer and/or the integrated ibaCapture-CAM player must
have a connection to the ibaCapture-CAM server where the videos are stored (except
for exported dat files with embedded videos). For this purpose, the default settings use
the server name which is stored in the data file. If, in the meantime, the name of the
ibaCapture-CAM server has been changed or the video files have been transferred to
another server, this option can refer to the new server name. The videos will then be
loaded from the selected server. Also on the new server, the ibaCapture-CAM server
service has to run to be able to play the videos.
Use alternative renderer (recommended for Windows 7,…):
If you work with Windows 7, it is recommended checking the box to use the Windows
graphic library for the screen layout. If you want to use the default mode (usage of the
preinstalled iba renderer), maintain the default settings.
Save credentials on this computer
If the user management was activated in ibaCapture-CAM and the rights were limited
with regard to video viewing, a user has to log in entering his user name and password
when opening a camera channel in ibaAnalyzer. If this user is not authorized to view
videos, no videos will be displayed. This registration is required once per ibaAnalyzer
session.
If you enable this option, the login information is stored on your local computer; after a
restart of ibaAnalyzer, it is not required to log in again.
With the <Clear credentials> button, you can remove this information from the
computer.
Print options
With these settings, you determine as to how video images are to be printed if you use
the print function in the File menu.
The number of columns determines how many images are to be printed side by side on
one page. The images are scaled accordingly. The number of rows determines how
many images are to be printed one below the other on one page.
For printing in the portrait and landscape format, these settings can be made
separately.
The settings apply to video images of ibaCapture-CAM and ibaCapture-HMI.
To activate the settings with an analysis being currently open, enable the "Apply to
analysis" option and click <OK>.
You can control your settings under menu File – Print preview.
98 Issue 6.3
ibaAnalyzer Manual
3.10.16 Overview
The settings in the "Overview" tab refer to a specific form of database trend query. The
result of this query is presented in the "Overview" view in the area of the signal table.
For detailed information, please refer to the ibaAnalyzer-DB manual.
Issue 6.3 99
Manual ibaAnalyzer
Note
No matter which option is selected, it is only carried out after re-starting ibaAnalyzer.
Export
If the settings are to be saved, use the <Export...> button. After clicking on this button,
you can name the *.zip file and determine the file path. By checking the corresponding
boxes, you can choose which settings are to be exported:
Preferences:
All settings are exported which are not listed separately.
Analyses tree:
The settings are saved which were made under the "Analysis" menu in the signal
tree window. Irrespective of this export mode, these settings can be exported
and/or imported in the signal tree by right-clicking.
Filters:
All filters marked "global" are exported (see Dialog window of the filter editor ,
Page 374)
Macros:
All macros marked "global" are exported (see Import and export macros , Page
370)
Database queries:
All settings made in the query builder or in the query dialog are exported. The
import and export functions are also available in the query dialog.
Note
In addition to export/import, all global filters or macros are copied from and/or to the
ibaAnalyzer master directory, e. g.:
C:\Documents and Settings\user name\Application Data\iba\ibaAnalyzer
Macro files are *.mcr files and filter files are *.fil files.
3.10.18 HD Server
Form version 6.3.0 and higher, ibaAnalyzer also allows access to data having been
stored with ibaHD-Server.
By means of a number of settings, you can decide which signals are contained in the
pseudo data file after an HD query and how they are to be loaded and displayed.
Changes in the preferences also affect new analyses. If you change the strip settings
of a current analysis, where this tab is also available, the HD data is automatically
reloaded.
Also query aggregated minimum/maximum channels
When loading a signal, its average value and – if available – maximum and minimum
are loaded by default. If you deactivate this option, the corresponding value is not
loaded in ibaAnalyzer. If this option is deactivated, you can save storage space.
These options are activated by default.
Include HD server name in query name
In principle, the name of the pseudo data file consists of the HD server name, the store
name as well as the start and stop time of the queried range. In order to keep the name
a bit shorter, you can prevent the HD server name from being used by disabling this
option. If you want to see the HD server name in the name of the pseudo data file, you
need to activate this option.
Tip
If you usually save your data files in a particular directory, such as D:\dat, work
becomes much easier if you define this folder as the preferred folder. You can do this
by simply clicking the yellow folder icon with the plus sign in the upper right corner
after selecting the folder. You can also define several preferred folders which you can
then quickly select from the picklist (arrow key next to the input box for the preferred
folder).
...by the way: if no data files are offered in this dialog, this can be due to the following
reasons:
a) There are no data files (*.dat, *.txt, *.csv)
b) You selected the "Open analysis" dialog by mistake (button with the yellow folder
icon in the tool bar) because ibaAnalyzer suppresses the display of other file types.
This additional information is useful for a first general assessment of a data file before it
is actually opened.
The two icon buttons on the left can be used to toggle between an info display and the
signal tree in the field below.
The area on the right to it can be divided in different ways. The buttons in the middle
can be used to activate four views as follows:
Curve of a signal which was marked in the signal tree on the left.
File list if several data files were selected, so that several files can be
opened or a file group defined. Optionally with/without detailed information on the
files.
Curve shape + file list; the same signal is displayed in each case depending
on which file is marked in the file list.
The last-mentioned view is particularly suitable for a good pre-selection of data files by
selecting a distinctive signal whose curve can be assessed at this point already. As
long as no files have been copied into the file list (refer to the following section), you
can also mark individual files in the selection window above or select individual files
using the cursor in order to view the signal curve.
Tip
As usual when working with Windows, a short description (tooltip) is shown when
moving the mouse over the button.
The blue folder icon with the two ++ signs (see above) allows for adding further data
files to previously selected data files in order to analyze signals from different sources.
The same command can also be executed via the File - Add new data file menu.
With ibaAnalyzer version 4.1 or higher, you can also enter wildcards * and ? in the file
name field of the Open datafile dialog in order to open multiple data files at the same
time.
To open several data files from the Windows Explorer, you have the following options:
Drag files one after another in the ibaAnalyzer program window. If you drag the
files into the signal tree window, make sure the mouse is not placed on a data file
while the files are being dropped. Otherwise, the new data file is appended (see
below).
Select several files (all files in the directory using <Ctrl>+<A>) and drag them into
the program window using drag & drop.
Note
Selecting several files and then pressing the <Return> key does not lead to the
desired result. Instead, ibaAnalyzer opens each file in its own instance.
Procedure:
1. Open the "Open data file" dialog by using the File - open data file menu or the
button.
2. If you have not done yet, click the <Show Advanced> button in order to expand the
dialog window and select the last of the four possible views.
3. In the browser field (top), select the drive and path where the desired data files are
located.
4. Mark several files and, using drag & drop, drag them into the group window in the
lower right area and click <OK>. (The files must be marked in the group window!)
5. You can now find the data files in the window of the data file group list above the
signal tree:
If you click the "Open from file group" button instead of "OK" in step 4, the data files are
opened parallel in much the same manner as in the case of "Add new data file" and
they are displayed in the signal tree window rather than in the group window.
Some more buttons are offered in conjunction with the definition of a data file group in
the "Open data file" dialog:
Use the "plus" button in order to add files which are marked in the upper window
(browser) to the group of files.
Use the "minus" button in order to remove the files marked from the group of files.
The "rubber" button deletes the complete file list from the group window.
If a particular group of files is to be opened frequently, the list of files can be saved in a
text file.
When the "save" button is pressed, the current list of data files is saved in a text file.
You can select any name and path for this file. You can, of course, also use a
simple ASCII editor in order to create such a file.
By clicking the "Open file" button, you can select a text file which contains a group
of data files from a dialog window. In order to load this group of files, click "OK" in
order to confirm the opening of the text file and the names of the data files are
displayed in the file group window. Then, click the <OK> button in the "Open data
file" dialog and the files are opened.
If you want to append data files from the Explorer, proceed as follows:
1. Open the first data file as usual.
2. Then drag one file after the other from the Explorer exactly to the name of the last
data file in the signal tree window.
The appended files are displayed as follows:
The file boundaries are shown as vertical, broken green lines. If the start time of a data
file is not available, e. g. when appending database query results, the lines have
magenta color. If no lines are visible, please check the settings for 2D view in the
preferences or strip settings. The Show triggers and file separators option has to be
selected (checkmark).
The picture above shows a number of data files recorded continuously one after
another. This also means that the assignment of the values to the time axis is also
correct. However, in case of linking data files which were not exactly recorded
chronologically, this may lead to misinterpretation.
Note
If you wish to append data files which were not exactly recorded one after another,
note that the time axis information is correct for the first file only. ibaAnalyzer does not
by default evaluate the time stamp of the data file, and appends the files directly one
after the other.
The example below shows a situation in which the data files of five production jobs
were appended.
The picture suggests that the signal lasts for only about 8 minutes. This, however, is
not the case at all, as the recording times of the data files are far apart from each other.
In order to present appended data files in their real positions on the X axis, the
presentation must be synchronized with the real recording time. For this purpose, either
activate the "Synchronize data files with recording time" option in the strip settings, X
axis tab, or right-click on the X axis and select the same command.
Tip
If you select the setting Absolute time (hours – minutes – seconds) at the same time,
you can additionally activate the date display in the axis settings. In case of long time
periods, you can also see the changes of days.
While you have to search the folder tree for data or text files on your own when in
"Open data file" dialog, this task can be performed by the search function. When
clicking the <Search> button, the following sub-dialog will open:
You can see various options that will help you to specify or limit the search function. On
the one hand, you can set the path from which the search is to start. Furthermore, by
checking the corresponding box, you can decide whether the search is limited to the
set path/folder only ("Search preferred folders") or if it should extend to the sub-folders,
too. In addition, you can set a time limit and select whether to search for data or text
files. The search function is limited solely to text or data files (extensions *.dat or *.txt).
After you have limited the search function, a search window (only displayed during the
search process) will open and inform you about the current status of the search.
The dialog "Open data file" (see picture) appears after the search is complete. The first
data or text file found during the search process will be displayed in the main window.
The related folder can be found in the structure on the left (grey background). All other
search results are displayed in the preview window as a group.
The two arrow keys enable switching between the data files of the group.
In order to start the slide show, just click the button. ibaAnalyzer will then
successively open the data files of the group at an interval which you can select under
"Automatic slide show" on the "Miscellaneous" tab of the "Preferences".
Click the button once again in order to exit the slide show.
5. If you prefer to reload the data file manually, click the button once again in order
to deactivate the automatic mode and subsequently use the button .
In the example below, the time shift was calculated by means of the markers. The
markers were each positioned on an event of equal rank in the graphs. Following this,
the difference of the marker positions was used as expression for the time shift.
If a time shift is activated for a data file, this can be recognized by a green double arrow
icon in the signal tree:
Figure 84: Marking a time shift of the data file (upper icon)
If required, a collective time shift can be specified in the preferences or in the signal
strip settings. The time shift then applies to all open data files. The setting can be found
in the X axis tab, Time sub-tab.
Figure 85: Setting of time shift for data files in the preferences
Note
If a collective time shift is applied to data files with individual time shift, the individual
time shift will be overwritten. Therefore, it is important to define the collective time shift
first and then the individual time shift.
The time shift setting is stored in the analysis file. Thus, a time shift is immediately
applied to an open data file as soon as the analysis with time shift has been opened.
Example
The trends of two rolling force signals from two consecutive data files give the curves
shown below:
In order to permit a better analysis of the two curves, the rising edges of the signal
(marker) are to be made congruent. The position indicator in the signal table,
"Markers" tab, shows a difference of 38.5 s between the markers (X2-X1).
This means that it is only necessary to shift the upper curve by this amount to the left
in order to make the two signal curves congruent.
st
[0] [1 Data file index]
D:\dat\pda500.dat Path and file name
nd
[1] [2 Data file index]
D:\dat\pda501.dat Path and file name
rd
[2] [3 Data file index]
D:\dat\pda502.dat Path and file name
D:\dat\pda503.dat Path and file name
D:\dat\pda504.dat Path and file name
If you start ibaAnalyzer via the command line and want to specify a file tree at the same
time, you can use the /filetree switch.
Example
c:\programme\iba\ibaAnalyzer\ibaAnalyzer.exe /filetree:MyFileTree.txt
Note
Since the referencing of signals is based on the module and channel numbers, it is
also possible to apply an analysis to data file which actually do not match this analysis.
This means that values are displayed without an error message being generated.
Since also the analysis files with the .pdo extension are linked to the ibaAnalyzer
program under Windows, it is also possible to start ibaAnalyzer by double-clicking a
pdo file in the Windows Explorer. ibaAnalyzer will then start with the settings saved in
the analysis, however, without any measured data unless the name of a data file was
also saved in the analysis (refer to Save analysis , Page 122)
If you have already made settings or arrangements which you wish to discard in order
to start anew, you can create a new analysis via the File - New analysis menu or by
clicking the corresponding icon (see above).
Data files which have been loaded continue to be displayed in the signal tree window.
The new analysis does not yet have a name (i.e. it is unnamed).
In order to open an existing analysis, use the File - Open analysis menu or click the
corresponding button (see left) in order to access the "Open analysis" dialog.
Tip
... By the way: If no analysis files are offered in this dialog, this can be due to the
following reasons:
a) There are no analysis files ( *.pdo).
b) You selected the "Open data file" dialog by mistake (button with the blue folder
icon) because ibaAnalyzer suppresses the display of other file types.
In order to load an analysis, select the desired name so that it appears in the topmost
field of the window and click <Retrieve>.
Tip
You can place the menu command for opening the analysis from a database as button
on the tool bar. For this purpose, go to the menu View - Toolbar Setup... and drag the
appropriate button from the dialog into the tool bar.
Tip
You can place the menu command for saving the analysis into a database as button
on the tool bar. For this purpose, go to the menu View - Toolbar Setup... and drag the
appropriate button from the dialog into the tool bar.
Note
The analysis tree is NOT stored in an analysis file but in the registry (like the
preferences). Therefore, the analysis tree- once created - is also available when
ibaAnalyzer is started without an analysis. In order to remove an analysis tree it is
required to delete all elements of the tree.
In order to enter a group name, click on the + symbol, double-click on the “Add
group” branch or mark the branch an press <ENTER>.
4. After entering the group name, the group will be created and another branch called
"Add group" will appear for you to create more groups. In the first group, you now
have the possibility to add various items.
5. Add the desired elements to the group(s). A mouse click on the + symbol, a
double-click on the "Add item(s)" branch or selecting the branch and clicking
<ENTER> allows you to select an item.
Subgroup
Analysis (pdo-file)
Signal
Expression
SQL query
When you click on an arrow button for the first time, ibaAnalyzer will open the youngest
data file in the assigned folder, if available. Further clicks on the arrow buttons will open
the data files which are older (left arrow) or younger (right arrow) as the current file, if
available. If you opened another file in the meantime on a different way, e. g. via dialog
Open data file, then a click on the arrow buttons after will open again the youngest file
in the assigned folder, like at the first time.
If you hold the <ALT> key when clicking on the arrow buttons, then the new data files
will be appended to the current file instead of replacing it. The function of the arrow
buttons is altered by the use of the <ALT> key too. A click on the right arrow button will
append a younger data file to the end of the current file and thus at the end of the chain
of appended files. A click on the left arrow button appends the file which is older than
the current first file in the chain before that file, i. e. it puts the new file at first position of
the chain. This rule guarantees the correct chronological order of the data file in the
chart display.
Instead of using the mouse for these operations you may use the cursor keys together
with the <CTRL> key, provided the group node is marked. The appending of files works
respectively with the key combinations <ALT> + <CTRL> + < >/< >.
Besides adding, replacing or removing dat folder links, the context menu which pops up
when clicking on a group node, contains some more functions.
You can rename and remove a selected group, all groups or add the current analysis to
a group.
Groups and subgroups can be moved inside the analysis tree by drag & drop.
The selected analysis files are always added to the tree right beneath the group or
subgroup.
The analysis file can be opened by a double-click on the item or pressing <Enter>
when it is marked. Also, using the context menu (right mouse click on the item) and
choosing Open selected file will open the analysis. You may use the context menu for
removing an analysis file from the tree as well (Remove selected file).
You should group your analyses in a way that suits best your requirements. For
example you can create groups with reference to the technological structure of your
plant or process (e. g. entry section, cleaning, furnace, skin pass mill, exit section) and
assign the corresponding analyses.
Or you decide to create more general groups like technology, production, statistics etc.
Also personalized groups can be useful, particularly when several people use the same
computer for different analyses.
Analysis files can be moved inside the analysis tree and assigned to another group by
drag & drop.
Note
The analysis tree is NOT stored in an analysis file but in the registry (like the
preferences). Therefore, the analysis tree- once created - is also available when
ibaAnalyzer is started without an analysis.
Tip
Using signal shortcuts makes switching between the signal and analysis tree
unnecessary.
The data file must be opened in ibaAnalyzer in order to create signal shortcuts.
After you have clicked on the node Add item(s) and chosen the button for signal in the
pop-up control, a signal browser window Select signal(s) will open. In the browser you’ll
see the well-known signal tree of the data file. Select one or more signals from the tree.
In the signal browser the following options are available to find a signal. They should be
selected by mouse click on the corresponding radio button:
on number
A signal of a currently open data file can always be displayed via this signal shortcut if it
has the same number (i.e., file number, module number and channel number).
on name
A signal of a currently open data file can always be displayed via this signal shortcut if it
has the same name. The first signal in a data file which has this name will be displayed
(in case of multiple signals having the same name).
on number OR name
A signal of a currently open data file can always be displayed via this signal shortcut if it
has either the same number (see above) or the same name. The first signal matching
one of these conditions will be displayed.
If a signal, the shortcut refers to, is not available in the data file it will be indicated by a
red cross on the shortcut icon.
This can happen when the loaded data file does not contain the same signals as the
data file which had been used for creating the signal shortcuts. A right mouse click on
the signal shortcut opens a context menu with some signal-specific options.
Setup
This command opens the signal browser just like when adding a signal shortcut. You
may select a different signal or change the option for finding and opening a signal.
Open signal
This will display the signal in the recorder window.
Remove signal
This will remove the signal shortcut from the group. If it is the only signal, the node
"Signal shortcuts" will also be removed from the group.
Remove all signals
This command will remove all signal shortcuts including the node "Signal shortcuts"
from the group.
By the way, another method for adding a signal shortcut is to drag and drop a signal
from the recorder window on a group or a node in the analysis tree.
Signal shortcuts can be moved within the analysis tree and assigned to another group
by drag and drop.
The following options are available to define the reference for displaying an expression.
They should be selected by mouse click on the corresponding radio button.
on name
An expression of an actual open analysis can always be displayed via this shortcut if it
has the same name. The first expression in an analysis which has this name will be
displayed only (in case of multiple expressions having the same name).
on name AND expression
An expression of an actual open analysis can always be displayed via this shortcut if it
has both the same name and the same expression.
create when not found
If this option is enabled an expression which is already available in the analysis tree will
automatically be created in the signal table of the current analysis. This may occur for
example when a different analysis file has been loaded which doesn’t contain yet the
expression in question. With the help of this option an expression shortcut can always
be opened.
After closing the browser window by <OK> the expression shortcuts will be displayed in
the analysis tree.
If an expression, the shortcut refers to, is not available in the analysis file it will be
indicated by a red cross on the shortcut icon.
This can happen when the current open analysis does not contain the same
expressions like already available in the analysis tree. A right mouse click on the
expression shortcut opens a context menu with some expression-specific options.
Setup
This command opens the expression browser like for adding an expression shortcut
before. You may select a different expression or change the option for finding an
expression.
Open expression
This will display the expression in the recorder window. Opening an expression will not
necessarily open a new signal strip in the recorder window. It may be displayed in a
signal strip with other signals, depending on where it was created.
Remove expression
This will remove the expression shortcut from the group. If it is the only expression the
node "Expression shortcuts" will also be removed from the group.
Remove all expressions
This command will remove all expression shortcuts including the node "Expression
shortcuts" from the group.
By the way, another method for adding an expression shortcut is to drag and drop a
currently displayed expression from the recorder window on a group or a node in the
analysis tree. Expression shortcuts can be moved inside the analysis tree and
assigned to another group by drag & drop.
The following options are available to define the reference for displaying a marker.
They should be selected by mouse click on the corresponding radio button.
on name
A marker in of an actual open analysis can always be displayed via this shortcut if it
has the same name. The first marker in an analysis which has this name will be
displayed only (in case of multiple markers having the same name).
on name AND expression
A marker of an actual open analysis can always be displayed via this shortcut if it has
both the same name and the same expression which defines the marker.
create when not found
If this option is enabled a marker which is already available in the analysis tree will
automatically be created in the current analysis (marker table). This may occur for
example when a different analysis file has been loaded which doesn’t contain yet the
marker in question. With the help of this option a marker shortcut can always be
opened.
After closing the browser window by <OK> the marker shortcuts will be displayed in the
analysis tree.
This can happen when the current open analysis does not contain the same markers
like already available in the analysis tree.
A right mouse click on the marker shortcut opens a context menu with some
marker-specific options.
Setup
This command opens the marker browser like for adding a marker shortcut before. You
may select a different marker or change the option for finding a marker.
Open marker
This will display the marker in the recorder window. Typically the markers are not
opened in new signal strips but in signal strips of other signals or expressions (e. g.
frequency based markers in FFT-strips). It is recommended to drag and drop the
desired marker from the analysis tree into an appropriate signal strip.
Remove marker
This will remove the marker shortcut from the group. If it is the only marker the node
"Marker shortcuts" will also be removed from the group.
Remove all markers
This command will remove all marker shortcuts including the node "Marker shortcuts"
from the group.
By the way, another method for adding a marker shortcut is to drag and drop a
currently displayed marker from the recorder window on a group or a node in the
analysis tree.
Marker shortcuts can be moved inside the analysis tree and assigned to another group
by drag and drop.
Further documentation
For detailed information on database queries, please refer to the ibaAnalyzer-DB
manual.
Further documentation
For detailed information on database queries, please refer to the ibaAnalyzer-DB
manual.
Import and export function are up and down compatible. Export files created by
previous versions of ibaAnalyzer usually can be imported by newer versions.
If analysis trees which had been created by a newer version should be imported in
ibaAnalyzer of versions <5.8 then the subgroups and in versions <5.1 the shortcuts to
signals, expressions and markers will be ignored.
Signal identification:
Analog signals: , Module:Channel
Digital signals: , Module.Channel
The most important info fields:
beginchannel: absolute channel number in the PDA system
name: channel name acc. to PDA module setting
unit: physical unit of the signal
channel_offset: position of the signal data within the data file (service information)
visualmin, visualmax: scale limit values acc. to PDA module setting (analog values
only)
$PDA_comment1/2: signal comments acc. to PDA module settings
$PDA_Tbase: time base acc. to storage profile
$PDA_Typ: data type
$PDA_filter: filtering (average value, maximum or minimum) acc. to storage profile
Depending on the application, ibaPDA configuration and type of data file, more
information can be contained, e.g. if the file is generated by ibaQDR or processed by
ibaDatCoordinator.
It is, for example, often not helpful to open a separate signal strip for every signal
because this would mean that the recorder window is soon full and difficult to read. It is
hence possible to position several signals in one signal strip before you can then
decide whether each of the signals is to be given its own Y axis or whether a common
Y axis is to be used.
1. Select the first signal: Simply drag the desired signal to a free position in the
recorder window.
2. Presenting another signal in a new strip: Simply drag the desired signal into the
area of the X axis in the display window, or double-click the signal name.
3. Presenting another signal in an existing strip: Simply drag the desired signal into
the area of the desired strip. The signal is now displayed in the same strip, but with
4. Presenting another signal in an existing strip, however, referring to the same axis as
the existing signal: Simply drag the desired signal into the area of the Y axis of the
desired strip. Both signals now have the same Y axis reference. A new color is
automatically assigned to the new signal. (Fig. 68) The names of the respective
signals are referenced in the upper left area of the strip. Signals having the same
axis are connected by a hyphen.
Tip
If you wish to have several signals presented in one strip with separate Y axes, just
double-click the corresponding signal name whilst keeping the <STRG> key
depressed – this saves time.
Tip
If you wish to have several signals presented in one strip with a common Y axis, just
double-click the corresponding signal name whilst keeping the <SHIFT> key
depressed – this saves time. Every further signal is assigned to the Y axis of the
bottommost signal.
You may mark and drag more than one signal into the signal strip. Use the <SHIFT> or
<CTRL> key together with a mouse click to select multiple signals.
The group of marked signals will be treated as a group when dragging them into a
signal strip. A mutual Y-axis will be provided for the entire group. If there is no signal
strip available yet or if the group is dragged on the X-axis the behaviour is as follows:
Dragging the group with depressed <CTRL> or <SHIFT> key: The signals will be put
into a mutual signal strip.
Merely dragging the group: Each signal will be displayed in its own signal strip.
How to search:
1. Click on the Search tab in the signal tree window.
2. Enter a search string in the Search field above. The search string may be an entire
signal name or just a part of it. The search mode is "full-text search", i.e. the search
returns all signals whose names include the character string you have entered.
3. Activate the desired search option.
4. Press the Return key (< >) in order to start the search.
5. The signals found are listed in the table. You can put the signals, expressions or
markers on display in the recorder window by double-click or drag&drop.
6. You can refine the search by checking the Search in previous results checkbox and
modifying the search string afterwards. Again press the Return key (< >). Now,
only the search results will be searched for the modified search term. The previous
results will be overwritten by the new search results.
142 Issue 6.3
ibaAnalyzer Manual
7. If you want to add the results of another search to the results of your latest search,
then select the Add to previous search results checkbox before you start a new
search. The previous results will not be overwritten.
Generally, the results remain in the table until they are overwritten by new results or
ibaAnalyzer is closed. The search results are not stored in the analysis file.
2. Keep the mouse key depressed, drag the signal to the other strip and finally drop
the signal there in a free area.
4. If you drag the signal in step 2 to the existing signal until a little gray arrow appears
rather than dropping the signal, the moved signal is assigned to the same Y axis
6. The color does not change as a result of the signal being moved. If you wish to
have different colors used for the signals, click the icon for automatic color
assignment (see icon above).
In order to separate a signal (and open a new strip at the same time), simply use the
cursor in order to "grab" the signal in the strip and drag the signal into the free area of
the X axis of the recorder window.
Alternatively, you can also open the context menu on the Y axis of the signal in
question and select the Remove axis command. But remember: When you remove the
Y axis, all signals belonging to this axis are also removed.
Another way of removing a signal works via the signal table. For this purpose, mark the
line containing the signal to be removed on the "Signal definitions" tab, press the right
mouse key in order to open the context menu and select the Remove signal command.
2. Now, keeping the mouse key depressed, move the strip, for example, upwards. At
first, only the black frame moves and shows above which strip the moved one will
be inserted. For example, in order to move the strip to the topmost position, the
frame must be appear around the strip which is currently in the top position.
3. Finally, release the mouse key whereupon the strip is inserted on top.
In order to ensure a clear display, it may sometimes be necessary to hide strips without
removing these (as well as the signals contained therein) from the analysis. In order to
hide a strip, just click the small arrow at the upper right end of the strip (see above).
The small arrow continues to be displayed in the recorder window and, pointing
downwards, indicates that there are still hidden strips.
When a strip is hidden, the tick in the "Show" column is removed for all the signals
contained in this strip in their signal definitions. This means that you can also hide a
strip by hiding all its signals.
Click the small cross in the upper left corner at the Y axis.
Click into a free area of the strip with the right mouse key in order to open the
context menu, and select Remove graph from the context menu.
4.3.10 Scale signals
The scaling of signals in the Y direction can be changed in the recorder window by
moving the scale ends using the mouse (refer to Shift scales , Page 147), or by
selecting the desired values from the Graph setup menu and/or from the context
menus. (Refer to Y axis , Page 77).
4.3.11 Y axis
Shared Y axes are created when one signal is linked to another as described in section
Move signals , Page 143. The Y axes are separated again by pulling the signal into the
free strip area, thereby detaching it from the other signal.
Move the mouse cursor to the Y axis until the hand symbol appears. Keep the left
mouse key depressed and move the scale up or down. In the zoomed-in condition, the
X axis can be moved in the same manner.
Position the mouse cursor in the upper area of the Y axis until two blue arrows appear.
In order to compress or stretch the Y scale, click the appropriate arrow and keep the
mouse key depressed until the desired scaling is reached.
If you are using a wheel mouse you can change the scale by turning the mouse wheel
when the mouse pointer is over the Y-axis. This works for X-axis as well.
You may make the settings in the preferences dialog or in the setup of the signal strips,
tab 2D View.
In addition to the graphical attributes, you can also adjust the content of the legend.
By default, only the signal name is contained. You can also add information to the
settings, such as module name, comment, marker values and much more.
Information on this can be found in the chapter 2D view, Page 82
Zooming out can be carried out in steps using the button. Every click successively
reverses all previous zoom steps. The context menu also offers the same function in
the strip in question.
The zoom function can also be carried out using the red frame. Just move the cursor
on the red frame line until the cursor changes to a double arrow. Then, keeping the
mouse key depressed, reduce or enlarge the red frame. Since this also works at the
upper and lower margin, it is also possible to change the section in the Y direction too,
however, for the topmost signal strip only. When zooming and shifting in the X direction,
all the strips having the same X-axis mode as the topmost one will follow suit.
By positioning the cursor within the red frame, you can move it over the curve. The
section shown in the signal strip is adjusted accordingly.
Pressing the cursor keys left / right will also move the red frame.
The navigator window will always display the time or length based form of a signal,
never a FFT presentation of a signal. If signals are displayed in FFT mode in the
recorder window, these representations are adjusted when changing the width and
position of the navigator frame because the frame also selects the samples which are
used for the FFT calculation.
X-range
If you know the required range, given in seconds or meter, resp. inches, you can enter
it in this field.
Alternatively, you may derive the range setting from different parameters.
Set from current selection
Clicking this button will set the X-range according to the width of the current navigator
rectangle.
Set from sample count
Specify the number of samples in the entry field on the right and click the button. The
width of the navigator rectangle is set accordingly.
Set from required FFT precision
Specify the required FFT precision, given in Hz, in the entry field nearby. The width of
the navigator rectangle is calculated in such way that the number of samples is
sufficient to have FFT data at every multiple of the given precision between minimum
and maximum frequency (which are in turn specified in the settings of the FFT axes,
scaling options).
Note
Any value you type can be adjusted so that the number of samples is a power of two
or a minimum number of 128 samples is respected.
Also note that only the fixed range is persistent, any values you used to calculate the
fixed range are reset the next time you open this dialog.
4.3.17 Autoscrolling
After zooming into a signal curve, the context menu for the relevant strip offers the Start
panning function.
When the panning function is activated, a compass icon is displayed in the strip in
question. This compass forms a reference point. When you now position the mouse
cursor to the left or right, above or below the symbol, the graph automatically moves in
the corresponding direction. A signal curve can be conveniently traced in this way.
Scrolling in the Y direction does not work if an autoscale operation was carried out in
the zoomed condition.
The panning function is useful in conjunction with a high zoom factor when it comes to
measuring points where repeated zooming out and in would be too great an effort.
a) b) + c) +
Time based
Fast Fourier Transform (time based)
Length based
Fast Fourier Transform (length based)
X–Y
The selection always refers to the active strip. The tool buttons which are offered at the
header bar of the strip refer to the kind of signals (time or length based) which are
displayed in the strip.
This means that all the time based signals share the same time axis, all length based
signals share one length axis, all time based FFT presentations share one frequency
axis (1/s) and all length based FFT presentations share one frequency axis (1/m). The
scaling factor of the respective axis is determined by the longest signal of its kind in the
recorder window. The X-Y presentation is a special case which is only offered if a strip
contains more than one signal.
The time mode is used for time-related signals, the length mode for length-related
signals. No curve is displayed if the mode selected does not correspond to the signal
reference.
The time mode is the default setting because the measuring data is usually recorded
on a time-related basis. Length-related signals do not exist in the regular ibaPDA data
format (*.dat file). An exception is the ibaQDR data format which can, however, only be
generated by the ibaQDR system.
4.4.2 X-Y
2. Then select the strip mode X/Y, for example, via the buttons in the header bar of the
strip.
3. Now the X-axis is divided into the position unit (mm). The Y axis of the other signal
(roll force) remains unchanged. Now, however, the roll force values are no longer
entered according to time, but according to the corresponding position values.
Tip
In the X-Y presentation, the signal occupying the bottommost position in the strip is
always shown on the abscissa, i.e. in the above example the position (green).
In order to reverse the presentation (i.e. position vs. roll force) simply use the mouse
and change the position of the signals in such a manner that the desired signal
appears in the bottommost position (see Move signals , Page 143). Alternatively, you
can click the signal which is to form the X axis with the right mouse key. Then select
the Make X-axis command in the context menu which is now opened.
4.4.3 FFT
The Fast Fourier Transformation (FFT) is a mathematical method of the Fourier
transformation and a faster variant of the Discrete Fourier Transformation (DFT). This
method transforms time-related signals into the frequency range. The FFT is used to
break down periodic signals into individual sine oscillations which, on their part, are
then broken down further into the corresponding spectral frequencies.
The FFT mode generates an FFT analysis for one or more signals within a strip and
shows the distribution of the oscillations contained in the signal as the result of the
transformation operation. The Y axis becomes the (frequency) amplitude axis, whilst
the X axis becomes the frequency axis. A power spectrum FFT is carried out according
to the algorithm of the mean square amplitude (default setting). However, you can
modify the calculation basis and the algorithms for the FFT as required both in the
preferences and in the strip setup. (Refer also to Fast Fourier , Page 80)
The results can be compared on the basis of a sine oscillation (f = 10 Hz) in Fig. below.
All the strips in the example below show the same signal with different FFT settings.
The topmost strip represents the time-based signal.
Beside the classic time based frequency axis (Hz = 1/s) ibaAnalyzer provides since
version 5.0 also a “length frequency” axis. The results of the FFT are displayed over an
inverse length axis with the unit 1/m (or 1/inch, if the inch would be given as metric
unit). This enables ibaAnalyzer to display FFTs of length based signals. Such
representations are useful when one wants to examine phenomena that reoccur
periodically over the length of something, for example irregularities in the thickness of a
finished rolled plate.
The example in Fig. above shows the recording of a measured speed signal (excerpt
over 60 s) which is “polluted” with a noise or other frequency.
The FFT of the time based signal does not show any reasonable result.
The speed signal, transformed into a length based signal, looks like the original one.
But the FFT of the length based signal shows a prominent spike at 5 1/m, which
corresponds to a distance of 0.2 m. Also the harmonics of this “frequency” are easy to
spot by their minor spikes.
4.5 Views
4.5.1 Standard view
The term "standard view" refers to the simple, two-dimensional (2D) curve
presentation. 2D presentations are typically used for displaying values which change as
a function of just a single parameter, such as time or length. The line and polygon
presentations are available in conjunction with the graph modes "time" and "length
basis". In the FFT analysis graph mode, bars and discrete frequency lines are
additionally available.
The type of 2D presentation is selected for the current strip either from the Setup -
Graph setup... menu or from the context menu for the current strip.
this purpose, select the menu Graph mode - Show cross profiles or use the strip's
context menu.
The zoom function works in the same manner as in the case of the 2D view.
4.5.2.1 Settings
In the 3D view tab of the strip settings, the topmost of the three presentation modes
must be selected (see picture above). More settings can be found in the Colors and
Color axis tab.
Colors
You can use the <Add>, <Remove> and <Edit> buttons in order to change the color
scale for the presentation of values. Corresponding to the value range of the signal
measured, the colors are distributed over ten stages each representing 10% of the
maximum value.
In order to obtain, for example, a finer graduation, further colors must be added. For
this purpose, click the color bar above which the new color is to be added. Then click
the <Add> button. The program automatically adds a new color and re-computes the
percentage stages in line with the new number of colors.
Analogously, you can also reduce the number of stages by marking a color bar and
subsequently clicking the <Remove> button.
In order to change a color, first use the mouse to mark it and then click the <Edit>
button. You can then define any color you like in the dialog which follows now.
If you notice that you made a mistake, click the <Default> button in order to reactivate
the default values. However, if you have changed the default values, this option is no
longer available, of course.
The "Use intermediate colors" and "100% correct color mapping" options refer to the
resolution with which the colors are presented. The "Use intermediate colors" option
leads to a significantly smoother presentation of the transitions between colors.
If you click the <Apply> button, you can apply the changes to the current presentation
without saving the changes. If the result is insufficient, you can continue changing the
settings or you can click the <Cancel> button in order to discard the changes. Click the
<OK> button in order to save the settings.
Color axis
In the Color axis sub-tab, you can set end values, position and division of the color
scale. Therefore, check "Manual scaling" and enter fixed scale start and end values.
Basically, the settings correspond to the settings in the Y-axis tab for the normal signal
display.
Sometimes, the frames can contain invalid (ranges without data, or the like) when in 2D
presentation mode (see marked ranges in the picture below).
In order to prevent this, you can cut the frames and thus improve the presentation.
Therefore, open the Setup (right mouse key) menu and select the Y axis tab. Select
Manual scaling and adjust the minimum and maximum value of the scale in such a way
that they comply with the real value.
As the measured values are always in the center of a zone and an interpolation
regarding the value of the adjacent zone(s) is performed for the coloring, there are
empty ranges in the two outermost zones each ranging from the center to the outside
margin of the zone. For these margins, an interpolation cannot be performed due to a
missing adjacent zone.
When autoscaling, the Y axis is scaled to the smallest and largest valid value by default
so that these margins are not visible, see picture on the bottom left at -10 and +10,
respectively.
If you activate the above-mentioned setting, the Y axis is scaled to the entire width of
all zones as shown in the bottom right picture.
4.5.3.1 Settings
Colors
The color settings enable the selection of monochrome or color presentation. When
you select the multicolor presentation option, the amplitudes of the measured values
are additionally presented in different colors. In order to set these colors, proceed in
accordance with the description in "2D top view , Page 158".
In the case of the monochrome mode, you can select the color from a small box next to
the "Monochrome" option.
Color axis
The settings of the color axis correspond to those of 2D top view, see "Settings , Page
159".
Rotation
Two axes – X and Y – can be enabled or disabled for the rotation function, no matter
whether in manual or animated mode. Ticking off the corresponding field blocks the
rotation around this axis.
If the "Animation" field is ticked off, the graph is automatically rotated around all the
axes that are enabled.
B-Splines
The B-Splines settings can be used to increase or reduce the density of the grid.
When you select the "Raw data" option, the original measuring points are presented
and connected by straight lines both in the X direction and in the Z direction.
If the B-spline curve shape is activated, the mathematical fundamentals of the B-spline
calculation are used for creating a smoothened or rounded surface. During this
process, the lines connecting the measuring points are converted to curves via
additional control points.
In the "Max. allowed complexity" input field, you can define the total number of points
(10,000 –1,000,000 points).
Finally, you can use the sliders in order to select the point density and the curve
character for the X and Z axis.
Grid
In the Grid tab, you can activate and deactivate the three-dimensional grid in which the
graph is displayed, as well as the scale values for the X and Y directions.
4.5.4 3D surface
In the 3D surface presentation, the "skeleton" of the grid presentation is covered by
some kind of "skin". The setting options of the two presentation modes thus also
resemble each other.
If the lighting function is ticked off, the program simulates lateral illumination of the 3D
graphic. This option is available both with monochrome and with color presentation.
The only way to find the optimum setting is by trial and error.
The Add signal function adds a blank line to the table and a corresponding signal strip
in the recorder window.
In the "Expression" column of this line, you can now enter any expressions you like.
These include:
Raw data (original signals)
Constant values
Expressions for creating artificial signals using the functions of the expression
builder
Mathematical operations with artificially created signals and/or raw data as
operands
The figure below shows some examples: A constant value (7.5), the generation of a
time line using the TIME function, and the generation of a sine signal using the time
line and the sine function. (For an explanation of the functions, please refer to
Expression builder , Page 228)
However, new signals can also consist of a combination of original signals. This is, for
example, shown in the figure below.
In order to add a new signal, select the Duplicate signal function from the context menu
of the signal table. This does, however, also mean that the contents of the signal to be
duplicated are copied too. This is helpful in the case of minor modifications of an
existing, longer expression.
Signals which were created in this way are saved in the analysis (*.pdo). If the analysis
is opened without a data file, these expressions are available, however, without any
values. They are not filled with values until a data file is opened.
These newly added expressions can, on their part, be operands in other new
expressions. This is why they are also offered for selection in the signal tree of the
expression builder. They are not displayed in the signal tree window!
Note
Although the signals generated in this way are saved in the analysis file (*.pdo) and
are thus independent from a data file, these expressions are also irreversibly deleted
when a signal strip containing these signals is deleted (clicking the small 'x' to the left
of the Y scale)!
In order to open the dialog window for the logical signal definitions, click the button (see
above picture) on the tool bar.
The left part of the dialog window shows a signal tree which, besides the original
signals from the data file, also offers the additionally created expressions for selection.
The field in the upper right corner shows the logical signals already created (only a
blank standard signal in the previous picture).
Red symbols beside to each signal indicate a modification (!) or deletion (X) which has
not yet been applied by <Apply> or <OK>.
Next to this field are the buttons for adding, deleting and renaming signals. <Delete>
and <Rename> refer to the signal currently marked.
If you want to delete a logical signal definition by clicking the <Remove> button the
intended deletion is just indicated at first. The signal won't be deleted before you click
<Apply> or <OK>.
172 Issue 6.3
ibaAnalyzer Manual
The buttons <Import> and <Export> are used for importing and exporting of logical
signal definitions (see section below).
The information shown below refers to the structure and contents of the signal.
A right mouse click in the window of the logical signal definitions list opens a context
menu with more commands, e. g. conversion of reference (signal name or number),
alphabetical order and deletion of all definitions.
Dimension
In this field a numerical value between 1 and 2048 can be entered. "Dimension" here
means the number of related expressions continuous over time or length which can be
subsequently displayed in a 3D view.
Regular, simple signals hence have a dimension of 1.
In order to realize a three-dimensional profile presentation, a number of measuring
series which are assigned to the third space coordinate must exist for the physical
measurand. You'll find more information further below.
Comment 1 and 2
Like for measuring signals of a data file you can enter two comments for logical signal
definitions as well which provide more information and can be used in the legend, for
example.
Unit
This unit will be used as a caption in the legend and in the signal table.
Time based / Length based
Select one of these options in order to determine whether the signal in question is
time-based or length-based.
Zone offset and zone unit
These settings provide for a more realistic presentation of profile measurements in
case of multi-dimensional signals (vectors).
For more information refer to chapter Zone control with vector signals, Page 178.
Signal expressions table
An expression which represents the desired signal must be entered in the line(s) of this
table. If you simply wish to use raw signals or existing expressions, you can use the
drag&drop function in order to drag them from the signal tree of the dialog window into
the expression table, or double-click the desired signal or expression.
In the case of complex expressions using the mathematical functions, click the button
in the table line in order to activate the expression builder. For a description of the
"Expression builder" and its use, please refer to Expression builder , Page 228.
Button <Reset signal expressions>
This button is used for removing the contents from the "Signal expression" column.
Other settings of the logical signals like name, dimension, unit etc. remain unchanged.
Buttons <Apply> and <OK>
Clicking the button <Apply> will validate modifications or deletions without closing the
dialog. The button <OK> does the same and closes the dialog.
The picture "Logical signal definition and simple expression" shows that the "logical
signal" [Artificial_sine] appears in the signal tree. However, the expression "sine" -
created as described in Add signal in the signal table , Page 169 - is not shown.
When you open the data file in ibaAnalyzer, you will only see a string of modules and
signals which, when shown individually, are not very informative.
Fig. above shows that the last signal has the number 107. Modules 0 to 3 hence
contain the signals "Measur 000" to "Measur 107".
The consecutive list of signals in the signal tree window is the more favorable basis for
the following explanations. Thus proceed as follows.
1. Select the Linear numbering option from the context menu of the signal tree
window. The signals are now shown without modules in the signal tree.
Furthermore, the signals are no longer identified by [Module number:channel
number] but by consecutive numbers from 0 to 107.
2. Open the dialog for the logical signal definitions. A signal named "Logical_001" is
offered.
3. Enter the number 108 in the "Dimension" box. As a result, 108 lines (0...107) are
created in the "Signal expressions" table.
4. Click the first line of the table in order to mark this line (gray).
5. Double-click the first signal (Measur 000) in the signal tree of the dialog window. All
the 108 signals are thereby imported to the table.
8. Now double-click the new signal or use the Drag&Drop function in order to open the
new signal in the recorder window. Due to the multi-dimensionality of the signal,
ibaAnalyzer automatically activates the 3D surface mode for the signal strip.
The full value range is, of course, initially displayed. In practical applications, however,
it is often more interesting to see the thickness fluctuations in the range of the setpoint.
This corresponds to the upper, horizontal plane in the display.
In order to obtain a more relevant display in this respect, you can use the "XMarkValid"
function of the expression builder (refer to XMark functions , Page 276) ) in order to cut
out the relevant part of the measured values. This is shown in the lower part of Fig
below.
Note
This example forms part of the sample files on the DVD delivered. The 3d_demo.dat
file contains both the measured values and the analysis, including 3D signal. Another
3D presentation sample file, 3d_demo_heavy.dat, has a similar structure, but contains
significantly more measured values, so that the calculation of the graph can take
substantially longer, depending on CPU capacity.
By indicating a zone width according to the geometrical width and a physical unit, such
as mm or cm, you get a geometrically correct representation of the strip width on the Y
axis.
Moreover, there are measuring devices having measuring zones of different width. To
get a realistic representation of the measured values in such a case, the indicated zone
width can be adjusted individually for each zone. The results of both the 2D top view
and the 3D view show a geometrically correct distribution of the measured values along
the Y axis.
For the zone width, only numerical, positive values can be entered.
By default, the zone widths are set to 1. You can overwrite these values. If many zones
are to obtain the same values, you can enter the value and click on the caption of the
zone width column. All cells below the cell where the cursor is placed are filled with this
value.
When using the zone width, the measured values are considered to be in the center of
each zone.
For a correction of the position relative to the zero line, you can enter an offset between
zero line and the center of the first zone. The offset can be a positive or negative value.
Example
The following example shows the connections based on a vector signal with 5 zones:
Display:
The first signal is positioned as specified with the Offset parameter (here at -10). The
sum of the zone widths amounts to 22 so that the last signal is displayed at +10. The
other signals' distance from each other results from the average value of the particular
zone widths. ibaAnalyzer calculates the gradients by means of a linear interpolation
between the adjacent signals. In the outer half of the outermost signals, no colors are
displayed, as an interpolation is not possible.
In the Y axis settings and the preferences, respectively, you can decide whether or not
the empty ranges are to be displayed when autoscaling the strip.
Example
Another example is to show the difference in presentation when using different zone
widths. A vector signal with 10 zones is configured for a measuring width of 500 mm:
With 10 equal zones at a width of 50 mm
With 10 different zones between 10 and 150 mm
Figure 123: Impact of equal (above) and different (below) zone widths
The lower picture clearly shows the widening of the middle range (-150 to 150).
Also in 3D presentation, the zone widths are taken into consideration:
Figure 124: 3D presentation of a vector signal with the same (above) and different (below) zone widths
Or, in MS Excel:
As long as you keep the formatting, you can edit the text file according to your needs.
Afterwards save it again as a text file and just import that text file in the logical signals
definition dialog and you saved a lot of time.
Note
The print preview function only works if a local or network printer is installed under
Windows.
In order to open the print preview, select the File - Print Preview menu.
The header of the preview includes several buttons and input boxes with the following
functions:
Print
Opens the printer dialog and starts printing.
Next page
Open the next page.
This button is only active if one page only is displayed but if more than two pages exist,
or if two pages are displayed and if more than two pages exist.
Page preview
Open the previous page.
This button is only active if one page only is displayed but if more than two pages exist,
or if two pages are displayed and if more than two pages exist.
One page / two pages
This toggle function can be used to decide whether the print preview is to show one or
two pages.
Zoom in
Slightly enlarges the page displayed (by one step).
Zoom out
Reduces the page displayed until it is completely displayed in the window, or until two
pages are displayed in the window, respectively.
Close
Closes the print preview and returns to ibaAnalyzer.
Text field
In this input box, you can enter any text and comment you like. Just click into the field
and then enter the text. Thereafter, click <Insert new>. The text is added to the sheet
and the input line is cleared for the next entries.
Insert new
Entering the text line on the sheet.
The text inserted is initially positioned in the middle of the first page or of the sheet
displayed. Use the mouse in order to move the text to wherever you like.
Remove
Removes a previously marked object from the print sheet (text and information only).
Font
Opens a dialog window where you can select the font to be used for a previously
marked object (text and information only).
Insert info
You can use this button in order to select information from the "Info" branch of the data
file and to insert this information in the hardcopy, for example, the start time of the
recording process.
Just mark the desired information and click < OK >.
Edit info
This function is similar to the "Insert info" function, however, with the difference that,
following selection of the desired information, you can additionally select characters or
parts of this information to be added to the hardcopy.
The example in Fig. above shows how the date can be extracted from the start time, so
that the date only is printed (i.e. without the time information). Use the mouse to mark
and select the desired information.
Save text fields as part of analysis file
If you need the text, comments and information inserted not just for this single
hardcopy, but if you wish to regularly apply these elements to data files of all kinds, we
recommend ticking off this box.
This is especially important and vital for the automatic generation of reports too.
All amendments are then saved in the analysis file (*.pdo) and are hence available
again as soon as this analysis is used again.
After you have entered the tick and exited the print preview, save the analysis once
again.
Note
The export function described in this chapter can only be used manually, i.e. each
export procedure must be configured and triggered manually.
For an automated export, e.g. with ibaDatCoordinator, there is a so-called data
extraction function available. This function requires a license and can be configured in
the same dialog like the data base extraction. Instead of a database the export target
is just a file. Similar options like for Export and more functions are available for
extraction.
The product name of the extractor license is ibaAnalyzer-Dat-Extractor.
Select the "Binary" export mode in order to create a new dat file in the iba default
format.
"Export analysis (pdo) as part of data file"
If you activate this option, the current analysis will be saved in the export file. When
opening the export file with ibaAnalyzer later on, the data is immediately presented in
exactly the same way.
Video export mode
If you wish to export ibaCaptureHMI or ibaCaptureCAM videos, this option has to be
enabled. In this case, all videos which are selected in the signal tree will be exported.
Moreover, you can choose whether the video sequences are stored in the export file
(.dat) or as separate video file (.mp4). A separate video file is stored in the same
directory as the export file.
Important Note
For exporting the videos, ibaAnalyzer needs access to the video files. Therefore, make
sure that ibaAnalyzer is connected to the ibaCapture-CAM server or to the
ibaCapture-HMI station.
In order to export the data to a text file, select the "ASCII" mode.
ibaAnalyzer automatically uses a tab-based text format. This means that the measuring
series (= signal channels) are separated from each other by tabs (<TAB>) in the text
file.
Further options are available as follows:
Time export mode
This option determines whether or not a column for the time stamp of the recording
process is to be created in the export file. If time information is to be exported too, you
can choose between the relative time offset
(0...x s) or the absolute date and time.
Export signal name
Tick off this option if you wish to have the signal names of the measured values to be
exported, too. The signal names then appear in the header of the measured value
columns.
Export signal unit
Tick off this option if you wish to have the signal units of the measured values to be
exported, too. The signal units then appear in the header of the measured value
columns.
Export technostring
Enable this option if you want to export a technostring from a data file ("technostring"
info field). However, this option refers to older data files (<ibaPDA-V6.8) for reasons of
downward compatibility.
From ibaPDA-V6.8 and higher, technostrings are treated and stored just like info fields.
It is thus necessary to enable the next option if you want to export one or several
technostrings.
Export infofields
Using this option, you enable the export of technostrings from data files generated by
ibaPDA-V6.8 or higher. Other info fields from the data file, in particular the internal info
fields automatically generated, are not exported.
With ibaPDA-V6, the user can only configure technostrings as exportable info fields.
Other exportable info fields can only be written into the data file with other applications,
e.g. ibaFiles, ibaDatCoordinator-DTS (Update Task) or ibaAnalyzer-DAT-Extractor.
4.8.2.3 COMTRADE
COMTRADE is an abbreviation that stands for IEEE Standard Common Format for
Transient Data Exchange (COMTRADE) for Power Systems. This is a definition of a
particular format for the exchange of data files as documented in the IEEE Std
C37.111-1999 standard. The standardization applies to both the format of the data files
and the type of media to be used for exchanging fault signal, test or simulation data of
energy supply systems.
ibaAnalyzer generates a *.dat file during the COMTRADE export which contains the
measured values, as well as a *.cfg file with configuration data, such as channel
information (signal number, signal name, info columns), the start and end time, etc.
Type
Here select the file type (ASCII or binary) of the export file.
Net Frequency
Setting of the correct net frequency (50 / 60 Hz)
Station name and recording device
According to the COMTRADE convention, information concerning the station name and
the recording device must be entered here. This information is stored in the cfg-file
which ibaAnalyzer generates during the export process in addition to the data file.
Figure 131: Original signal (blue) and exported signal (red), no linear interpolation
You can use the arrow buttons in order to adjust the time base by increasing it by
multiples of the original time base.
The export time base can never be smaller than the original time base.
Several groups with the following functions are available for selecting the signals to be
exported.
File no.:
If you select this option, all signals of the data file are exported. The number behind
the word "File" specifies the data file that will be exported if several data files are
opened. This is always the file which is marked in the signal tree window.
Export subsignals
By enabling this option, the subsignals of each signal – if available – are also
exported.
Subsignals are, for example, maximum, minimum, average value or standard
deviation. They can occur under the following conditions:
With ibaAnalyzer-DB following a database query if the additional channel
information was activated when extracting the data. After the database query,
these values are stored as subsignals below the main signals in the signal tree.
Enabling this option, these subsignals are also exported both to binary and ASCII
files. Each subsignal gets its own column which is marked accordingly.
After an HD query, which is based on the information of a time base by nature,
the minimum and maximum value of the signals are provided as subsignals in the
signal tree by default.
Tip
If you do not wish to export the complete signal content of the file, but, e.g., freely
select signals to be exported, the option of the subsignals is available in the context
menu of the signal tree.
Example
The following example of an exported ASCII file shows an analog signal, a text
channel and a digital signal exported with a time base of 1 s.
Note
Since version 4.0 ibaAnalyzer supports only the HTML-format instead of OLE objects
for the clipboard function.
It is sometimes helpful if an analysis view is not just printed as a report or written into a
separate file but if this view can also be made available to other Windows programs.
You can use the Edit (Edit - Copy) menu function in order to copy a current curve view
(all signal strips and visible tables) to the Windows clipboard from where it can be
imported to many other programs, such as MS Word or MS Excel.
The same Copy function is available in the context menu of the signal strip.
The special feature in this case is that the view is copied as collection of HTML objects.
This means that the objects can be used in other programs.
This offers an easy way to document process or fault analyses.
With older versions of ibaAnalyzer (< V6), only one table could be copied. From
ibaAnalyzer version 6.0 and higher, it is possible to position all tables arranged as tabs
by default in separate windows.
These are:
Signal tables including the signal definitions
Statistics
Marker
Harmonic markers
If you arrange these tables as separate widows in the user interface, they are also
copied as separate objects into the clipboard.
If you paste the clipboard into an MS Word file, for instance, you will see that the
graphs are arranged as graphic objects in a table and the tables (signal definitions,
markers, statistics or harmonic markers) are copied as table objects. Please note that
all signals and expressions in the signal table are copied, even the ones hidden in
ibaAnalyzer.
The navigator view and the trend overview will not be copied to the clipboard.
The following picture shows an example how the objects are pasted into an MS Word
file. As you can see, the graphs and the signal table are arranged in a table. However,
you can mark the graphs, move and resize them or change their properties like for any
other image.
The signal table can be configured and formatted with the standard table functions in
MS Word (frames, color, size, alignment etc.)
The following picture shows how it looks if you paste the clipboard into MS Excel.
The cells of the signal table are converted into cells of the spread sheet. The graphs
are inserted as images. You can mark the graphs, move and resize them or change
their properties like for any other image.
Note
These commands only refer to exactly the signal strip the context menu was opened
upon. If you have several signal strips in the recorder window and want to export
them, you have to do this for each strip separately.
4.10 Markers
Since version 5.0 of ibaAnalyzer there are three groups of markers available which
help to measure and analyze the signal charts.
The Y-values of each signal will be displayed in the signal table and also the Y-values
of the harmonic markers (integer multiples or fractions) and sideband markers if they
are available. If no markers are shown, “--“ is depicted in the table. You can "grab" the
marker of the main frequency by its thick ends or at the left side of its legend and move
it along its X-axis.
Inside the marker’s legend (little green box) you find the X-value. Clicking the harmonic
marker’s legend will display side band markers and/or harmonic markers, if configured
in the setup.
1st click harmonic markers
2nd click harmonics and sidebands
3rd click sidebands only
4th click main marker only
Harmonic markers are located at the harmonics of the main frequency. They are also
indicated by dotted lines, though they have no thick ends. Harmonic markers can not
be moved along the X-axis as their x-position is determined solely by the position of the
main frequency marker (e.g., 2x, 3x,½x). If you move the main frequency marker, the
harmonic markers will follow proportionally in the corresponding distance.
A mouse click on the legend of a harmonic marker hides the legend. Another click on
the marker will show the legend again.
Figure 140: Main marker and its harmonic markers (up to 8x)
Sideband markers are located at equidistant intervals of the main harmonic marker, are
only two thirds the length of any other marker and are connected to each other with a
horizontal line at their tops.
Figure 141: Main marker with sideband markers and harmonic markers
In the graph settings (right mouse click in the graph in question) or in the preferences
you can:
set the number of harmonic markers to be displayed below and above main
frequency,
enable / disable sideband markers,
set the distance between the sideband markers (in Hz or 1/m, resp. 1/inch) and
set the number of sideband markers (symmetrical to main frequency) to be
shown.
The number of sideband and harmonic markers as well as the distance between the
individual sideband markers can be altered by right clicking the corresponding signal
strip. Select then Setup in the context menu. In the dialog for the strip settings click the
X-axis tab and then the Frequency or the 1/Length tab. Altering the number of
harmonics (below or above) will also reset the number of harmonics shown in the
signal table.
The sideband markers of the harmonic markers can be modified too by dragging the
outer sideband marker with the mouse.
The dialog will open showing the tab that corresponds to the X-axis mode of the graph
you clicked on (time, length, frequency, 1/Length).
Column Show
Select by checkmark whether a marker should actually be displayed or not.
Column Name
Enter here the name for the marker.
Column Expression
Here you can enter an expression for the computation of the marker position. See for
example the expression in the picture "X-axis markers dialog": a marker is placed at
the position in the signal strip where the signal exceeds the roll force value of 500 tons
in the loaded data file for the first time. Note that the expression control has two buttons
at its sides (like the expression control in the signal table).
The left button opens the expression builder dialog.The right button allows you to check
any errors in your expressions.
If you use a marker on a FFT or 1/Length axis, please mind that this marker is affected
by the range of the navigator frame, provided that the result of the expression is
varying in time and not constant. This means that the marker defining expression must
be evaluated over time or length in order to take into account the part of the signal
within the rectangle of the navigator. (A time or length based signal must be displayed
in the first graph.)
For example, an expression with "XFirst" or "Max" will return a constant value and thus
is not permitting navigator control. This is not the case with other expressions which
return a non-constant signal curve of frequency or inverse length over time or length
axis. When applying such a marker to a FFT or 1/Length axis it is displayed at the point
on the X-axis which corresponds to the average of the time or length based expression
in the navigator frame.
Please keep in mind that the expression you enter must always return a position on the
X-axis in order to get a marker. At least the result of the expression which defines the
marker must comply with the unit of the X-axis of the graph the marker should be used
in.
For example, if you want to use a marker defined by an expression which returns a
frequency over time (e. g. rpm of a motor), this marker can only be used in graphs with
a frequency X-axis. (convert from rpm to Hz!)
Column Color
Select the color of the marker. Default color is red.
Column Value
If the position of a marker can be evaluated, that value will be displayed in this column
after pressing the <Apply> button, provided the "Show" option is checked.
The marker from the example above would be displayed like follows:
This marker will be placed at the point on the length axis where the measured roll force
exceeds 700 tons for the first time.
4.11 ibaCapture
4.11.1 ibaCapture-CAM
General
ibaCapture makes it possible to display measuring signals together with synchronously
recorded image data (HMI monitor display, camera images).
Video files recorded with ibaCapture-CAM or ibaCapture-HMI are loaded together with
the related *.dat file. The video sources and the related measuring signals are
displayed in the signal tree of ibaAnalyzer. In addition to the video signals, also
event-driven signals (triggers) are displayed. The relevant preferences can be made in
the ibaCapture-CAM system (see manual "ibaCapture-CAM).
Video signals are listed in the signal tree just like usual measuring signals, marked as
camera.
User management
ibaAnalyzer supports the user management of ibaCapture-CAM. If the user
management is activated in ibaCapture-CAM, a user needs to authenticate for viewing
videos in ibaAnalyzer. This ensures that no viewing rights are infringed.
In case of a protected camera view, the following message appears:
To restore the protection, you do not need to close all camera views, but you can log
out via the context menu.
Tip
The login information can be stored in the analysis (encoded), too. For this purpose,
enable the “Save password” option in the login dialog. If the analysis is saved
afterwards, the login information is saved, too.
If such an analysis file is loaded, also the video permissions are immediately available.
For reasons of safety, this only works on the computer where the analysis is saved.
This is particularly useful if, despite activated user management, automatic reports
with video still images or video exports are to be generated.
You can also save the ibaCapture-CAM permissions on the computer by enabling the
"Save login data on the computer" option.
Thus, you can guarantee access to the protected videos on this computer independent
of the loaded analysis file.
Clicking on the <Clear credentials> removes the login data from the computer.
Issue 6.3 207
Manual ibaAnalyzer
The video signals contained in the video file can be loaded into the recorder window by
a double click or drag & drop. Each video, i.e. each camera, is displayed in its own
window.
When opening a video trigger signal, a binary time signal and the X1 marker are
opened simultaneously. This gives you a quick overview about when the trigger-driven
recording is going to end. You can open the related video by double-clicking on the
trigger signal. If you have opened video signals in addition to the trigger signal, you can
modify the video image by moving the X1 marker.
Figure 147: Video window and related trigger signal with marker
corresponding signal curves and marker view are opened, the X1 marker will always
show the current position of the video in the signal curve. Clicking <Stop> will stop the
playback or end it. The X1 marker will jump back to its original position.
Speed (fast/slow or back/forward), brightness and contrast can be set with the sliders
at the top or right side of each video. The sliders can also be moved during playback.
If you want to enlarge a detail in the video, draw a rectangle around this object using
the mouse or just scroll the mouse wheel with the cursor on the image. You can zoom
out either by using the scroll wheel of the mouse or by clicking on the magnifier icon.
When zoomed in, you can pan the image detail by moving the mouse keeping the
<ALT> button pressed. The cursor changes to an index icon.
The opened video windows can be docked as well as positioned freely floating at any
place, even outside the program window, using drag & drop. The same rules apply as
for all other docking windows (see chapter Smart Docking , Page 25 ).
The size of a video window is variable. Simply move the cursor over either one of the
margins or over one of the corners of the window. When the cursor changes to resizing
arrows, left-click and resize the window as desired. No matter where you click, the
preset aspect ratio cannot be changed.
If you have several video windows of different size arranged in tiled windows and/or in
tab cards and want to arrange them having the same size, the context menu provides
the same function for resizing as do the other docking windows.
For more information, please see the chapter Scale window automatically, Page 29
Every video can be started or paused by a combined <start/pause> button. The buttons
<next frame> or <previous frame> allow for playing the video reverse or forward frame
by frame (1 frame = 1 click).
If you click on the buttons for more than 1 second, the frame rate will increase to 5
frames per second. Via the "Speed" slider, you can reduce the frame rate of integrated
windows with a originally high frame rate.
4.11.2 ibaCapture-HMI
In ibaAnalyzer, video recordings generated with ibaCapture-HMI are generally handled
the same way as videos generated with ibaCapture-CAM. The videos are indicated
with a camera symbol in the signal tree and can be opened in a separate video window
via double click or drag&drop. The usage is described in "ibaCapture , Page 206"
Different elements are available for the control of the video display.
In case you want to print ibaCapture-HMI videos, particular settings are available. You
will find a detailed description in ibaCapture , Page 97.
If you want to integrate ibaCapture-HMI videos in a report, proceed the same way as
when working with ibaCapture-CAM videos. (see Video objects , Page 399)
If you want to export ibaCapture-HMI videos from a dat file, activate the "Free
selection" module in the signal selection of the export mode. Subsequently mark the
relevant video signals. If you tick off the "Export video as part of a data file" option in
the export mode and subsequently reload the exported file, the "Replace path..." and
"Copy video files to local disk before loading" options in the Preferences/Signal strip
settings will be ignored. (see picture below for setting items)
For more information, please refer to ibaCapture, Page 97.
4.12.2 Presentation
In ibaAnalyzer, text channels can be found in the signal tree of the data file and can like
any other signal be dragged into a signal strip or opened by a double click.
The positions of text channels displayed in a signal strip correspond to their positions in
the data file. They appear as a vertical line with a legend, in which the value or the text
is displayed.
In the following picture, for example, the product number (Coil no.) was created as a
text channel in ibaAnalyzer and saved again whenever a value changed. For
comparison, the product number is also displayed as numerical value with the red
curve above.
4.12.3 Processing
It is also possible to export text channels into a binary file (*.dat).
The functions SHL and SHR (move signal/expression to the left or right) do also
support text channels.
After you dragged the text channel over the video, you can set the position and the
presentation mode via the context menu Setup overlay text.
Further documentation
Structure, function and configuration of an HD server are described in detail in the
corresponding ibaHD server product manual.
Files or HD queries in the signal tree are replaced by the new query.
If there already is an HD query or a data file in the signal tree and you want to add an
HD query, click Historical data – add HD query in the menu or click on the
corresponding button.
The context menu of the signal tree window also contains some commands for adding,
replacing or appending:
This tab shows a table including the computers recognized in the network running an
HD server (service). If required, you can update the table by clicking on <Search>.
Green entries indicate HD servers with existing stores and data. Red entries indicate
HD servers of an incompatible version (see picture above). The HD query with
ibaAnalyzer is only supported for HD server versions 1.3.0 or higher.
Select the desired HD server in the table and the name is displayed in the "Server" field
at the top.
Alternatively, you can manually enter the computer name or IP address in the field.
The port number must comply with the setting of the selected HD server service, which
is usually the case.
In the next step, select one or several HD store(s) to be taken into consideration when
querying.
Open the selection list in the "Store" field and check the stores which you want to use
for the query. In the query result, a separate pseudo data file appears for the selected
storage in the signal tree. If you do not select a store, separate pseudo data files are
created for all stores.
If you have completed all settings, go to the Time selection tab.
Signal tree
The signal tree is located in the left area of the dialog. There, you will find the HD
stores having been marked in the Connection tab before. Under each HD store, you
will find the signals saved by the HD server.
In the signal tree window, the context menu provides different commands for the
display mode and filtering of the signals.
The display mode determines as to how the signals are displayed in the tree.
Note
The setting selected for the display mode is taken over for the normal signal tree in
ibaAnalyzer and vice versa.
The filter settings define which signals are displayed. Active signals are signals which
are currently also being written in the HD store. Inactive signals are signals which have
been recorded, however, are currently being not written.
Moreover, the signal tree window offers a search function in order to search for
particular signals. The function is equivalent to the search function in the normal
ibaAnalyzer search window.
In addition to the markers, there are also other means for limiting the time range.
Input fields and calendar functions for date/time of starting and stopping time
If you shift the markers, the values in the fields are adjusted accordingly. You can
also directly enter date and time. The markers are then positioned accordingly.
If you click on the Stop link marked blue in front of the date field of the stop
marker, the stop marker is automatically positioned on the current point in time
and the signal values currently being available in the HD store are loaded.
<Zooming in on range> button
As the markers are always bound to the point in time set on the X axis, they are
not repositioned when zooming in or out or when moving the X axis. Also moving
the markers or changing the start and stop time values does not induce an
Issue 6.3 219
Manual ibaAnalyzer
automatic adjustment of the zoom factor. Thus, they can be very close to each
other or they can be outside the window. By clicking on the button, the zoom
factor and position are set in such a way that the selected time range is displayed
in the center of the signal strip. Start and stop markers are always positioned at
one quarter or three quarters of the visible X axis segment.
Duration input fields
The duration, i.e. the width of the time range, is displayed in these fields. The
values are adjusted accordingly while shifting the markers. However, you can
also directly enter the time in days, hours, minutes and seconds. If you change
the time values by entering or using the up and down buttons, the markers will be
positioned according to the button nearby.
- "From stop": stop marker fixed, start marker is shifted
- "From start": start marker fixed, stop marker is shifted
- "Centered": the center of the selected range is stationary, both markers are
shifted symmetrically to this.
If you change a time value using the up and down buttons while holding down the
<Ctrl> key, the other values are set to zero.
If you directly enter the numerical values, hold down the <Ctrl> key and press
<Enter> to apply the value and to set the other values to zero.
Preferred time base
You can select from the preferred time base drop-down list a time base with
which the data is to be loaded if possible. The ibaHD server automatically tries to
find a time base as suitable as possible. There is more information on this topic in
the next chapter.
Figure 158: HD query dialog, selection list for preferred time base
By means of this selection list, a time base can be selected with which the loaded
signal values are to be displayed later on. Depending on the time resolution of the
requested data, select a small time base (high resolution) or a larger time base (lower
resolution).
The values contained in the list are integral standard values and are usually only
approximations. The actual time base with which the data can be loaded is determined
by the storage in the HD server. Only the original time base (highest resolution) and the
automatically determined time bases of the different consolidation levels are available.
When selecting the preferred time base, the following cases can occur:
Selection Result
Preferred time base equals The data will be loaded with this time base.
an existing time base in the
HD store
Preferred time base is The data is loaded with the smallest time base available.
smaller than any time base
in the HD store
Preferred time base is ibaHD server makes the decision as to which available
between a smaller and time base will be loaded based on the following formula:
larger time base in the HD The larger time base will be loaded if
store
Depending on the time range set, the selected time base has significant impact on the
data volume.
In the HD query dialog, you can only set the time range for the query, but you cannot
select particular signals. For an HD query, all signals contained in the HD store in
question are loaded for the set time range.
If the set time base is very small and the time range very large, the data volume to be
loaded can exhaust the storage capacity so that further processing or analyzing the
data is only possible to a limited extent, if any.
The ibaHD server thus calculates the data volume to be expected depending on the set
time range and indicates the borders by means of a color change of the time base
values in the drop-down list. The "Auto" setting always selects the optimum time base
automatically.
In addition to this, a tooltip points to possible difficulties if the relevant time base is
selected nonetheless.
The following table explains the color code and possible messages.
Color Relevance
Red Adjusted time range and this time base would require more storage
capacity than ibaAnalyzer is able to provide. When selecting this time
base without minimizing the time range, an error message occurs if you
click <OK> for exiting the dialog.
In general, the signals of an HD query are treated the same way as the signals from a
normal data file.
In principle, analyses created by means of a data file can also be applied to the HD
query results and vice versa.
Depending on the selected options in the HD server tab in the strip settings or
preferences, the maxima and minima of the aggregated values of a signal are queried
as sub-channels. This can be particularly interesting when selecting a large time base
or with regard to data of a higher consolidation level. "Outliers" can thus be easily
identified.
For more information on HD settings, see chapter HD Server, Page 101
For executing a drill-down, you can use the corresponding button or the command in
the View menu:
Button and menu command are only available if it was zoomed in before. If you want to
execute another drill-down, you have to keep on zooming in.
The executed drill-down operations are saved in a stack and can be undone
individually. The button and the menu command for Undo drill-down are available if at
least one drill-down had been executed.
Drill-down operations are only applied to pseudo data files whose signal(s) is/are
displayed in the currently selected signal strip or used in an expression which is
displayed in the currently selected signal strip.
According to this, a drill-down can only be undone for pseudo data files to which the
displayed signals or expressions relate.
If you execute a drill-down, you practically execute a modified HD query. The original
pseudo data file in the signal tree is overwritten accordingly. The HD query generated
by a drill-down has the following characteristics:
Same HD server and same HD store
Time range in accordance with the zoomed X axis range
A preferred time base, calculated according to the following formula:
Example
An HD query over a time range of 2 days and 8 hours with a time base of 30 s
provides the following picture after zooming in to a time range of only 8 min:
Content Description
[HDQ file] Identification HD query
port number=9180 Port number for network connection
server=IBA-BLN-NOTE345 HD server name
starttime=31.10.2013 10:15:50.336000 Period to be read out
stoptime=31.10.2013 10:19:25.758000 HD store where the data is stored
store=HD store_Time Time base of the measured data
timebase=0.001 Time-based or length-based data
type=time
The HD-query files with suffix .hdq can be used like normal measured data files in the
commandline excution of ibaAnalyzer too.
5 Expression builder
5.1 Function and use
The so-called expression builder is a tool for entering (mathematical) formulae or
expressions which are described in detail in the following sections. It is, of course, also
possible in principle to manually enter these expressions in the lines of the signal table
on the Signal definitions tab. In this case, however, you need a profound knowledge of
the possible operations and their syntax, good eyesight and a fast hand on the
keyboard.
The expression builder facilitates the process of selecting and entering operations. In
order to open the expression builder, click the icon (see picture above) which you can
find in every line of the table of signal definitions.
Note
The button on the tool bar does not open the expression builder. It rather triggers
the dialog for the logical signal definitions, i.e. for the creation of virtual and complex
signals (refer to Logical signal definitions , Page 172.
Tip
The decimal point (Anglo-Saxon system) rather than the comma serves as the
decimal separator in numerical values.
5.1.1 Configuration
The part on the left shows a signal tree which is very similar to the one in the signal
tree window. However, in contrast to the signal tree window, this window here contains
not just the original signals but also all the expressions which were already created
using the expression builder. From this signal tree, you can now select the desired
signals or expressions to be used in the calculations.
The right part of the dialog window contains a function tree view with a collection of the
available mathematical operations and other functions according to subjects. The
command line in which you enter the desired expression is located below these two
selection fields. The gray area above this line shows a short note concerning the syntax
of an operation if this operation is marked in the function tree.
The <Reset expression> button removes all entries from the command line.
You can enable the "Reference signals by name" check box if you want to use the
signal names in the expressions instead of the usual signal designations consisting of
[module number:signal number].
Note
When using the signal names as signal reference, it must be guaranteed that the
signal names are unambiguous!
In order to move signals and expressions into the command line of the expression
builder by a double-click, use only the signal tree in the dialog window of the
expression builder rather than the normal signal tree in the signal tree window!
Tip
The experienced user may use alternatively the supportive input aid Intellisense. As soon as
you start typing in the signal table (Expression column) or in the command line of the
expression editor a window will pop up suggesting potential completions of the string you are
about to enter. This includes functions and their parameters as well as signals or virtual
expressions which are available in the measuring data file. By means of cursor control buttons
you can select an appropriate entry in the Intellisense window and take it over by pressing
<Return>. If you go on typing the range of suggestions will be adjusted accordingly until the
expression is finished.
Example
Calculating the mean value of an original signal (temperature value)
1. Click the button in order to open the expression builder in a blank line of the
signal definition table which you have previously opened using the Add signal
option.
2. Double-click the "AVG" function in the "Statistics" branch of the function tree.
The function is copied to the command line, with the first parameter (operand)
being automatically marked.
3. Now search for the desired signal in the signal tree and double-click this signal in
order to select it. The signal is copied to the position marked.
4. Add the closing bracket and the operation for the average calculation is completed.
Example
Calculating the mean value of a calculated expression
Proceed in just the same manner if calculated expressions are used as operands.
Steps 1 and 2 are the same as above. In step 3, double-click the desired expression in
order to copy it to the command line.
Although the expression itself is automatically entered as the signal name, you can
simply overstrike it by manually entering a plain text. In the case of more complex,
cascaded expressions, we urgently recommend using names which should be as short
and clear as possible in order to ensure that the expression is readily understandable.
When a mistake occurs during work in the expression builder or in the signal definition
line, for example, when you forget a parenthesis, ibaAnalyzer marks this mistake in red.
It goes without saying that no mistakes other than formal or syntax errors can be
detected here with which a calculation is not possible. Using the diagnosis functionality
is another way of obtaining further information concerning the cause of an error. When
you click the yellow question mark icon in the corresponding signal definition line, the
diagnosis window is opened.
In this simple example, the missing right parenthesis is relatively easily identified as the
mistake. In the case of more complex, nested expressions, this is sometimes much
more of a problem. You can, of course, activate the diagnosis at any time even when
there is no mistake to be analyzed, for example, in order to obtain an overview of the
correlations between the operands in an expression.
Figure 166: Comparative operations, example: comparison of the momentary values of signals A and B
Note
If the crossing point of two curves is located between two measuring points, the result
of the comparative operation of the last two measuring values is retained until the next
measuring point. This means that any change from TRUE to FALSE (or vice versa) is
always entered in the grid of the measuring points. The line which connects two
measuring points in the presentation of analog values is just a graphic approximation.
Figure 167: Boolean algebra, example: different combinations of two digital signals (Logical_A and -_B
If the arguments are not integers, the decimal part will be dropped before the operation
is executed. If the arguments are too big so that their absolute value does not fit in a
32Bit integer, the operation is executed only on the 32 low-order bits.
When linking two analog values with a bw function, the individual bits of both values
are logically linked. The result then is an analog value of the same type with a bit
pattern in accordance with the logical link.
Example
For 2 analog values W1 = 15 and W2 = 2, the results are as follows:
Example
The following picture shows 2 signals (Signal 1, Signal 2) in the upper 2 graphs. The
graphs below show the different bitwise combinations.
5.2.4 Branching
5.2.4.1 If
If ('condition', 'true expr', 'false expr')
The If function can be used for a conditioned execution of further calculations.
Depending on the Boolean result of a ‘condition’, which can be an operation itself, the
operation ‘true expr’ will be executed in case of TRUE, the operation ‘false expr’ in
case of FALSE.
Hence, different calculations can be executed in a process-controlled manner. Of
course, you can use this function in a nested matter and thus realize further branches.
5.2.4.2 IsData
IsData (‘expression’,’end')
The result of this operation is TRUE if measured values are available for 'expression'.
The result is FALSE if measured values are missing or signals are empty.
This function, for example, can be used as condition for other calculations.
Optionally, the 'End' parameter can be entered. With this parameter, you can reduce or
extent the result signal of the function so that it complies with other signals and can be
used for further links. If you do not specify the 'End' parameter, the length of the result
signal complies with that of the input signal (incl. invalid samples).
Example
In the following example, two signal curves of different lengths are displayed in the
view (1). The "sine_short" signal is only half as long as the "sine_long" signal. For the
time period > 5 seconds, the "sine_short" signal has no measured values.
For demonstration purposes, the XMarkValid function from the measured values of the
"sine_short" signal being between 0 and 2.5 s is used to generate a new signal
"sine_part" (2).
If you apply the "IsData" function without the end parameter to the "sine_part" signal,
the result from 0 to 2.5 s is TRUE and from 2.5 to 5.0 s FALSE (3).
The FALSE value is displayed up to 5.0 s, as the original reference signal is
"sine_short".
If you apply the "IsData" function with the end parameter, the result is shortened or
reduced to the length of the signal specified as "end" – in this case "sine_long" (4).
This allows, for example, the linking of the IsData result with the "sine_long" signal
also in the time period > 5 s.
5.2.5.2 SetReset
SetReset (Set, Reset, Setdominant)
This function returns the result TRUE (logical 1) if a rising edge (01) is detected with
signal “Set”.
It returns the result FALSE (logical 0) if a rising edge (01) is detected with signal
"Reset”.
The parameter “Setdominant” can be used for control of the dominance of the edges. If
no “Setdominant” is specified, then “Set” is dominant.
If “Setdominant” = TRUE (log. 1), then “Set” is dominant over “Reset”.
If “Setdominant” = FALSE (log. 0), then “Reset” is dominant over “SET”.
The value for "Setdominant" can be entered as a constant like
“1” or “true()” in case of TRUE and like “0” or “false()” in case of FALSE.
This function can be used, for example, to enable conditional calculations with a signal
and to disable them with another signal (e.g. combined with IF function).
The TP function provides a pulse of the length PT as output signal with a rising edge of
input signal IN. If at the beginning of the acquisition the input signal is TRUE already,
the first pulse is generated when starting the acquisition. With every first rising edge
after the end of the previous pulse, additional pulses are generated.
5.3.1.2 Abs
ABS ('Expr')
This operation returns the absolute value of 'Expr' as its result.
5.3.1.3 Mod
MOD ('Expr1', 'Expr2')
This operation returns the modulo of 'Expr1' and 'Expr2' as its result. This function also
permits the use of floating-point values for 'Expr1' and 'Expr2'.
The modulo r is the residue of the division Expr1 / Expr2 so that the following
relationship applies in reverse:
Expr1 = Expr2 * n + r , where n is an integer.
The modulo r always has the same sign as 'Expr1' and the absolute value of r is always
smaller than the absolute value of 'Expr2'.
If 'Expr1' < 'Expr2', then the function returns the value of 'Expr1' as its result.
Mathematically speaking, the modulo can also be described as "Expr1 modulo Expr2".
Examples: MOD (7,3) = 1 ; seven divided by three equals two, modulo 1.
MOD (20.0,10.5) = 9.5
The example in the above picture shows how to evaluate the length of a rolled bar in a
reversing mill by means of the integral. When using the Int function on the speed signal
without the reset operand, the result would be a curve like in the third graph. In order to
get the length of the rolled bar, you should consider only the time when the bar is in the
rolling mill. The expression “Empty roll gap” is the virtual signal that indicates if no
material is in the rolling gap (assumed roll force < 0.25 MN). As long as this signal is
TRUE, it must not be integrated. Using this signal in the Int function as ‘Reset’ operand,
the integration will be suppressed as long as the gap is empty. Hence, only the length
of the rolled bar is calculated for each pass of the mill (graph at bottom).
5.3.2.2 Dif
Dif (‘expr',dy)
This operation provides different results depending on the 2nd parameter (dy). The
operation can also work with non-equidistant measured values.
If the 2nd parameter (dy) is not specified or the value 0 or FALSE() is indicated,
the result is the derivation (differential) dy / dx of 'expr'.
If 'expr' is, e.g., a length measuring signal, the speed curve can be determined by
means of this operation.
If the 2nd parameter is set to 1 or TRUE(), the function always calculates the
difference between the current and previous sample.
5.3.3.1 Pow
Pow ('Expr1', 'Expr2')
This operation increases 'Expr1' (basis) to the power of 'Expr2' (exponent).
5.3.3.2 Sqrt
Sqrt ('Expr')
This operation returns the square root of 'Expr' as its result.
5.3.4.1 Exp
Exp ('expression')
This operation calculates the result of e (Expression).
5.3.4.2 Log
Log ('Expression')
This operation returns the natural logarithm (ln x) of 'Expression' as its result.
5.3.4.3 Log10
Log10 ('expression')
This operation returns the decadic logarithm (lg x) of 'Expression' as its result.
5.3.5 PI
Pi()
The number PI (π) is stored as a constant (3.1415927...) in the system for various kinds
of calculations.
5.3.6 Sum
Sum (‘Expression’, ‘Reset’)
This operation summarizes all signal points of a function point by point. If the
summation is interrupted by a reset value, then the summation starts again. In the
shown example, this means: The summation starts with the signal point 10 + 9 + 8 +
…6. Here, 'reset' = TRUE (where [Y]=5) causes an interruption and the function is reset
to zero. After that, the summation starts again.
5.4.1 Cos
Cos ('Expression')
This operation returns the cosine of 'Expression' as its result.
5.4.2 Sin
Sin ('Expression')
This operation returns the sine of 'Expression' as its result.
5.4.3 Tan
Tan ('Expression')
This operation returns the tangent of 'Expression' as its result.
5.4.4 Acos
Acos ('Expression')
This operation returns the arccosine of 'Expression' as its result.
5.4.5 Asin
Asin ('Expression')
This operation returns the arcsine of 'Expression' as its result.
5.4.6 Atan
Atan ('Expression')
This operation returns the arctangent of 'Expression' as its result.
5.4.7 ATAN2
Atan2 (X,Y)
This operation returns the arctangent of Y/X as its result. Signs are taken into account.
5.5.1.1 Avg
Avg ('Expression')
This operation returns the arithmetic mean value of 'Expression' as its result. It is
displayed as a constant value (horizontal line) in the signal strip.
5.5.1.2 AvgInTime
AVGinTIME ('expression', ‘interval')
This operation returns the average value per X axis interval of the length 'interval' of
'expression' as its result. The entire signal is divided into intervals of the length
'interval', with the arithmetic mean value being calculated for each of these intervals.
5.5.1.3 Mavg
Mavg (‘expression', ‘interval in X axis units')
This operation returns the floating arithmetic mean value of 'expression' as its result,
calculated over an interval of 'X axis interval' and advancing by one measuring point in
each case.
Note
Using these functions, also signals and expressions can be processed which are not
time-based, i.e. which have the bases length, frequency or 1/length. Instead of “Time”
as X axis interval, enter the required X range in units of the corresponding base (m, Hz
or 1/m).
5.5.1.4 AvgValid
AvgValid ('Expression’)
This operation returns the mean value of 'Expression' for the interval (time or length) as
its result where a related control signal is TRUE (horizontal line).
5.5.2 Maxima
5.5.2.1 Max
Max ('Expression')
This operation returns the maximum value of 'Expression' as its result. It is displayed as
a constant value (horizontal line) in the signal strip.
5.5.2.2 Max2
Max2 ('Expression1', 'Expression2')
This operation returns the maximum value of 'Expression1' and 'Expression2' as its
result. The two signals are compared measuring value by measuring value, with the
larger value in each case being supplied as the result.
5.5.2.3 MaxInTime
MAXinTIME ('expression', 'interval')
This operation returns the maximum value of 'expression' during each interval of the
'interval' length as its result. Signals and expressions being time-based ("interval" in
seconds) or length-based ("interval" in meters) can be processed.
5.5.2.4 MaxValid
MaxValid ('Expression’)
This operation returns the maximum of 'Expression' for the interval (time or length) as
its result where a related control signal is TRUE (horizontal line).
5.5.2.5 Mmax
Mmax (‘expression', ‘interval in X axis units')
This operation returns the maximum of "expression" within a floating X axis interval of
the length "X axis interval" as its result, advancing by one measuring point in each
case.
5.5.3 Minima
5.5.3.1 Min
Min ('Expression')
This operation returns the minimum value of 'Expression' as its result. It is displayed as
a constant value (horizontal line) in the signal strip.
5.5.3.2 Min2
Min2 ('Expression1', 'Expression2')
This operation returns the minimum value of 'Expression1' and 'Expression2' as its
result. The two signals are compared measuring value by measuring value, with the
smaller value in each case being supplied as the result.
5.5.3.3 MinInTime
MINinTIME (‘expression', ‘interval')
This operation returns the minimum value of 'expression' during each interval of the
'interval' length as its result. Signals and expressions being time-based ("interval" in
seconds) or length-based ("interval" in meters) can be processed.
5.5.3.4 MinValid
MinValid ('Expression’)
This operation returns the minimum of 'Expression' for the interval (time or length) as its
result where a related control signal is TRUE (horizontal line).
5.5.3.5 Mmin
Mmin (‘expression', ‘interval in X axis units')
This operation returns the minimum of "expression" within a floating X axis interval of
the length "X axis interval" as its result, advancing by one measuring point in each
case.
5.5.4.1 StdDev
Stddev ('Expression')
This operation returns the standard deviation Sx of 'Expression' as its result.
The standard deviation is calculated by the following formula:
∑ ( x − x)
i
2
sx = i =1
n −1
5.5.4.2 MstdDev
MstdDev ('expression', 'interval')
This operation returns the floating standard deviation of 'expression' over each time
interval of the length 'interval' as its result. Signals and expressions being time-based
("interval" in seconds) or length-based ("interval" in meters) can be processed.
5.5.4.3 StdDevInTime
StdDevInTime (‘expression', ‘interval')
This operation returns the standard deviation of 'expression' during each interval of the
length 'interval' as its result. Signals and expressions being time-based ("interval" in
seconds) or length-based ("interval" in meters) can be processed.
5.5.4.4 StdDevValid
StdDevValid ('Expression’)
This operation returns the standard deviation of 'Expression' for the interval (time or
length) as its result where a related control signal is TRUE (horizontal line).
5.5.5 Percentiles
5.5.5.1 Percentiles
Percentile ('expr', 'p')
This operation returns the "pth" percentile of 'expr' as its result.
The "pth" percentile is the smallest value of a set of measured values which is greater
than p% of the number of values measured. A typical percentile is the 50% percentile,
the so-called median. The median divides the set of values measured into two equal
halves: 50% of all values measured are smaller than the median value, the remaining
50% are greater than or equal to it. Further typical percentiles are 25% and 75% which,
together with the median, enable the division of a set of values measured into four
groups, the so-called quartiles. (< 25%, <50%, <75%, ≥75%).
The "Percentile" function determines the percentile value of the total number of
measuring points of a signal. The percentile 'p' must be entered as a decimal value,
i.e.:
50 % --> p = 0.5 (default value)
75 % --> p = 0.75
95.9 % --> p = 0.959
This function is, for example, particularly useful when it comes to assessing the quality
of a product where a particular property must comply with a defined classification.
Example: Classification of the quality of the rolling process of strip steel in terms
of the thickness deviation of the finished product.
In order to determine the quality of the rolled strip, quality classes are defined for the
thickness deviation as one out of several measures. The lower the thickness deviation
of the strip thickness measured from the related setpoint, the higher the quality of the
rolled product. The following values are assumed here for illustration purposes.
The thickness deviation must comply with the following criteria as a precondition for a
finished rolled strip to be classified as marketable:
at least 95% of all the measured values of the strip must be smaller than 20 µm
at least 97.5 % of all the measured values of the strip must be smaller than
80 µm
at least 99.5 % of all the measured values of the strip must be smaller than
150 µm.
In other words, this means that, for example, only 0.5% of the values measured may be
subject to a thickness deviation greater than 150 µm as a precondition for the strip not
to be sorted out.
In the example shown below, the three percentiles, i.e. 95% (p = 0.95), 97.5% (p =
0.975) and 99.5% (p = 0.995) of the measuring value "116 Thickness deviation behind
F7" were thus determined. Although the percentile values are not displayed in the
signal strip display in order to save space, they are displayed in the "Report info"
window using the report generator function. In the interest of enhanced presentation,
the values determined are compared to the above-mentioned limit values and the result
of the comparative operations is displayed as binary signals (color bars). All the three
bars must be displayed as thick bars in order for the strip to meet the quality
requirements.
This is the case in the following picture. The thickness deviation values are clearly
below the specified limit values in all three bands. 99.5% of the values measured, for
example, show a thickness deviation of less than 78.1 µm.
The picture below shows a strip where 95% of the values measured comply with the
limit value for class A and 97.5% of the values measured with the limit value for class
B, but unfortunately 5% of the values measured violate the limit value for class C,
amounting to 171 µm and more.
5.5.5.2 VectorPercentile
VectorPercentile (Vector, Percentile=0.5)
This function was introduced to output the "pth" percentile per time stamp for a
multidimensional signal (vector) consisting of several individual signals. The percentile
must be entered as a decimal value, e.g.:
50 % -> p = 0.5 (Default)
75 % -> p = 0.75
95.9 % -> p = 0.959
The example in the picture shows the curve of the percentile 85% (thick red line) for a
vector consisting of sinusoidal quantities.
5.5.5.3 PercentileValid
PercentileValid ('Expression', 'Valid', Percentile=0.5)
This operation returns the percentile of 'Expression' for every interval (time or length)
as its result for which a related control signal 'Valid' is TRUE.
5.5.6.1 Correl
Correl (‘Expression 1', 'Expression 2')
This function calculates the correlation coefficient between Expression 1 and
Expression 2. The entire recording length is taken into account. The function returns a
constant value as result.
5.5.6.2 Mcorrel
Mcorrel ('Expression 1', 'Expression 2', 'Interval')
This function calculates the correlation coefficient between Expression 1 and
Expression 2 over intervals of 'interval' s, m, Hz or 1/m.
5.5.6.3 CoVar
CoVar ('Expression 1', 'Expression 2')
This function calculates the covariance between Expression 1 and Expression 2. The
entire recording length is taken into account. The function returns a constant value as
result.
5.5.6.4 McoVar
McoVar ('Expression 1', 'Expression 2', 'Interval')
This function calculates the covariance between Expression 1 and Expression 2 over
intervals of 'interval' s, m, Hz or 1/m.
5.5.7 Kurtosis
The calculation of the kurtosis is used e. g. for the evaluation and analysis of
oscillations. It serves to determine the number of outliers within an oscillation signal.
In mathematical terms, the kurtosis is a measure for the relative "flatness" of a
distribution (compared to the normal distribution which has a kurtosis of zero). A
positive kurtosis shows a tapering distribution (a so-called leptokurtic distribution),
whereas a negative kurtosis shows a flat distribution (platykurtic distribution).
This statistical method is particularly suitable for analyzing random or stochastic
signals, e. g. in terms of condition-based maintenance (Condition Monitoring) when
analyzing oscillations. For characterizing the signal curve, methods of probability
density or frequency are used. It is assumed that after filtering out e. g. rotational
frequency oscillation components, a noise signal with a Gaussian amplitude distribution
is measurable with machines in good order. In case of occurring damage, particular
impulse signals interfere with this signal changing the distribution function. By choosing
suitable characteristic values such as the crest factor or the kurtosis factor, the
machine condition can be evaluated.
If regularly measured, these methods offer an overview of the machine status.
However, the disadvantage is that the characteristic values decrease again after they
had increased. The reason for this is that the number of impulse signals increases in
case of advancing damage. This again affects the effective value, the peak value,
however, is hardly affected. Modifications of the time signal caused by shock pulses
effect a change in the resulting distribution function. Thus, damage with distinctly
discrete character makes the kurtosis factor increase excessively. Its absolute value
thus allows statements on damage.
The calculation of the kurtosis is similar to the calculation of the standard deviation
'StdDev'.
5.5.7.1 Kurtosis
Kurtosis (Expression')
This operation returns the kurtosis of the selected time signal as its result (expression).
5.5.7.2 KurtosisInTime
KurtosisInTime ('Expression', 'Interval')
With this operation, the selected expression is divided into intervals of equal length of
the quantity 'Interval'. For these intervals, the kurtosis is subsequently calculated.
5.5.7.3 MKurtosis
MKurtosis ('Expression', 'interval')
This operation calculates the kurtosis of 'expression' over a fixed but floating X axis
interval.
5.5.7.4 KurtosisValid
KurtosisValid ('Expression', 'Valid')
This operation describes the kurtosis for those areas where a related control signal is
TRUE.
5.5.7.5 VectorKurtosis
VectorKurtosis('Vector')
This operation calculates the kurtosis for every signal point of a vector. Please note that
at least 4 signal points must be available for this calculation.
5.5.8 Skewness
Like the kurtosis factor, the skewness factor can be used for evaluating and analyzing
oscillations. The skewness factor can be used if the symmetrical properties of an
oscillation signal are to be checked (e.g. acceleration signal). In mathematical terms,
this is the evaluation of the skewness of a distribution function. A distribution is called
positive (and/or negative) if the lion's share of the distribution is concentrated on the left
(and/or right) side. The skewness level is defined by the third moment of the
distribution. The calculation of the skewness is similar to the kurtosis and standard
deviation functions:
5.5.8.1 Skewness
Skewness ('Expression')
This operation returns the skewness of the selected time signal (expression) as its
result.
5.5.8.2 SkewnessInTime
SkewnessInTime ('Expression', 'Interval')
With this operation, the selected expression is divided into intervals of equal length of
the quantity 'Interval'. For these intervals, the skewness is subsequently calculated.
5.5.8.3 MSkewness
MSkewness ('Expression', 'interval')
This operation calculates the skewness of 'expression' over a fixed but floating X axis
interval.
5.5.8.4 SkewnessValid
SkewnessValid ('Expression', 'Valid')
This operation described the skewness for those areas where a related control signal is
TRUE.
5.5.8.5 VetorSkewness
VectorSkewness ('Vector')
This operation calculates the skewness for every signal point of a vector. Please note
that at least 4 signal points must be available for this calculation.
5.6.2 Sort
Sort ('Expression‘, Descending=FALSE)
This function sorts all samples of a curve ('Expression') by their values in ascending
order from left to right.
Preference: Sorting in ascending order (descending=FALSE).
If the samples are to be sorted in descending order from left to right, "1" or "True()" has
to be entered as second operand.
Figure 197: Miscellaneous functions: Sort samples by ascending and descending order
5.7.1.2 Resample
Resample ('Expr', 'Timebasis')
This operation returns the signal curve of 'Expr' on a new time basis stated in seconds
as its result. The momentary values are transferred from the original curve temporally
correct in line with the new time basis, so that the length of the new curve is practically
the same. This enables the graphic smoothing of a curve if a larger time basis is used
in the resample function because fewer points are connected to each other. This does
not mean that average values are calculated!
The function can also be used for length-based signals. In this case, the value of a
distance must be entered in m rather than a time span.
In the next picture, the original measuring record that was recorded with a time basis of
20 ms was "resampled" with 100 ms in one case and with 1 s in another. The new
curves hence show only every fifth and every fiftieth, respectively, value of the original
curve.
5.7.2.1 Shl
Shl ('expression', 'distance')
This operation returns as its result a signal curve which is shifted by the amount of the
length 'distance' to the left on the X axis against the original signal. Otherwise, the
values measured remain unchanged. The function can be used for time-based signals
('distance' in seconds) as well as for length-based signals ('distance' in meters).
5.7.2.2 Shr
SHR (‘expression', ‘distance')
This operation returns as its result a signal curve which is shifted by the amount of the
length 'distance' to the left on the X axis against the original signal. Otherwise, the
values measured remain unchanged. The function can be used for time-based signals
('distance' in seconds) as well as for length-based signals ('distance' in meters).
5.7.3 Time
5.7.3.1 Time
Time ('Count', 'Timebasis)
This function returns as its result a linear, time-proportional signal with a number of
"Measuring points" at a distance between points (timebasis). The timebasis is stated in
seconds. The time values are entered both on the X axis and on the Y axis.
The time function was already used in many of the cases explained before, for
example, as the basis for creating a sine-shaped signal. It is not necessary to load a
data file as a precondition for using the time function.
In the upper part of the below picture, a time signal was generated which consists of
100 measuring points at a distance of one second, so that the time signal is 100
seconds long. The strip in the middle shows a signal which consists of 1000 points at a
distance of 100 ms and hence is also 100 s long. The signal in the lower strip is based
on the same number of points, however, half the time basis, so that the signal is now
only 50 seconds long.
In the "SignalName" column, you can enter any name (such as "t") for the signal, so
that it can be used in further expressions.
5.7.4.2 TimeToLengthL
TimeToLengthL ('Expression', 'Length, 'Precision'):
This function converts the time-related measuring value 'Expression' into a
length-related value, with a length measuring value 'Length' as the position [m].
The explanations given under TIMEtoLENGTH apply analogously, however, with the
only difference that a suitable length or position measuring value is used instead of the
speed.
The example in the above picture shows the recording of the width measurement in a
reversing mill. The five passes can be clearly seen. During every odd pass (1, 3, 5), i.e.
in the forward direction, a length measuring value (red curve) appears which matches
the width measurement. The width measurement during the 3rd pass was chosen for
conversion to length reference. In order to ensure that the calculation is correct, all the
values measured before and after the 3rd pass must be masked. The width and the
length measuring values were thus cut out using the XMarkValid function dependent on
the "Valid" signal (green) (refer to"XMark functions , Page 276"). Since length rather
than speed information is available, the TIMEtoLENGTHL function was used to convert
the width to length reference. The entry of a precision value was omitted. A look at the
X axis of the bottommost signal strip now clearly shows that the strip is around 18 m
long after the 3rd pass which, by the way, corresponds exactly to the highest Y value of
the length measuring value during the 3rd pass in the time-related presentation. Minor
deviations are due to interpolation.
5.8.2 XAlignFft
XAlignFft ('FixedExpr', 'AlignmentExpr', Start, End, MinScale,
MaxScale, ScaleStep, QualityParam)
With this function, length-based signals with the same physical significance which were
measured in different places in the process can be aligned to each other.
One example for this is the thickness-length-profile, which is recorded at the exit of a
hot strip mill, and the thickness-length-profile, which is measured at the entry of the
subsequent continuous pickling line.
When applying the function, different steps have to be taken into consideration that is
described in the following.
Preparation of the data for an alignment (example thickness measurement)
For an automatic alignment, both of the thickness measurements (e.g. exit hot rolling –
entry cold rolling or exit hot rolling – entry pickle, etc.) have to be length-related. To
transform a time-related thickness measurement to length reference, three signals are
required (see also "Conversion from time to length reference , Page 270"):
the time-related thickness measurement
[thickness_time]
a time-related speed signal describing the speed of the strip in the thickness gauge.
[speed_time]
a binary signal indicating whether a strip is present in a thickness measurement
[valid]
With these three signals, the transformation can be carried out with the TimeToLength
function of the ibaAnalyzer as follows:
[thickness_meter] = TimeToLength(XCutValid( [thickness_time], [valid]),
XCutValid([speed_time], [valid]))
If there still is an obvious Y offset due to outliers at the head or foot, both measurement
series can be adjusted for the mean value of their "fillet":
[Fillet] = XmarkRange([thickness_meter], [start_fillet], [end_fillet])
FixedExpr
The result of the alignment later refers to this thickness measurement. Thus, this
measurement has to be scaled and shifted with the result values.
Start
The interval from Start to End indicates the x-intercept where the measurement
'AlignmentExpression' can be moved. The zero here is the zero of 'FixedExpression'.
Also negative values are permitted. If, compared to "FixedExpression', the
measurement 'AlignmentExpression' is allowed to protrude 10 axis units on the
left-hand side in the ibaAnalyzer, the following must apply Start = -10 .
End
Specifies the end of the interval just described. It is recommended to select this end
dependent on the length of 'FixedExpression'. So, e.g. End =
XSize([FixedExpression]) or End = 1.2 * Xsize([FixedExpression])if an
surplus of 20 percent is allowed.
MinScale
By means of this parameter, the ratio between precision and speed can be controlled.
The smaller the value, the slower and more reliable the algorithm works. The higher the
value, the more the algorithm is accelerated by a heuristic. In case of too high values
for ScaleStep, this can lead to a wrong result. For an optimal result, it is
recommended to transfer the resolution of the measuring data. If, the samples have a
distance of 10 cm, for example, ScaleStep = 0.1 . If the calculation of results takes
too long, the value can be revised upwards.
A useful sample call could be the following:
XAlignFFT([thickness1],[thickness2],0,Xsize([thickness1]),0.7,1.3,0.01
)
[Scale] = GetRows([Alignment],0)
[Offset] = GetRows([Alignment],1)
[MSE] = GetRows([Alignment],2)
By means of the functions XY(…) and XValues(…), scaling and shifting can now be
applied to the alignment measurement.
XY( [align] , XValues( [align] ) * [Scale] + [Offset] )
5.8.3.1 XCutRange
XCutRange ('Expr', 'Start', 'End')
This function can be used to cut out a part of a curve. The function can be applied both
to time-related and to length-related signal strips. The 'Start' and 'End' parameters,
entered in [s] or [m], define the beginning and end of the segment to be cut out.
The segment cut out is placed at the beginning of a separate signal strip. However,
since the X axis (time or length) remains unchanged, the correct time or length
reference of the values measured is no longer given.
5.8.3.2 XCutValid
XCutValid ('Expr', 'Valid')
This function cuts out all the measuring points of a signal curve 'Expr' depending on a
'Valid' condition if this condition supplies the value TRUE. The function can be applied
both to time-related and to length-related signal strips. The 'Valid' parameter is a
Boolean expression. This can be a digital input signal, the result of a comparative
operation, or any other binary expression. Measuring points for which the condition is
FALSE are not taken over.
The parts cut out are placed, one after another, at the beginning of a new signal strip.
5.8.4.1 XMarkRange
XMarkRange ('Expr', 'Start', 'End')
This function can be used to cut out part of a curve in a manner similar to the
XCutRange function. The function can be applied both to time-related and to
length-related signal strips. The 'Start' and 'End' parameters, entered in [s] or [m],
define the beginning and end of the segment to be cut out. The part cut out is displayed
in a separate signal strip, however, it also continues to be displayed in the original
position on the time or position axis, whilst the measuring points outside the specified
range are discarded.
5.8.4.2 XMarkValid
XMarkValid ('Expr', 'Valid')
This function cuts out – in a manner similar to the XCutValid function - all the
measuring points of a signal curve 'Expr' depending on a 'Valid' condition if this
condition supplies the value TRUE. The function can be applied both to time-related
and to length-related signal strips. The 'Valid' parameter is a Boolean expression. This
can be a digital input signal, the result of a comparative operation, or any other binary
expression. Measuring points for which the condition is FALSE are discarded. The
parts cut out are displayed in a new signal strip, retaining their X positions.
Tip
The XMarkValid function is particularly suitable, for example, to highlight limit-value
violations by using different colors in a signal curve by showing the result signal in the
same strip and on the same Y axis as the original signal. By choosing different colors,
the limit-value violation ranges can be clearly identified.
Example: Values within the tolerance range = blue; values out of tolerance = red.
The above picture shows the different results of the mirroring operation, depending on
whether the segment to be mirrored was previously cut out using XMarkValid (red) or
XCutValid (green).
5.8.5.2 XStretch
XStretch ('Expr1', 'Expr2')
This function can be used to graphically stretch the curve of a signal to the same (final)
length of another signal. The function can be applied both to time-related and to
length-related signal strips.
In this way, it is, for example, possible to correlate measured values of a rolled strip
from the roughing mill to those from the finishing mill or to compare the individual
passes of a reversing mill to each other.
In the above picture, the roll force curve of the first pass (RF_pass_1_L, blue) is
stretched to the final length corresponding to the ninth pass (RF_pass_9_L).
#
Figure 209: Roll force comparison for ten passes
The above picture shows the recording of the roll force over 10 passes. Besides the roll
force, the pass number and a digital signal (gauge closed) were recorded, too. In the
example given here, only passes 1, 2, 3, 4 and 10 are shown for reasons of space. The
analogous procedure is applied to the remaining passes. In order to enable a better
comparison of the roll force curves of the individual passes, they must be cut out
individually from the original signal (XCutValid). The logical condition for the XCutValid
function consists of a logical function whose result is TRUE if the pass number is equal
to the desired pass number AND if the roll gap is closed at the same time. Following
this, every pass with an even number (2, 4, 6, 8 and 10) must be subsequently
mirrored because rolling took place in the reverse direction during these passes, so
that the strip was rolled from the tail to the head end.
If you then shift the corresponding signals into a common signal strip and if you define
different colors for the different signals, you can already make first comparisons.
However, all that can be compared is the roll force curve in relation to the time. A
correlation with the strip length cannot be derived from this. (see next picture)
The comparison of the length-related roll force curves is more telling because this
comparison correlates the roll force and the pertinent position on the strip (strip length).
Before conversion from time to length reference is possible, the pertinent speed
measurement for each roll force measurement must first be cut out in the same manner
using XCutValid. You must, however, use the absolute speed value because the
reversing process means that negative speed values are also available.
Note
If the time-related roll force curves for the even passes were already mirrored
beforehand, the corresponding speed curves must now be mirrored too in order to
ensure that the measured roll force values are correctly mapped over the strip length.
You can avoid this additional mirroring by first converting all signals from time to length
reference before you subsequently mirror the even passes.
You can now use the TIMEtoLENGTH function in order to convert the roll force curves from time
reference to length reference (cf. Conversion from time to length reference , Page 270 ).
The above picture shows that the strip has become more than 4500 m long after the
last pass. However, comparisons of the curves are still relatively difficult. It is hence
even more interesting to have the roll force curves of all the passes displayed with the
highest resolution possible from the head to the tail end of the strip. This is what the
XStretch function is designed for. You can use this function in order to stretch the
curves of the first passes, during which the strip was still much shorter, to the final
length of the last pass.
If you then use the marker presentation, you can see which measuring value from the
first pass corresponds to which point in the finished strip. In this way, you can, for
example, decide whether production defects existed from the beginning or whether
they occurred during a subsequent pass.
Figure 213: Roll force comparison, length-related, passes 1, 2, 3 and 4, stretched to the length of pass 10
5.8.5.3 XStretchScale
XStretchScale (‘Expression’, Scale)
With this function, the curve of a signal can be stretched by a specified factor. The
scaling factor is also used if the curve is already provided with an offset.
5.8.6.2 XLast
XLast ('Expression')
This function returns as its result a value on the X axis (time [s] or position [m]) for
which "Logical expression' is for the last time TRUE. This means that 'Logical
expression' must be a Boolean quantity. This can be a digital input signal, the result of
a comparative operation, or any other binary expression.
In the next picture, the time is determined where the measuring value "116 Thickn. dev.
beh. F7" reaches its minimum value for the first time (red, after around 0.86 s) and
when it has its maximum value for the last time (green, after around 3.94 s).
Since this presentation is not very telling, you may want to combine the XFirst and
XLast functions with the XMarkValid function, for example, in order to color the range
between the corresponding points of the curve.
5.8.7.2 XSumValid
XSumValid (‘expr')
This function can be used to determine the duration or length for which the condition
‘expr' is TRUE. Any measuring points for which the condition is not true (FALSE) are
disregarded in the calculation. This means that ‘expr' must be a Boolean quantity. This
can be a digital input signal, the result of a comparative operation, or any other binary
expression.
The result is at a constant value of 0 if the input signal is invalid.
In this way, it is, for example, possible to determine the time during which a drive was
switched on by recording the ON signal in a time-based manner. It is easily possible to
determine the offsize length of a coil if the measured thickness values were presented
in a length-related manner beforehand and if expr1 supplies the comparison between
measured thickness value and thickness limit value.
The previous picture shows the example of recording the thickness deviation (gray
curve). This signal is to be analyzed during the last 20 seconds only. This range is
determined using the XSize function, and is presented using the XMarkRange function
(blue). Finally, the duration – i.e. the sum of all periods – during which the signal
exceeds the tolerance limit of 2 µm during these last 20 seconds is to be determined.
This is what the XSumValid function is used for. The result shows that the signal has
deviated from the tolerance for 7.46 seconds, although with interruptions.
5.8.7.3 XValues,
XValues (‘expression')
This function returns the X values for every sample of an expression as its result. It is
basically equivalent to the “Time” function. What makes this function special is that it
will also work on signals or expressions which are not time-based, i.e. length-based
(m), frequency-based (Hz) or inverse length-based (1/m).
With a usual time- or length continuous signal it will return a rising straight line as
result, writing the time or length values along the Y-axis in base units (s, m).
The function also works with non-equidistant measuring values.
A special application of this function is the differentiation and integration in the
frequency range:
FFT(Dif([Expr])) := FFT([Expr]) * xvalues[Expr] * 2 * PI()
FFT(Int([Expr])) := FFT([Expr]) /( xvalues[Expr] * 2 * PI())
5.8.8 VarDelay
VarDelay ('Expression', 'Delay')
This operation returns the 'Expression' delayed by a time constant as its result. This
operation is also available in ibaPDA-V6 version 6.13 and higher.
5.8.9 XY
XY ('Expression1', 'Expression2', Precision(optional))
This function is used if the result from the X-Y representation is to be used for further
operations (X-Y representation see "X - Y , Page 154").
After the selection, the signals of the X and Y axis are assigned to the function.
Please note that in the resulting function, the distances between the signal points are
not the same as the distances of the original signals. Also the distance between the
signal points is different. By means of the 'Precision' parameter, a fixed distance
between the signal points can be determined. If no parameter is entered, the shortest
distance of the signal points is used as fixed value for all subsequent operations.
5.8.11.2 XOffset
XOffset ('Expression‘)
This function provides the interval of the first sample of a signal from the beginning of
the data file in seconds.
The result is negative if the signal starts earlier and positive if it starts later.
If several data files are opened at the same time and the "Synchronize data files with
recording time" option is enabled, the offset is necessarily not determined with
reference to the start of the data file of the selected signal, but to the start of the data
file having the earliest starting time.
The only parameter of the function is the signal (expression).
Possible reasons for occurring offsets are as follows:
Several data files are opened at the same time and the "Synchronize data files
with recording time" option is activated.
In the "xoffset" info field of a signal, an offset ≠ 0 is specified.
SHL or SHR functions were used (see example below)
5.9.2 GetRows
GetRows ('Expression', 'From, 'Cells', 'Step')
This function extracts rows of values from an array. Arrays are multi-dimensional
signals consisting of a number of individual signals in order to, e.g., enable 3D profile
presentations (thickness or temperature profiles). Usually, they are generated by
means of the logical signal definitions or from the individual results of a macro.
Expression is the array which contains the signals to be extracted.
From is the index of the signal contained in the array which should be extracted first.
The minimum index is 0.
Number is the number of signals to be extracted starting from the index “From”.
The function parameter Step is the interval in which the individual signals are to be
extracted starting from the index "From"
The following example shows the result for the function:
Application: analysis of specific value rows or masking of value rows which are not
relevant for analysis, e. g. margins, to improve clarity.
5.9.3 GetZoneCenters
GetZoneCenters (vector)
This function determines the position of the center of the zone on the Y axis for each
zone of the vector. The only argument of the function is the vector. The result again is a
vector with a number of values in accordance with the number of zones. The below
picture shows in the 2nd line the function with the vector of example 1 in chapter Zone
control with vector signals , Page 178.
5.9.4 GetZoneOffset
GetZoneOffset (vector)
This function determines the offset of the first zone, i. e. the position of the center of the
zone of the first zone, based on the zero line of the Y axis. The only argument of the
function is the vector. The result is a constant value. The above picture (chapter 5.9.3)
shows in the 3rd line the function with the vector of example 1 in chapter 4.6.2.4.
294 Issue 6.3
ibaAnalyzer Manual
5.9.5 GetZoneWidths
GetZoneWidths (vector)
This function determines the width of each zone of the vector in units of the Y axis. The
only argument of the function is the vector. The result again is a vector with a number
of values in accordance with the number of zones. The above picture (chapter 5.9.3)
shows in the 4th line the function with the vector of example 1 in chapter 4.6.2.4.
Note: only 3 lines (2, 4, 10) can be seen, as the zone widths 2 and 4 occur twice.
5.9.6 MakeVector
MakeVector (r0,r1,....rn)
This function creates a vector with the value rows r0 to rn. The arguments r0 to rn can
be constant values or signals and expressions, respectively. This is comparable with
the generation of a vector in the Logical signal definitions dialog.
The MakeVector function was mainly developed to enable macros to return
multi-dimensional signals as their results. In the macro editor, the partial results of
different calculations can be declared as interim values within the macro. As final macro
result, a vector can be defined whose arguments are the interim values.
The vector is basically used as container for macro results to simplify the macro
interface.
MakeVector ([res1],[res2],...), with [res1],[res2],... as interim
values
The macro then returns a vector as its result which contains several results. The
individual partial results can be determined by the result vector using the GetRows
function.
This example shows the modified macro for the hysteresis calculation from chapter
5.16.2.1:
The following picture shows the application of the "hysteresis" macro and the
breakdown of the macro result.
Figure 229: Breakdown of the result vector of a macro into partial results
5.9.7 SetZoneWidths
SetZoneWidths (vector, widths, offset)
This function creates a vector with specified zone widths. In doing so, the values of the
result vector are taken from a vector ('vector') and the zone widths from another vector
('widths'). Since the vector with the zone widths can use expressions as arguments,
this function can be used to generate vectors with different zone widths depending on
the loaded data. The expressions for defining the zone widths should be constant over
time and not change for data loaded once. If this is not the case, the width values will
be averaged over the overall period.
Parameter:
Vector: vector with the (measured) values of the result vector
Widths: vector containing the zone widths as values which the result vector has to
receive
Offset: Offset, i. e. the distance of the zone center of the first zone from the zero
line of the Y axis. This parameter is optional. If it is not specified, the offset of the
'Vector' input vector applies.
Example
The function
SetZoneWidths (MakeVector(1,2,3,2,1), MakeVector(2,4,10,4,2), -10)
generates the same vector as the one generated with the logical signal definitions in
chapter Zone control with vector signals , Page 178.
5.9.8 VectorAvg
VectorAvg (Vector)
This function calculates the average of the cross profile for each sample, i. e. the
average of all vector tracks per point in time or per X axis position, respectively. The
only argument of the function is the vector. The function returns a one-dimensional
signal as its result showing the curve of the cross profile average value over the
time/length of the vector signal with the same number of samples.
5.9.9 VectorKurtosis
VectorKurtosis (Vector)
This function calculates the kurtosis of the cross profile for each sample. The only
argument of the function is the vector. The function returns a one-dimensional signal as
its result showing the curve of the cross profile kurtosis over the time/length of the
vector signal with the same number of samples.
5.9.10 VectorMarkRange
VectorMarkRange (Vector, PositionFrom, PositionTo)
This function returns a partial vector of a vector with a zone width from 'PositionFrom'
(lower edge) to 'PositionTo' (upper edge) as its result.
The positions must be indicated in units of the Y axis. The positions can be both fixed
values and signals or expressions and thus be dependent on the data loaded.
The expressions for defining the positions should be constant over time and not
change for data loaded once. If this is not the case, the position values will be
averaged over the overall period.
This allows for enlarging sections of interest or for hiding areas which are not
interesting or invalid.
5.9.11 VectorMax
VectorMax (Vector)
This function calculates the maximum of the cross profile for each sample, i. e. the
maximum value of all vector tracks per point in time or per X axis position, respectively.
The only argument of the function is the vector. The function returns a one-dimensional
signal as its result showing the curve of the cross profile maximum over the time/length
of the vector signal with the same number of samples.
5.9.12 VectorMin
VectorMin (Vector)
This function calculates the minimum of the cross profile for each sample, i. e. the
minimum value of all vector tracks per point in time or per X axis position, respectively.
The only argument of the function is the vector. The function returns a one-dimensional
signal as its result showing the curve of the cross profile minimum over the time/length
of the vector signal with the same number of samples.
5.9.13 VectorPercentile
VectorPerzentile (Vector, Percentile)
This function calculates the percentile of the cross profile for each sample.
The second argument in addition to the vector is the specification of the percentile to
be calculated. Default value is 0.5 (median). This value is also set if no percentile
argument is specified. The function returns a one-dimensional signal as its result
showing the curve of the cross profile percentile over the time/length of the vector
signal with the same number of samples.
The following picture shows the application of the VectorPercentile function to the
"Profile" vector. At the marker position (at 40 s), the result for the 80 % percentile (0.8)
of all values of the cross profile is 2281.6. This means that 80 % of the cross profile
values are smaller than 2281.6.
5.9.14 VectorSkewness
VectorSkewness (Vector)
This function calculates the skewness of the cross profile for each sample. The only
argument of the function is the vector. The function returns a one-dimensional signal as
its result showing the curve of the cross profile skewness over the time/length of the
vector signal with the same number of samples.
5.9.15 VectorStdDev
VectorStdDev (Vector)
This function calculates the standard deviation of the cross profile for each sample. The
only argument of the function is the vector. The function returns a one-dimensional
signal as its result showing the curve of the cross profile standard deviation over the
time/length of the vector signal with the same number of samples.
5.9.16 VectorSum
VectorSum (Vector)
This function calculates the sum of all values of the cross profile for each signal. The
only argument of the function is the vector. The function returns a one-dimensional
signal as its result showing the curve of the value sum in the cross profile over the
time/length of the vector signal with the same number of signals.
If you divide the VectorSum expression by the number of vector tracks, the result is the
same as with the VectorAvg function.
Example
In the following example, a vector consists of 3 sine signals. The VectorSum function
returns the same result as adding the 3 individual signals.
5.9.17 VectorToSignal
VectorToSignal (Vector, XBase)
This function generates a one-dimensional signal from the elements of a vector along
the cross profile. Every sample of the resulting signal corresponds to an element of the
vector. The result basically complies with the cross profile.
The function was changed with ibaAnalyzer version 6.4.0.
Up to version 6.4.0, the vector elements had to be constant over time and not change
for data loaded once. In case of changing values, the vector values were averaged
over the overall period. The XBase parameter had to be specified to be able to display
the result signal on a time or length axis.
Parameter:
Vector: the vector from which the samples are to be taken.
XBase: time base of the result signal; the samples of the result signal are
displayed on the X axis in this distance.
Usually, the function was developed to provide the tables in the report generator with
values.
From version 6.4.0, this function has been extended for better cross profile
representation.
The XBase parameter is optional. If XBase is not indicated, the zone widths and the
offset of the vector are used. The resulting signal can also receive non-equidistant
samples.
Issue 6.3 301
Manual ibaAnalyzer
Example
In connection with the YatX functions and the marker position, the VectorToSignal
function can be used to display the cross profile at any position in the vector.
VectorToSignal (YatX([Vector],XMarker1()))
Figure 234: Using the VectorToSignal function for cross profile representation
1 N 2
E eff = ∑ e (n )
N n =1
5.10.2.1 DeltaCollectiveUeff
DeltaCollectiveUeff ('u12', 'u13', 'u23', 'freq')
This function calculates the collective effective voltage in a delta grid. It uses the
following formula:
1 2
U eff = ( U 12,eff + U 223,eff + U 31
2
,eff )
3
5.10.2.2 DeltaCollectiveIeff
DeltaCollectiveIeff ('i1', 'i2', 'i3', 'freq')
This function calculates the collective effective current in a delta grid. It uses the
following formula:
3
I eff = ∑I
x =1
2
x ,eff
5.10.2.3 DeltaActiveP
DeltaActiveP ('u13', 'u23', 'i1', 'i2', 'freq')
This function calculates the active power in a delta grid. It uses the following formula:
1 N
P= ∑ [u 23 (n )i 2 (n ) + u 13 (n )i1 (n )]
N n =1
5.10.2.4 DeltaApparentP
DeltaApparentP ('u12', 'u13', 'u23', 'i1', 'i2', 'i3', 'freq')
This function calculates the apparent power in a delta grid. It uses the following
formula:
S = U eff I eff
5.10.2.5 DeltaReactiveP
DeltaReactiveP ('u12', 'u13', 'u23', 'i1', 'i2', 'i3', 'freq')
This function calculates the reactive power in a delta grid. It uses the following formula:
Q = S2 − P 2
S : apparent power
P : active power
5.10.2.6 DeltaReactivePS
DeltaReactivePS ('u12', 'u13', 'u23', 'i1', 'i2', 'i3', 'freq')
This function calculates the signed reactive power QS in the delta grid. While the
previous function (‘DeltaReactiveP’) is always positive, this function might also return
negative values. The values are calculated by temporarily shifting the voltages one
quarter of a period in phase with the currents and then calculating the active power in
the delta grid.
5.10.2.7 DeltaActivePFactor
DeltaActivePFactor ('u12', 'u13', 'u23', 'i1', 'i2', 'i3', 'freq')
This function calculates the active power factor in a delta grid. It uses the following
formula:
P
cos ϕ =
S
S : apparent power
P : active power
5.10.2.8 DeltaReactivePFactor
DeltaReactivePFactor ('u12', 'u13', 'u23','i1', 'i2', 'i3', 'freq')
This function calculates the reactive power factor in a delta grid. It uses the following
formula:
Q
tan ϕ =
P
Q : reactive power
P : active power
5.10.2.9 DeltaReactivePFactorS
DeltaReactivePFactorS ('u12', 'u13', 'u23','i1', 'i2', 'i3',
'freq')
This function calculates the signed reactive power factor in a delta grid. It uses the
following formula:
QS
tanϕ =
P
The star functions use the phase voltages and phase currents to calculate the different
power values. These functions are typically applied to a star network but they can be
applied to any network where the phase voltages and currents are measurable.
5.10.3.1 StarCollectiveUeff
StarCollectiveUeff ('u1', 'u2', 'u3', 'freq')
This function calculates the collective effective voltage in a star net. It uses the
following formula:
4
U eff = ∑U
x =1
2
x _ eff
5.10.3.2 StarCollectiveIeff
StarCollectiveIeff ('i1', 'i2', 'i3', 'i4', 'freq')
This function calculates the collective effective current in a star net. It uses the following
formula:
4
I eff = ∑I
x =1
2
x ,eff
5.10.3.3 StarActiveP
StarActiveP ('u1', 'u2', 'u3', 'i1', 'i2', 'i3', 'freq')
This function calculates the active power in a star net. It uses the following formula:
3
1 N
P = ∑ ∑ u x (n )i x (n )
x =1 N n =1
5.10.3.4 StarApparentP
StarApparentP ('u1', 'u2', 'u3', 'i1', 'i2', 'i3', 'i4', 'freq')
This function calculates the apparent power in a star net. It uses the following formula:
S = U eff I eff
5.10.3.5 StarReactiveP
StarReactiveP ('u1', 'u2', 'u3', 'i1', 'i2', 'i3', 'i4', 'freq')
This function calculates the reactive power in a star net. It uses the following formula:
Q = S2 − P 2
S : apparent power
P : active power
5.10.3.6 StarReactivePS
StarReactivePS ('u1', 'u2', 'u3', 'i1', 'i2', 'i3', 'i4', 'freq')
This function calculates the signed reactive power QS in the star net. While the previous
function (‘StarReactiveP’) is always positive, this function might also return negative
values. The values are calculated by temporarily shifting the voltages one quarter of a
period in phase with the currents and then calculating the active power in the star net.
5.10.3.7 StarActivePFactor
StarActivePFactor ('u1', 'u2', 'u3', 'i1', 'i2', 'i3', 'i4', 'freq')
This function calculates the active power factor in a star net. It uses the following
formula:
P
cos ϕ =
S
S : apparent power
P : active power
5.10.3.8 StarReactivePFactor
StarReactivePFactor ('u1', 'u2','u3', 'i1', 'i2', 'i3', 'i4',
'freq')
This function calculates the reactive power factor in a star net. It uses the following
formula:
Q
tan ϕ =
P
Q : reactive power
P : active power
5.10.3.9 StarReactivePFactorS
StarReactivePFactorS ('u1', 'u2', 'u3','i1', 'i2', 'i3', 'i4',
'freq')
This function calculates the signed reactive power factor in a star net. It uses the
following formula:
QS
tanϕ =
P
5.10.4.2 HarmPhase
HarmPhase ('u', 'Nharm', 'freq')
This function calculates the phase of 'NHarm' harmonic component of signal ‘u’. It uses
the following formula:
u Im ag ,k
ϕ k = −a tan
u
Re al,k
th
uReal,k : the real part of the k harmonic component of u
th
uImag,k : the imaginary part of the k harmonic component of u
th
ϕk : the phase of the k harmonic component of u
5.10.4.3 StarHarmUGeff
StarHarmUGeff ('u1', 'u2', 'u3', 'freq')
This function calculates the actual negative sequence voltage UGeff. (amount of the
negative sequence indicator). It uses the following formula:
1 2 4
UG = u 1,1 + u 2,1 (− π ) + u 3,1 (− π )
3 3 3
U G2 ,real + U G2 ,imag
U Geff =
2
5.10.4.4 StarHarmUMeff
StarHarmUMeff ('u1', 'u2', 'u3', 'freq')
This function calculates the positive sequence system voltage UMeff (amount of the
positive sequence indicator). It uses the following formula:
1 2 4
UM = u 1,1 + u 2,1 ( π ) + u 3,1 ( π )
3 3 3
U 2M ,real + U 2M ,imag
U Meff =
2
5.10.4.5 StarHarmUnSym
StarHarmUnSym ('u1', 'u2', 'u3', 'freq')
This function calculates the voltage asymmetry in a star net. The result is expressed in
%. It uses the following formula:
U Geff
SYM = × 100
U Meff
5.10.4.6 WeightedDistortionFactor
WeightedDistortionFactor ('u', 'Nharm', 'freq')
This function calculates the weighted distortion factor of 'u' (all phases) using 'Nharm'
harmonics. NHarm is 50 by default. It uses the following formula:
Nharm
∑n
n =2
2
U 2n
DW =
U1
5.10.4.7 UnweightedDistortionFactor
UnweightedDistortionFactor ('u', 'Nharm', 'freq')
This function calculates the unweighted distortion factor of 'u' (all phases) using
'Nharm' harmonics. 'Nharm' is 50 by default. It uses the following formula:
Nharm
∑U
n =2
2
n
D UW =
Nharm
∑U
n =1
2
n
5.10.4.8 TIF
TIF ('u', 'Nharm', 'freq')
The function calculates the Telephone Interference Factor of 'u', considering the first
'nHarm' harmonics. 'NHarm' is 50 by default. It uses the following formula:
Nharm
∑ (K × Pn × U n )
1
TIF =
2
n
U1 n =2
Kn = 5*n*freq
Pn = BTS coefficient (British Telephone System)
Un : effective value of the nth harmonic component of signal u
U1 : Effective value of the voltage of the fundamental of u
5.10.5 Examples
5.10.5.1 Dreieck
This paragraph gives an example of the power functions applied to a delta net. The
example can be found in Electric_Power_Delta.pdo.
The line currents can be calculated from the phase currents by using Kirchoff’s current
law in the three nodes. The following vector diagram illustrates these calculations.
Note the extra phase shift of 30° between the line currents and the line voltages. The
following table contains the calculated and the theoretical result of all ibaAnalyzer
electric functions applied to this delta net. The delta power functions use the line
currents and voltages.
Q DeltaReactiveP ([u12], -[u31], [u23], [i1], [i2], [i3], 50) calculated : 54.0479
3 ⋅ U 12,eff I1,eff sin ϕ = 54.0479
theoretical :
S DeltaApparentP ([u12], [u23], [u31], [i1], [i2], [i3], 50) calculated : 311.250
3 ⋅ U 12,eff I1,eff = 311.250
theoretical :
cos ϕ DeltaActivePFactor ([u12], -[u31], [u23], [i1], [i2], [i3], 50) calculated : 0.9848
theoretical : cos ϕ = 0.9848
5.10.5.2 Star
This paragraph gives an example of the power functions applied to a star net. The
example can be found in Electric_Power_Star.pdo.
The line voltages can be calculated from the phase voltages. The following vector
diagram illustrates these calculations.
Remark the extra phase shift of 30° between the line currents and the line voltages.
The following table contains the calculated and the theoretical result of all ibaAnalyzer
electric functions applied to this star net. The star power functions use the phase
currents and phase voltages.
P StarActiveP ([u1], [u2], [u3], [i1], [i2], [i3], 50) calculated : 306.5214
3 ⋅ U 1,eff I1,eff cos ϕ = 306.5214
theoretical :
Q StarReactiveP ([u1], [u2], [u3], [i1], [i2], [i3],0, 50) calculated : 54.0479
3 ⋅ U 1,eff I1,eff sin ϕ = 54.0479
theoretical :
S StarApparentP ([u1], [u2], [u3], [i1], [i2], [i3],0, 50) calculated : 311.250
3 ⋅ U 1,eff I1,eff = 311.250
theoretical :
cos ϕ StarActivePFactor ([u1], [u2], [u3], [i1], [i2], [i3], 0, 50) calculated : 0.9848
theoretical : cos ϕ = 0.9848
tan ϕ StarReactivePFactor ([u1], [u2],[u3], [i1], [i2], [i3], 0, 50) calculated : 0.1763
theoretical : tan ϕ = 0.1763
Remark:
You can get the same results by using the delta functions with the line voltages u12,
u23, u31 and line currents i1, i2, i3.
Figure 235: Function COUNT, principle of operation and effect of edge types
Tip
The COUNT function can also be used for binary signals. For this purpose, choose
0.5 for Level and, for example, 0.1 for Hysteresis. This then means that all changes
from FALSE (0) to True (1) and vice versa will be detected and counted.
5.11.2 Debounce
Debounce ('Expr', 'Debounce interval)
This function returns as its result a debounced signal curve of 'Expr' with 'Debounce
interval' as dead range given in seconds (time-based) or meters (length-based).
The function works in a manner similar to an OFF-delay time relay, however, with the
difference that the signal change from TRUE to FALSE (falling edge) is presented in
realtime, i.e. without delay, unless another change from FALSE to TRUE (rising edge)
occurs during the time set.
In this way, it is possible to smooth unsteady signals, for example, from photocells or
limit switches. This is particularly important if these signals are used as conditions in
certain operations, such as XMarkValid or XCutValid, because every discontinuity
would interrupt the calculation of the operation, so that result values would be lost. The
difference can be clearly seen in the following picture.
5.11.3 Envelope
Envelope (Expression, X axis interval)
This function calculates the upper envelope of a signal or expression. The envelope is
constructed by linking the high peaks of the signal curve. The quality of the envelope
can be adjusted by parameter “X axis interval”. Without this parameter, only the
maximum peak will be taken into account over the entire recording length of the signal.
The parameter “X axis interval” specifies the length of an interval in base units of X axis
(s, m, Hz, 1/m). By using this parameter the peaks inside the interval will be taken into
account too and the envelope nestles against the signal curve.
In order to get an envelope along the lower side of the signal curve, you can enter the
same function as follows -Envelope (-Expression, X axis interval) . In this case the low
peaks (minimum values) will be linked.
5.11.5 GetBit
GetBit ('Expr', 'Bit no')
This function returns as its result the Boolean value of the bit 'Bit no' of 'Expr' after
rounding of 'Expr' to the next integer value. The rounding limit is in each case the next
0.5 increment. (2.48 --> 2; 2.50 -->3). Valid bit number sequence: 0 (LSB) to 15 (MSB)
or 0 (LSB) to 31 (MSB), respectively.
The function does not apply to integers with 64 bits because these data types are not
supported by ibaPDA and thus cannot be included in a data file.
In the table below, the least significant byte of an integer value with the bits 0...7 is
shown as an example. In order to represent the values 0...8, the individual bits are
highlighted red. (red = TRUE)
Bit no 7 6 5 4 3 2 1 0
0
1
2
3
4
5
6
7
8
Table 5 Example for bit signs
The next picture shows the same case with the Getbit function (turned by 90°). Using
the TIME function, a linearly increasing signal from 0 to 8 was generated. Since the
straight line consists of 800 points, there are a lot of Y values besides the integer
values 0, 1, 2, 3,...8. The Getbit function takes every measuring point and rounds its Y
value up or down. This means, for example, that all values smaller than 0.5 are
interpreted as 0, whilst all values greater than or equal to 0.5 and smaller than 1.5 are
interpreted as 1. The significance of the bit specified by 'Bit no' is determined and
represented for the integer value calculated.
One possible application is, for example, the evaluation of status words or packed
control bits.
Tip
If one or more 8-, 16- or 32-bit integers should be reduced to single bits you can ease
your work. Just make a right mouse click on the desired signal in the signal tree and
select “Show bits” in the context menu. All 8, 16 or 32 bits of the signal will be
displayed immediately as separate digital signals in new signal strips. The internal
method of this function is the same like for GetBit.
5.11.6 GetBitMask
GetBitMask ('input', 'bit no')
This function interprets 'input' as a bit mask of a float value and returns as its result the
value of the bit 'bit no'. Valid range: 0 (LSB) to 31 (MSB)
This function was specifically developed for work with data from SimadynD in one
particular case where up to 32 digital values are recorded in packed format as a float
variable. The GetBitMask function only evaluates the valence of the specified bit 'bit no'
irrespective of whether it is part of the mantissa or of the exponent. In contrast to the
GetBit function, there is no rounding to the next integer.
In order to better understand the way this function works, you should first use simple
values and change the value display on the "Markers" tab to hexadecimal code.
Tip
If one or more 32 bit floating values should be reduced to single bits you can ease
your work. Just make a right mouse click on the desired signal in the signal tree and
select “Show bits” in the context menu. All 32 bits of the signal will be displayed
immediately as separate digital signals in new signal strip. The internal method of this
function is the same like for GetBitMask.
5.11.7 HighPrecision
HighPrecision (expression)
With this function, 'expression' is marked as quantity with double precision.
Calculations which are then performed with 'expression' are implemented with double
precision, even if the original expression only has single precision.
From version 5.21.0, ibaAnalyzer can perform calculations both with single precision
(32 bit) and double precision (double precision, 64 bit).
Double precision, on the one hand, has the advantage that calculations can be
performed more precisely, on the other hand, however, it also has the disadvantage
that it requires twice as much storage capacity. Therefore, ibaAnalyzer automatically
decides based on the input arguments which precision to be used for a calculation.
If a signal is available as 16Bit integer or 32Bit floating point value in the data file,
ibaAnalyzer works with single precision.
If a signal is available as 32Bit integer or 64Bit floating point value in the data file,
ibaAnalyzer works with double precision.
With the "HighPrecision" function, you can force ibaAnalyzer to perform calculations
with double precision, irrespective of the precision of the input arguments.
With regard to storage capacity, ibaAnalyzer is optimized in such a way that no 64Bit
copy of the argument is generated, but it is only noted that the calculations are to be
performed with double precision. The results of a calculation with double precision are
saved as 64Bit values.
5.11.8 InfoField
Info field ('FileIndex', "'Info field'", 'Start', 'End')
This operation gets the string from any info field of a data file and supplies it for display
purposes. Sole restraint: it must be a numerical string!
Parameter:
FileIndex refers to an ongoing numbering (top-down) of loaded data files, from 0
to n. If only one data file is open, use 0 for ‘Fileindex’.
"Info field": name of the info field to be read. Use quotation marks!
Start: first character of the field content to be read. Minimum value for start is 0
(=default). This parameter is optional. If no "Start" value is defined, the complete
content is read.
End: last character of the field content to be read. This parameter is optional. If
no "End" value is defined, it will be read from the start to the last character (end
of text = default).
324 Issue 6.3
ibaAnalyzer Manual
The following example shows how to derive day, month and year from the starttime info
field.
Figure 240: Presentation of data files start date (day, month, year), derived from the INFOFIELD function
Tip
If you double-click on the desired info field, ibaAnalyzer automatically inserts the
corresponding function as new signal into the signal table. If required, you then only
have to adjust the signal name and beginning/end. This method also works in the input
box of the expression builder. The function will then be inserted at the cursor position.
If you want to read out the content of an info field as text channel, use the
ChannelInfofieldText function.
5.11.9 ChannelInfoField
ChannelInfoField (channel, "Info field", start, end)
This function works like the "InfoField" function, however, it refers to the info fields of a
signal (channel) and not the data file. If only one data file is opened, the function
returns a constant numerical value as its result which is read out from the specified info
field. If several files are appended to each other, the value changes at every file
boundary according to the field content.
Parameter:
Channel: the signal from which the info field is to be read out
"Info field": name of the info field to be read. Use quotation marks!
Start: first character of the field content to be read. Minimum value for start is 0
(=default). This parameter is optional. If no "Start" value is defined, the complete
content is read.
End: last character of the field content to be read. This parameter is optional. If
no "End" value is defined, it will be read from the start to the last character (end
of text = default).
Tip
If you double-click on the desired info field, ibaAnalyzer automatically inserts the
corresponding function as new signal into the signal table. If required, you then only
have to adjust the signal name and beginning/end. This method also works in the input
box of the expression builder. The function will then be inserted at the cursor position.
If you want to read out the content of an info field as text channel, use the
ChannelInfofieldText function.
5.11.10 LimitAlarm
LimitAlarm (Expression, Limit, Deadband, Time)
The function returns the result TRUE (logical 1) when „Expression“ exceeds „Limit“ for
more than „Time“ seconds at least. The function returns the result FALSE (logical 0)
again when “Expression” is lower than (“Limit” – “Deadband”).
5.11.11 ManY
ManY ('Xbase','y0','y1',....)
This function can be used in order to manually generate a signal curve with the
"measured values" of 'y0'....'y99', each at a time or position distance of 'Xbase' apart.
The 'Xbase' value is expressed in [s] for time-related values and in [m] for
position-related values. The number of points is limited to 100.
In this way, it is, for example, possible to enter reference curves to which the signals
measured in the field are then compared. Furthermore, it is also possible to add data
which is not available as a measuring value to an analysis.
Using this function, text channels can also be manually generated entering different
values.
If you put the parameters y0 to y99 (max.) in brackets, the entered characters are not
taken over as numerical values but as ASCII characters.
In the picture below, a curve Signal_ManY with 26 values with an XBase of 1 s has
been generated (blue) as an example. Additionally, a text channel Textkanal_ManY
with three different texts at a distance of 10 s was defined.
Tip
Depending on whether a time-based or a length-based signal is to be generated, the
appropriate strip mode (Time-Y or Length-Y) must be set prior to entering the
function. Subsequent switching after the function has been entered is not possible.
This means: First execute the "Add signal" function in the "Signal definitions" table,
then switch the strip mode to "Length", if necessary, and finally enter the function and
the values.
5.11.12 RAND
Rand ('Count', 'Unit')
This function generates a signal consisting of random numbers within the range of 0 to
32767 for the 'Count' of points in the 'Unit' [s] (time-based) or [m] (length-based). The
next picture shows three signals which are all 100 seconds long, but which consist of
different numbers of points. The time basis 'Unit' is 1 s, 100 ms and 10 ms.
5.11.13 Sign
Sign ('Expr')
This function returns the sign of 'Expr' as its result.
'Expr' > 0 --> +1
'Expr' = 0 --> 0
'Expr' < 0 --> -1
5.11.14 Technostring
Technostring ('Fileindex', Begin', 'End')
This function extracts the string from 'Fileindex'(0..n) between 'Begin‘ and 'End'. The
standard start index is = 0. This means that it is possible to interpret information from
the technostring as signals (numerical characters only).
The technostring information displayed in the "Info" branch in the signal tree window is
evaluated. This is, however, subject to the condition that the technostring information
was saved by ibaPDA in the data file.
'Begin' and 'End' correspond to the position of the characters in the technostring which
limit the range of interest which is to be evaluated as a signal. Only numerical
characters can be evaluated. Leading zeros are ignored.
The 'DataFileIndex' only has to be entered if several data files are open at the same
time. The file in the topmost position in the signal tree window has the index 0. All the
other files, from top to bottom, then have the index 1, 2, and so forth. The index must
always be 0 if only one file is open.
The above picture shows an example with three data files from a finishing mill. All the
three files contain technostring information with the coil number. As a precondition for
the coil numbers from all the three files to be displayed, the TECHNOSTRING function
must be executed with a different 'DataFileIndex' in each case. In this example, only
the coil number is contained in the technostring, i.e. from position 0 to 5 (= six
characters). However, the technostring can also contain a lot more information, so that
it is also possible that multiple values can be read from a technostring with a repeated
application of the function. It is, for example, possible to extract primary data, setpoints
or customer data from the technostring and to use this information in the analysis and
in the report generator.
5.11.15 WindowAlarm
WindowAlarm (Expressions, Limit1, Deadband, Limit2, Deadband2,
Time)
The function returns the result True (logical 1) if 'Expression' is out of range ['Limit2',
'Limit1'] for at least 'Time' seconds.
The function returns the result False (logical 0) again if 'Expression' enters the range
['Limit2' + 'Deadband2','Limit1' - 'Deadband1'].
5.11.16 YatX
YatX (‘expr', ‘X’,’continuous')
This function returns as its result the Y value of ‘expr' in position 'X' on the X axis. The
function can be applied to both time-related and length-related signals.
In standard mode, i.e. if the ‘continuous' parameter is not indicated or FALSE or 0, the
function expects a constant X value and returns a constant Y value as its result.
The 'X' parameter can also be variable, i.e. it can be a function itself. In this case, the
continuous mode needs to be activated by setting the ‘continuous' parameter to TRUE
or 1. The function then determines the suitable Y value for every value of 'X' .
1 For a signal (blue curve), the YatX function is used twice in the standard mode
(without a third parameter):
a) 'X' = 21 --> Y value at 21 s
b) 'X' = half of the signal length --> Y value after half of the time. 'X' here is a
function, however, the result is constant.
2 By means of the time function, an auxiliary signal T was generated to be used as
'X'. 'X' is thus variable and the 'Continuous' parameter has to be set to "1". As the
linear function has the same step width and number of samples as the signal, the
result is a curve again resembling the signal.
3 By means of the Time function, an auxiliary signal T was generated having ten
times as many samples as the auxiliary signal T. If the auxiliary signal T2 is used as
'X' , the result also contains ten times as many samples. 'Continuous' = 1.
4 By means of the ManY function, an auxiliary signal ManX was generated used as
'X'. The result is a curve with 6 points at t = 0, 5, 10, 15, 20 and 25 s. 'Continuous' =
1.
The above picture illustrates the application of the filter function with 40 Hz to a
superposed sinusoidal oscillation which is made up of oscillations with 50 Hz and 10
Hz. The amplitude of the 50 Hz oscillation is significantly dampened.
Note
Digital filters which were generated using the filter editor can be saved in the system
and are then also available as filter functions in the expression builder.
Figure 250: Example with 5 different filters from the filter archive
The filters, if necessary, can be used in any desired expressions in the signal table or
the logical signal definitions.
The parameters of the filter from the definition in the filter editor are saved and
displayed in the expression builder dialog.
In the above figure, these are the corner frequencies F_pass and F_stop as well as the
gain G_pass and G_stop.
In order to use the filter function, only the signal or the expression needs to be
specified after the filter name (function name) to which the filter is to be applied.
In the above example, it would be sufficient to enter the following:
Lowpass_50_Hz (Expression) Expression = Signal name
In this case, exactly the frequency and gain values set for the graphic definition of the
filter would be used for the calculation.
Optionally, you can also indicate and change the parameters. Instead of fixed values,
even signals or expressions can be used for the frequency and gain values so that the
Issue 6.3 333
Manual ibaAnalyzer
filter function can be changed dynamically, too. The values set in the filter editor are
then overwritten for the current calculation. The filter stored in the archive, however,
remains unchanged.
You can thus adjust the filter function to the currently loaded data. However, the
parameters should be constant over time during the calculation or for a loaded data set.
If this is not the case, their average value is used for the overall period.
The following explains the parameters when used as filter functions for the 4 filter
types.
Parameter
Expression: signal/expression to be filtered (compulsory)
F_pass: the passband edge frequency, i.e. the rightmost point of the passband on
the frequency scale (optional)
F_stop: the stopband edge frequency, i.e. the leftmost point of the stopband on
the frequency scale (optional). F_stop must be greater than F_pass.
G_pass: gain of the passband in dB (optional), must be between -0.5 dB and -5
dB.
G_stop: gain of the stopband in dB (optional), must be smaller than G_pass
minus 0.1 dB.
G_pass and G_stop do not have to be indicated. If you leave these parameters out, the
gains originally defined in the filter will be used. If only F_pass is indicated, but not
F_stop, F_stop is automatically calculated in such a way that this results in the same
difference between F_pass and F_stop as in the original filter.
Tip
If you want to omit individual parameters when entering the function, please make
sure to place commas. Otherwise, the specified parameter is interpreted incorrectly.
Example: Omitting parameter F_stop:
Filter name (expression,F_pass,,G_pass,G_stop)
Parameter
Expression: signal/expression to be filtered (compulsory)
F_stop: the stopband edge frequency, i.e. the rightmost point of the stopband on
the frequency scale (optional). F_stop must be smaller than F_pass.
F_pass: the passband edge frequency, i.e. the leftmost point of the passband on
the frequency scale (optional)
G_stop: gain of the stopband in dB (optional), must be smaller than G_pass
minus 0.1 dB.
G_pass: gain of the passband in dB (optional), must be between -0.5 dB and -5
dB.
G_pass and G_stop do not have to be indicated. If you omit these parameters, the
gains originally defined in the filter will be used. If only F_stop is indicated, but not
F_pass, F_pass will be automatically calculated in such a way that this results in the
same difference between F_pass and F_stop as in the original filter.
Parameter
Expression: signal/expression to be filtered (compulsory)
Fc: the center frequency of the passband (optional)
D_pass: the width of the passband, i.e. the band width of the filter (optional); the
cut-off frequencies of the passband are symmetrical to the center frequency Fc at
an interval of D_pass.
D_stop: the interval of both stop bands (optional); the two stopband frequencies
are also symmetrical around the center frequency Fc. D_stop must be greater
than D_pass.
G_pass: gain of the passband in dB (optional), must be between -0.5 dB and -5
dB.
G_stop: gain of the stopbands in dB (optional), must be smaller than G_pass
minus 0.1 dB.
D_pass, D_stop, G_pass and G_stop do not have to be indicated. If you omit these
parameters, the gains originally defined in the filter will be used. If only Fc and D_pass
are indicated, D_stop will be automatically calculated in such a way that this results in
the same difference between D_pass and D_stop as in the original filter.
Parameter
Expression: signal/expression to be filtered (compulsory)
Fc: center frequency of the stopband (optional)
D_stop: the width of the stopband, i.e. the band width of the filter (optional); the
cut-off frequencies of the stopband are symmetrical to the center frequency Fc at
an interval of D_stop.
D_pass: the interval of both passbands (optional); the two passband frequencies
are also symmetrical around the center frequency Fc. D_pass must be greater
than D_stop.
G_stop: gain of the stopbands in dB (optional), must be smaller than G_pass
minus 0.1 dB.
G_pass: gain of the passband in dB (optional), must be between -0.5 dB and -5
dB.
D_pass, D_stop, G_pass and G_stop do not have to be indicated. If you omit these
parameters, the gains originally defined in the filter will be used. If only Fc and D_stop
are indicated, D_pass will be automatically calculated in such a way that this results in
the same difference between D_pass and D_stop as in the original filter.
5.13 Technological
5.13.1 ChebyCoef
ChebyCoef ('logical', 'beginsegment', 'endsegment', 'N-order',
'Coverfactor')
The ChebyCoef function calculates the coefficient of a Chebyshev polynomial of nth
order by polynomial splitting of ‘logical’ between ‘beginsegment’ and ‘endsegment’
considering the optional ‘coverfactor’ (default = 1).
The Chebyshev polynom, named after the Russian mathematician Tschebyschow
(1821 – 1894), turned out to be a suitable mean for describing in a mathematical way
the profile of a roll gap. Regarding the roll gap approximation, the orders 0 to 6 of the
polynomial are relevant. The function provides the coefficients T0 to T6 for it.
In real life, the coefficients can be derived from the measured values of a flatness
measuring roll. The measured values of every zone are collected in a multidimensional
signal ‘logical’ (vector). Each vector element corresponds to a segment in terms of the
cross profile of the gap. The range of segments to be considered is determined by the
vector indexes ‘beginsegment’ and ‘endsegment’. The ‘coverfactor’ can be given
optionally. It considers the coverage of the segments at the outer zones (strip edges).
5.13.2 CubicSpline
CubicSpline (expression,X,Y)
The function calculates a cubic spline for a number of points and returns a smoothened
signal along this spline as its result. The function can be used for interpolating a
compensation curve for a signal with few samples.
Parameter:
Expression: Values to be applied at the spline
X: X coordinates of the pair of points defining the spline (knot)
Y: Y coordinates of the pair of points defining the spline (knot)
The X coordinates, by the way, do not have to be unique and sorted. If there are
several value pairs with the same X coordinate, only the last value pair will be kept for
calculating the spline. The remaining value pairs are sorted by X coordinates.
Example
A curve has only 17 samples over a time of 5000 s (Y values, green curve). The
corresponding X coordinates – also only 17 values – are drawn in as blue curve. The
compensation curve as smoothened signal is to receive a significantly higher
resolution (more samples). Therefore, the CubicSpline function is transferred a linear
function with 5000 samples at an interval of 1 s as 'expression' parameter.
With a high level of zooming in, the calculated samples of the compensation curve can
be seen (red). The original X/Y coordinates form the knots of the splines (green).
5.13.3 LSQPolyCoef
LSQPolyCoef (‘X’,’Y’,’Order’)
This function calculates the coefficients of a polynomial for a (signal) curve dependent
on a quantity ‘X‘ according to the method of least squares.
Operand 'X' is the quantity that specifies the values along the X axis.
Operand 'Y' is the quantity whose curve requires the calculation of the coefficients.
As third operand, the order of the polynomial has to be indicated.
Values for order:
0 – possible, but makes little sense, as only the mean value of the Y values is
determined (constant).
1 – of first order, approximation of a line (or a line of best fit) (y = ax + b); the function
provides a vector with 2 values (coefficients a and b).
2 – of second order, quadratic function (y = ax² + bx + c); the function provides a vector
with 3 values (coefficients a, b and c).
3, 4, 5,...20 – higher orders as may be necessary
The result of the function is a vector (multidimensional signal, array) containing the
coefficients. The vector field with the index 0 contains the constant or offset of a
polynomial. The coefficients are written in vector fields with ascending index according
to their ascending order.
st nd
Figure 258: Coefficiants in the resulting vectors of LSQPolyCoef for 1 order polynomial (left) and 2 order
polynomial (right)
Application
Example 1
The function can be used for calculating a regression curve, e. g. a line of best fit
(order = 1).
Explanation
The picture shows the calculation of a line of best fit ('linewithpolynomial') based on
the curve of a measured signal ('input'). For further calculations, only a part of the
entire input signal is used, hereinafter referred to as 'cutinput'. The result of the
coefficient determination of LSQPolyCoef, the vector 'coef', shows two values: ca. 7.01
and 10.6. For clarification, the coefficients ('a' and 'b') were extracted from the array by
means of the GetRows function and once again represented separately.
Signal definitions:
1st line: The 'input' signal is artificially generated by means of the Time function and a
random component.
2nd line: The line of best fit 'linewithpolynomial' is drawn by means of the polynomial
function. The first operand of the function is the result vector of the LSQPolyCoef
function from line no. 3.
The second operand is the quantity that specifies the values for the X axis, in this
case, it is identically equal to the time. For calculating these time values, the XValues
function is used having the 'cutinput' input signal as operand.
3rd line: Calculation of the coefficients. Operand for the X coordinate provides the time
values, operand for the Y coordinate provides the values of the input signal, order = 1
effects the determination of 2 coefficients for a straight line.
4th and 5th line: Extracting the coefficients from the result vector 'coeffs'.
Example 2
Calculation of a line of best fit by the hysteresis curve of a calibration traverse with a
rolling stand to determine the stand module.
Explanation
In the above picture, the signal curves of roll force and roll position (roll gap) are
plotted over the time first. Calibration starts with high roll force and negative roll gap.
The stand opens, until release, and then closes again.
If the roll force is now plotted over the position in the XY presentation, a graph with two
curves being slightly different is shown (hysteresis).
To calculate a line of best fit for the hysteresis, the coefficients are determined (3rd line
in the signal table) and included in the polynomial function (5th line).
First of all, the final line of best fit is displayed time-based in a separate signal strip.
You then have to shift it in the XY presentation of roll force and position.
Important: Attach the line of best fit to the Y axis to ensure the correct presentation.
5.13.4 Polynomial
Polynomial ('Coef', 'X')
This function calculates the polynomial value for every sample of ‘X‘ on the basis of a
coefficient vector 'Coef'.
It is required for the representation of regression lines or best-fit curves whose
coefficients were calculated with the LSQPolyCoef function prior to this.
Example see above picture, "LSQPolyCoef , Page 340".
Note
From version 5.22.6 of ibaAnalyzer and higher, the FftInTime function is no longer
available in the expression editor. It was replaced by the functions FftInTimeAmpl and
FftInTimePower . For reasons of downward compatibility, the function is still supported
in terms of computations. Existing analyses using the FftInTime function must not be
changed.
The same applies to the functions FftOrderAnalysis and FftPeaksInTime.
Note
'SuppressDC' also applies to 'FftOrderAnalysis', 'FftAmpl', and 'FftPower'.
Time Determination of the step width, in which distances the order analysis is to
be carried out
Order subdivisions Determination of a possible grid width between the integer orders (default
= 1)
An interpolation is carried out between the individual signal points to calculate the
FftOrderAnalysis.
The function does not yield results if the number of signal points in an interval (step
width) is more than twice as high as the selected step width (time parameter).
To read out the requested values from the result vector, you can use the 'GetRows'
function.
Example
Assuming that you calculated an FftPeaksInTime function with the result vector '[res]'
for 3 peaks, you will then receive the following values by means of the 'GetRows''
function:
GetRows([res],0) --> frequencies with the highest peaks
GetRows([res],1) --> amplitudes/powers of the highest peaks
GetRows([res],2) --> frequencies with the second highest peaks
GetRows([res],3) --> amplitudes/powers of the second highest peaks
GetRows([res],4) --> frequencies with the third highest peaks
GetRows([res],5) --> amplitudes/powers of the third highest peaks
Time Determination of the step width, in which distances (time or length) an FFT
analysis is to be carried out.
This parameter, multiplied by the overlap factor, determines the time or
length interval for which an FFT is to be calculated in each case. Multiplied
by the sampling rate of ‘expression', this parameter roughly determines the
number of the samples used for the FFT calculation
Number of peaks This is the number of peaks to be shown. The new vector contains twice
as many cells, since the frequency value and the amplitude or power are
determined for each peak. If fewer peaks are available at a time in the FFT
analysis, then the last cells of the vector do not have values
Min frequency The lowest frequency to be considered. Peaks occurring in case of lower
frequencies are not taken into consideration. This parameter is optional. If
it is omitted, all frequencies in the spectrum of the FFT up to half of the
sampling rate (Nyquist frequency) are taken into consideration
Max frequency The highest frequency to be considered. Peaks occurring in case of higher
frequencies are not taken into consideration. This parameter is optional. If
it is omitted, all frequencies in the spectrum of the FFT between min.
frequency and half of the sampling rate (Nyquist frequency) are taken into
consideration
Adding zeros If this parameter is set to 1 or TRUE(), the last window is filled with zeros
before calculating the FFT.
This is particularly relevant if a value >0 is selected for the overlap.
If the parameter is 0 or FALSE() (default), then the last window is
discarded.
Table 9: Parameters of functions FftPeaksInTimeAmpl/FftPeaksInTimePower
5.14.4 FftAmpl
FftAmpl ('Expression', 'Resolution', 'Window', 'SuppressDC')
This function calculates the amplitude for each FFT component, i. e. the amount of the
complex component. In contrary to "normal" FFT (i. e., the ones you get by selecting
the frequency axis or 1/length axis), this function takes all samples into account and not
just those in the signal strip.
'Expression': The signal or expression you wish to have an FFT from.
'Resolution': The number of desired frequencies
'Window': The window type you wish to apply before calculating the FFT. Default is 0
(no window or rectangular), although a window is usually required. Please enter one of
the following numbers in order to select the window type:
None (= 0), default
Bartlett (= 1)
Blackman (= 2)
Hamming (= 3)
Hanning (= 4)
Blackman-Harris (=5)
5.14.5 FftPower
FftPower ('Expression, 'Resolution', 'Window', 'SuppressDC')
This function basically equals the function FftAmpl but instead of taking the amount, it
calculates the square of the real part + the square of the imaginary part.
5.14.6 FftComplex
FftComplex(input,inverse,normalize)
Note
This function, just like the functions FfTReal and FftRealInverse, is designed to
provide FFT results which were identified without averaging in “bins", windowing or
advanced normalization. The results are therefore even more suitable for further
calculations and can be used more flexibly. Advanced users can apply their own
methods to averaging, windowing or normalization.
Unlike the usual FFT functions in ibaAnalyzer, the number of samples of the input
signal does not necessarily have to be a power of 2.
The FftComplex function returns a two-dimensional signal (vector) as its result which
contains both the real component and the imaginary component of the FFT calculation
result. The function can calculate both normal FFT and inverse FFT.
The function uses the following parameters:
Input: input signal to which the FFT is to be applied. It can be both a
two-dimensional signal consisting of real and imaginary components and a
5.14.7 FftReal
FftReal (input,normalize)
This function calculates the FFT of a real (one-dimensional) signal and returns a
two-dimensional signal with real component and imaginary component of the FFT
operation as its result. Only the positive spectrum is output, as the negative spectrum is
only the conjugate gradient of the positive spectrum.
As to the number of samples N in the input signal, the following applies:
N does not have to be a power of 2.
If N is even, N/2+1 frequency points are calculated; the first (DC component) and
last point are merely real.
If N is odd, (N+1)/2 frequency points are calculated; for those, the DC component
is merely real.
The function uses the following parameters:
Input: real input signal to which the FFT is to be applied.
Normalize: if this parameter is TRUE or 1, a normalization is performed. If the
number of samples N is odd, all frequency values except for the DC component
are divided by N/2. If N is even, all frequency values except for the DC
component and the last value are divided by N/2. The excluded values are
divided by N instead.
If this parameter is FALSE or 0 (default) or if it is not specified, no normalization is
performed.
Example
In the following example and picture, the FftReal function is applied to a square-wave
signal (f=0.5 Hz. The result is a vector [RealForward] (green/olive curves) providing
the real and imaginary component for the contained frequencies. By means of an
inverse FFT applied to the result vector, the original signal is to be restored with the
input signal for the inverse FFT [Filter] (purple /turquoise curves) being modified
depending on the position of the X1 marker. This way, a low-pass filter can be
realized, as the frequency range above the X1 marker position is hidden for the
FftRealInverse function. By moving the X1 marker, it can be easily identified which
filter frequency is enough already to get a sufficiently precise signal [FilteredInverse]
(red curve).
In the signal tree of the expression builder, you can clearly see the vector nature of the
result of the FftReal function.
5.14.8 FftRealInverse
FftRealInverse(input,normalize)
This function calculates an inverse FFT. A two-dimensional signal (vector) is expected
as input signal containing the real component and the imaginary component of the
positive spectrum. The result is a real signal.
The function uses the following parameters:
Input: two-dimensional input signal (vector) to which the FFT is to be applied.
Normalize: this parameter should be set to TRUE or 1 if the input signal had been
normalized before as described with the FftReal function. Otherwise, this
parameter should be set to FALSE or 0.
If FftRealInverse is applied to the result of a FftReal function and the Normalize
parameter for both functions is TRUE, the original, real signal is displayed again.
If Normalize is FALSE for both functions, the original, real signal is displayed
multiplied by N.
Parameter:
FileIndex: Refers to a consecutive numbering of the loaded data files, from 0
(above) until n (below). If only one data file is open, use 0 for ‘Fileindex’.
"Info field“: name of the info field to be read. Use quotation marks!
If you enter "filename" or. "pathname" instead of an info field name, the data file
name or the complete path of the data file is displayed.
Begin: first character of the field content to be read. Minimum value for start is 0
(=default). This parameter is optional. If no "Start" value is defined, the complete
content is read.
End: last character of the field content to be read. This parameter is optional. If
no "End" value is defined, it will be read from the start to the last character (end
of text = default).
Figure 264: Using path and file name as text channels in the graph
Tip
If you double-click on the desired info field, ibaAnalyzer automatically inserts the
corresponding function as new signal into the signal table. If required, you then only
have to adjust the signal name and beginning/end.
If you want to read out the content of an info field as numerical value, use the Infofield
function.
5.15.2 ChannelInfoFieldText
ChannelInfoFieldText (channel, "Info field", begin, end)
This function works as the "InfoFieldText" function, however, it refers to the info fields of
a signal (channel) and not the data file. The function returns a text channel with the
content of the specified info field as its result.
Parameter:
Channel: the signal from which the info field is to be read out
"Info field": name of the info field to be read. Use quotation marks!
Begin: first character of the field content to be read. Minimum value for start is 0
(=default). This parameter is optional. If no "Start" value is defined, the complete
content is read.
End: last character of the field content to be read. This parameter is optional. If
no "End" value is defined, it will be read from the start to the last character (end
of text = default).
Tip
If you double-click on the desired info field, ibaAnalyzer automatically inserts the
corresponding function as new signal into the signal table. If required, you then only
have to adjust the signal name and beginning/end.
If you want to read out the content of an info field as numerical value, use the
ChannelInfofield function.
5.15.3 TextCompare
TextCompare (Text1, Text2, CaseSensitive)
This function allows you to compare the text information lexicographically.
The function works with contents of text channels as well as with plain text which –
used with quotation marks – is directly entered in the signal definition.
Parameter:
Text1: first comparison text. It can be a text channel or a plain text. Plain text
must be used with quotation marks.
Text2: second comparison text. It can be a text channel or a plain text. Plain text
must be used with quotation marks.
CaseSensitive: optional parameter which can be used to specify whether case
sensitivity is taken into consideration for the comparison.
If this parameter is TRUE (default) or not specified, case sensitivity is taken into
consideration. "aaAA" and "aaaa" are thus different texts.
If this parameter is FALSE, there is no differentiation. "aaAA" and "aaaa" are
identical texts.
Comparison and results:
The result is -1 if the information of the first text is to be arranged lexicographically
before that of the second text. In the below picture, this is the case for the result of
"time-start date comparison". The start times of the first two data files (07:22:48 and
07:34:48) are before the comparison time "07:40:00".
The result is 0 if both texts contain the same information. In the picture below, this is
the case for the result of "date-start date comparison". The start date of all three data
files (25.03.2009) is equal to the comparison date "25.03.2009".
The result is +1 if the information of the first text is to be arranged lexicographically
after that of the second text. In the below picture, this is the case for the result of
"time-start date comparison" regarding the last data file. The start time of the third data
file (07:49:47) follows the comparison time "07:40:00.
Figure 266: Using the TextCompare function to compare date and time
The following table shows further examples as well as the impact of the
"CaseSensitive" parameter:
5.15.4 ToText
ToText ('Expr', Format="%g")
This function converts a numerical signal value into a text channel. In case of
equidistant samples of the “expr" input signal and a constant Y value, only the value of
the first signal point is entered and displayed as sample in the text channel. If the Y
value changes, a sample is entered and displayed in the text channel for every new Y
value.
If the “expr" input signal does not contain equidistant samples, a sample is entered and
displayed in the text channel for each input sample.
Parameter:
Expr: the signal or expression whose values are to be converted into a text
channel.
Format: this parameter is optional. You can specify a format string for the
conversion of floating point values of the numerical signal into text. The format
string is to be entered according to C printf syntax. You can only indicate a
parameter (%) complying with an IEEE 32 bit floating point value. Default value is
%g. This value is also used if you do not indicate the optional parameter.
Examples:
%g = conversion of the floating point value into a text %.
4f = text/number with 4 decimal places, etc.
The "ToText" function can be helpful e. g. if trends are visualized containing vast
amounts of data. Without constantly changing between the marker and signal view, the
numerical values can be easily displayed.
5.15.5 TrimText
TrimText (Text, RemoveOption=0)
With this function, you can remove the spaces from texts. This function can be used
both in case of text channels already contained in data files and in case of results of the
InfofieldText and ToText functions.
Parameter:
Text: Text channel or expression generating text from which spaces are to be
removed.
RemoveOption: Parameter for setting the operating mode
0 (default): Removing spaces before and after the text
1: Removing spaces before the text only
2: Removing spaces after the text only
3: Removing all spaces, also in the text
5.16 Macros
By using the macro function (macro designer), the user can define and save extensive
and standardized analysis functions as so-called macros. The macros are generated
with the familiar functions of the expression builder. They can be universally used, as
the input and output parameters can be replaced by placeholders. Macros can be
globally stored and thus be made available for other analyses, too. Macros can be
exported and imported for exchange. Using macros, analyses can be created more
clearly and comprehensibly.
Via the macro designer, you can generate and/or change macros. This is opened by
clicking the macro function in the tool bar (see the below picture) or via menu Setup –
Macro Design....
In the macro designer, all functions of the expression builder are available. By using
macros, the following advantages arise:
If calculations have to be carried out repeatedly for different input signals, the effort
for generating the expression functions can be significantly reduced
Complex calculations can be hidden in a macro so that short and comprehensible
expressions are displayed in the signal table of the ibaAnalyzer
General calculations can be stored as macros in a library being available for other
analyses, too.
Macros can be exported and imported. Thus, other users can use macros as well.
Exchanging complete analyses is sometimes difficult, since usually the analyses
are applicable to specific dat files only.
Using macros does not require any programming skills
You can protect macros from unauthorized changing by means of a password.
Tip
Individual macros can be specifically exported from the macro archive and/or imported in the
archive.
To import macros, right-click in the pane of the macro archive, select Import macro in the
context menu and browse the requested *.mcr file.
To export macros, right-click on the macro to be exported in the macro archive and select
Export macro in the context menu. You then save the macro as *.mcr file at a location of your
choice.
Inputs
Here, the required parameters of the macro are entered. Please refer to the subchapter
"The input dialog , Page 363" for a more detailed description.
Intermediate values:
This dialog defines expressions serving as interim results and being available for other
operations. Please refer to the subchapter "The intermediate values dialog , Page 364"
for a more detailed description.
Result
Here, the function is entered which is to lead to the result of the macro. The result
function can be generated from the familiar expressions of the expression builder or by
using further macros. If you want to use other macros, please make sure that they are
valid. If you use intermediate results, you have to put them in square brackets
([intermediate results]), as is the common practice in the expression builder. You can
also use additional channels (other signals of the loaded dat file, logical signals, results
from database queries, etc.). However, it has to be guaranteed that the selected
channels are always available and valid, as otherwise the macro cannot be executed.
Preview window:
The preview window shows all valid input arguments, intermediate results and the
macro result itself. You can suppress the preview function by not enabling the selection
fields in the "Show" column. The preview window offers the same operations as a
signal strip in the recorder window.
First, 2 is selected as number for the required arguments. Then, the input signals are
selected (X and Y values). As input signals of the macro, only two time-based signal
curves of a position (Y) and force measurement (X) are used.
Interim calculations are required for generating the macro. These interim calculations
are entered as intermediate values:
FirstMinimum:
Calculation of the signal point where the input signal has its reversal point (the input
signal starts to decrease). This point is determined by means of the functions XFirst
and Dif (the derivation changes from a negative to a positive value).
FirstMaximum:
Calculation of the signal point where the input signal again has its reversal point
and starts increasing again. Again, the calculation is made by means of the
functions XFirst and Dif (the derivation changes from a positive to a negative value).
SecondMinimum:
The signal point is calculated where the input signal goes into reverse again. This
calculation again is made by means of the functions XFirst and Dif, the signal point
is determined after FirstMaximum .
XPartRising:
By means of the function XCutRange, the area between FirstMinimum and
FirstMaximum is determined for the input signal.
YPartRange:
By means of the function XCutRange, the area between FirstMinimum and
FirstMaximum is determined for the output signal.
XPartDropping:
By means of the function XCutRange, the area is calculated where the input signal
between FirstMaximum and SecondMinimum decreases.
YPartDropping:
By means of the function XCutRange, the area is calculated where the output signal
between FirstMaximum and SecondMinimum increases.
hysLowerCurve:
The lower curve of the hysteresis curve is determined by means of the XYfunction
(here YPartRising vs XPartRising).
hysUpperCurve:
The upper curve is determined by means of the XYfunction (here YPartDropping vs
XPartDropping). Usually, the XYfunction requires the X argument (here
XPartDropping) to always increase. Since this is not the case in the example, it is
corrected with the function XMirror for XPartDropping and YPartDropping first.
The area to be determined between the two curves is then easily determinable by
integrating the difference hysUpperCurve and hysLowerCurve .
The difference between Mark and ReqLength is the result of the calculation, the macro
respectively (beginning of the fillet section).
Macro for calculating the area where the fillet ends - macro name BodyEndL
The same parameters are selected as input signals as in the previous example.
The following intermediate results are required for calculating the macro:
Length:
Same expression as in the previous example
WithinLimits:
Same expression as in the previous example
ValidLengths:
By means of the function MaxValid, the value is determined where the condition
WithinLimits is met for the last time, i.e. is TRUE, (where the tolerance conditions
are ultimately met).
Mark:
By means of the function XLast, both the point is determined where the condition
ValidLength is ultimately met and the point where the range of validity of ReqLength
is exceeded.
The sum of Mark and ReqLength then is the result of the calculation, the macro
respectively (end of fillet section).
You can then specify the path and file name of the *.zip file.
After importing the file, macros contained in an export file are available as global
macros.
You can import global macros by selecting a suitable *.zip file in the "Import" section of
the dialog and enabling the second or third method for loading the settings. Then exit
the dialog by clicking the <OK> button and restart ibaAnalyzer.
Moreover, there is an *.mcr file in the "C:\Documents and Settings\user
name\Application Data\iba\ibaAnalyzer" directory for every global macro. Also, these
macro files can be imported in an analysis and/or a macro archive. (see "Import and
export macros , Page 370").
To export macros, right-click on the macro to be exported in the macro archive and
select Export macro in the context menu. You then save the macro as *.mcr file at a
location of your choice.
Basically, you can also apply this method to global macros in the macro archive.
However, the global status gets lost then and the macro is entered as local macro first
when imported in another analysis.
To remove the macro protection, just disable the options in the Macro protection dialog.
Important Note
From version 5.22.0 and higher, macros are saved in encoded form in the analysis or
in the .mcr files in the program folder of ibaAnalyzer (e. g. global macros). This is to
prevent macro information from being tapped by means of Hex editors. One
consequence of this is that macros having been generated with ibaAnalyzer versions
5.22.0 or higher cannot be processed by older versions (<5.22.0) anymore. Older
macros, however, can be easily used with new ibaAnalyzer versions.
6 Filter editor
6.1 Creating digital filters using the graphic editor
The functionality of "creating digital filters" is one of the most powerful areas of
ibaAnalyzer. Filters can be graphically created, saved or renamed in this context.
In order to open the dialog window, click the button on the icon bar shown above.
Note
Filters can be exported out of or imported into a filter archive individually.
To import filters, right-click in the pane of the filter archive, select Import filter in the
context menu and browse the requested *.fil file.
To export filters, right-click on the filter to be exported in the filter archive and select
Export filter in the context menu. You then save the filter as *.fil file at a location of your
choice.
The signal generator can generate several test signals, such as sine, square, impulse
and multi-tone (frequency mixture). The signal shape and frequency range can be
selected on this tab, and the frequencies can be selected using a slide control.
The multi-tone signal is composed of individual basic frequencies (tones). A multi-tone
with one tone corresponds to a sine tone. A multi-tone with two tones corresponds to
the addition of two sine signals, one basic frequency (lower frequency) and a second
sine with a higher frequency. If more than one tone is selected ("No. of tones" >1), a
second slide control is displayed. The upper slide control is used to set the basic
frequency, the lower one to set the higher frequency. The higher frequencies result
from the bandwidth set (upper frequency minus basic frequency) divided by the number
of tones. Every additional tone is considered in the addition with half the amplitude
compared to its predecessor. The lower slide control cannot have a lower frequency
than the upper one and vice versa.
Highpass
Highpass, eliminates the lower frequency components and allows the high frequency
components to pass.
Bandpass
Bandpass, allows frequencies within the frequency range set to pass and eliminates
the lower and higher frequencies.
Bandstop
Bandstop, eliminates the frequency components within the specified frequency range
and allows lower and higher frequencies to pass.
The lower right corner of the dialog window contains six tickboxes as follows.
Show phase response: shows the phase offset of the filter in degrees (deg).
Show FFT input signal: shows the FFT of the input signal in red. Click the
button in order to open the configuration dialog for the FFT setup for this view.
Show FFT filtered signal: shows the FFT of the filtered signal in green in the same
graph as the FFT input signal.
Show input signal: shows in a separate strip the original signal (input signal or
signal generator) in red that has been marked in the signal selection in the upper
right corner.
Show filtered signal: shows the filtered input signal in green in the same graph.
Create graph from current settings: This option creates a new signal strip in the
recorder window of ibaAnalyzer which shows the filtered signal as soon as you click
the <OK> button and exit the dialog. This function is important if filtered signals are
to be added to the analysis.
2. Initially, only activate "FFT input signal" and "Input signal" for the graph
presentation. The shape of the input signal which is now to be generated using the
signal generator can be checked via these displays.
3. In order to improve the display of the FFT, change the FFT setup ( ) as follows:
4. In order to generate a test signal, now open the "Signal generator" tab in the "Signal
selection" area. The test signal should contain several frequencies, including one at
around 50 Hz. Numerous settings can be chosen to generate such a signal. This is
just one option:
5. Using the FFT display for the input signal, adjust the slide controls of the signal
generator until a distinct increase in amplitude is observed at 50 Hz. In the event
that the frequencies are too close to each other or too far on the left, simply open
the context menu by pressing the right mouse key in the strip, and select Autoscale
frequency axis in signal range. The scaling of the frequency axis is now improved. It
should look as follows:
The test signal thus contains chiefly the frequencies of 20, 50 and 78 Hz. The
bottommost strip shows the time curve of the signal.
6. Now select the "Bandstop" filter type. In the event that the green points in the strip
with the frequency response are incomplete or not shown at all, we recommend
re-scaling the strip via the context menu, this time via the Autoscale frequency axis
in filter range option.
7. Push the outermost points and the frequency band in such a manner that a
compact, but still manageable (movable) characteristic is obtained. Now use the
mouse in order to seize the filter points at the center point and move them towards
the frequency amplitudes of the input signal.
8. Now use the Autoscale frequency axis in the signal range option again in order to
re-scale the graph until you obtain a better resolution of the area of interest.
9. You can now move the points for the corner frequencies to the desired points. For
this purpose, move the center point to the 50 Hz position and then shift the
neighbouring points in order to adjust the frequency band in such a manner that the
corner frequencies are located at 45 and 55 Hz. Now, the filter is already almost
complete.
10. In order to check the result, you can now have the filtered FFT signal (use the same
FFT settings as above!) and the filtered signal displayed. As you can see, the
frequencies around 50 Hz are completely missing in the filtered signal. The filter
behaviour can still be slightly modified by adjusting the damping via the two outer
green points.
11. By the way: Zooming is possible in the bottommost strip in order to see the signal
curve more clearly.
12. If you think that the filter is ok and should be saved, just click the <OK> button in
order to exit the dialog. In order to make sure that the filter is not lost when
ibaAnalyzer is exited, also save the analysis once again. If the filter is to be
available even to applications other than the current analysis, tick off the "Filter is
global" box before you exit the dialog.
13. No matter whether local or global – with immediate effect, the filter is now available
in the expression builder and can be used for filtering out 50 Hz oscillations from all
kinds of signals.
14. By changing the filter type, you can now easily test or create other filters. If you
switch to the bandpass filter, for example, the frequency band remains in force, and
all frequencies other than 45-55 Hz are filtered out now. What remains is a perfect
50 Hz oscillation.
You can then set the path and file name of the *.zip file.
Filters included in an export file are available as global filters after the file import.
You can import global filters by selecting a suitable *.zip file in the "Import" section of
the dialog and activating the second or third method for loading the settings. Then exit
the dialog by clicking the <OK> button and restart ibaAnalyzer.
Furthermore, a *.fil file is generated for each global filter in the directory "C:\Documents
and Settings\user name\Application Data\iba\ibaAnalyzer". These filter files can also be
imported specifically into an analysis or a filter archive. (Refer also to the next chapter.)
It is generally also possible to apply this method to a global filter in the filter archive.
When imported into another analysis, however, the filter loses its global status and is
initially entered as local filter.
7 Report generator
This chapter gives an introduction to the reporting options using the report generator.
The most important aspect that will be discussed here is the data interface with the
report generator in the form in which it was implemented in ibaAnalyzer.
Details concerning report layout and design, i.e. the use of combit's
(http://www.combit.net/reporting/report-generator-List-Label) reporting tool "List &
Label", can be found in the online documentation. We recommend booking an
additional report generator training course at our company in order to learn how to use
this complex tool.
Note
iba offers a standard course on the subject of the report generator. Please visit our
website for course times, availability and prices, or just call us.
In order to edit the report layout or the output function immediately you can also drag
the relevant icons into the menu bar (via menu View - Toolbar setup...) This function
can make the use of the report generator easier.
Report file
Using the browser, you can select an existing report file (extension always .LST) in
order to subsequently edit the report (adding contents, changing layout, ...).
In order to create a new report, simply leave this field blank. After clicking the <Edit
report layout> button, a "project assistant" is automatically started or the blank report
editorreport designer is displayed.
Number of pages
This setting has an influence on the report output (printer, file) only. It is not possible
with this option to change the number of pages in the report designer.
You can preset a fixed number of pages by entering a fixed value or a function of the
expression builder. Simply choose a fixed value, e.g. the minimal number of pages to
be created. If the preset number of pages is not sufficient to display all data and/or
information in a report, missing pages are added automatically until the report is
complete.
The number of pages, however, can also be a function of the expression builder. This is
useful if the number of pages is dependent on the signals of the *.dat file.
Example
A data file recorded for several hours. In this case, settings could be configured in
such a way that one report page is output every hour. The relevant function could be
entered in the expression builder:
Ceil(XSize([0:0])/3600)
Note: The function XSize([0:0]) provides the data file duration in seconds.
If the result of the function is no integer value, this value will be rounded up to the next
integer number. Therefore, a report page is created for every started hour.
In some cases it may be useful to create reports only when certain conditions are
fulfilled. In case of the
If([Condition],3,0) function, for example,
a three sided report is generated only when the condition is TRUE.
Exported graphs
Before the report designer is started, you must tick off in the EXP column all the graphs
and/or signals which are to be used in the report (including the "Report info" window).
The number of blank lines displayed always corresponds to the number of signal strips
which are displayed in ibaAnalyzer. When selecting (click) the individual lines, the
preview window right of the lines displays the currently selected signal strip similar to
the display in ibaAnalyzer. We recommend giving the individual report variables telling
names, as they are subsequently displayed and used as report variables in the report
designer. Remember not to use any blanks, dots, commas, hyphens, etc. as part of the
name. The use of the understroke as separator is permitted!
Picture below: Technostring with information such as product number, primary data,
customer data etc. or the name of the data file
Column name
This is where a telling name is defined for the information from the info field. The yellow
highlighted part of content is then assigned to this name (as in the picture above
"starttime" -> "startdate").
Column type
An info field like “technostring” can consist of up to 10,000 text characters and/or
numerical characters.
Here, you must precisely define the data type of which data type the characters of this
newly defined info field are (number, text).
Function
This cell is automatically filled with the appropriate function corresponding to the
marked info field by pressing the <Apply> button (see step 5). This function exists for
every type of info field. The parameters in brackets are data file index, start and stop
index. The latter two indices are derived from the part highlighted in yellow. It is also
possible to edit the functions directly in the table cells.
Show
In the "Show" column, you can activate the individual fields for the report and the
information window (report info). Only checked and therefore activated fields are also
available in the report designer and in the "Report info" window.
"Select from start index until end of infofield" option
If you enable this option, you just have to mark the starting position in the info field from
which on the entire rest of the contents is to be assigned to the new info field. By using
this option, you can even work with contents of variable length.
Column name
At this point, first choose a telling name for the computed value. This name is
subsequently displayed in the report designer.
Figure 294: Information from "Computed columns" as variables in the report designer
Expression
In this column, you can directly enter the formula for computing a value. However, you
can also start the expression builder by clicking the <fx> button in the same table line.
All functions of the expression builder are available (see "Expression builder , Page
228" et seqq.).
X (X axis type)
Here, you need to decide for each computed value whether it is a length-based or a
time-based calculation. A click opens a selection box.
Show
In the "Show" column, you can activate the individual computed values for the report
and for the "Report info" window. Only checked and therefore activated values are also
available in the report designer and in the "Report info" window.
Tip
Import and export of computed columns
You have the possibility to export / import all computed columns into / from a text file
by a right mouse click in the table.
This function can be very helpful if you have to use the same expressions again, e. g.
for the data base extraction.
Moreover, the text file is easy to edit with an editor or MS Excel. This is also very
useful if you have to configure many computed columns.
An import always overwrites all current columns.
As shown in the picture below, the variables can be found in the report designer.
Figure 298: Arrangement of the text variables in the variables list in the report designer
This tab provides several options for notifying other people that a report was generated
or for automatically triggering certain processes. All four options can be triggered
optionally by one of the following events:
On completion of a report generation process (on success)
In the case of a failure of a report generation process (on failure)
Only after the first failure of a report generation process (on failure (1st failure
only))
On completion of the complete report generation process (on completion)
Each of the four options can be activated by ticking off the pertinent box.
E-mail address
Enter a valid email address in this line if somebody is to be informed about the result of
the report generation process.
IMPORTANT: A standard email client (e.g. MS Outlook, Outlook Express, etc.) must be
installed on the same PC.
Net send computer name
Enter a valid computer name in the network in this line if somebody is to be informed
about the result of the report generation process. You can also use the browser button
in order to search for and select the desired PC. This function uses the messenger
service of Windows in PC networks. A message window is opened on the recipient's
screen.
Command line
In this line, you can enter any computer command, such as the call of a program,
execution of a batch file, etc.
Write to Windows application event log
If you select this option, the message is written into the Windows event log, user area.
By using this tab you can transmit every generated report via e-mail. Therefore you
have to enable the option “Send generated report via e-mail” in this dialog. As a
prerequisite for automatic transmission the ibaAnalyzer-computer must be connected
to an e-mail server (SMTP server). Therefore several settings are to be configured.
Clicking the button <E-mail settings> will open the setup dialog for the e-mail
transmission. You may also use an e-mail client program (e.g. Microsoft Outlook).
Then, however, due to manual interaction, only a manual transmission might be
possible.
Other documentation
You may get more detailed information about the e-mail settings during the training course
"Report generator" or from the instructive List & Label manual of combit
(http://www.combit.net/reporting/report-generator-List-Label).
By default, a picture is displayed besides the object name (signal title from the list of
variables). The picture shows the moment when the video recording started. You can
change these displays by double clicking the object or via the menu item "Objects -
Properties".
The functions of the expression builder can be used in order to compute the proper
moment for the display of the matching picture, e.g.
XFirst([digital signal]).
1 Image
2 Rectangle
3 Formatted text
4 Technostring
5 Text/ variable
6 Bar code
7 Report variable
8 Table
In order to generate a report as shown in the figure above the data defined in the data
interface must be subsequently assigned in the report designer to the corresponding
objects.
The user interface of the editor is displayed. In the "Layout preview" window in the
middle, all the objects which the report is to contain in future are inserted and
formatted.
1 Toolbar
2 Object levels preview
3 Properties
4 List of variables
5 Layout preview
Toolbar
The toolbar contains text and graphic objects which can be activated by a simple click
and which are subsequently positioned in the layout preview by keeping the left mouse
key depressed whilst moving the cursor.
"Objects" tab
This window shows an overview of all the objects of the report. The default names can
be replaced with telling names after a slow double-click (in the example above: Title or
Z_ibaLogo, etc.). When an object is selected, the corresponding object is also marked /
surrounded by a frame in the layout preview!
"Properties" window
In this tool window, the properties of a previously selected object are defined. The
possible properties are strongly dependent on the object type. Besides position, color
and size of an object, it is, for example, also possible to activate presentation and
pagination conditions.
"Layout preview" window
This is the work area where existing objects can be edited or deleted and where new
objects can be added. The shape and dimensions result from the defined layout
preferences.
The work area always consists of one single page only. This means that it is not
possible to create further pages as you may know from other programs.
In order to create multi-page analysis reports, you have to define and assign so-called
"levels".
"List of variables" window
This window shows the previously defined data from the data interface of ibaAnalyzer.
You can use the drag and drop function in order to position and subsequently format
the variables in the work area.
These include, for example:
Report variables (signal strips)
Computed values
Technostring fields
Furthermore, other types of data are additionally made available by default:
Information from the data file (such as sample time, start trigger, time, ...)
Fields / arrays from the data file (such as signal name, unit, ...)
Tip
The output of reports can be automized and conveniently configured with the help of
the software tool ibaDatCoordinator.
8 Installation
8.1 System requirements
PC, multi-core CPU, 2 GHz or better
2048 MB RAM or more for extended analyses (with video etc.)
100 MB or more available hard disk space for the program
Additional hard disk capacity for data files and analyses, depending on your
particular application
Operating system: MS Windows XP, Vista, 7, Server 2003, Server 2008 or Server
2012
Internet Explorer 6.0 or higher
8.2 Installation
The CD delivered contains all the necessary program files in one directory. They can
be found in the directory ..\ibaAnalyzer_Vm.n.. (m.n = Version). The installation file is
available in zipped and unzipped form.
You can
a) copy the zip file to the hard disk of your computer and unzip it there or
b) run the installation file ibaAnalyzerInstall_vm.n.exe directly from CD.
When downloading the installation file from our website, you will receive a zip file which
has to be saved to your hard disk and unzipped there.
Then proceed as follows:
1. Run the file ibaAnalyzerInstall_vm.n.exe.
If ibaAnalyzer is already installed on your computer, you will be notified and asked
to confirm the reinstallation.
Click <Yes>.
The installation wizard will start.
2. Click <Next> to start the installation.
In the next step, you can change the target folder for the program files, if you wish.
3. Click <Next>.
In the next step, you can select the type of database support. This is only necessary
if you use ibaAnalyzer-DB (ibaHistorian) to extract data into a database or to read
from a database. All other applications do not require database support.
4. Make your choice and click <Install>.
The installation will start and a progress bar will be displayed. If interested, you can
click on <Show details> in order to track the individual actions.
A notification will be displayed after the installation is complete.
5. If you want to launch ibaAnalyzer immediately after the installation, then activate the
checkbox "Launch ibaAnalyzer" and click <Finish>.
Other documentation
The description of the database interface is available as a separate document
(ibaAnalyzer-DB) and comes with the additional license, and/or is available on
request.
Figure 306: Open data file: txt, csv and dat file formats
As the files are identified solely by their extension, even files which may not contain
any text rather than data are offered for selection. The extended "Show advanced"
function is not available for the above-mentioned file types. Any other functions, such
as load file, create file group, add and append files, work in just the same manner as
the iba original files.
Refer also to Defining groups of data files, Page 108
Y axis preferences 77
Y axis reference 78
Y axis scale offset 78
Y axis scaling mode 77, 78
Y axis scaling mode 77, 78
Y axis scientific notation 77
YatX 330
Z
Zoom 149
413
Manual ibaAnalyzer
Note
If you require support, indicate the serial number (iba-S/N) of the product.
Contact
Headquarters
iba AG
Koenigswarterstr. 44
90762 Fuerth
Germany
Phone: +49 911 97282-0
Fax: +49 911 97282-33
Email: iba@iba-ag.com
Contact: Mr Harald Opel