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.

https://global.download.synology.com/download/Tools/CloudStationDrive/4.2.7-4415/Windows/Installer/Synology%20Cloud%20Station%20Drive-4.2.7-4415.msi

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..

https://www.synology.com/ko-kr/knowledgebase/DSM/tutorial/Backup_Restore/How_to_back_up_your_data_to_a_remote_Synology_NAS_or_file_server_with_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.