Professional Documents
Culture Documents
Miniprof Software Manual
Miniprof Software Manual
Technical Reference
Author
Jens Christian Rodi Hansen
Reviewers
Jane Nielsen
Jens Skouboe Poulsen
MiniProf for Windows
Editor
Technical Reference Jens Christian Rodi Hansen
Layout
Version 2.4 Jens Christian Rodi Hansen
Copyright° c 1997-2008
Greenwood Engineering A/S
First Edition, January 2008
www.greenwood.dk
Copyright notice
MiniProf for Windows Version 2.4 Copyright°
c 1997-2008, Greenwood Engineering A/S. All
rights reserved.
License Agreement
1. License. This agreement grants any owner of MiniProf measurement equipment a
license to use the software, MiniProf for Windows, for performing measurements and
for analyzing the measurements and results. In addition, the software may be used on
any number of computers for post-processing measurements without charge.
2. Restrictions. The software contains trade secrets and in order to protect them the software
may not be decompiled, reverse engineered, disassembled, or otherwise reduced to a
human perceivable form. Furthermore it is not allowable to modify, adapt, translate,
rent, lease, resell for profit, distribute or create derivative works based upon the software
or any part thereof.
Disclaimer of Warrenty
THIS SOFTWARE AND ACCOMPANYING WRITTEN MATERIALS ARE PROVIDED
“AS IS” WITHOUT WARRANTY OF ANY KIND. FURTHERMORE, GREENWOOD
ENGINEERING A/S (GE) DOES NOT WARRANT, GUARANTEE OR MAKE ANY
REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF USE, OF THE
SOFTWARE OR WRITTEN MATERIALS IN TERMS OF CORRECTNESS, ACCURACY,
RELIABILITY, CURRENTNESS ETC. THE ENTIRE RISK AS TO THE RESULTS AND
PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU. IF THE SOFTWARE
OR WRITTEN MATERIALS ARE DEFECTIVE YOU, AND NOT GE OR ITS DEALERS,
DISTRIBUTORS, AGENTS, OR EMPLOYEES, ASSUME THE ENTIRE COST OF ALL
NECESSARY SERVICING, REPAIR OR CORRECTION.
NEITHER GE NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION,
PRODUCTION OR DELIVERY OF THIS PRODUCT SHALL BE LIABLE FOR ANY
DIRECT, INDIRECT, CONSEQUENTIAL OR INCIDENTAL DAMAGES (INCLUDING
DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS
OF BUSINESS INFORMATION, AND THE LIKE) ARISING OUT OF THE USE OR
INABILITY TO USE THE SOFTWARE EVEN IF GE HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
C ONTENTS
Contents i
List of Tables v
Introduction 1
Multilingual support 21
5.1 Translating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Index 23
Contents i
ii Contents
L IST OF F IGURES
List of Tables v
vi List of Tables
C HAPTER 1
I NTRODUCTION
The Technical Reference to MiniProf for Windows is intended as a help for the advanced user.
Its main purpose is to document the more technical elements related to the software. This is
done to enable a larger integration with other applications and to make it possible to extend
the software’s functionality by adding and altering the configurations.
This reference includes file-format descriptions for measurement-files, result-files and reference-
files generated and used by the MiniProf software. It also includes a small description on how
to get the software translated to other languages.
Chapter 1: Introduction 1
2 Chapter 1: Introduction
C HAPTER 2
Measurements made with the MiniProf software can be stored in two different formats,
depending on the equipment used and the measurements made. The main difference between
these formats is the number of profiles that a single file contains. Each format is described in
the following sections.
The single measurement file contains information and measurement data for one single profile.
It is an ASCII formatted text file divided into two parts: a header with information about the
measurement and the data with the actual measured points. At least one empty line divides
the two parts. Please note that the header can be left entirely out of a measurement file. The
file is in that case initiated with one or more empty lines.
The format of the header depends greatly on the version of the program which has written
the file. There are basically two different formats: the old and the new. The old format, used
by the Dos software versions prior to MP35, writes a number of lines like shown in Figure 2.1
below.
As a part of the latest version of the Dos based software MP35, a new and more generalized
format for the header was defined. This is also the native format used in MiniProf for Windows
version 2, though this software also supports partial extraction of the information from old
headers, mainly to give a greater level of backward compatibility.
The new format splits each header-line into two parts divided by an equal sign. The left part
is called the field-name and the right part is called the field-value. This formatting is also very
similar to the configuration files used by windows (known as ini-files). Figure 2.2 below shows
an example of how the old header would look in the new format.
MPTypeNo=130
MPSerNo=221
Date=1996/7/2
Filename=23090011
Stock=
CarNo=
AxleNo=
WheelID=
FlangeDia=1249.592
Taperline=1188.179
OffsetY=-44.360
Sd=31.98
Sh=30.71
qR=10.74
The field-name and field-value can contain any character, except the equal sign and characters
with ASCII codes below 32. Field names must be at least 1 character long and they should be
unique. Field values can be any length, including empty. See the later section on field identifiers
for a list of standard identifiers as they are defined and used in MiniProf for Windows.
In the data part of the measurement file each line represents one measured point. The contents
of these lines vary depending on the version of the program that wrote the data. The ColumnDef
field holds the column definition used to identify which columns contain what. The field contains
a comma seperated string of characters, one for each column, as described in the table below.
If the ColumnDef field is not present in the header, which is the case for older measurement
files, assume two columns with X and Y coordinates.
There is no way to tell how many points are present in the data part, without reading through
all the data. Even when a field in the header indicates the number of points, it should not be
used as an exact measure.
When measuring multiple profiles related to each other (for instance measuring a switch), it is
not ideal to get the measurements stored in multiple files, but instead in one single file, keeping
all the information together. The multiple measurement files are also known as TwinHead files,
because the format was designed for use with the TwinHead equipment. Actually the format
turned out to be very useful for other purposes, such as switch measurements.
A multiple measurement file places the data from a number of single measurement files into a
single file. To do this, the file is divided into a number of major sections, each initiated with a
label encapsulated by square brackets. See the example below in Figure 2.4.
[Profile1Info]
MPTypeNo=130
MPSerNo=221
Date=1996/7/2
Filename=23090011
..
[Profile1Points]
0.71 18.03 1.489
0.73 18.23 1.489
..
[Profile2Info]
..
[Profile2Points]
..
The FileInfo section contains information, which is global for the entire file. The sections named
Profile1Info and Profile1Points contains the header and data for the first profile formatted as
described for single measurement files. All headers, including the file header, use the new header
format.
There is no way to determine the number of profiles stored in a file, without reading through
and interpreting the entire file. It is not even possible to start from the tail of the file to find
the last section, using it to find the number of profiles, because there is no guarantee of order
in which the sections are placed.
The field id is used as the key for accessing information from the profile header. Below follows a
list of all the standard identifiers. All identifiers marked with a star (*) are considered reserved
to the MiniProf software and should not be used for other purposes.
Though field identifiers used to store results from calculations can be changed in MiniProf for
Windows, their standard id’s have been included in the list.
Measurement files can be stored in a compressed binary format with MiniProf for Windows
Version 2.2 or later. This compression will typically reduce the file size with about 50 percent.
The exact format of these files will, for the moment, remain confidential.
Results files created with the MiniProf for Windows software can be stored in two different
formats, depending on the number of results contained in the file. Each format is described in
the following sections.
The single result file contains information and result data for one single result. It is an ASCII
formatted text file divided into two parts: a header with information about the result and the
data with the actual result points. At least one empty line divides the two parts. Please note
that the header can be left entirely out of a result file. The file is in that case initiated with
one or more empty lines.
The header is formatted similar to the header of a measurement file. This format splits each
header-line into two parts divided by an equal sign. The left part is called the field-name and
the right part is called the field-value. This formatting is also very similar to the configuration
files used by windows (known as ini-files). Figure 3.1 below shows an example of how a result
header could look.
The field-name and field-value can contain any character, except the equal sign and characters
with ASCII codes below 32. Field names must be at least 1 character long and they should be
unique. Field values can be any length, including empty.
In the data part of the result file, each line represents one point. The contents of these lines
vary depending on the type of result stored. The ColumnDef field in the header defines the
sequence of the columns. Use the column descriptions (ColumnX... and ColumnY...) to locate
the columns of interest.
There is no way to tell how many points are present in the data part, without reading through
all the data. Even when a field in the header indicates the number of points, it should not be
used as an exact measure.
A result file can, just as measurements files, contain multiple results. To do this, the file is
divided into a number of major sections, each initiated with a label encapsulated by square
brackets. See the example below in Figure 3.3.
[FileInfo]
ProgramName=MiniProf for Windows
ProgramVer=2.1.12
..
[Result1Info]
ColumnDef=X1,X2,Y1
ColumnX1Name=Tangent angle
ColumnX1Flag=
ColumnX1Form=%.*f◦
ColumnX1Unit=deg
..
[Result1Points]
-90.1494 0.0000 12.3643
-89.8679 0.1377 12.3643
..
[Result2Info]
..
[Result2Points]
..
The FileInfo section contains information, which is global for the entire file. The sections named
Result1Info and Result1Points contains the header and data for the first result formatted as
described for single result files.
There is no way to determine the number results stored in a file, without reading through and
interpreting the entire file. It is not even possible to start from the tail of the file to find the
last section, using it to find the number of results, because there is no guarantee of order in
which the sections are placed.
Result files can be stored in a compressed binary format with MiniProf for Windows Version
2.2 or later. This compression will typically reduce the file size with about 50 percent. The
exact format of these files will, for the moment, remain confidential.
The MPT format was developed in order to make it possible to use mathematical defined
reference profiles in the MiniProf software. Reference profiles can be specified much more
precisely in this way, and the inaccuracy on calculations will at the same time be minimized.
MPT files was originally designed from a subset of the commands used in DXF files, which
easily can be generated by AutoCAD and other CAD applications. More elements have been
added now, making it even more usable than the DXF format. The MiniProf software can
import DXF and export the profile to a MPT reference, but if elements like the polynomium
is required (which is not available in the DXF format) the MPT have to be written manually.
MPT files use a very simple text-based format, in which files are read line by line and empty
lines are ignored. The contents of a single line can be classified entirely by the first character.
The table below describes the format for the elements in the individually lines.
All numbers are represented as floating point with a precision of seven decimals. The period
sign is used to separate the integer part from the fraction part. All coordinates are stated in
millimeters and angles for arcs and ellipsis are given in degrees in the interval -360◦ to 360◦ .
E xc yc ra rb v2 v1 v0 Places an ellipsis in (xc ,yc ) with the major axis ra and miror axis
rb , starting in v1 and ending in v2 . The ellipsis major axis is
rotated v0 relative to the coordinate system.
Note: The format code ‘P’ have been given a new meaning in MiniProf for Windows
Version 2.2 and above. Previously the code denoted a point, which was a redundant type.
If a reference is formed by a series of points, it is not really a mathematical precise definition,
and it should be stored in the measurement file format instead. If, for some reason, points
are needed in a region of a profile, define these using lines.
The reference can be defined either asymmetrical or symmetrical. For asymmetrical references
all parts of the references must be defined. By symmetrical references however only the left or
right part needs to be defined. The software will automatically generate the remaining part of
the reference by mirroring along a vertical line, which goes through the coordinate (0,0).
To complete this description, Figure 4.1 below shows an example of an MPT reference file. The
file defines a symmetrical rail profile reference named UIC60.
M ULTILINGUAL SUPPORT
The MiniProf for Windows software has been designed to support multiple languages. The
following sections describe how to get the software translated and how to install a new language.
5.1 Translating
All the text which needs to be translated is located in an Excel file found on the CDROM in the
language folder. Use Microsoft Excel to edit the contents of the files. There are some essential
things, which must be considered during the translation.
1) Each line in the files is used separately by the software. Therefore, do not break a line
into two or more lines. Also do not insert new lines or delete any of the existing.
2) Some of the lines include the ‘|’ character, which must be preserved. It divides the line
into two parts, where the first gives a short description for some function and the last is
a longer description for the same function.
3) All the text used in menus and on buttons uses the ‘&’ character to indicate which letter
will be highlighted with an underscore. Place this character carefully and make sure that
all items in one submenu have a unique highlighted letter.
4) Some of the text includes formatting codes, which should be preserved. The codes are
all encapsulated by curly brackets (‘{’ and ‘}’). As an example, the text “Press the
{b1}Cancel{b0} button” will be displayed as “Press the Cancel button”, making the
word Cancel appear bold.
When the translation is complete, mail the translated files to us, preferable as e-mail. The
addresses can be found in the back of this manual. We will then generate the language files,
verify that they work, and return them as fast as possible.
D S
Data format . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 14
Single measurement file format . . . . . . . . . . . . . . . . .3
Data format . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Header format . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Single result file format . . . . . . . . . . . . . . . . . . . . . 13
F Data format . . . . . . . . . . . .
Header format . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 14
. 13
Field identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
T
H The file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Translating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Header format . . . . . . . . . . . . . . . . . . . . . . . . . . 3, 13
I
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
M
Measurement file formats . . . . . . . . . . . . . . . . . . . . .1
Compressed format . . . . . . . . . . . . . . . . . . . . . . . 11
Field identifiers . . . . . . . . . . . . . . . . . . . . . . . . . .6
Multiple measurement file format . . . . . . . . . . . . .5
Single measurement file format . . . . . . . . . . . . . . .3
Multilingual support . . . . . . . . . . . . . . . . . . . . . . . 19
Translating . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Multiple measurement file format . . . . . . . . . . . . . . .5
Multiple result file format . . . . . . . . . . . . . . . . . . . . 14
R
Reference file format . . . . . . . . . . . . . . . . . . . . . . . 16
Index 23