raw_100

Section: WIN SYSTEM (1W)
Updated: 1997.6.30
Index Return to Main Contents

NAME

raw_100 - Changing sampling rate of RAW format data to 100 Hz

SYNOPSIS

raw_100 inkey outkey shmsize [ chfile [ logfile ]]

DESCRIPTION

Raw_100 loads win format data written in a shared memory segment identified by a key inkey, leaves data of channels with a sampling rate of 100 Hz as are, and linearly interpolates and converts data of channels with a sampling rate not being 100 Hz into ones with a sampling rate of 100 Hz. In either case, raw_100 writes the data to another shared memory segment identified by another key outkey. Note, however, that raw_100 writes out data of channels with a sampling rate below 50 Hz as it is, without performing sampling rate conversion. The data format in the input-side shared memory can be either a format with "written time" not sorted in order of time or a format sorted in order of time. Raw_100 automatically determines which format the data is in, and writes the data in the output-side shared memory without changing the format.

In addition to the abovementioned rules, when a channel file chfile is given, only the data of the channels listed in this file will be converted and written while any data of any other channels are not written. If the channel file name is prefixed with '+,' however, only the channels listed in this file will be converted while any other channels are not converted. In whichever case, the data will be written. Alternatively, if the channel file name is prefixed with '-,' the channels listed in this file will not be converted while any other channels are converted. In whichever case, the data will be written. If the channel file chfile is not given or if '-' is specified as the channel file, all the channels will be converted and written.

If the shared memory segment with the key outkey does not exist, a shared memory segment with a size of shmsize (KB) will be created. When it already exists but has a size smaller than shmsize (KB), an error will occur. The shared memory key is a 32-bit integer value.

When log file name logfile is specified, operation log is set here. When it is not specified, log information is sent to the standard output. The log file is opened/closed in each write.

When raw_100 is initiated without argument, brief usage is displayed.

When receiving a hang-up signal, the raw_100 process rereads the channel file.

CHANNEL FILE FORMAT

The channel file is a text file that hexadecimally lists channel numbers, one for each line. In each line, only the first item is read, while the subsequent items delimited by blanks or tabs are all bypassed. Any lines starting with '#' are also bypassed.

FORMAT OF SHARED MEMORIES

Refer to recvt(1W) and order(1W).

OPTIONS

None

SOURCE

`raw_100.c'