


MKTRACK(1)               USER COMMANDS                 MKTRACK(1)



NAME
     mktrack -- programmable conversion of annotations to feature
     traces

SYNOPSIS
     mktrack (-i item) (-r samplingrate) (-f feature)  (-h  high-
     val) (-l lowval) trackfile sfsfile

DESCRIPTION
     mktrack creates a track item from an annotation item using a
     file  which  maps  annotations  onto  a  track  construction
     specification.  The output is  constructed  by  sequentially
     applying  the  constructions  derived  from matching annota-
     tions.  Thus it is possible to specify  that  an  annotation
     "X"  should  be mapped to a feature trace that switches from
     low to high 50ms  before  the  annotation  and  extends  50%
     through the duration of the annotation.  The track construc-
     tion specifications are stored in a supplied trackfile, with
     one  file  per feature track to be generated.  The format of
     this file is detailed below.

     The program operates as follows: the specifications  in  the
     trackfile  are  parsed and held in memory.  Matches are made
     between each annotation and each entry in the  track  table,
     the  first matching specification is then held in a process-
     ing table.  Once a specification has been  found  for  every
     annotation  in  the  input,  the  specifications are applied
     sequentially, with later specifications over-writing earlier
     specifications if they overlap.

     Options:

     -I         Identify the program name and version.

     -iitem     Select input item number.

     -rsamplingrate
                Select the sampling rate  for  the  output  track
                item.   Default is 100Hz. Choose sampling rate of
                -1 to obtain sampling rate  of  input  annotation
                item.  Absolute durations in the track specifica-
                tions are multiples of the sample duration.

     -ffeature  Place an entry "feature=XXXXX" in the history for
                the output track.

     -hhighval  High target value.  Default 1. Can also be set in
                specifications.

     -llowval   Low target value.  Default 0. Can also be set  in
                specifications.   Comments  in the track file are
                complete lines beginning with '#',  or  all  text



SFS                     Last change: UCL                        1






MKTRACK(1)               USER COMMANDS                 MKTRACK(1)



                following  Each specification line in the mapping
                file must have the following format:

                    <annotation match list> :: <track construction specification>

                where <annotation match list> is

                    <annotation context> {, <annotation context> }

                and <annotation context> is

                    ( <(> <annotation match> <)> ) <annotation match> ( <(> <annotation match> <)> )

                where <annotation match> is a regular  expression
                (tied  to  start  of  annotation string) matching
                annotations in the input item.  The three matches
                in  an  annotation  context  refer to an optional
                left context match, a mandatory centre match  and
                an  optional  right  context  match.   Thus  <m->
                matches all annotations "m-", while < m-  (ar)  >
                only  matches "m-" when followed by an annotation
                "ar", and < (m-) ar (-k) > matches "ar" when pre-
                ceded by "m-" and followed by "-k".  In all these
                examples, a regular expression could be  used  to
                specify the annotation matches.

     The <track construction specification> consists of:

         <action> <value> { <action> <value> }

     where <value> is a number to be associated with an  <action>
     specifying  how the track is to be built, from the following
     list:

     on         Set track to  high  value  for  <val>  frames  at
                current position.

     off        Set track  to  low  value  for  <val>  frames  at
                current position.

     mid        Set track to middle value (mean of high and  low)
                for <val> frames at current position.

     up         Ramp track from low  value  to  high  value  over
                <val> frames at current position.

     down       Ramp track down from high value to low value over
                <val> frames at current position.

     high       Set high value to be <val>.

     low        Set low value to be <val>.



SFS                     Last change: UCL                        2






MKTRACK(1)               USER COMMANDS                 MKTRACK(1)



     back       Move current position back by <val> frames.

     forward    Move current position forward by <val> frames.

     If the value ends in a "%" sign, it refers to  a  percentage
     of the duration of the current annotation.

EXAMPLES
         # set feature on for every m, n and ng:
         m, n, ng :: on 100%
         # set feature off for all vowels:
         [iIe&VAOQUu@] :: off 100%
         # mark aspirated stops with single frame
         p-rel (p-asp) :: off 100% back 100% on 1
         # ramp over ar - liquid - ar
         (ar) [lrwj] (ar) :: back 5 up 5 on 100% down 5


VERSION/AUTHOR
     1.1 - Mark Huckvale

SEE ALSO
     antr

SOURCE
     /users/mark/sfs/man/../prw/util.src/mktrack.c





























SFS                     Last change: UCL                        3



