


LINK(SFS1)        MISC. REFERENCE MANUAL PAGES         LINK(SFS1)



NAME
     link - link primary speech data to secondary SFS file

SYNOPSIS
     link sfs_source newfile
     link -i item (-s|-S start) (-e|-E end) sfs_source (destfile)
     link -i item -f freq (-c chan/#chan)  (-s|-S  start)  (-e|-E
     end)
     (-n networkname) (-b) (-d DC) (-m mult) binary_source  dest-
     file

DESCRIPTION
     link is a program to create one or more "virtual items" in a
     SFS  file  that  link  back  to some primary data in another
     file.  The data can be accessed through the SFS file as nor-
     mal,  but  the primary data cannot be affected by any opera-
     tion.  The program operates in three modes:

     1.         Link whole contents of existing SFS file  to  new
                SFS file.

     2.         Link single item in existing SFS file to existing
                SFS file.

     3.         Link part of a binary  file  to  an  item  in  an
                existing SFS file.

     The program takes two files, the  second  of  which  ("dest-
     file")  must  be  a SFS file.  In the first mode, "destfile"
     must not already exist.  The primary file ("xxx_source") can
     one of the following:

          SFS file on host machine
          binary file, single channel, on host machine
          binary file, multiple channels, on host machine
          binary file, single channel, on networked file server
          binary file, multiple channels, on networked file server

     Files on the host machine are  specified  with  a  filename.
     Files  accessed through a file server running the UCL proto-
     col are specified with a host  name  ("networkname")  and  a
     filename.

     For SP and LX items in SFS or binary files, a  part  of  the
     primary  data  set  may be linked, using specified start and
     end times (in seconds or samples).

     Binary data may be transformed by  (i)  selecting  channels,
     (ii)  swapping  bytes,  (iii)  removing a DC offset and (iv)
     shifting bit pattern up/down word.  Options and their  mean-
     ings are:




SFS                     Last change: UCL                        1






LINK(SFS1)        MISC. REFERENCE MANUAL PAGES         LINK(SFS1)



     -I         Identify program and exit.

     -iitem     (sfs source) Select primary item.  Single item is
                linked.
                (binary source) Specify datatype.  Single item is
                linked.

     -ffreq     (binary source)Specify sampling frequency in Hz.

     -cchan/#chan
                (binary source)Specify channel number and  number
                of  channels  for  multiplexed  binary data.  For
                example:  two-channel  data  acquired  and  first
                channel required: "-c 1/2". Default is "-c 1/1".

     -sstart    Specify start time for linked item (in seconds).

     -Sstart    Specify start time for linked item (in samples).

     -eend      Specify end time for linked item (in seconds).

     -Eend      Specify end time for linked item (in samples).

     -nnetworkname
                Specify network host for file.  Host must be run-
                ning UCL File Server.

     -b         (binary source)Swap bytes in sampled data.

     -dDC       (binary source)Subtract value given by "DC"  from
                samples. Performed after byte swapping.

     -mmult     (binary  source)Shift  sampled  bit  pattern   up
                (positive  shift) or down (negative shift) by the
                number of bits specified  in  "mult".   Performed
                after byte swapping and DC offset correction.

VERSION/AUTHOR
     2.1 - Mark Huckvale

BUGS
     Item offsets are not preserved in links to individual  items
     across files.

SOURCE
     /users/mark/sfs/man/../src/link.c









SFS                     Last change: UCL                        2



