Professional Documents
Culture Documents
Beatscope - Ug - Manual
Beatscope - Ug - Manual
Beatscope - Ug - Manual
User’s Guide
© 05/2002 FMS
0344
2 BeatScope 1.1, User’s Guide
Finometer, Portapres, Modelflow and BeatScope are manufactured and sold by:
Information in this document is subject to change without notice and does not
represent a commitment on the part of FMS. The software described in this User’s
Guide is furnished under a license agreement. The software may be used only in
accordance with that agreement.
WARNING:
Table of Contents
1. Introduction......................................................................... 9
1.1 TNO TPD Biomedical Instrumentation .................................................. 9
1.2 Finapres................................................................................................... 9
1.3 Portapres ............................................................................................... 10
1.4 Modelflow method................................................................................ 10
1.5 Finometer .............................................................................................. 11
1.6 BeatScope ............................................................................................. 11
1.7 Beat analysis software........................................................................... 12
1.8 Release notes......................................................................................... 13
1.9 Document conventions.......................................................................... 14
1.10 Customer support .................................................................................. 15
2. Installation ........................................................................ 17
2.1 Operating system................................................................................... 17
2.2 Installing BeatScope on your system .................................................... 17
2.2.1 De-installing a previous BeatScope version.................................. 17
2.2.2 Installing BeatScope 1.1 ............................................................... 18
2.2.3 Copy protection............................................................................. 18
3. Quick tours........................................................................ 21
3.1 Quick tour 1: The selection dialog........................................................ 21
3.2 Quick tour 2: Analyzing a (Portapres) measurement. ........................... 22
3.2.1 Analyzing a Portapres file with Beatfast ....................................... 23
3.2.2 Printing beat-to-beat data with Printres......................................... 27
3.3 Quick tour 3: Viewing data files and exporting data............................. 29
3.3.1 User interface of BeatScope's View Files window........................ 30
3.3.2 Opening data files ......................................................................... 32
3.3.3 Selecting signals in the viewports. ................................................ 33
3.3.4 Browsing in the data file ............................................................... 35
3.3.5 Selecting an episode between two event markers.......................... 36
3.3.6 Exporting beat results to a file ...................................................... 37
4. Data files used by BeatScope .......................................... 39
4.1 Binary samples files .............................................................................. 39
4.1.1 TNO samples file .......................................................................... 39
4.1.2 'Other' binary samples files ........................................................... 40
4.2 Portapres Model 2 compressed files ..................................................... 41
4.3 Beat-to-beat results files........................................................................ 41
4.4 Finometer files ...................................................................................... 43
4.5 Text data files ....................................................................................... 43
4.5.1 ASCII samples files ...................................................................... 43
6 BeatScope 1.1, User’s Guide
1. Introduction
Welcome to BeatScope, the software package for the analysis of blood pressure
waveforms. This chapter introduces you to BeatScope, to the developers of
BeatScope, to the Finapres, Finometer and Portapres devices and to the remaining
chapters in this User's Guide.
1.2 Finapres
1.3 Portapres
The Portapres blood pressure device is similar to Finapres and developed by BMI.
Portapres has a number of features that make the device suitable for ambulatory
use.
• The device is light weight and battery powered
• Portapres measures blood pressure in two (adjacent) fingers. By pressurizing
the finger cuffs alternately the slight discomfort when a cuff is wrapped around
a finger longer than about an hour, can be prevented.
• Portapres uses a hydrostatic height correction system to compensate for
vertical movement of the hand with respect to heart level and the concomitant
pressure changes in the finger blood pressure.
• Portapres stores the data of 24 hr finger arterial blood pressure waveform,
hydrostatic height, event marker, and status messages on its built-in Flash
Memory Card.
• A Control unit is used to enter data, to set-up the device and to start a
measurement. During a measurement this unit may be disconnected. This
reduces the overall weight of the device.
Several different Portapres versions were built in the past few years with additional
features for various space agencies, including NASA and ESA. They have their
own dedicated PC software user interface programs, which are not discussed here.
This document refers only to our standard Portapres M2.
The Modelflow method has been implemented in two pressure wave analysis
software programs developed by TNO TPD Biomedical Instrumentation:
1.5 Finometer
The Finometer is a blood pressure device similar to Finapres, but with a number of
significant extensions.
• Finometer offers the non-invasive monitoring of continuous brachial artery
blood pressure, based on the finger arterial pressure measurement as
implemented in Finapres and Portapres, and published pressure waveform
reconstruction and calibration methods.
• Cardiac output, based on the Modelflow cardiac output method, and other
haemodynamic data are available in real time on a built-in color display.
• Similar to Portapres the Finometer is equipped with a height correction
system, a built-in disk for data storage and a serial interface with a PC.
1.6 BeatScope
BeatScope is a Windows program which integrates a number of modules:
• to control measurements performed either with Portapres or Finometer,
• to monitor in real time Portapres pressure and cardiac output via the Beatport
module and to monitor Finometer measurements with the Finolink module.
• to analyze off-line the pressure waveforms; this step is not necessary for
Finometer, since this analysis is performed within the device.
• to output the derived beat-to-beat data as a table to either a file or a printer
with the Printres module
• to print a standardized stripchart plot of the beat-to-beat data
• and to help the user with the data analysis by displaying event information, and
descriptive statistics
12 BeatScope 1.1, User’s Guide
The Beatfast program scans fully automatically one channel in a samples file for
the presence of waveforms that look like arterial pressure pulsations or beats. The
fundamental feature detected for a pulsation is its begin upstroke. Once the begin
upstroke is detected further parameters are derived from a pulsation. Obvious ones
are the systolic and diastolic pressure levels. They are detected on the low pass
filtered waveform and are thus reliable even when 50/60 Hz hum and high
frequency noise components are present on the waveform. Systolic pressure is the
highest pressure during arterial systole. Diastolic pressure is not taken as the lowest
pressure in a pulsations, since that may lead to erroneous levels at high heart rates.
Instead, the value just before begin upstroke is taken. Mean arterial pressure is
computed as the true integrated mean pressure per beat. The time lapse between
two consecutive pulsations is the pulse interval and its inverse is pulse rate.
The other feature detected in a pulsation is the dicrotic notch at the end of left
ventricular ejection. The time lapse between begin upstroke and notch is the left
ventricular ejection time.
Finally, the pressure pulsation is fed to a model of aortic input impedance and the
aortic inflow is computed by simulating that model. This flow pulsation is
integrated over the period between begin upstroke and notch to yield stroke
volume. It is then simple to compute cardiac output per beat and total peripheral
resistance. This is called the Modelflow method. It provides reasonably close
values of stroke volume and cardiac output in an absolute sense (SD 15%), and is
very accurate in tracking changes in stroke volume (SD 7%) [WESSELING 93,
JANSEN 2001]. See also Appendix D for an overview of recommended literature.
BeatScope 1.1, User’s Guide 13
Keyboard combinations:
Style: Description:
KEY Indicates that you have to press the key. For example
F5 means that you have to press the function key F5.
KEY+KEY Indicates that you should press and hold the first key
while pressing the second key. CTRL+X means that
you should press and hold the CTRL key and press X,
and then release both keys.
Dialog box
Combobox
Radio buttons
Combobox Combobox
Notebook tabs
Buttons
E-mail address:
info@Finapres.com
WWW site:
www.Finapres.com
Mail address :
FMS, Finapres Medical Systems BV
Simon Stevinweg 48
6827 BT Arnhem
The Netherlands
T: +31 (0)26 384 9080
F: +31 (0)26 384 9081
2. Installation
For optimum performance, BeatScope requires a Pentium 120 MHz system with at
least 10 Mb of hard disk space.
BeatScope 1.1 can either be used with a license key (dongle) mounted on the
parallel port or with a software license ‘key’. It is not necessary to have the license
key connected during the installation process.
Please note that both Finometer and Portapres are supplied with a serial interface
cable with 9 pin subD connectors. This cable is for serial communication only. The
license key should be attached to the parallel (printer) port of your PC. It is
possible to connect a printer to the free side of the key.
BeatScope 1.1, User’s Guide 19
If a BeatScope hardware license key (dongle) is present on the parallel port and
BeatScope generates an error message like the message displayed in Figure 2.1,
you should check:
• The correct installation of the license key driver. If an error occurred during
installation, e.g. because the current login account on Windows did not allow
the installation of the driver, the error message is generated.
To re-install the license key driver:
• Run the file setup.exe in the directory c:\program files\beatscope\driver
• Some printer port settings in the computer BIOS do not allow two-way
communication between port and license key or printer. As a consequence the
driver on the PC is not able to communicate with the license key on the
parallel port.
• The license key may be defective.
To register BeatScope:
• First find your BeatScope license number. This license number can normally
be found in the delivery note of your Portapres or Finometer system. An
example of a license number is “20020555”
• Start BeatScope and click the ‘Registration’ menu item in the ‘Help’ menu.
• Fill-in the ‘Registration form’, make sure you did enter the License number
20 BeatScope 1.1, User’s Guide
• Then, either
- save the form to disk and E-mail the file contents to info@finapres.com, or
- print the form and fax it to Finapres Medical Systems: 00-31-26 384 9081
One of the fields in the Registration form is automatically filled with a site code
that is linked to the hardware of the computer running BeatScope.
After sending the Registration Form you will obtain the ‘unlock code’ within a few
working days.
Transfer license
If you want to install BeatScope on another computer, or if you want to change e.g.
the hard disk in your computer, you will have to transfer the software license from
one computer to another. To do so you do not need to contact the manufacturer,
but you can transfer the license yourself using a diskette.
To transfer a license:
1. Prepare an empty, formatted, 3.5” diskette
2. Start BeatScope
3. Click on ‘Transfer License’ in the Help menu
3. Quick tours
To help you get familiar with the options of BeatScope this chapter describes three
quick tours to explore BeatScope:
1. Starting BeatScope, exploring the Selection dialog
2. Analyzing a Portapres measurement and printing its results.
3. Viewing data files and exporting data.
• View files
- To view files,
- To make selections in these files,
- To export data,
- To print,
- To obtain simple descriptive statistics etc.
• Portapres
- To monitor a Portapres measurement on-line,
- To download data from Portapres off-line,
- To decompress Portapres M2 data files,
- To merge interrupted Portapres measurements.
• Finometer
- To monitor measurements with Finometer
- To download the data
- To unpack the compressed Finometer files
• Beat analysis
- To analyze Portapres files or other samples files for beats,
- To output the beat-to-beat results to a printer or a file,
- To create a stripchart plot of the beat results.
• Utilities
- To extract an episode of data from a data file,
- To edit and to run batch command files.
This is a good time to try the various command buttons and see the accompanying
dialogs.
Click on one of the selection tabs to select a page of the notebook. To select a
command either type the underlined character in the button text or click the button.
Each dialog has a Close or Cancel button in the right bottom part of the dialog
window. To close a dialog click the Close button or press ESC.
In this quick tour we will do a beat-to-beat analysis with the program Beatfast on a
samples file. Then we will print the beat results.
BeatScope 1.1, User’s Guide 23
For the example we need a data file with a sampled arterial pressure waveform. In
the BeatScope directory (C:\PROGRAM FILES\BEATSCOPE) a data file
EXAMPLE.DAT can be found. This file is a Portapres M2 data file, containing a
finger pressure waveform signal, a hydrostatic height correction signal and run
time events. The file duration is about 5 minutes.
Please note that this beat-to-beat analysis is not necessary for a Finometer packet
file, since the results of the Modelflow cardiac output analysis are embedded in the
file, provided you did enter the correct subject data and configuration information.
If you need to redo the beat-to-beat analysis of a Finometer measurement you
should first unpack the Finometer file and perform the analysis on the file
containing the sampled waveform.
browse button
Input file
browse button
Output file
Note After providing the name of the input file, the Portapres M2 file is
interpreted automatically, and data such as the number of channels, sampling
frequency, channel containing the pressure waveform are filled by BeatScope.
After you fill the input file name an 'Output file' box is shown.
2. Enter the name of the output file in the 'Output file' box:
- type the name of the file, or
- click the browse button at the right of the output file drop-down list, or
- click on the Create output name button. The last used output directory is
combined with the filename without extension. Finally the Beatfast default
extension .R00 is added to the name.
Note 1 It is recommended to use the same file name with a different extension.
Beatfast’s default extension for an output file is .R00 so we will use the output file
name EXAMPLE.R00 in this example.
Note 2 During a beat-to-beat analysis both a binary results file (.R00 extension)
and an ASCII text results file (.A00 extension) are generated. The binary file is
compatible with BeatScope 1.0, the other file contains all beat-data in a format that
can easily be used in a spreadsheet program without the need to convert the binary
file first to text format.
Now we have defined the name of an input file and of the output file.
• The cardiac output model used by Beatfast is Modelflow, not the formerly
used TNO Pulse contour method,
• The initial cardiac output calibration is set to 100 %
• The finger pressure analysis –finger arterial pressure, since
EXAMPLE.DAT is a Portapres file- is performed without additional
filtering to brachial pressure or other more advanced options.
After clicking the Run button BeatScope runs the program Beatfast. The following
run time screen is displayed during the analysis.
During the beat-to-beat analysis, no user interaction is required. Please refer to the
chapter on Beatfast if you want to get more information about Beatfast's run time
screen. It is however possible to configure the run time screen during the analysis
by pressing:
26 BeatScope 1.1, User’s Guide
• F1 To read a help text in the lower panel of the Beatfast run time screen. Use
PAGE UP and PAGE DOWN to browse through the help pages.
• F3 To change the scaling of trends and pressure signal. Use the arrow keys:
- to change pressure scaling
- to change the type and scaling of the left and right axis of the top trend
panel
- to change the time scaling
• F4 To select a channel in the input file to display. In a Portapres file the first
channel is finger pressure the second is the height correction signal.
• F6 To show beat-to-beat variables:
At the end of the analysis, the Beatfast window is automatically closed and the
Beatfast dialog is re-displayed. Close the Beatfast dialog with the Close button.
Beatfast has now created a beat-to-beat results file EXAMPLE.R00. The data in
this file are stored in a binary format, which means that you cannot view the file
directly with a text editor.
BeatScope 1.1, User’s Guide 27
Sometimes, however, you need to output the beat results in a different way,
perhaps with the time of day instead of the time in seconds relative to the start of
the measurement, or with averaging applied, or without column labels etc. These
options can be found in the Printres (Print Result file) option of BeatScope.
First select the beat-to-beat results file EXAMPLE.R00. The easiest way to select
this file is to use the small arrow down file history button, which is part of the
drop-down list box. Select the file EXAMPLE.R00 from the list. You can also
click on the browse button at the right of the Beat results file input field and select
the file from a directory. BeatScope now fills the input fields in the dialog box,
based on the information in the beat-to-beat results file.
28 BeatScope 1.1, User’s Guide
Subject data displays age, gender, height and weight of the subject This
information can not be changed. If you want to change subject data the beat-to-beat
analysis has to be repeated.
In this third quick tour we will open the Portapres file EXAMPLE.DAT that we
used before to demonstrate the beat-to-beat analysis with Beatfast. We will also
open the beat-to-beat results file EXAMPLE.R00 and view signals of both files.
You will learn how to browse in files, and how to view the numerical values of the
beat results file without the need to run the Printres option that was used in Quick
Tour 2.
30 BeatScope 1.1, User’s Guide
Speed bar
View Port 1
View Port 2
Time Control
• The File menu contains options to open and close data files, to export
data, to load and save BeatScope sessions, to Print viewports and to Exit
the program.
• The View menu contains options to change the visual appearance of the
BeatScope window, i.e. the number of viewports and the signals to be
displayed in the viewports.
• The Data menu provides tools to enable time or beat averaging in data
files, to do descriptive statistics and to hide certain types of events from
data files.
• The Timing menu enables you to change the time format used in all plots
and dialogs, and to define a new time window to view the data files. The
normalize time option can be used to adjust the current time window so
that the ticks at the time-axis are at 'nice' rounded values.
• The Options menu allows you to configure BeatScope, to load/unload a
text (event file) file with a time string in the first column and a text string
in the second column. This option is a convenient way to display your
own markers/events in the plots.
• The Help menu gives quick access to BeatScope's help file.
• Speed Bar contains a number quick access buttons to invoke frequently used
menu options.
• Time Bar can be used:
- Browse a full page to the left
- To browse a half page to the left
- To browse a half page to the right
- To browse a full page to the right
- To zoom in (time window period is halved)
- To zoom out (time window period is doubled)
• Status Bar provides one-line help information, current patient data and
current time and date
32 BeatScope 1.1, User’s Guide
Directory
File name
File directory
mask
Displaying a The beat-to-beat data found in either the first beat-to-beat file or the first Finometer
numerical file that is opened can be displayed in a special Beat Results window which is
beat results available to browse in the numerical output of the beat result data. Use the View,
window Beat results option to display the numerical beat results window.
Each time the File Open Dialog is opened, BeatScope assumes that you are going
to open a file from a different measurement, and thus default assumes that the
BeatScope 1.1, User’s Guide 33
currently opened files have to be closed. To prevent BeatScope from closing these
files, remove the checkmarks in the checkboxes with open files. You can also use
the button ‘Leave files open’ for that purpose.
You can also use the following method to open both files:
To open both the Portapres and the beat results file at the same time:
• Open the BeatScope File Open Dialog
• Type e.g. EXAMPLE.* in the filename field, or select the ‘Any file *.*’ file
type.
• Select both files, while pressing the Ctrl key, both files are highlighted and the
filename field will show “EXAMPLE.DAT” “EXAMPLE.R00”.
• Click the Open Button to open the files.
• The first two signals of a Finometer packet file are the pressure waveform used
for the on-line beat analysis (usually finger arterial pressure) and the
hydrostatic height correction signal.
Each viewport can display up to four signals, the number of viewports can be four,
so BeatScope can display maximally 16 signals simultaneously. To change the
signal selection:
• Click on one of the four signal selection buttons at the top of each viewport, or
• click View and then Setup viewport #, where # is a number 1..4, in the menu.
Note that the signal name is always appended by the @ symbol followed by the
filename (e.g. Porta@EXAMPLE.DAT).
Signal
Scaling
Click tabs to define up
to four signals
The Signal selection dialog displays a notebook with four selection tabs. The tabs
correspond with viewport axes:
• The first tab from the left (and the first selection button at the top of each
viewport) is related to the left axis of a viewport.
• The second tab (and selection button) is related to the axis at the right of a
viewport.
BeatScope 1.1, User’s Guide 35
Each selection tab of the Signal selection dialog gives access to the following
options:
Signal The signal drop-down list enables you to select a signal in BeatScope. The
number and type of signals available depends on the files that are currently open in
BeatScope.
Scaling The scaling box enables you to set the scaling for the selected signal. If
you check the Auto checkbox the range of the signal is calculated before the data
are displayed. If necessary BeatScope adapts the scaling to get a full viewport
view.
Color The color box enables you to select one of 15 colors or Auto Color
meaning that BeatScope will assign a default color to the selected signal.
Line type The line type box enables you to select either the line width or a plot
symbol from a drop-down list.
To view the numerical values of all beats select View, Beat results from menu.
You can make a selection either in the Beat results window or in the viewport
screen by clicking with the left mouse button on the starttime of the period you
want to select and by dragging the mouse to the last line of the selection. In the
beat results window you can also use the SHIFT key in combination with the
ARROW UP and ARROW DOWN keys to make a selection.
Click on File and then on Export in the menu. This invokes the Export dialog.
1. In the 'Export from file' box select the beat-to-beat results file from the drop-
down list box with files that are currently open in BeatScope.
38 BeatScope 1.1, User’s Guide
Note:
Make sure you select the beat results file, i.e. the file with the .R00 extension.
Exporting 60s from e.g. a Portapres M2 samples file creates an output file with
60x100 (Hz) =6000 lines.
2. In the ‘To file’ box type the name of the file to write the data to, or select a file
with the browse button at the right of the To file input field.
3. In the ‘Export type’ box, select To text file.
4. In the ‘Select period’ box the default period is the current selection (if part of
the file is selected), or the current time window when no selection has been
made.
5. Check the time format, averaging, the output format (i.e. fixed width columns
or delimited columns), and whether you want to export beats, events or both
beats and events.
6. You can output a subset of all available signals in a beat-to-beat results file.
Select All for the moment.
Click the Export button, the selected part of the beat-results file will be saved in a
text file.
BeatScope 1.1, User’s Guide 39
• Binary samples files: Files with one or more sampled signal channels, e.g.
generated by the module BEATPORT in BeatScope which works with
Portapres M2, and by most data acquisition systems using an Analog Digital
Converter.
• Portapres M2 files: generated by Portapres, containing the finger pressure
waveform, height correction and status information.
• Binary beat data files: generated by a beat analysis with BEATFAST (off-
line) or BEATPORT (on-line), or after unpacking a Finometer packet file into
a samples file and a beat data file.
• Finometer files: generated by the Finometer. A Finometer packet file consists
of four sampled waveforms, including the finger arterial pressure waveform
(finAP), beat data, and comprehensive status and haemodynamic data.
• Text data files: Text files containing lines with one or more columns of data,
separated by e.g. a comma or a tab
This chapter also addresses a number of additional files which are used by
BeatScope, such as header files and batch command files.
frequency used. For this reason not only a samples file is created but also a header
file. The header file is a text file with essential information about the contents of
the samples file (see below).
A TNO samples file is either sampled at 100 Hz or 200 Hz. The number of
sampled channels in the file is either 1, 2, 4 or 8. Each sample is written to disk as
a 16 bit two's complement integer. This means that the file is a binary file, you can
not load the file in a text editor to view its contents.
The resolution of the signals is 2.5 mV or 0.25 mmHg. Zero pressure corresponds
with a zero sample value. The internal format of a two channel (A,B) samples file
is :
with sAn the nth 16 bit sample of signal A and sBn the nth 16 bit sample of signal
B.
Note that the header length HH depends on the number of channels (n). The first n
values in the file are filled with a value 8000H (-32768), followed by an eight word
header consisting of the following words:
hh mm ss cc s0 s1 s2 s3
hours minutes seconds 0.01 s signature information
The program BEATPORT stores pressure and height samples in a 100 Hz file on
disk:
Chan01: Finger pressure
Chan02: Hydrostatic Height Level
The resolution of the signals does not need to be 2.5 mV and a fixed offset can be
compensated for. It is possible to skip a number of bytes at the beginning of a file,
for instance to skip a header block created by another data acquisition software
package.
BeatScope 1.1, User’s Guide 41
A non-TNO binary samples file can have 1 to 99 channels. Each channel is stored
as a 2 byte, two's complement integer. The internal format of the file is very similar
to the TNO pressure file format. Note, however, that there is no specific header
block.
All beat-to-beat files start with a header block (consisting of a number of markers
at time 0) with the following information:
• the cardiac output model used (Modelflow method or TNO pulse contour)
• the cardiac output calibration factor (usually 100 %).
• the patient data used in the beat-to-beat analysis.
• and other markers that depend on the kind of beat analysis performed.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
i i i i s s d d m m v v ej ej h a
Table 4.1 Beat-to-beat file record
42 BeatScope 1.1, User’s Guide
The artifact bitset (one byte) can be decoded as follows: bit description
Note on bit 3: Beat recognition in Beatfast is a two stage process. If a beat was
recognized in the first stage of the analysis, and later rejected in the second stage,
bit 3 of the artifact byte is set (to 1). This can be caused by an artifact in the
pressure waveform but also by a pronounced dicrotic wave.
If artifact bit 7 is set the 16 byte record does not belong to a beat but is a
marker/event record. The combined 'h' and 'a' byte should then be interpreted as a
16 bits word, with the following definition of bits 8 through 15:
bit description
8 marker level change detected
9 patient sex, age, height, weight record
10 current model parameters (afterload, RTF, level correction…)
11 10 character comment
12 time out of xxx minutes
13 thermodilution injection start/stop
14 thermodilution C.O. value
15 Modelflow calibration value
BeatScope 1.1, User’s Guide 43
Finometer stores the sampled unprocessed (raw) finger pressure waveform and
three other waveforms, sampled at 200 Hz, in a so called packet file. Each packet
consists of 0.5 s of data and not only includes the four waveform signals but also
the information of up to two heart beats (maximum heart rate 240 bpm), and
detailed status information about the finger pressure measurement, the upper arm
calibration, and the waveform filtering that is applied.
When a Finometer file is opened in BeatScope, the beat results are automatically
extracted from the file and stored in a temporary beat results file, which has the
same name as the Finometer packet file but with the prefix ‘beat.’, the Finometer
file ‘EXAMPLE.FPF’ thus also opens a beat data file ‘beat.EXAMPLE.FPF’.
BeatScope interprets the Finometer file as a samples file and opens the temporary
beat results file to display the accompanying beat results.
If there is a time column, the time data should increase monotonically. If no time
data are available in the text data file a sampling interval can be selected.
the Batch editor and load a command file from disk. Then you can run the
command file.
There are important differences between BeatScope command files and DOS batch
files:
• In a DOS batch file each single line is interpreted and executed. In BeatScope
command files commands often consist of a number of consecutive lines. The
command name appears first (e.g. '[BEATFAST]','[PRINTRES]') followed by
a combination of the lines INPUT, OUTPUT, OPTIONS and PERIOD.
• It is not possible to run a BeatScope command file from the DOS prompt.
• DOS batch files can not be run in BeatScope, without conversion.
In a session file all information to re-build the screen of the View Files utility is
saved. A session file is similar to an .INI file in Windows. Although it is possible to
edit session files this is not recommended. The format of the information in a
session file is further undocumented.
If you copy beat-to-beat results files or samples files to another directory it is best
to copy the header files too.
You never have to open a header file manually; if a header file is found it is loaded
automatically by BeatScope.
BeatScope 1.1, User’s Guide 45
BEATFAST header files : If you use the extension ‘.R’ followed by two digits (e.g.
‘.R01’, ‘.R49’) in Beatfast, the accompanying header file automatically gets the
same name with an ‘.H’ instead of the ‘.R’. See table below. If you use another
extension the header file always gets the name of the samples file, however the
‘.HDR’ extension is appended to this new file name
BeatScope helps you finding your samples, beat results files, text data files and
session files. Still it is important to have a basic understanding of the file naming
convention(s) used by e.g. Beatport and Beatfast.
The file type identifier at position 6 in the file name can either be:
For other examples of frequently used files in BeatScope see Table 4.3.
Filename Description
2JA12R07.300 Bat-to-beat results file ('R'), 2002, January 12th at 07:30
0DE25S18.34 Samples file, 2000, December 25, at 18:34
0DE25P18.34 Finometer packet file
0DE25H18.34 Header file
0DE25A18.34 ASCII text file created during from a Finometer file
0DE25$18.34 Incomplete Finometer packet file, cf. Section 8.2.1
EXAMPLE.DAT Portapres M2 file (usually .POR, or .DAT
EXAMPLE.POR Portapres M2 file (usually .POR, or .DAT)
EXAMPLE.PRN Some kind of ASCII text file
EXAMPLE.TXT idem
EXAMPLE.ADC A binary samples file (Analog Digital Converted)
EXAMPLE.R0# (Binary) beat-to-beat results file, #=digit (0..9).
EXAMPLE.S0# (binary) samples file, #=digit (0..9).
EXAMPLE.SES BeatScope session file
EXAMPLE.CMD BeatScope batch command file
EXAMPLE.FPF Finometer packet file (default extension .FPF)
Table 4.3 File names used in BeatScope
BeatScope 1.1, User’s Guide 47
• Basic monitoring The first option is a basic monitoring of the beat data sent
by Portapres. You can view thsee beat-to-beat data (sys, dia, map, HR, height
correction value) and important run time messages. The PC can start and stop
a measurement, switch on/off physiological calibrations (physiocal) and set an
event marker in the memory card of Portapres.
If your Control Unit has software version 1.1E or higher the pressure
waveform is also available in a third plot. It is, however, not possible to store
this pressure waveform.
To start monitoring and control select the Portapres page in the Selection dialog
Check that the correct serial port is selected in the ‘Serial COM port’ box. Then
click the Monitoring and Control button.
Message panel At the top of the window, under the menu, important messages
pertinent to the measurement are displayed. If your control unit has version 1.1E or
higher the current two control unit display lines are displayed in this panel.
Message panel
Control panel
The menu Use the menu to print the current viewports, or to adapt the time scale
of the beat-data trend plots (two upper viewports) and the time window of the
pressure waveform time window. The menu also gives access to the creation of log
files.
5.1.1 Logfiles
During a measurement with Portapres beat-to-beat pressure data are derived from
the finger pressure waveform, in the Portapres embedded software. These beat-to-
beat data are not stored on the built-in Flash Memory Card since a comprehensive
beat analysis is available with the Beatfast option in BeatScope. The beat data are
used internally in the device to control and monitor the measurement, and the data
are sent to the Control Unit and to a remote PC via the serial protocol. The Basic
monitoring function, described in this section, displays the beat data derived by the
Portapres software. It is possible to log these data in text files. An example of such
a log file is shown in the figure.
Note that the beat time is generated in the PC, since it is not part of the serial
protocol. Therefore the use of the other monitoring option, Beatport, is
recommended for research applications since a full waveform analysis is performed
using Modelflow algorithms.
The purpose of this dialog is to provide the Beatport program with the necessary
information to analyze and store the blood pressure waveform and beat results.
Note that the '$' character in the name is replaced by 'H' for the header file, 'R' for
the beat-to-beat results file and 'S' for the pressure samples file.
Note that Beatport does not generate an ASCII beat results file during a
measurement as the Beatfast (off-line analysis option) does. You should therefore
convert the binary results file to an ASCII beat results file using the Printres utility.
So if the output files field displays: EXAMPLE.$02, Beatport will create three
files:
• A samples file EXAMPLE.S02, a Beatport samples file is a two channel file
sampled at 100 Hz:
Chan 1: Finger pressure (0.25 mmHg resolution)
Chan 2: Finger height level (0.25 mmHg resolution)
• A beat results file EXAMPLE.R02
• A header file EXAMPLE.H02
52 BeatScope 1.1, User’s Guide
Note: if you select brachial filtering with continuous level correction the beat file
contains ‘brachial’ beat results. In the samples file, however, always the ‘raw’
finger pressure signal is stored. This enables you to re-analyze the pressure
waveform off-line with Beatfast. If you view the beat file and the samples file
simultaneously you will notice that the ‘brachial’ beat results are generally slightly
higher than the unprocessed finger pressure waveform.
Subject data
Gender, Age, Height, Weight The subject's Gender and age should be entered. The
height and weight data may be entered as '0' if these data are not available.
Info
You can enter three lines with additional information about the Portapres
measurement here. The information is stored in the header file that is created by
Beatport.
Title layer
In the title layer information about waveform filtering can be found:
BeatScope 1.1, User’s Guide 53
Pressure layer
The second panel always shows the beat-to-beat pressure waveform (left), the
diastolic and systolic pressure trends and the (eight beat averaged) systolic and
diastolic pressure.
Information layer
The third panel displays information about the output file(s) that are created (left),
a plot of the Portapres waveform (center), and parameters that are related to the
Modelflow method (right).
Tabcard layer
The notebook and tabs that are displayed at the bottom of the screen provide an
easy interface to check the current selections and to change setting when necessary.
Notebook pages are selected via the keyboard with function keys F1 to F6.
Beatport is a Dos program and no mouse functions are supported in this program.
54 BeatScope 1.1, User’s Guide
Flow layer
Presure layer
Information layer
Portapres line
Tabcard layer
F1
To read a help text in the lower panel of the run time screen. Use PAGE UP and
PAGE DOWN key to browse through the help pages.
F2
To enter a comment, press F2 and then start to type. Each time when either 10
letters have been typed, or the ENTER key is pressed, a 10 byte commentary
marker is saved to the beat-to-beat results file.
F4
To select a channel to display. You can either select channel 1 (Portapres
waveform) or channel 2 (height).
BeatScope 1.1, User’s Guide 55
F5
To change the calibration factor of the Modelflow cardiac output method. Usually
this factor is 100 %. Changing the calibration factor may be helpful if you want to
make Modelflow cardiac output equal to an independently derived cardiac output.
To change the factor press ENTER. Use the ARROW UP and ARROW DOWN
keys to increase or decrease the calibration factor. If you are finished changing the
calibration factor press ENTER to accept, or ESC to skip.
F6
To show beat-to-beat variables:
- Pressure Sy=Systolic, Di=Diastolic, Mn=Mean blood pressure.
- Time PI=Pulse interval, HR=Heart rate, ET=Ejection time
- Modelflow SV=Stroke volume,CO=Cardiac output, PR=peripheral
Resistance
- Indexed values (normalized to body surface area) of Modelflow
variables
ESC
To Cancel the current Beatport analysis.
Troubleshooting
If the communication between Portapres and BeatScope fails, the message 'Unable
to start flash link' pops up.
58 BeatScope 1.1, User’s Guide
Locate the measurements you want to transfer, use the vertical scrollbar if
necessary.
• Selecting a single measurement: Click (with the left mouse button) the
measurement you want to transfer.
• Selecting multiple sequential measurements: Click the first measurement
you want to transfer, and then drag the cursor to the last item you want.
• Selecting multiple nonsequential measurements: Press and hold down
CTRL, and then click each item you want.
The Download files dialog enables you to define the output directory and
filenames of the measurements you have selected.
First select the output path. All measurements that were selected in the directory
will be saved in this output path. To enter the output path:
• Type the name of the output path, or
• Select a directory with the Browse button at the right of the Output path field.
The dialog lists all measurements you have selected. The column Number refers to
the measurement number, ranging from 1 to 255, and the column FileName lists
the filenames that are going to be used. To change the names of the files you are
going to transfer:
• You can edit the fields in the Filename column.
• You can also use the fields in the ‘File mask’ and ‘File numbering’ boxes to
instruct BeatScope to create file names (semi-) automatically. Such filenames
consists of :
If you make changes in the 'FileMask', 'Extension' or 'File numbering' boxes you
should click the Apply button to update the filenames in the Filename column.
During the download process a status window is displayed, with information about
the current measurement that is transferred and the speed of the serial link
(baudrate).
Normally, this baudrate should be 115000 Baud (115 kBaud). If the computer is
not fast enough to handle this high speed protocol, data loss may occur and the
warning 'Serial line errors' is displayed. BeatScope then automatically selects a
lower baudrate. If the baudrate ends up lower than 57 kBaud do the following:
• make sure there is no activity at all on the serial port you are using.
• limit the concurrent activity on other output ports in your computer, i.e.
suspend printing and/or working with a ZIP drive.
• the power management in some (notebook) computer cause problems with
high speed serial communication. If you frequently experience problems with
the Flash link, try switching the power management off to see it that makes a
difference.
• try the program on a faster computer to check that the control unit is
functioning properly. If you suspect a problem in the control unit of Portapres,
contact Finapres Medical Systems BV.
After finishing the data transfer the Flash card directory dialog is displayed
again. You can select another set of measurements to transfer or click on the Close
button to return to the Selection dialog.
BeatScope 1.1, User’s Guide 61
Click the Event file button on the Portapres page of the Selection dialog.
Note: If you select the View Files utility in BeatScope, and if you open a Portapres
M2 file, the events in the file are automatically extracted.
1. Portapres Model 2 file Select the name of the Portapres file from the drop-
down list, or click the browse button at the right of the filename field to locate
the file.
2. Time format options are:
• seconds relative to the start of the measurement,
• hh:mm:ss format relative to the start of the measurement
• the time of day.
3. You can either Output to:
• Printer to print the event listing.
• File to write the events to a file, type the name of the event file or select
the browse button at the right of the filename field.
• Screen to display the event listing.
Finally click the button above the Close button which is named 'Print', 'To File' or
'View' depending on your selection in the 'Output to' box.
Click on Close to close the dialog and to return to the Selection dialog.
BeatScope 1.1, User’s Guide 63
Since the samples are stored in a compressed format, you should unpack a
Portapres M2 file if you want to use the pressure samples in a non-TNO analysis
package.
To invoke the Decompress Portapres file dialog, click the Decompress file
button on the Portapres page of the Selection dialog.
• Portapres Model 2 file Select the name of the Portapres file from the drop-
down list, or click the browse button at the right of the filename field to locate
the file.
• Output file BeatScope default suggests an output filename with the
extension.ADC. If you want to change the output file name either type the
name or click the browse button at the right of the output file field.
64 BeatScope 1.1, User’s Guide
Click on Close to close the dialog and to return to the Selection dialog.
Remarks:
• The first file should end, before the start of the second file
• The gap between both files should be less than 24h.
8. Finometer
On the Finometer page buttons can be found that give access to functions to work
with Finometer and its files:
• The Monitor function enables the on-line real time monitoring, and limited
control, of Finometer measurements.
• The Download function can be used to download measurements from
Finometer via a serial line to the PC.
• The Read pack function is used to split a Finometer packet file into four
different files:
1. An eight channel binary samples file, sampled at 200 Hz
2. A BeatScope beat-to-beat data file
3. An ASCII file with a comprehensive set of physiologic data for each beat
4. A header file
• The Classico function enables you to transfer data of semi-automatic blood
pressure measurements performed when Finometer is in ‘Classico Mode’.
Note: the serial connection is not necessary for the Readpack function.
Note:
• If Finolink is running and connected with Finometer via the serial line during
an entire measurement, the same data file can be found on the Finometer disk
and on the PC disk and there is no need to download the measurement.
• If Finolink could not monitor an entire Finometer measurement, either because
of a bad serial connection or because monitoring was started too late, or
stopped to early, the data file on the PC is incomplete. This is signalled with a
‘$’ instead of the ‘P’ in the Finometer packet file name. See the example
below:
Notes
• Patient information such as age and gender must be set on the Finometer.
For correct cardiac output computation you should enter patient data before
starting a measurement.
• Configuring Finometer, e.g. the selection of waveform filtering or selection of
external input channels, can only be performed on the Finometer device itself.
• A return to flow (RTF) procedure can be started about two minutes after the
start of a measurement.
Connect/
Disconnect
Download
Finometer files have unique filenames containing the date, time and file type. The
naming of these date + time files is addressed in Section 4.9.
72 BeatScope 1.1, User’s Guide
5. Click on one or more filenames in the directory. Use the CTRL Key to select
non-sequential files.
6. Click on ‘Local files’ to select a destination directory
7. Click on ‘<’, to download the selected files. If you want to transfer only a
single measurement you can also double click the filename.
Note: The ‘Gndr’ (Gender) column may contain three letters ‘D’ – Decide, ‘F’ –
Female, and ‘M’ – Male. The ‘D’ signals that neither before nor during the
measurement the patient information was set. Default patient information: Age,
Height (‘Hght’) and Weight (‘Wght’) is assumed.
After clicking the ‘<’ button to download the selected files, the following dialog is
shown.
The file rename dialog enables you to use your own file naming. Use the ‘File
naming’ radio buttons:
• to select the usage of the Finometer filename convention (date + time
filenames, such as 2ap20p12.212), or
BeatScope 1.1, User’s Guide 73
• to rename the file names using a mask. If the mask is set to ‘EXAMPLE’ and
the ‘starting with’ value at 20, then the first selected file will get the filename
example20.fpf. The extension .fpf stands for ‘Finometer packet file’.
Use the Readpack function to decompose a Finometer packet file into a number of
standard data files.
Samples file
Readpack outputs an eight channel (TNO format) samples file, as defined in
Section 4.1.1, sampled at 200 Hz.
• Channel 1 is the unprocessed (raw) finger pressure, i.e. without waveform
filtering and level correction. The pressure signal is, however, height
corrected. It is important to realize that this channel always contains the
unprocessed pressure even if the Finometer measurement was performed with
finger to brachial pressure reconstruction active.
• Channel 2 is the hydrostatic height correction signal
• Channel 3 is the upper arm cuff pressure transducer signal
• Channel 4 is the plethysmograph signal.
BeatScope 1.1, User’s Guide 75
Note : If waveform filtering to brachial pressure was applied during the Finometer
measurement the beat results are labeled as ‘reconstructed’ (prefix re), if not they
are labeled with the prefix fi.
BeatScope 1.1, User’s Guide 77
This listing provides a quick overview of the basic and more advanced features of
Beatfast:
• Beat-to-beat data : From each heart beat detected in the pressure waveform
twelve parameters are derived.
• Arterial pressure sites : Beatfast supports the following arterial pressure
sites: aorta, femoral artery, temporal artery, brachial artery, radial artery, and
finger artery, the latter from Finapres, Finometer or Portapres.
• Marker detection : Detection of sudden level changes in a specified (marker)
channel.
• Physiocal detection : Detection of interruptions in the finger arterial pressure
waveform, due to physiological calibrations (Physiocal) of Portapres and
Finapres recordings.
• Waveform filtering : Application of filters that correct for pressure wave
distortion when arterial pressure is obtained in a peripheral site such as a
finger artery or the radial artery.
• Level correction : In addition to waveform filtering a built-in level shift
correction can be applied to correct for the pressure decrement of mean blood
pressure between the heart and the finger. This level correction can only be
activated for finger arterial pressures.
• Level calibration : Beatfast can analyze a specified (return-to-flow) channel
with cuff pressure measured in an upper arm Riva-Rocci cuff to calibrate the
individual level correction that is needed to move pressure levels to brachial
artery levels. Level calibration can only be activated for finger arterial
pressure waveforms.
• Special channel analysis : Beatfast can analyze a specified (special) channel
and determine in that channel either the average, the integral, or the peak-to-
78 BeatScope 1.1, User’s Guide
peak signal value, for each beat detected. The pressure channel can be
advanced or delayed 500 ms with respect to arterial pressure.
Click the Beat analysis page of the Selection dialog then click on Beatfast.
Each time you invoke the Beatfast dialog a default session is assumed. In a default
session Beatfast:
• Uses a TNO standard 100 Hz samples file or a Portapres file
• Uses the Modelflow method to compute cardiac output with a Modelflow
calibration factor of 100 %
• Does not use waveform filtering, level correction or level calibration.
• Does not perform a special channel analysis
• Does not detect markers in a marker channel
The input file is opened when you either press Enter (while editing text in the input
field) or when you move the cursor to another field in the dialog.
Then BeatScope tries to collect all necessary information about the samples file by
reading additional information from the samples file and subsequent from an
accompanying header file.
Note for Finometer users: To re-analyze a Finometer packet file, you should
unpack the Finometer file and redo the analysis on the samples file that is created.
This analysis is normally not necessary since a full beat analysis is already
performed during the measurement and stored with the samples in the packet file.
Since on-line in Finometer more information is present about the pressure signal,
and e.g. the occurrence of Physiocals, an off-line analysis may be less accurate than
the original Finometer packet file.
Note: If you selected a Portapres M2 file, all fields are filled with the proper data.
Since a Portapres M2 file has always the same format it is not possible to change
any of the remaining fields in the 'Input file' box.
Verify the data in the following fields for other file types and correct them if
necessary:
# Channels : The number of channels in the samples files. If you have opened an
ASCII text data file, enter the number of columns in the file.
In TNO samples files the number of channels is obtained directly from the header
block in the samples file itself.
Markers are detected whenever the voltage in the marker channel rises or drops
step wise to a new steady level within 10 ms. The new level must be held for at
least 100 ms. The time of onset and the new signal level are stored as an event in
the beat-to-beat results file. Bits 7 and 8 of the artifact bitset of this event are set.
Note: in a Portapres M2 file the marker channel is always set to ‘2’. In this way
Beatfast automatically merges the run time events found in the Flash Memory Card
with the beats detected.
Height corr.: The channel containing the hydrostatic height correction signal of
Portapres, or Finometer.
BeatScope 1.1, User’s Guide 81
Note: in a Portapres M2 file the ‘height corr.’ channel is always ‘2’. Therefore, the
hydrostatic height correction value is available as one of the beat results.
The height correction value is used only to be stored with the other beat data in the
beat results file. The value is not used to correct the arterial pressure waveform. It
is assumed that the pressure waveform is the blood pressure at heart level (i.e.
height corrected).
RTF : Selecting a return-to-flow channel is only necessary if you want to apply the
pressure correction option with R.T.F. calibration in Beatfast. Specify the channel
with the cuff pressure measured in an upper arm Riva Rocci cuff proximal of the
finger cuff.
Freq : The frequency, either 100 or 200 Hz. Beatfast supports samples files with
these sampling frequencies.
Offset and resolution : This box enables you to specify a non zero offset and the
resolution of the pressure waveform.
• Resolution (Scaling)
- Binary samples files : the resolution is usually 2.5 mV ( 0.25 mmHg ). If the
polarity of the signals is negative you may enter a scaling of e.g. -0.25 mmHg.
- ASCII text files : the scaling is the multiplication factor that is used to convert
the pressure values in the text files to mmHg. Therefore, if the pressure
column already has mmHg units the scaling field should be 1.000. Negative
82 BeatScope 1.1, User’s Guide
scaling values are allowed when polarity of the pressure signal has to be
inverted.
• Offset is the zero offset level, only for binary files. If a pressure sample is read
from file with a value equal to offset, the pressure is 0 mmHg.
Skip : Skip specifies the number of bytes or lines (ASCII text file) that have to be
skipped at the start of the samples file. Use this value to skip a header block in a
samples file or header lines in an ASCII samples file.
Since the Modelflow cardiac output method critically depends on the proper age
and gender it is important to check the fields in this box:
- Age : The age of the subject (yr).
- Sex : The gender of the subject (male, female).
- Height : The height of the subject (cm). If the height is unknown, then enter a
'0' in this field.
- Weight : The weight of the subject (kg). If the weight is unknown, then enter a
'0' in this field.
Note: You can change execution speed during a beat-to-beat analysis with
ALT+X.
The next step in the Beatfast dialog is to name the output file(s). Beatfast always
outputs three files per analysis:
1. A binary beat results file (default extension .R00).
2. An ASCII beat results file (default extension .A00) with the full set of beat
results available, cf. Table 8.1 for information about the beat data columns.
3. An ASCII header file (default extension .H00) with information about the beat
analysis
The Beatfast dialog only prompts you to enter the name of the binary results file,
the filenames of the header file and the ASCII beat results file are based on the
name of the binary results file.
• Click the Create Output name button. The default filename is a combination
of:
- The last used output directory (which can be different from the input
directory)
- Followed by the input file name (without extension)
- Followed by the extension .R00, or
• Type the name of the output file, you can use long file names, or
• Click the browse button at the right of the output field
Beatfast header/ASCII beat results files : If you use the extension ‘.R’ followed
by two digits (e.g. ‘.R01’, ‘.R49’) in Beatfast, the accompanying header file
automatically gets the same name with an ‘.H’ instead of the ‘.R’ in the extension,
and likewise the ASCII beat results file gets the extension with an ‘.A’ instead of
the ‘.R’. See the table below. If you use another extension the header file always
gets the name of the samples file with the ‘.HDR’ extension appended to the file
name.
Binary beat results file Ascii beat results file Header file
EXAMPLE.R00 EXAMPLE.A00 EXAMPLE.H00
EXAMPLE.R45 EXAMPLE.A45 EXAMPLE.H45
EXAMPLE.BTB EXAMPLE.BTB.TXT EXAMPLE.BTB.HDR
You are now ready to do a default analysis with Beatfast. If, however, the Run
button is still disabled (grayed) the status line at the bottom of the Beatfast dialog
displays which information is still missing or wrong.
84 BeatScope 1.1, User’s Guide
The 'Cardiac output model' box allows to select either the standard Modelflow
model or the former 'corrected characteristic impedance (cZ) model' further
referred to the 'TNO pulse contour method'. The model computes stroke volume
using the contour of the pressure waveform. The original method was developed
around 1970 and a number of publications have appeared since then demonstrating
its precision in following changes in stroke volume and cardiac output. The model
is a uniform aortic transmission line, but non-linear corrections upon changes in
mean pressure and heart rate are implemented in an age dependent manner.
In 1993 TNO introduced the Modelflow method to derive an aortic flow pulse
from a continuous pressure waveform. The Modelflow method follows changes in
cardiac output with better accuracy than the TNO pulse contour method and
provides a rather complete afterload description in its model parameters and is
therefore the preferred model to compute cardiac output.
The calibration factor is not for the pressure, but for the cardiac output. Modelflow
and the TNO Pulse contour method both compute stroke volume based on
algorithms with parameters which are not exactly known for each individual
subject. The Modelflow method for instance assumes a population average aortic
area depending on the gender, age, height and weight of a subject. If the individual
aortic area is in fact 20% larger than average the computed waveform is smaller
than true flow and calibration should be increased to 120 %. It is generally not
recommended to change the calibration factor unless you have an accurate
independent (invasive) cardiac output method to compare with. The calibration
factor used in a beat-to-beat analysis is stored in the beat results file. The
calibration factor can be any integer value in the range between 25 % and 400 %.
• Once : Default; Beatfast performs a beat analysis of the file only once.
• Twice : Beatfast needs a small number of beats to adapt various (model)
parameters to the subject and the signals. However, on short files of only a few
beats the number of beats used for this purpose could be a substantial part of
the file. Valid results are produced only in the remaining beats. It is, therefore,
possible to play a file twice. The first play is used to adapt, the second to
produce beat-to-beat results.
• Continuously : For demonstration purposes it is also possible to play a file
continuously, in this mode no beat-to-beat results file is created.
If arterial pressure is measured in the finger, radial or brachial artery the pressure
waveform is always more or less distorted and some pressure pulse amplification
may occur. For a pressure recorded as peripherally as the finger additionally a
pressure gradient causes mean pressure levels to be below arterial. TNO TPD
Biomedical Instrumentation has developed a number of methods to correct the
pulse wave distortion and the pressure gradient. The 'Pressure correction' box can
be used to select the desired pressure correction method:
computation but is does affect values for systolic (most), diastolic and mean
pressure in beat results file.
• Finger to brachial : level corrected : This option not only enables the Finger
to brachial waveform filter, but does also a regression based level correction.
• Finger to brachial : R.T.F. calibrated : This option is similar to the previous
option, however, in addition it enables the calibration of the applied level
correction in a subject. To achieve a correct level calibration one has to record
the cuff pressure of an upper arm Riva-Rocci cuff in a so-called RTF channel
of the samples file. The offset and scaling of this RTF channel should be 0 and
1V/100 mmHg respectively. The cuff must be placed on the upper arm
proximal of the finger pressure recording site. With the finger pressure
measurement ongoing inflate the upper arm cuff (either manually or with a
special device) rapidly to a pressure about 30 mmHg higher than the expected
systolic pressure, and then deflate slowly at 2 to 3 mmHg/s. Once inflated the
finger pulse disappears. Upon slow deflation the finger pressure reappears and
this first pulsation (return-to-flow) is automatically detected by Beatfast. The
upper arm cuff, at this moment of return to flow, is stored in the beat results
file. Next, the finger pressure which is already converted to brachial waveform
by the filter, is automatically corrected to upper arm blood pressure.
• Radial to Brachial : This option enables the radial to brachial waveform
filtering.
One of the beat results that is stored in a beat-to-beat results file is ventricular
ejection time. This value is, however, not necessary sometimes. Beatfast enables
the storage of another parameter value instead of ejection time in its beat-to-beat
results file:
• Extreme values in a special channel
• Average values in a special channel
• Integrals per beat in a special channel
• The finger pressure level shift
• Pulse interval
• Systolic area.
BeatScope 1.1, User’s Guide 87
Action : As described above the analysis can examine the special channel for
extreme values, average values or integrals per beat.
88 BeatScope 1.1, User’s Guide
Channel delay : This option delays the special channel with respect to the primary
pressure waveform signal to account for up to ±500 ms time shifts between signals.
Stored in the 8 channels binary samples file are the following computed signals:
Click on the Advanced page of the notebook in the Advanced Beatfast settings
dialog to set up Modelflow waveform filing.
If you check the ‘Output Modelflow pressure and flow curves to disk’ checkbox
Beatfast will write samples to a file with the name pqv0.adc, pqv1.adc, pqv2.adc
etc. in the output directory. The output file name Beatfast selects depends on the
files with the mask PQV*.ADC that already exist in the output directory. You
should specify a start time (From) and a stop time (To) in seconds.
In the upper trend panel in the Beatfast run time screen various signals can be
selected to trend display. Default cardiac output and peripheral resistance are
displayed. During a beat analysis you can change the trends but it is also possible
BeatScope 1.1, User’s Guide 89
to configure the trends To change this selection, click on the Display page of the
notebook in the Advanced Beatfast settings dialog.
The 'Left trend' and 'Right trend' boxes enable the selection of the two trend signals
in the upper trend panel. The pressure (trend) display scaling can be changed in the
'Pressure display' box. The time window, which is default 6 min, can be changed to
30 min, 2, 8, 24 hr. Finally, if you prefer to view the trend signals and their
numerical values against a dark background select the Distance option in the View
from box.
Click the OK button to close the dialog and to return to the Beatfast, beat-to-beat
analysis dialog.
If you Reset a configuration file, all analysis options are set to their default values.
See Appendix B for more information about Beatfast configuration files.
90 BeatScope 1.1, User’s Guide
You can also use the Add button at this time. Then the Beatfast command is not
executed immediately but stored in a batch command file. Use the Edit button to
view and edit the current batch command file. Refer to section 14 for detailed
information about creating and running batch command files.
9.3.1 Troubleshooting
If Beatfast does not start please check the following possible causes:
• Check that BEATFAST and BEATSCOPE are in the same directory.
• Make sure there is enough memory to run DOS programs. An easy way to
check free memory in DOS is to click the Start button on the Windows
Taskbar, click Programs and then MsDos prompt. If you see the Dos
command prompt type MEM.EXE and then press ENTER, the program
reports the maximum memory size that a program can allocate. This memory
size should be 520 kB or more.
Flow trend
layer
Run time
messages Pressure
trend layer
Info layer
Tab card
layer
The run time screen is an interactive graphics screen which, with the PC keyboard,
allows user control. Note that Beatfast and Beatport are DOS programs, and that
the mouse is not functional in the run time screen. Nevertheless, user control is
easy via the keyboard since only the function keys (F1 to F6) are used in
combination with ARROW UP and ARROW DOWN to select pages of a notebook
displayed at the bottom of the screen and to configure the run time screen.
The screen is divided into five horizontal layers: the title layer, the flow trend
layer, the pressure layer, the information layer and the tab card layer:
Title layer
• Displays the program name and the cardiac output model that has been
selected (mf=Modelflow, cZ=TNO Pulse contour) followed by the version.
• Displays the number of the pressure channel, followed by 'BRA converted' if
waveform filtering was enabled to brachial artery followed by either 'RTF
calibrated' or 'level corrected' if selected.
• Trend values : A panel with the 8 beat running averaged numerical values of
the two signals selected in the trend plot.
Pressure layer
• Pressure waveform displays the full pressure waveform of the heart beat
which was recognized last.
• Diagnostic info : At the top of the pressure waveform window a diagnostic
status line is shown with information about the beat analysis.
• Pressure trend panel : A trend panel displaying systolic, diastolic, and mean
blood pressure.
• Pressure values : This panel displays the current systolic and diastolic
pressure (eight beat running average) as big numbers.
Information layer
• File information data fields
[Beatfast]:
♦ Dat : current date
♦ Tim : current time
♦ Fil : input samples file name (without path)
♦ Siz : size of the samples file, expressed in HH:MM:SS format
♦ Pos : current position in the file, expressed in HH:MM:SS format
♦ Spd : execution speed (‘normal=real time, ‘high’=10x real time, ‘very’=
the highest execution speed with graphics output)
[Beatport]:
♦ Dat : current date
♦ Tim : current time
♦ Rat : current sampling frequency (100 or 200 Hz)
♦ Out : output file name
♦ Siz : size of the output file, expressed in HH:MM:SS format
♦ Store : Storage mode
‘NOT’ : no storage of samples at all
‘contin’ : continuous uninterruptable storage of samples
• Raw input signal view : This panel default displays the pressure channel of the
samples file, during an analysis you can view other channels by selecting the
Configure A/D signals tab of the notebook.
BeatScope 1.1, User’s Guide 93
To change the factor press ENTER. Use the ARROW UP and ARROW
DOWN keys to increase or decrease the calibration factor. If you are finished
changing the calibration factor press ENTER to accept, or ESC to skip. (not
available in Beatfast)
• Show variables :
To show beat-to-beat variables:
- Pressure Sy=Systolic, Di=Diastolic, Mn=Mean blood pressure.
- Time PI=Pulse interval, HR=Heart rate, ET=Ejection time
- Modelflow SV=Stroke volume,CO=Cardiac output, PR=peripheral
Resistance
- Indexed values (normalized to body surface area) of Modelflow
variables
At the top of the Pressure waveform window in the run time screen a diagnostic
status line shows information about the beat analysis. Messages that are displayed
on the screen are also always stored in the beat-to-beat results file.
9.6.2 No pulsation
As soon as no beats are detected for more than five seconds a no pulsation warning
is issued. The first beat that is recognized after this no pulsation state will have the
'time out' bit set to 1 in its artifact byte. If no pulses are detected for 60 s, a special
timeout marker is written to the output file and the '.. min NO pulse' warning is
displayed. This message is repeated once every minute until beats are again
detected in the pressure waveform.
The beat-to-beat analysis outputs a beat at such a time instant with a systolic,
diastolic, and mean pressure level equal to the last detected beat that did not occur
during a Physiocal. If a beat is generated during a Physiocal the 'physiocal' bit in
the artifact byte of that beat is set to 1.
Beatfast detects and outputs the systolic, diastolic and mean pressure levels for
each detected beat which are recognized after digital low pass filtering of 16.7 Hz
at 100 Hz and 24.5 Hz at 200 Hz sampling frequency. In case of relatively high
frequency noise, such as 50 Hz hum or tape flutter, is present on the original
samples such disturbances will be removed before measuring the pressure levels.
This may lead to slightly different systolic and diastolic pressures than detected
with software without such filtering. It was found that levels from such filtered
pressures come much closer to true, undisturbed pressure levels than unfiltered
ones.
Storage is such that in each beat are combined: the instant of begin upstroke (t), the
diastolic pressure at that instant (t), the immediately following systolic pressure.
The delay between the instant of upstroke and this highest pressure point is not
further specified. the mean pressure level, integrated from instant t to begin
upstroke of the next beat (t+ibi).
If you want to be able to output only part of a beat-results file or if you want to
hide certain beat data columns you should use the View Files utility (cf. first page
of BeatScope's Selection dialog or the Exporting data utility).
Click the Printres button on the Beat analysis page of the Selection dialog
Subject data
Usually subject info such as age, gender, height and weight are automatically read
from either the beat results file or from an accompanying header file. It is not
possible to change subject info here. If wrong subject info was used during a beat-
to-beat analysis the analysis must be repeated with the proper subject info entered.
Results box
• Beats and Events : output both beat data lines and events stored in the beat
results file
• Beats only : output only beat data lines
98 BeatScope 1.1, User’s Guide
• Events only : output only the events stored in the beat results file
Note1: To warn you that no beat-to-beat data will be available in this mode, the
Events only option is colored red when selected.
Note2: If you check the No Model info checkbox, afterload information and level
correction and level calibration markers are suppressed.
Note: If you select Beat or Time averaging an input field is shown to enter the
number of beats or seconds to average. More information about beat and time
averaging can be found in Appendix C.
Time format to define how the time of each beat should be output:
• Seconds : output the time, relative to the start of the file.
BeatScope 1.1, User’s Guide 99
• hh:mm:ss relative output the time, relative to the start of the file in hh:mm:ss
format.
• hh:mm:ss time of day output the time of day in hh:mm:ss format.
Output to box. You can either direct the output to a printer or to file or to the
screen (preview).
• Printer :
- The button in the Printres panel changes its caption to ‘Print’
- Click this Print button to direct the output to the printer specified.
- To select another printer or to change printer properties use the Printer
Set Up button.
• File :
- The button in the Printres panel changes its caption to ‘To File’ .
- An edit field and browse button are displayed to enter the name of the
output file:
type the name of the output file,
or select a file with the browse button.
- Click the To File button to direct the output to the file specified.
• Screen :
- The button in the Printres panel changes its caption to ‘View’.
- Click the View button to display a Print preview window.
You can show all printer pages one by one. With most monitors (800x600
pixels) the output is readable.
The To file and Print options of Printres are not further discussed since the output
is handled automatically, without user interaction.
You can also use the Add button at this time. Then the Printres command is not
executed immediately but stored in a batch command file. Use the Edit button to
view and edit the current batch command file. Refer to section 14 for detailed
information about batch command files.
100 BeatScope 1.1, User’s Guide
Refer to “Table 3.1 Column information in beat results output of Printres option.”
on page 29 for detailed information about the output of the printres command.
BeatScope 1.1, User’s Guide 101
Click the Plotfast button on the Beat analysis page of the Selection dialog.
102 BeatScope 1.1, User’s Guide
The time period that is plotted on one page of the stripchart Select a period
from the list 1 min, 5 min, 15 min, 30 min, 1 hr, 2hr, 4 hr, 8hr and 24 hr.
8. Y axis maximum
sets the full scale values of the signals in the plots.
9. Options
- [Draw markers] Check this box to show events. Events are displayed as
vertical lines with a label.
- [Time Format] Select time in seconds relative to the start of the file, or
hh:mm:ss format relative, or hh:mm:ss time of day.
In the blue control panel, in the Plotfast box click the Print button to start
printing.
You can also use the Add button at this time. Then the Plotfast command is not
executed immediately but stored in a batch command file. Use the Edit button to
view and edit the current batch command file. Refer to section 14 for detailed
information about creating and running batch command files.
The BeatScope View files utility has a number of additional options which are
described in the next chapter, including:
• Export data (a selected period) from a file.
• Do descriptive statistics on the signals.
• Average signals in a file over time or over beats.
The first page, View files of the Selection dialog enables you to open session files.
A session file contains all information necessary to rebuild the BeatScope View
files screen.
• New Session : To reset BeatScope and to display two empty viewports by
default
• Open Session : To open a session file that you saved before in an earlier
BeatScope session.
• Last Session : To load the settings of the most recent session.
The run time screen consists of a menu, a speedbar with a button row to quickly
select frequently used options and 1 to 4 viewports.
106 BeatScope 1.1, User’s Guide
At the bottom of the run time screen a time control (scroll) bar, and status bar with
six status fields can be found. To hide or display the speed bar, time bar and/or
status bar click Options menu and then Configure.
Speed bar
View Port 1
View Port 2
Time Control
With a signal selection button you can select the signals to plot and define their
color and scaling. You can drag (copy) the contents of one signal selection button
to another signal selection button.
The top viewport is always viewport 1, the second viewport 2, etc. The number of
viewports can be configured via the View menu option.
The viewport layout - i.e. number of Y axes, time axis, plot grid - can be changed
(cf. Configure in Options menu). Viewports can not be configured individually,
the layout is always the same in each viewport. You can change:
• the number of Y-axes : none, one (left axis) or two (one left axis and one right
axis).
• signal bar : default a signal bar is displayed at the top of each viewport. This
signal bar has four signal selection buttons.
Default only the signal names and units are displayed. Optionally the scaling
can be added to each signal button. It is also possible to hide the entire signal
bar, as is shown in the figure.
108 BeatScope 1.1, User’s Guide
• time axis : default each viewport has its own time axis. However, to increase
the signal display area it is possible to show only one time axis for all
viewports at the bottom of the screen.
• plot grid : show/hide the horizontal and vertical grid lines in the viewport.
If a Finometer file is opened, the embedded beat data are automatically extracted in
a separate temporary beat data file with the same name but with the prefix ‘beat.’.
This beat results files is also shown in the title bar:
‘(beat.EXAMPLE.FPF), EXAMPLE.FPF’
Each time the File Open Dialog is opened, BeatScope assumes that you are going
to open a file from a different measurement, and thus assumes that the currently
opened files have to be closed. To prevent BeatScope from closing these files,
BeatScope 1.1, User’s Guide 109
remove the checkmarks in the checkboxes with open files. You can also use the
button ‘Leave files open’ for that purpose.
If you open a samples files and BeatScope does not have enough information to
read the file correctly, the following dialog is displayed
If you open a text data file BeatScope always needs more information to correctly
interpret the file. The following dialog is displayed.
• Time increment and Time column : If the text data file has a column with
time values enter the number of that column in the time column field. The first
column is column 1. If the time increment between consecutive text lines is
fixed you can enter this value [s] in the Time Increment field.
• First data in row : If the text file only contains data and no header
information the data starts at row 1. In case of a header information in the top
of the file you should adjust the row number so that the first data line is
selected.
Hint: if you double click the ‘First data in row’ box, the first lines of text data
file are displayed. Find the first line containing numerical data.
Figure 12.5 Define first data line, column names and units.
Double click in this viewer the first data line. In the example the first data start
at line 5.
• Use last : If you opened a similar text data file in a previous session, and if
you changed the column names in that session, you can load the previously
used column names from the session file.
• Use predefined : BeatScope automatically creates names for you. The name
always starts with 'Col' followed by the channel number.
• Read from file : If the text data file has a line with column names, you can
enter the line number in the Labels in row field, which is displayed when the
Read from file option is selected. If you also enable the Units from row
checkbox, an additional field is shown where you can enter the row (=line)
number that contains the column units information.
Hint: you can double click the Labels from row and Unit from row fields to view
the contents of the text data file, just as described for the First data in row field.
In Figure 12.5 the first data are at line 5, the column headings at line 3, and the
column units at line 4.
If you open a file in a new View files session with BeatScope, the first two signals
of the file are displayed by default, cf. Appendix A for information about signal
names:
File Signals
Portapres M2 file Portapres presure and height
Finometer file Finger blood pressure without (finAP) or with (reBAP)
waveform filtering (depending on measurement
configuration) and height
Beat data file Systolic (SYS) and diastolic (DIA) pressure
Samples file Channel 1 and 2 of the samples file
Text data file The first two columns in the file, not including the time
column
If you want to change the signals that are displayed you can:
• click one of signal buttons of a viewport's signal selection bar (Figure 12.1
View files screen), or
• click the appropriate Setup Viewport menu item in the View menu, or
• you can also copy one signal button to another by dragging. That is, click a
signal button and drag the button to another signal button. When the mouse
cursor is over the other signal button release (drop) the button.
BeatScope 1.1, User’s Guide 113
Up to four signals can be displayed in a viewport. The four buttons in the signal
bar of a viewport correspond with these signals.
• The first signal (button) in a viewport is always coupled to the left Y-axis.
• The second signal (button) is coupled to the right Y -axes
• The third and fourth signal can have their own scaling, however, they do not
have their own axes displayed.
The dialog displays a notebook with four tabs (signals), corresponding to the four
signals that can be displayed in each viewport:
• The first tab corresponds to the first signal (left Y axis)
• The second tab corresponds to the second signal (right Y axis).
• The remaining two tabs correspond to signals that do not have their own axes.
You can use CTRL + TAB or CTRL + SHIFT + TAB to select the next or
previous notebook page respectively.
114 BeatScope 1.1, User’s Guide
The tabs of the notebook give access to four signal selection pages, here you can:
• Select the signal from a drop-down list of available signals. Click the None
button to display no signal at all.
• Select Scaling from three buttons with different pre-defined scales. Selecting
the fourth button enables the definition of a user defined scaling for this signal.
• Auto If checked, the signal will be displayed automatically full scale until the
‘Auto’ check mark is removed.
• Color Select a color from the drop-down list of available colors. Autocolor
indicates that the color depends on the current BeatScope configuration. You
can either couple signals to colors (e.g. define that Systolic pressure should be
red) or couple axes to colors. Refer to Configure item in the Options menu.
• Line type Available line types are:
1. thin line : default solid line
2. thick line : thick solid line
3. crosses : draw plus ('+') symbols
4. stars : draw star ('*') symbols.
5. dots : draw small ('.') dots.
6. triangles : draw triangle ('∆') symbols
7. Squares : draw square (←) symbols
8. Vert. line : draws a vertical line to the X-axis.
After finishing data entry in one notebook page you can either select another
notebook page or click the OK button to close the dialog.
• Press + on the numerical key pad, to zoom in. The current time window is
halved.
• Press - on the numerical key pad, to zoom out. The current time window is
doubled.
• Press END to jump to the end of the file. The current time window width is not
changed.
• Press HOME to jump to the beginning of the file. The current time window
width is not changed.
BeatScope 1.1, User’s Guide 115
• Define a time window by proving the start time and the stop time (Free time
range has been checked):
♦ From : Start time of the time window
♦ To : Stop time of the time window
116 BeatScope 1.1, User’s Guide
Note: Changing the time format, also affects the way time is displayed in all other
dialogs.
In the header of the File structure information dialog the file name, the time
stamp of the file, the size of the file in bytes, and the file type are displayed. If
more than one file is currently open the dialog displays a notebook with a number
of tabs. Click a tab to select a page (file) of the notebook.
The information that is displayed in the notebook depends on the type of file.
BeatScope 1.1, User’s Guide 117
Click the View menu and then Beat results window to display this separate
window.
If the Beat results window partially overlaps the View files run time screen you can
use View, Tile Windows horizontal option to split the current screen and display
the View files run time screen at the right half of the screen and the Beat results
window at the left.
118 BeatScope 1.1, User’s Guide
You can also use View Tile Windows vertical option to split the screen in two
windows above each other, the Beat results windows at the top, and the run time
screen at the bottom.
Figure 12.9 View files screen and View beat results window.
The message displays a run time error message found in a Portapres M2 file.
Origin Description
Evt External event file
Fin Finometer file
Por Portapres file
Res Beat results file
However, the window is NOT an edit window. You cannot edit, add or delete beat
or event lines.
Note: To hide/view beat results in the Beat results window, click on the yellow
header line of the window or right click and select the setup option from the pop-
up menu.
You can select a subset of all available signals if you want. Only the channels with
a check mark are shown.
• All : To put a check mark next to every signal in the box.
• None :To remove the check marks of all signals.
• Disp : To select only the signals that are currently displayed.
120 BeatScope 1.1, User’s Guide
12.8 Printing
To Print the viewports that are currently displayed click the File menu, and then
Print.
than the time period to be printed, the print is divided into a number of pages,
similar to the plotfast utility.
Hint:
Another easy way to print the BeatScope screen is to type ALT + PRINTSCREEN.
Then a bitmap of the BeatScope Window is copied to the Clipboard in Windows.
You can paste this figure in e.g. a Word or Excel document.
You can load and save session files from within the View Files utility.
To load and save session files, click the File menu and then:
• Save session : To save the current screen layout to a session file.
• New session : To create a new session, if changes were made in the session
that is currently open, the message 'Save Current Session?' is shown.
• Load Session : To open a session file stored on disk. Before loading the
session file the message, "About to overwrite current settings with settings
from session file” is displayed. Click Cancel to abort loading the session file
and OK to load data from the session file.
122 BeatScope 1.1, User’s Guide
BeatScope 1.1, User’s Guide 123
This section describes the Export option. Use this option to extract data from one
file to another file or to the clipboard..
Export from file box. Select the file name from a drop-down list of currently open
data files.
Note You can only export data from a file which has been opened via the File
Open menu. If you want to output data from another data file, without opening the
file first in View files you should select the Export button on the Utilities page of
the Selection dialog.
Select period Type here the period that has to be exported. You can either select:
124 BeatScope 1.1, User’s Guide
The boxes described below are only visible if they make sense. An example: you
can not have a fixed format or comma separated output format when you export
data to binary files, therefore the output format box is only available if you output
(text) data to the clipboard or to a file.
Output Check the header box to put a header block with two lines above the data
table (text files and clipboard). The first line of the header contains the column
labels, the second line contains the column units.
Averaging You can select averaging over time (s) and over beats here. If you want
to output all data of a file, the averaging option should be off (Averaging None).
Refer to Appendix C for information about beat and time averaging.
BeatScope 1.1, User’s Guide 125
Data Column width The format of the columns in the clipboard data or the text
file can either be:
• Fixed : Column width is determined by BeatScope, columns are aligned with
spaces.
• Delimiter : Columns are separated by one of the following delimiters (comma,
TAB, semicolon (;)).
Note: A Finometer packet file contains both samples and beat-to-beat data. If you
export data from a Finometer file to e.g. a text file, export either samples or beat-
to-beat data. BeatScope can only export data with the same timing.
13.1.2 Exporting
To export data click the Export button in the Export data from file dialog.
You can also use the Add button at this time. Then the Export command is not
executed immediately but stored in a batch command file. Use the Edit button to
view and edit the current batch command file. Refer to section 14 for detailed
information about creating and running batch command files.
After you have exported data from a file you can continue with the same file, or
select another file to continue, or click the Close button to close the dialog without
further exporting data.
126 BeatScope 1.1, User’s Guide
To enable time or beat averaging in a file, click on Data menu and then on
Averaging.
The files that are currently open are listed. To change data averaging click the
name of the file first, then click either on:
• No averaging, or
• Time averaging and enter the number of seconds to average, or
• Beat averaging and enter the number of beats (or lines, samples) to average.
Press OK to close the dialog. If you click on Cancel the current averaging is not
changed.
Note : Refer to Appendix C for more information about beat and time averaging.
At intervals of defines the analysis interval. Use this field to do the same analysis
repeatedly at consecutive intervals in the time. You can for instance output
descriptive statistics at 30 min intervals, which is a convenient way to analyze a 24
h file recorded with Portapres.
Include : The box enables you to select a subset of all available analysis results:
• Mean mean signal level
• SD standard deviation of the mean
• Min,Max minimum and maximum values.
• Median 10,90 % the 10th and 90th percentiles.
• Area defined as mean signal level times analyzed period (s).
128 BeatScope 1.1, User’s Guide
Statistics You can either calculate statistics in all signals (possibly in different
files) that are visible on screen or you can analyze all signals in a specified file.
Select the file from the drop-down list with files which are currently open.
Note: The statistical analysis always uses all data (beats, samples) in a time period
independent of the currently selected beat or time averaging.
You can also use the Add button at this time. Then the statistics command is not
executed immediately but stored in a batch command file. Use the Edit button to
view and edit the current batch command file. Refer to section 14 for detailed
information about creating and running batch command files.
The edit box can be used to copy (selected) data to the clipboard, and to output
analysis results to a Printer Print or file Save. Finally you can wipe the text with
the Clear button to start all over again.
BeatScope 1.1, User’s Guide 129
It is possible to load your own event files and to display the event markers in the
viewports and in the numerical Beat results window. An event file should always
contain a time column followed by a string of characters (the event text).
100.20 START_VALSALVA
201.40 STANDING
The time column can be either in seconds (relative to start of the other files), in
hh:mm:ss (relative to the other files), or the time of day. Events loaded from such a
separate event file are labeled ‘[Evt]’ in the Beat results window and in the printer
and file output.
To load an event file, click Options menu and then click Load Event file. If you
do not want to use the extra events anymore click Options and then click Unload
event file.
With the Events filter dialog you can define which type of events you want to
hide. Click on Data menu and then on Event masking. You can either use :
• All events, there are no masked events
• Do NOT use the following events. Set a checkmark next to each event type
that you want to hide from now on.
If you have selected the events that have to be masked click the OK button.
In the Start timing of files dialog the filename and the corresponding start time of
all open files are displayed in a table. Update the start time(s) of the files, then
click the OK button to effectuate.
BeatScope 1.1, User’s Guide 131
14.1 Syntax
The following information is important if you want to edit batch command files:
• Batch command files are ASCII text files.
• Batch command files can only be used in combination with BeatScope
• Information in the batch command files is not case sensitive
• A line starting with ‘%’ is treated as a comment.
• Empty lines are allowed
• If the keyword ‘STOP’ is found, BeatScope will stop processing the batch
command file.
• If a line starts with a word preceded by ‘:’ (colon) that word is treated as a
label, e.g. ‘:ERROR’ is a label with the text ‘ERROR’. You can use GOTO
ERROR to jump to the ERROR label and continue processing commands after
the label.
• Usually all commands consist of a combination of the following lines:
Notes:
1. INPUT statement. Filenames can have up to 255 characters. File names cannot
include any of the following characters: forward slash (/), backslash (\), greater
than sign (>), less than sign (<), asterisk (*), period (.), question mark (?),
quotation mark (“), pipe symbol (|), colon (:), or semicolon (;).
2. OPTIONS statement. Options are always separated by comma’s. Note that this
differs from command line options in a DOS or Windows program, where
spaces are used. Options can be entered in any order.
3. PERIOD statement: The period line consists of two or three tokens separated
by comma’s:
- The start time in seconds, or hh:mm:ss format, followed by
- The stop time in seconds, or hh:mm:ss format, or the 'END', followed by
- The time interval (optional). May be omitted or set to 0.0 if not used.
INPUT=C:\PROGRAM FILES\BEATSCOPE\EXAMPLE.DAT,2,100,0
BeatScope 1.1, User’s Guide 133
OUTPUT=D:\beatscop\OUT\EXAMPLE.R00
OPTIONS=m30,h180,w80,mf100,very,ch2,Fin1,mrk2,
and the same command on a Dutch PC is (comma decimal separator, ‘;’ list
separator)
INPUT=C:\PROGRAM FILES\BEATSCOPE\EXAMPLE.DAT;2;100;0
OUTPUT=D:\beatscop\OUT\EXAMPLE.R00
OPTIONS=m30;h180;w80;mf100;very;ch2;Fin1;mrk2;
The easiest way to find out which options are available for a certain command is:
• to invoke the dialog corresponding to the batch command you are going to
use,
• to configure the dialog, and then
• to click the Add button instead of the Run button.
If you click the Add button the batch command is created by BeatScope and added
to the end of the current batch command file. If no batch file has been opened yet,
the default internal name ‘COMMAND FILE’ is used, until you save the file.
If you click the Edit button the current batch command file is displayed. You can
edit the batch command file if necessary. To close the dialog, click on Close.
Although the view on the batch command file is now closed, it can be reopened
any time when you click the Edit button. The current batch command file is not
saved or closed yet, the Close button only hides the batch command file dialog.
To run the batch command file click on the Run button in the dialog shown above.
Then the following message is displayed:
134 BeatScope 1.1, User’s Guide
You can run a batch analysis without saving it, but generally it is recommended to
first save the batch command file.
Before the batch command file starts the following message is displayed.
The batch file usually contains commands that output data to files on disk. If one or
more output files already exist data are overwritten by the batch analysis. Click the
Yes button to start processing the batch command file, click No to cancel.
14.3.1 Beatfast
Configuration section A beat to beat analysis batch command usually starts with a
[CONFIG] section with configuration details for the Beatfast analysis. The most
BeatScope 1.1, User’s Guide 135
[CONFIG]
%empty section, default configuration
[BEATFAST]
INPUT=
[BEATFAST] section
[CONFIG]
numchan=2
mrkchan=2
hitchan=2
[BEATFAST]
INPUT=C:\PROGRAM FILES\BEATSCOPE\EXAMPLE.DAT,2,100,0
OUTPUT=D:\beatscop\OUT\EXAMPLE.R00
OPTIONS=m30,h180,w80,mf100,very,ch2,Fin1,mrk2,
BeatScope 1.1, User’s Guide 137
14.3.2 Printres
Use the Printres command to convert beat-results to ASCII text files that can be
further processed with a text editor or spreadsheet program.
[PRINTRES] section
[PRINTRES]
INPUT=C:\PROGRAM FILES\BEATSCOPE\EXAMPLE.R00
OUTPUT=C:\PROGRAM FILES\BEATSCOPE\EXAMPLE.PRN
OPTIONS=beat,at10,thr
PERIOD=0.00,End,0.0
138 BeatScope 1.1, User’s Guide
14.3.3 Plotfast
Use the Plotfast command to print stripchart graphs on your printer.
[PLOTFAST] section
Note 1: The number following the signal code is the maximum Y-axis value.
Therefore, the S200 option requests an Y-axis 0 to 200 mmHg for systolic
pressure.
Note 2: The plot options can be combined. Use e.g. V100;C40 to combine stroke
volume and compliance in the same ViewPort. An example:
14.3.4 Export
The export command enables you to export and convert data from one file to
another file.
[EXPORT] section
INPUT=C:\PROGRAM FILES\BEATSCOPE\EXAMPLE.R00
OUTPUT=D:\beatscop\OUT\example.out
OPTIONS=ASC,AB1,TSR,NOHDR,NOFRM,BEAT,1:9
PERIOD=130,160
14.3.5 Statistics
Use the descriptive statistics command to analyze (selections of) your data files.
[Statistics] section
Note 1: If THA is selected the start and stop time are interpreted as time of day
too.
[STATISTICS]
BeatScope 1.1, User’s Guide 141
INPUT=C:\PROGRAM FILES\BEATSCOPE\EXAMPLE.R00
OUTPUT=D:\beatscop\OUT\stat.txt
OPTIONS=DATAROW,Mean,StDev,Median,File,Time,tsr,1:9
PERIOD=0.000,100.000
14.3.6 Execute
Use the execute command to run a Windows or DOS program from the batch
command file.
[EXECUTE] section
14.3.7 Exitprogram
Use the EXITPROGRAM command to close BeatScope, and to return control to
the calling program, perhaps a Windows batch file.
142 BeatScope 1.1, User’s Guide
BeatScope 1.1, User’s Guide 143
1) These are the default signal names for a text data file. Use the File, Info
Structure menu to change column names and/or units
2) The table shows the default names of signals in a binary samples file. Use the
File, Info Structure menu to change channel names and/or units
3) A beat-to-beat analysis in Finometer can be either performed on the ‘raw’
finger pressure (finAP) or on the waveform filtered and level corrected finger
pressure (reBAP). If no pressure waveform filtering to brachial pressure was
applied during the Finometer measurement the reBAP signal can not be
computed in BeatScope and is thus ‘NotAvail’.
BeatScope 1.1, User’s Guide 145
4) If external inputs were used, the height channel, the arm cuff channel and/or
the channel containing the plethysmogram will contain the external inputs.
5) If a special channel is used in a Beatfast analysis, this signal may have another
name and units
6) Analysis information: see table in section 3.2.2
146 BeatScope 1.1, User’s Guide
BeatScope 1.1, User’s Guide 147
dsptype=near
sigleft=vol
Where N is a number.
BeatScope 1.1, User’s Guide 151
Each data line (at time t) has the averaged data of the beats and/or parts of the
beats in the episode t-N to t+N, i.e. twice the interval N. Note that averaged data
contain partially overlapping episodes.
Beat averaging
If you specify averaging over N beats, each Nth beat a beat result is output.
The instant of the median (M) beat is displayed, the beat data are the averaged beat
results of beats M-N to M+N-1. Note that averaged data contain partially
overlapping episodes.
152 BeatScope 1.1, User’s Guide
BeatScope 1.1, User’s Guide 153
Finapres
Imholz BPM, Settels JJ, van den Meiracker AH, Wesseling KH, Wieling W.
Noninvasive continuous finger blood pressure measurement during orthostatic
stress compared to intra-arterial pressure. Cardiovascular Research 1990;24:214-
221.
Portapres
Waveform filtering
Index
A
Add (to batch file) button..................................................................................... 133
Adjust start timing of files ................................................................................... 130
Arterial pressure sites............................................................................................. 77
Artifacts ........................................................................................................... 29, 42
Auto scaling ......................................................................................................... 114
Averaging .................................................................................................... 126, 151
B
Batch command file ....................................................................................... 43, 131
Beat results window............................................................................................. 117
BEATFAST
available keys..................................................................................................... 94
batch command ................................................................................................ 134
Beat analysis messages ...................................................................................... 94
Configuration ................................................................................................... 147
PROGRAM........................................................................................................ 11
Run time screen ................................................................................................. 90
Beatport
Control keys....................................................................................................... 55
Entering Comments............................................................................................ 54
Run time screen ........................................................................................... 52, 90
Samples file ....................................................................................................... 51
Beat-to-beat file record .......................................................................................... 41
Beat-to-beat results file.......................................................................................... 41
Binary samples file ................................................................................................ 40
BMI ......................................................................................................................... 9
Browsing................................................................................................................ 35
C
Calibration factor ............................................................................................. 55, 85
Cardiac output........................................................................................................ 96
CO.......................................................................................................................... 29
Color selection for signals ................................................................................... 114
CONFIG section .................................................................................................. 134
Configuration file..................................................................................... 55, 89, 147
Configuration section........................................................................................... 134
158 BeatScope 1.1, User’s Guide
Customer support................................................................................................... 15
Cw.......................................................................................................................... 29
cZ method .............................................................................................................. 84
D
Damped pulse ........................................................................................................ 94
Date+time files....................................................................................................... 45
Decompress Portapres M2 file............................................................................... 63
Dias........................................................................................................................ 28
Diastolic pressure............................................................................................. 12, 96
Dicrotic notch ........................................................................................................ 12
Dongle ................................................................................................................... 18
Download......................................................................................................... 58, 60
E
Edit button ........................................................................................................... 133
Ejection time.................................................................................................... 12, 96
E-mail address ....................................................................................................... 15
Event file.............................................................................................................. 129
Event filter ........................................................................................................... 130
Event masking...................................................................................................... 130
EXAMPLE.DAT ................................................................................................... 23
Execute batch command ...................................................................................... 141
Execution speed ..................................................................................................... 82
Export .................................................................................................................... 37
Export batch command ........................................................................................ 139
Exporting ............................................................................................................. 123
Extension
.H00 ................................................................................................................... 46
.R00 ................................................................................................................... 24
.S00.................................................................................................................... 46
F
File format definition ........................................................................................... 109
File names.............................................................................................................. 46
File structure information .................................................................................... 116
Finapres ................................................................................................................... 9
Finapres Medical Systems ..................................................................................... 15
Flash card directory ............................................................................................... 57
Flash link ............................................................................................................... 58
troubleshooting .................................................................................................. 57
Flash Memory Card ............................................................................................... 10
BeatScope 1.1, User’s Guide 159
FMS ....................................................................................................................... 15
G
GOTO .................................................................................................................. 131
H
Header file ....................................................................................................... 40, 44
Heart rate ......................................................................................................... 12, 96
Height correction system ....................................................................................... 10
Hgt ......................................................................................................................... 29
I
Ibi........................................................................................................................... 29
INPUT line .......................................................................................................... 132
Interbeat interval.................................................................................................... 96
L
Label in batch file ................................................................................................ 131
Level calibration .............................................................................................. 77, 86
Level correction ......................................................................................... 52, 77, 85
Line type .............................................................................................................. 114
Literature ............................................................................................................. 153
M
Marker ................................................................................................................... 80
Marker detection.................................................................................................... 77
Mean ...................................................................................................................... 28
Mean arterial pressure............................................................................................ 12
Mean pressure........................................................................................................ 96
MODELFLO
PROGRAM........................................................................................................ 11
Modelflow Method .......................................................................................... 10, 84
Monitoring and Control (Portapres) ...................................................................... 47
N
No pulsation........................................................................................................... 95
Normalize time .................................................................................................... 116
P
Parallel port protection device ............................................................................... 18
Peripheral resistance .............................................................................................. 96
Physiocal.......................................................................................................... 77, 95
160 BeatScope 1.1, User’s Guide
Plotfast
Batch command ............................................................................................... 138
Program ........................................................................................................... 101
Porta....................................................................................................................... 47
Portapres ................................................................................................................ 10
Control unit........................................................................................................ 10
Event file............................................................................................................ 62
M2 file ................................................................................................... 41, 63, 80
Pressure and flow waveforms file .......................................................................... 88
Pressure level shift ................................................................................................. 86
Pressure sites.......................................................................................................... 77
Printing ................................................................................................................ 119
Printres
Batch command ............................................................................................... 137
Program ............................................................................................................. 97
Pulse contour ......................................................................................................... 84
Pulse interval ................................................................................................... 12, 86
R
R.T.F...................................................................................................................... 86
Rate........................................................................................................................ 29
Return-to-flow channel .......................................................................................... 81
Run time events ..................................................................................................... 41
S
Samples files.......................................................................................................... 39
Samples files, defining......................................................................................... 109
Selection dialog ..................................................................................................... 22
Session file............................................................................................. 44, 105, 121
Signal names .......................................................................................................... 34
Signal selection.............................................................................................. 34, 113
Signals ........................................................................................................... 33, 112
Site......................................................................................................................... 81
Special channel .......................................................................................... 77, 86, 95
Speed Bar............................................................................................................... 31
Start timing .......................................................................................................... 130
Statistics
Batch command ............................................................................................... 140
Utility............................................................................................................... 126
Status Bar............................................................................................................... 31
STOP ................................................................................................................... 131
Stroke volume.................................................................................................. 12, 96
BeatScope 1.1, User’s Guide 161
Support .................................................................................................................. 15
Syst ........................................................................................................................ 28
Systolic area........................................................................................................... 86
Systolic pressure .............................................................................................. 12, 96
T
Tej.......................................................................................................................... 29
Text data file.................................................................................................. 43, 110
Time....................................................................................................................... 28
Time Bar ................................................................................................................ 31
Time format ......................................................................................................... 116
Time window ....................................................................................................... 114
Timing menu........................................................................................................ 116
TNO pulse contour method.................................................................................... 84
TNO samples file................................................................................................... 39
TNO-TPD-Biomedical Instrumentation................................................................... 9
TPR........................................................................................................................ 29
U
Upstroke .......................................................................................................... 12, 96
Utility
Beat analysis ...................................................................................................... 22
Portapres ............................................................................................................ 22
Utilities .............................................................................................................. 22
View files........................................................................................................... 22
V
View Files
Run time screen ............................................................................................... 105
Utility......................................................................................................... 30, 105
Viewport setup..................................................................................................... 112
Viewports............................................................................................................... 34
Vol ......................................................................................................................... 29
W
Waveform filtering .......................................................................................... 52, 77
WWW site ............................................................................................................. 15
Z
ZO.......................................................................................................................... 29