Famos Iii
Famos Iii
Famos Iii
Training Material
© 2017
imc Meßsysteme GmbH • Voltastraße 5 • 13355 Berlin • Germany
imc Test & Measurement GmbH • Max-Planck-Str. 22b • 61381 Friedrichsdorf • Germany
About imc ACADEMY
Welcome to the imc ACADEMY training program. We thank you for joining us for today’s training session.
imc ACADEMY has existed since 1998 and offers a broad scope of instruction on measurement
technology from imc. For this purpose, you have a choice of different paths of knowledge transfer, for
instance training sessions, workshops and seminars. To cover the various topics, several traininers are
available who each focus on a different specialized area.
For any questions which may arise, imc's support department is happy to help:
By e-Mail: hotline@imc-berlin.de hotline@imc-frankfurt.de
By telephone: +49 (0)30 467090-26 +49 (0)6172 59672-40
By fax: +49 (0)30 463157-6 +49 (0)6172 59672-222
In this course, the use of Panels is imparted in the interaction with the Data Browser and the Dialog
Editor.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Disclaimer of liability
The contents of this documentation have been carefully checked for consistency with the hardware and
software systems described. Nevertheless, it is impossible to completely rule out inconsistencies, so that
we decline to offer any guarantee of total conformity.
We gratefully accept any suggestions for improvements, please contact our Hotline (hotline@imc-
berlin.de).
Copyright
© 2017 imc Meßsysteme GmbH, Berlin, Germany
© 2017 imc Test & Measurement GmbH, Friedrichsdorf, Germany
This documentation is the intellectual property of imc Meßsysteme GmbH and imc Test & Measurement
GmbH. imc Meßsysteme GmbH and imc Test & Measurement GmbH reserve all rights to this
documentation. The applicable provisions are stipulated in the "imc Software License Agreement".
The software described in this document may only be used in accordance with the provisions of the "imc
Software License Agreement".
GPL Sources
Some components of our hardware use software, that is licensed under GNU General Public License
(GPL). If you would like a copy of the GPL source code contained in this product please contact our
Hotline.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Table of Contents 5
1 Introduction ..................................................................................................... 6
2 Panel and Data-Browser ................................................................................... 7
2.1 How to use Panels ...................................................................................................... 8
2.2 Exercise: Panel pages ................................................................................................ 10
2.2.1 Exercise: Page Measurement ........................................................................................................ 10
2.2.2 Exercise: Page Report ................................................................................................................... 19
2.2.3 Exercise: Advanced ....................................................................................................................... 25
3 User-defined dialogs ....................................................................................... 31
3.1 Introduction to the Dialog Editor .............................................................................. 32
3.2 Event sequences for the dialog ................................................................................. 33
3.3 A first, simple dialog ................................................................................................. 34
3.4 Searching for errors in a dialog ................................................................................. 37
4 Miscellaneous ................................................................................................. 39
4.1 Favorites .................................................................................................................. 39
4.2 Entering a waveform’s Y-unit ................................................................................... 40
4.3 File structure ............................................................................................................ 41
4.3.1 Keys .............................................................................................................................................. 41
4.3.2 Variable types (imc FAMOS Chapter 6.3) ...................................................................................... 41
4.3.3 Data format for results ................................................................................................................. 41
4.3.4 Folders .......................................................................................................................................... 41
4.3.5 Remote calling of a sequence ....................................................................................................... 42
4.3.6 Placeholder ?, * and # ................................................................................................................... 42
4.4 Kits (brief overview) ................................................................................................. 43
Index ................................................................................................................... 0
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
6 Introduction
1 Introduction
The first two days of the training session presented the fundamentals of working with imc FAMOS and of
creating sequences. On this day, the skills already learned will be strengthened. For creating analysis
sequences, there is not only the possibility of including the “little” text boxes and prompts, but also
whole Panels and dialogs. Panels and Dialogs offer substantially more possibilities for user interaction,
allowing the creation of user-defined analyses which can be performed even without imc FAMOS skills.
In the following chapters, you will be introduced to imc FAMOS’ main Panel and dialog elements by
means of concrete examples. Since the functionality of the Panels and dialogs is determined by
sequences in reference to specific elements, this introductory session will also involve practicing the
creation of complex sequences.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
7
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
8 Panel and Data-Browser
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
How to use Panels 9
The Panel pages contain a step-by-step tutorial in blue font. Read the explanations and instructions and
then click on Next. Unfortunately, there is no Back-button.
When you reach the place when the data are loaded, you must go to the Browser-page.
Continue to work through the tutorial to become familiar with the operation of the Panel page.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
10 Panel and Data-Browser
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 11
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
12 Panel and Data-Browser
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 13
3. Select a measurement. Then drag all four channels to the curve window.
4. Right-click the mouse in the curve window and select "Configuration\Display". Display the channels
with their Y-axes stacked one on top of the other.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
14 Panel and Data-Browser
A new channel is calculated. This channel’s Max, RMS and Mean values are determined.
Run these command lines one by one. The results are graphed as they are produced.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 15
2. Display the results in an additional curve window. To do this, drag the channel Level from the
Channels list to the Panel and create an additional standard curve window.
You can place the channel "Level_Smo" by means of the dialog More Waveforms in curve Window. By
means of the filter "Level_s*" in the box "Wildcards", it is easy to find the variable.
3. Select various measurements in succession and test whether the calculated channel is also updated.
Note that the sequence is only run if the Panel is no longer in Design mode .
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
16 Panel and Data-Browser
2. Link the input box with the variable "t_smo" via the variable name. We will set up this link
subsequently but we can already prepare for it. As the text, enter "<VAR.VALUE("#.#")> s". This
placeholder will adopt the value of the variable "t_smo" and format the number to have one decimal
digit. The "s" for seconds simply appears after it.
3. Copy the text box and the input box and insert them again. Repeat the last step for the threshold
specification. The variable's name is "Threshold"; the unit "mm/s^2"
4. In the initialization, create the variable "t_smo" (=1) and "Threshold" (=40).
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 17
8. In order for the variables to take effect, they must be incorporated into the sequence. The sequence
now appears as follows:
Note that the threshold must be divided by a factor of 1000, since the values belonging to Level lie in
the range mm/s^2. The curve window automatically scales the unit m/s^2 to mm/s^2 um.
9. Change the values for the smoothing window width and the threshold and click on the button. As
always, execution of the function can occur only when Design mode is deactivated.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
18 Panel and Data-Browser
3. Click in the cells of the left column and write “Max”, “Mean” and “Duration”. In the right column, set
the link to the single values and under “Text” set the placeholder as " <VAR.VALUE("0.#")> mm/s^2.
Format the table as desired.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 19
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
20 Panel and Data-Browser
Observe the box "Text": "Test Object:". The permanent text "Test Object: " is combined with the contents
of the Variable Test_object.
Proceed in the same way with the variable "Tester" and "Department".
6. The Date box indicates the current date. Enter into the text box just the text" Date: <SYSTEM.DATE>".
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 21
4. Create a "Group box" around the controls. Click the context menu of the group box and set it "To
Backround"
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
22 Panel and Data-Browser
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 23
2. Printout is performed by means of the Panel menu or by means of the toolbar icons.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
24 Panel and Data-Browser
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 25
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
26 Panel and Data-Browser
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 27
; Set markers
CwNewElement("marker") ; Create first marker
CwMarkerSet("x.type", 1) ; physical units
CwMarkerSet("y.type", 1)
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
28 Panel and Data-Browser
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Exercise: Panel pages 29
2. Right-click the mouse over the cross and select the context menu item "Fill". This completely fill the
Panel with the curve window.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
30 Panel and Data-Browser
3. Now change the number of measurements selected. Then change the channels.
Result: The curve window always shows the first channel selected among all the measurement
selected. If an additional channel is selected, it is not displayed.
4. Next, in the curve window open the dialog Configuration > More waveforms...
The curve window shows placeholders which are linked via their index. You can subsequently change
the index for each entry under Adapting channel selection.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
31
3 User-defined dialogs
What are user-defined dialogs?
imc FAMOS contains an editor for creating dialog, similarly to a Panel-page in the Layout "dialog". There
is an extensive library of widgets, which even exceeds the scope of the Panel-widgets. When using the
widgets, events are triggered which can be associated with sequences. In this way, it is possible to design
a FAMOS analysis having a simple input interface. Advanced skills in imc FAMOS are not necessary to use
it.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
32 User-defined dialogs
Toolbox
The toolbox contains the widgets grouped by Standard-elements (buttons, text boxes, etc.), Lists and
tables and Curve window. In the group Menu, the menu structure is set up, whose elements appear as
events in the main window.
Properties
The respective settings available for the selected widgets are listed in the Properties and are edited
there.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Event sequences for the dialog 33
The event Init is triggered once creation of the dialog is concluded. Here, dialog elements are initialized
which are linked with FAMOS variables.
The event End is triggered upon closing the dialog by the function DlgCloseDialog(). it is the last event
triggered by the dialog. Although the dialog is then no longer visible, all dialog elements are still valid. In
this event, it is possible to delete any variables no longer required.
The event Close is triggered when the user wishes to close the assigned dialog at runtime by means of
the function DlgCloseDialog(). With this event, it is possible to have automatic validation of user inputs.
In case of input errors, the user is informed and the dialog can only be closed once all inputs are valid.
Below this, the widget's events are entered.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
34 User-defined dialogs
Procedure: 1. Create a new project for the dialogs, and use the name SimpleWaveform.
2. Start the Dialog Editor (menu item Extra : Dialog-Editor or the toolbar button ).
3. Create a dialog with the view as in fig. below. To do this, first set the title bar content
under the Properties for a dialog to "Static parameters" . Then add buttons and the
curve window from the toolbox. The symbols on the buttons are entered as part of
the properties “image” for the respective buttons.
The names of the added elements are decisive for controlling the sequence
structure. For this reason, name the buttons as follows:
BN_Load – for the Load button
BN_Calculation – for the Calculate button
CV_Curve1 – for the curve window
4. Save the dialog under the name “Simple1”
5. Now for the functionality:
Create sequences of which the sections produce the corresponding results. Toward
this end, it is possible to carry out the command lines step-by-step while making
them, in order to save work typing.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
A first, simple dialog 35
Calculation
Here is where calculations are performed
Maximum = max(<VG:DataSet>)
Minimum = min(<VG:DataSet>)
Mean_value = Mean(<VG:DataSet>)
; Search peaks
VG:PosRelmax = xmax(hyst(<VG:DataSet>,1),-1e20)
VG:valuerelmax = value(<VG:DataSet>,VG:posrelmax)
RelativeMaxima = XYOf(VG:PosRelmax,VG:valuerelmax)
Click to "Topic" and go to the "Lines..." and mark the points for "RelativeMaxima" with thick dots.
Save the configuration as "MaxMinMean.ccv".
Initialization
Now we can fill out the Initialization. Here, the variables used/generated in the sequence are deleted.
This ensures that upon starting a dialog, there are no impeding values in the sequence. Also, the
previously saved configuration is loaded.
; Dialog for calculating statistical variables
; The sub-group VG for local variables is used
; If the dialog is used in conjunction with other sequences
; pay attention to potential crossover effects in the following lines
del RelativeMaxima
del maximum
del minimum
del mean_value
del VG
; for the curve window, the CCV is opened
; as a precaution
VG:error = CvConfig("CV_Curve1","MaxMinMean.ccv")
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH
CwSelectWindow("CV_Curve1") imc FAMOS III, 12th Edition - 2017-02-15
End
36 User-defined dialogs
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Searching for errors in a dialog 37
After such a breakpoint, it is possible to use Shift+F7 or the corresponding icon or command in order
to subsequently continue the dialog normally.
Assignment: Change the dialog from Chapter 2.3 so that when a new additional waveform, it will also
be displayed.
Procedure: 1. Open the dialog from the chapter above, load a file and perform a calculation. Now,
before opening another waveform, select "Interrupt (upon next next command)" from
the task bar. Now load the waveform and observe why it is not displayed as the
sequence unfolds one step at a time.
2. Next, load the waveform. imc FAMOS jumps to the first row in the event "Load data".
Now observe the sequence as it is executed step-by-step why it is not displayed.
3. The cause is indicated by the value of the variable VG:replaced, which is a zero,
although a waveform actually is to be replaced. The reason is that CwReplace is trying
to find the position "slope". However, after the last loading, this is no longer available.
4. As a remedy, repeat the loading of the curve configuration. To do this, paste the
command line VG:error = CvConfig("CV_Curve1","MaxMinMean.ccv") from
the Initialization in front of the line with CwReplace.
Save the dialog under the name "Simple2"
Result: Now each time the Load button is pressed, the loaded waveform is displayed in the curve
window.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
38 User-defined dialogs
In particular when creating dialogs for other users, it is necessary to pay close attention that no errors
arise from the fact that the user has almost unlimited choice in the order in which to select list elements
or to press buttons, or to initiate other actions.
Another common source of errors in using dialog is that elements of the graphical display are renamed
after already having been assigned permanent names in the sequence part. In this case, imc FAMOS
opens a new curve window instead of updating the curve window in the dialog.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Favorites 39
4 Miscellaneous
4.1 Favorites
How is a new function group created?
· Right-click on mouse: New group
How is a function key created?
· Right-click on mouse: New entry
How do I transfer my personal favorites to a different computer?
· In the folder IMC\Bin there is a program named Xconfig.exe. This can be used to save either all or
selected imc FAMOS settings in a file. This file is then loaded by the same program to the target
computer.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
40 Miscellaneous
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
File structure 41
4.3.4 Folders
- How can the default folders be changed?
o Extras Þ Options Þ Folders
o Within a sequence by using LDIR or better yet SetOption
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
42 Miscellaneous
? imc FAMOS supports the placeholder “?”. For instance, if you wish to load all waveforms from
sintest1 through sintest5, simply enter LOAD sintest?.
The placeholder “?” can be positioned anywhere, but there may only be one at a time.
* The placeholder “*” is different from “?”, which does not only stand for one letter, but for all
subsequent ones. LOAD s* loads all waveforms whose first letter is an “S”.
The placeholder “*” can be used at any position and even multiple times, e.g. LOAD *test*
It is also possible to mix the two placeholders. DELETE k?l* deletes all waveforms beginning with a
“k” and whose third letter is an “L”.
# The placeholder “#” stands for sequential numbers. THIS FUNCTION ONLY APPLIES TO SEQUENCES!
Example: Within a sequence, you perform a calculation on more than one result waveform having the
same name. Add an “#” in order to ensure that your results are not overwritten.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
Kits (brief overview) 43
Time to Stamp ASCII: File format for writing ASCII texts with time base. Þµ-Musycs( J-Bus)
· tsa_channel= TsaCreateEmpty( 0.0, 1e-3, "s")
· TsaAppendText(tsa_channel, "Alarm1", 11)
· TsaAppendText(tsa_channel, "Alarm2", 12)
Curves
· Remote control devices for editing of the curve window
Report Generator
· Remote control commands for filling out a report
File-Kit
· Functions for file and folder handling
Panels
· Remote control of panels.
Dialogs
· Remote control for user defined dialogs.
Excel
· Remote control to read and write Excel-sheets.
Video Player (ab Professional)
· Remote control for playing video files.
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15
44 Miscellaneous
© 2017 imc Meßsysteme GmbH, imc Test & Measurement GmbH imc FAMOS III, 12th Edition - 2017-02-15