cat

speech signal process tools

		     | sqrt	 square	root   |
		     | tan	 tangent       |
		     |__________________________|
		_____________________________________
	       |	 Functions on Fields	    |
	       |_________________________________________________________________________|_
	       | max	maximum	of elements in field|
	       | mean	mean of	elements in field   |
	       | min	minimum	of elements in field|
	       | prod	product	of elements in field|
	       | size	number of elements in field |
	       |_s_u_m_____s_u_m__e_l_e_m_e_n_t_s__i_n__f_i_e_l_d_________|

     The only legal argument for functions on fields is	a  single
     <field_name>   without   an   index.    In	 this  case,  the
     <field_name> refers to the	entire field.

     If	<external_function> is	found  in  an  expression  _s_e_l_e_c_t
     searches  the  users  current  PATH  for  a program with the
     specified	name.	This  program  is  assumed  to	accept	a
     single-record ESPS	FEA file as its	only argument and to out-
     put a value (ASCII) on standard  output.  _S_e_l_e_c_t  creates	a
     single-record  ESPS file from each	record in the input files
     and calls <external_function> with	this file; the output  of
     <external_function>  is then used within the query. An exam-
     ple of the	source code for	an external function can be found
     in	 the  _s_e_l_e_c_t  source  directory,  or in	/usr/sps/lib on	a
     non-source	system.

     There are several built in	field  names  that  have  special
     meaning.  The are:







	Copyright Entropic Research Laboratory,	Inc. 8G8	8






SELECT(1-ESPS)				    ENTROPIC RESEARCH LAB



_______________________________________________________________________________________
 |______________________________________________B__u__i__l__t____i__n____F__i__e__l__d____N__a__m__e__s_______________________________________________|_
 | tag	  built	in tag field of	the record			   |
 | REC	  record number	(from 1)				   |
 | FILE	  file name of the input file within the set of	input files|
 |__________________________________________________________________|
     The field name "tag" always refers	to the built in	tag field
     of	 the  record.	(See  the  discussion of tags and segment
     labelling under DESCRIPTION.)  The	name "REC" refers to  the
     record  number  (from  1)	of the record in the set of input
     files and the name	"FILE" refers  to  the	filename  of  the
     input file	in the set of input files.

EEEEXXXXPPPPRRRREEEESSSSSSSSIIIIOOOONNNN EEEERRRRRRRROOOORRRRSSSS
     There are three types of expression errors.

     The first type are	 syntax	 errors	 caught	 by  the  parser.
     These  result result in a "syntax error" message followed by
     the offending character.	In the current release,	the query
     is	 usually  executed  anyway.   If the selected records are
     not wanted, they can be removed from  the	buffer	with  the
     UUUUNNNNDDDDOOOO command.  If the select is long (because the input file
     is	large) then  the  select  can  be  interrupted	and  then
     undone.   This will be improved in	a future release.

     The other type of expression errors relate	to the	execution
     of	 the  expression  itself.  These include use of	undefined
     fields, undefined functions, field	indexes	 out  of  bounds,
     arithmetic	 overflow  and	underflow,  and	 divide	 by zero.
     Errors that cannot	change from one	record or one input  file
     to	 the  next  are	considered fatal and terminate the SSSSEEEELLLLEEEECCCCTTTT
     (or EEEEVVVVAAAALLLL or SSSSHHHHOOOOWWWW SSSSEEEELLLLEEEECCCCTTTT).	This type of error is  caused  by
     trying  to	 call  an  undefined built in function or trouble
     running an	external function.

     The other errors described	above cause  the  termination  of
     the  expression  for  the current record.	In most	cases the
     expression	evaluates to zero.   In	 the  case  of	undefined
     field  and	 index	out  of	 bounds, zero is returned and the
     expression	continues.   In	the case of arithmetic	problems,
     the  expression  is  terminated and zero is returned for the
     expression.  The reason that these	errors are not	fatal  is
     that  several input files might be	open and they do not have
     to	all have the same fields.   A field might not be  defined
     for one file of the input set, but	might be defined for oth-
     ers.  Therefore, the query	should be allowed to process.	A
     message is	printed, once for each file, in	the case of these
     errors.   The  query  can	be  interrupted	 if  the  desired
     results will not be achieved.

     In	all cases a message is printed	stating	 what  action  is
     being taken when errors are found.



	Copyright Entropic Research Laboratory,	Inc. 9G9	9






SELECT(1-ESPS)				    ENTROPIC RESEARCH LAB



EEEESSSSPPPPSSSS PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     The ESPS parameter	file is	not read by _s_e_l_e_c_t.

EEEESSSSPPPPSSSS CCCCOOOOMMMMMMMMOOOONNNN
     ESPS Common file is not read or written by	_s_e_l_e_c_t.

EEEESSSSPPPPSSSS HHHHEEEEAAAADDDDEEEERRRRSSSS
     _S_e_l_e_c_t reads the _c_o_m_m_o_n._t_y_p_e field	from the header	of  _i_n_p_u_t
     (to  make	sure  that  it	is of type FEA), and it	reads the
     field-defining information	as well. If output files  do  not
     exist,  their headers are created with _c_o_p_y__h_e_a_d_e_r	(3-ESPS).
     Unless the	----nnnn option is used, the headers	of  output  files
     are  expanded  to include the the input files as sources and
     the selection queries as comments	in  the	 _v_a_r_i_a_b_l_e._c_o_m_m_e_n_t
     field.

EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
     The PPPPAAAAGGGGEEEERRRR environment variable determines what  paging  pro-
     gram is used to break up large displays of	text. By default,
     the _m_o_r_e program is used (however,	this may  be  changed  by
     the installer).  To use a different pager (or if your system
     doesn't have _m_o_r_e), set this environment  variable	 to  some
     other value.  A full pathname is not required.  If	you don't
     like paging, try setting PPPPAAAAGGGGEEEERRRR to _c_a_t.

EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     _T_h_i_s _c_o_m_m_a_n_d _g_a_t_h_e_r_s _a_l_l _v_o_i_c_e_d _f_r_o_m _t_h_e _i_n_p_u_t _f_i_l_e_s _i_n_t_o _a_l_l_v_o_i_c_e_d._f_e_a
     select -q 'frame_type == "VOICED"'	-o allvoiced.fea *.fana

     _T_h_i_s _c_o_m_m_a_n_d _a_p_p_l_i_e_s _a _c_o_m_m_a_n_d _f_i_l_e _o_f _q_u_e_r_i_e_s _o_n _f_i_l_e_1 _w_i_t_h _o_u_t_p_u_t _t_o _f_i_l_e_2
     select -o file2 file1 < commands

     Examples of queries:

     select pulse_len =	90 & frame_type	= "VOICED"
       _f_r_a_m_e__t_y_p_e _i_s _a _C_O_D_E_D _t_y_p_e

     select (a = 3 & FILE = "f1") | (b = 4 & FILE = "f2")
       _t_h_i_s _m_e_a_n_s _t_o _s_e_l_e_c_t _r_e_c_o_r_d_s _w_i_t_h _a = _3 _f_r_o_m _i_n_p_u_t _f_i_l_e
       _f_1 _a_n_d _b	= _4 _f_r_o_m _i_n_p_u_t _f_i_l_e _f_2;	_a_s_s_u_m_i_n_g _t_h_a_t _t_h_e_r_e
       _a_r_e _a_t _l_e_a_s_t _t_w_o	_i_n_p_u_t _f_i_l_e_s

     select sqrt(gamma)/4 > alpha[3]
       _I_f _g_a_m_m_a	_i_s _a _f_i_e_l_d _o_f _s_i_z_e _o_n_e,	_t_h_e_n _i_t_s _v_a_l_u_e _i_s _u_s_e_d _b_y _t_h_e _s_q_r_t
       _f_u_n_c_t_i_o_n.   _I_f _g_a_m_m_a _i_s _a _f_i_e_l_d _o_f _g_r_e_a_t_e_r _t_h_a_n _s_i_z_e _o_n_e, _t_h_e_n _t_h_e
       _e_l_e_m_e_n_t _i_s _u_s_e_d (_s_a_m_e _a_s	_s_a_y_i_n_g _g_a_m_m_a[_0]).

     select sum(gamma) > mean(beta)
       _T_h_e_s_e _f_u_n_c_t_i_o_n_s _o_p_e_r_a_t_e _o_n _e_n_t_i_r_e _f_i_e_l_d_s, _s_o _t_h_e	_f_i_e_l_d_n_a_m_e _h_e_r_e
       _w_i_t_h_o_u_t _t_h_e _i_n_d_e_x _d_o_e_s _n_o_t _r_e_f_e_r	_t_o _o_n_l_y	_t_h_e _f_i_r_s_t _e_l_e_m_e_n_t; _i_t _r_e_f_e_r_s
       _t_o _t_h_e _e_n_t_i_r_e _f_i_e_l_d.




       Copyright Entropic Research Laboratory, Inc. 10G10      10






SELECT(1-ESPS)				    ENTROPIC RESEARCH LAB



     select sum(gamma) > mean(beta) && ($func1 > 45.6)
       _s_u_m _a_n_d _m_e_a_n _a_r_e	_f_u_n_c_t_i_o_n_s _o_f _f_i_e_l_d_s.  $_f_u_n_c_1 _i_s	_a _u_s_e_r _s_u_p_p_l_i_e_d
       _e_x_t_e_r_n_a_l	_p_r_o_g_r_a_m	_w_h_i_c_h _i_s _c_a_l_l_e_d	_f_o_r _e_a_c_h _r_e_c_o_r_d.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ESPS(5-ESPS), FEA(5-ESPS)

FFFFUUUUTTTTUUUURRRREEEE CCCCHHHHAAAANNNNGGGGEEEESSSS
     Provide a method to link in user-defined functions	 to  pro-
     vide higher performance than external functions.

WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
     A number of warning and error message  are	 printed  in  the
     event  of	various	expression errors.  Some errors	terminate
     the query.

BBBBUUUUGGGGSSSS
     The following paragraph describes the way _s_e_l_e_c_t will handle
     existing output files and input files with	tags:

     If	the output file	exists and is segment  labelled,  and  if
     there  is	one or more tagged input file, all tagged records
     written  to  the  output  file  are  converted  to	  segment
     labelled.	 If  the output	file exists and	is tagged, and if
     there is one or more tagged input file, the output	 file  is
     converted	from  tagged  to segment labelled, and all tagged
     records written to	the output file	are converted to  segment
     labelled.

     This is not done in this version.	 The pre-existing  output
     file  is  not changed, and	the tag	values copied into it may
     be	meaningless (because the _r_e_f_e_r file might be different.

     A syntax error in a query will terminate the  parse  of  the
     query  and	 it will then run.   After it runs you will get	a
     syntax error message.  If the select, selected records  that
     you don't want, use the "undo" command to undo the	effect of
     the most recent select operation.	Undo  can  only	 be  used
     once  after  each select.	You can't undo an undo (except to
     select again).

     If	referenced fieldname is	a complex feature field, then the
     real  part	 of that is used in the	expression.   Better sup-
     port for complex types will be added in the next version.

AAAAUUUUTTTTHHHHOOOORRRR
     Manual page by John Shore and Alan	Parker
     Program by	Alan Parker







       Copyright Entropic Research Laboratory, Inc. 11G11      11