Getting Started
한국어Introduction
This guide document is intended to guide clinical researchers who wish to conduct research by collecting biosignal data from patient monitors in operating rooms, intensive care units and emergency rooms.
You can quickly install Vital Recorder and collect data by following this document.
Preparations
- Windows compatible PC to run Vital Recorder
- USB to Serial Converter (1 port, 2 port, 4 port, etc.): This is a converter with a serial port on one side and a USB port on the other side. Many modern computers do not have a serial port, so a converter is required to receive signals from the serial port of the medical device and input them to the USB port of the computer.
- Cross Gender (required on some equipment): On some devices, the pin connection of the serial terminal requires a cross connection. Devices that require cross gender are listed in the document “Device Connection Guide”.
Type of serial cables
Vital recorder can only acquire data from medical devices with serial communication. Serial communication typically uses a 9-pin connector called DB9. The DB9 connector is divided into male/female terminals according to the shape of the terminal and direct/cross (or null modem) types depending on the pin map. Depending on the medical device, the correct terminal shape and pin connection is mandatory.
Different types of cable/gender are required depending on what medical device to be used.
Equipment side connector | Connection method | PC side connector | Gender | Devices |
Female | Direct | Male | Does not require a gender. | GE, BIS |
Female | Cross | Male | F-M Orange; "NULL MODEM" is written | Orchestra |
Male | Direct | Male | F-F Yellow; NULL MODEM is not written; "gender changer" or "US Patent" is written | None |
Male | Cross | Male | F-F Orange; "NULL MODEM" is written | Invos, Edwards devices, PHilips MP400-500 monitors, CardioQ, FMS2000 |
Windows settings
Turn off sleep mode
To prevent Windows from entering sleep mode while recording data, set the Screen Off and Sleep Mode settings to None in the Settings> System> Power & Sleep tab as shown below.
Prevent Automatic Windows Updates
Windows Automatic Updates may cause the Vital Recorder program to stop working.
You can use the following program to force Windows automatic updating to stop..
http://greatis.com/blog/stopupdates10
Even if you stop Windows automatic updating, we recommend that you keep your Windows secure by performing periodic manual updates at the time between data recording.
Do not prompt for password when logging in Windows
Right-click the Windows Start button and click Run (R) or press Windows Key + R to bring up the Run window.
Enter “control userpasswords2”.
Turn off the "User must enter username and password to use this computer (E)" option. If you click OK, you may need to enter your current password once.
Vital Recorder setup
Vital Recorder installation
Install the latest version of Vital Recorder from http://vitaldb.net/vital-recorder/
Vital file storage path setting
You create a folder in which to save your vital files and specify them in Vital Recorder's settings. Below we used the path “C: \ vital”.
RPM (Remote Patient Monitoring) setup
Vital Recorder's real-time monitoring capabilities allow you to monitor data collection remotely. To do this, your computer must be connected to the Internet. Copy the VR code in the Management menu from the Vital Recorder's Settings menu.
Log in to vitaldb.net with your account and register the code you copied in the VR Code field at http://vitaldb.net/web-monitoring/.
Data backup
Vital Recorder stores data in local storage (HDD, SSD) on the computer where the program is installed. However, you can maintain stability by backing up your data using a private or commercial cloud. We recommend backing up your data to the cloud and periodically deleting data from your local computer using the two-way sync feature of your personal NAS (Network Attached Storage). Below is an example of using Synology, a representative device of a personal NAS.
Sync program settings
Install cloud station drive to synchronize data between Synology NAS and local storage.
Please refer to Synology homepage for detailed usage.
File Management on Researcher Computers
The folders on the synced NAS can be synced back to the researcher's computer. Install a cloud station drive on your research computer and sync it bidirectionally with the data upload folder on your NAS. Now deleting the files in the Sync folder from the Researcher's folder will simultaneously delete them from the local storage on all computers where the NAS and Vital Recorder are installed. You need to calculate the storage space of all the depots and repeat the backup and delete periodically.
Automated Backup and Versioning with Hyper Backup
Synology's Hyper Backup package allows you to recover data to an earlier point in time, even if you accidentally delete or overwrite it. See the links below to learn more about Hyper Backup..
Data Preparation
The biosignal data automatically collected by Vital Recorder is stored as a case file (* .vital).
Creating Patient Information Summary File
Vital Recorder does not handle any personal information and therefore requires matching of vital files with corresponding patient information. Use Excel or Google Spreadsheets to registry each patient's case number and relevant clinical information and record each patient's case file name (* .vital) together.
Batch Extraction of Data
The Vital Utility program, distributed with Vital Recorder, allows you to batch extract the desired tracks from the Vital files in a specific folder at the desired resolution. The extracted files can be loaded in analysis programs such as SPSS, R and Excel in csv format.
Batch Processing
To read or batch process data from multiple vital files, you must use a programming language. You can do this with the help of the utilities that are installed with Vital Recorder.
For example, vital_recs.exe is a utility program for batch extraction of data. This allows you to extract data samples from vital files in any programming language you are familiar with.
Open vital file with Python
import csv
import subprocess
ipath = "1.vital"
interval = 1
p = subprocess.Popen('vital_recs.exe -h "{}" {}'.format(ipath, interval), stdout=subprocess.PIPE)
output = p.communicate()[0].decode("utf-8")
for row in csv.reader(output.splitlines()):
print(row)
Open vital files using Python and Pandas libraries
import io
import subprocess
import pandas as pd
ipath = "1.vital"
interval = 1
p = subprocess.Popen('vital_recs.exe -h "{}" {}'.format(ipath, interval), stdout=subprocess.PIPE)
df = pd.read_csv(io.StringIO(p.stdout.read().decode('utf-8')), index_col=0)
print(df)
Extract vital file tracks of specific folder with Python and Pandas
import io
import os
import csv
import subprocess
import pandas as pd
rootdir = r"//Vitalnew/vital_data/Monthly_Confirmed/SNUH_OR"
for dir, dirs, files in os.walk(rootdir):
for file in files:
ipath = '{}/{}'.format(dir, file)
cmd = 'vital_trks {}'.format(ipath)
p = subprocess.Popen(cmd, stdout=subprocess.PIPE)
df = pd.read_csv(io.StringIO(p.stdout.read().decode('utf-8')), comment='#')
devs = []
for index, row in df.iterrows():
if row['tname'] != 'SV':
continue
devs.append(row['dname'])
if not devs:
continue
print('{},{}'.format(ipath[len(rootdir)+1:], ','.join(devs)))
Open vital file in R
load_vital <- function (path, interval=1) {
cmd <- paste0("vital_recs.exe -h ", path, " ", interval)
return (read.csv(pipe(cmd)))
}
# load vital file and get samples at 1 sec interval
vit <- load_vital("1.vital", 1)
# print maximum arterial pressure
print(max(vit$SNUADC.ART1, na.rm=TRUE))
Conclusion
Congratulations on starting your biosignal data collection and research.
You can also use the collected data for collaborative research with other researchers.