cat

speech signal process tools

SELECT(1-ESPS)				    ENTROPIC RESEARCH LAB



NNNNAAAAMMMMEEEE
     select - applies arbitrary	queries	to select records from FEA files

     eselect - applies arbitrary queries to select records from	FEA files

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     sssseeeelllleeeecccctttt [ ----nnnn ] [ ----cccc	] [ ----qqqq _q_u_e_r_y ] [ ----eeee _e_x_p_r_e_s_s_i_o_n ]  [   ----	ffff
     _f_o_r_m_a_t _s_t_r_i_n_g ] [ ----llll _l_o_g ]	[ ----oooo _o_u_t_p_u_t ] [	_i_n_p_u_t_1 _i_n_p_u_t_2 ...
     ]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     This program is stored under the name _s_e_l_e_c_t and _e_s_e_l_e_c_t  in
     order  to avoid a name conflict with the _k_s_h builtin command
     _s_e_l_e_c_t.

     _S_e_l_e_c_t  applies  selection	 criteria  to  FEA  files.    The
     selected  records	may  be	 printed  and  may appended to an
     internal record buffer, which  in	turn  may  be  output  to
     another FEA file.	The selection criteria are specified as	a
     set of queries, with each query being  a  condition  on  the
     fields in the FEA record.

     _S_e_l_e_c_t operates in	two modes:  non-interactive and	 interac-
     tive.   The  non-interactive mode applies when the	----qqqq and ----oooo
     options are used.	In this	 case,	the  specified	query  is
     applied  to  all of the _i_n_p_u_t files and the selected records
     are written to _o_u_t_p_u_t.

     In	interactive mode (no ----qqqq	option), _s_e_l_e_c_t	prompts	the  user
     for  commands  (see below).  Alternatively, a file	of selec-
     tion commands can be used as standard input (e.g.,	_s_e_l_e_c_t	<
     _c_o_m_m_a_n_d__f_i_l_e).   Command  files can also be invoked interac-
     tively.

     The following options are interpreted by _s_e_l_e_c_t:

     ----nnnn	   No source files or comments about queries are added to
	  the  headers of output files.	 Normally, 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.  The ----nnnn option	 disables
	  this	and  results in	faster operation, especially when
	  the output file already exists and is	large.

     ----cccc	   By default, comparisons involving  feature  fields  of
	  type	coded  are case	insensitive.   When the	----cccc option
	  is used, these comparisons are case sensitive.

     ----qqqq	_q_u_e_r_y
	  Apply	the _q_u_e_r_y  to  the  _i_n_p_u_t  files  and  write  the
	  selected records to _o_u_t_p_u_t (see ----oooo).




	Copyright Entropic Research Laboratory,	Inc. 1G1	1






SELECT(1-ESPS)				    ENTROPIC RESEARCH LAB



     ----eeee	_e_x_p_r_e_s_s_i_o_n
	  Execute the _e_v_a_l command on the input	 file  and  print
	  the  result  to standard output.   For details, see the
	  _e_v_a_l command below.

     ----ffff	_p_r_i_n_t_f _f_o_r_m_a_t _s_t_r_i_n_g
	  This option allows the specification of a _p_r_i_n_t_f format
	  string  to  be used to output	the values resulting from
	  use of the ----eeee	option.	 The  string  can  be  any  valid
	  _p_r_i_n_t_f  format  string,  except that only the	following
	  character escapes are	handled: \n, \t, \b, \r,  \f,  \\
	  (to  enter  a	slash),	and \' (to enter a single quote).
	  (Note	in particular, that \ddd is not	 handled.)   Keep
	  in  mind that	the value being	displayed is typed _d_o_u_b_l_e
	  inside of the	program.  So use of an incompatible  out-
	  put specification will result	in garbage dispplay.  For
	  example  the	following  option  might  be   used:   ----ffff
	  ''''VVVVaaaalllluuuueeee::::\\\\tttt%%%%eeee\\\\nnnn''''  or  ----ffff  AAAAnnnnyyyy  ssssttttrrrriiiinnnngggg:::: %%%%ffff uuuunnnniiiittttssss\\\\nnnn''''.   The
	  specification	string should contain at most one  output
	  format  control  appropriate for double values (%e, %f,
	  %g).

     ----oooo	_o_u_t_p_u_t
	  Specifies an output file.  This option must be used  if
	  the ----qqqq option	is used, and it	cannot be used unless one
	  or more input	files are specified on the command line.

     ----llll	_l_o_g
	  All user commands, together with  all	 terminal  output
	  from _s_e_l_e_c_t, will be recorded	on a file named	_l_o_g.

     Each command to _s_e_l_e_c_t consists of	one or two keywords  fol-
     lowed  by arguments.  The keywords	may be abbreviated.  Your
     unix interrupt character (_e._g. ^C)	will always terminate the
     current  command.	 Required  portions  of	 the keywords are
     shown in capital letters in the description below;	_s_e_l_e_c_t is
     not sensitive to case.  An	EOF is equivalent to a WWWWrrrriiiitttteeee fol-
     lowed by a	QQQQuuuuiiiitttt....

     Tagged and	segment	labelled input files involve some special
     handling  in  order  to make it possible to associate output
     records with the sampled  data  files  to	which  the  input
     records  refer.   If  the output file does	not exist, and if
     there is only one tagged input file, then the output file is
     also  tagged,  with  the  tags  being pointers into the same
     refer file	as specified in	the input file.	  If  the  output
     file  does	 not  exist,  and if there are two or more tagged
     input files, the output file is segment  labelled,	 and  all
     tagged  records  written to the output file are converted to
     segment labelled.	For the	case of	an existing output  file,
     see  the  note under BUGS below.  For more	information about
     taggged and segment labelled FEA files, see FEA (5-ESPS).



	Copyright Entropic Research Laboratory,	Inc. 2G2	2






SELECT(1-ESPS)				    ENTROPIC RESEARCH LAB



     @@@@_c_o_m_f_i_l_e
	  This command causes _s_e_l_e_c_t to	read  commands	from  the
	  file	_c_o_m_f_i_l_e	 ,  rather  than from the standard input.
	  When end-of-file is  reached,	 _s_e_l_e_c_t	 resumes  reading
	  from	the standard input.  Command files may be nested;
	  the maximum nesting depth is three.  Command files  are
	  aborted  (all	 remaining  commands  are  skipped) if an
	  error	or user	interrupt occurs while the  command  file
	  is being read.

     !!!!_c_o_m_m_a_n_d
	  Shell	escape.	 A shell is forked off	to  execute  _c_o_m_-
	  _m_a_n_d.	  The  command	output does not	appear in the log
	  file.	 The exclamation  point	 must  be  in  the  first
	  column.  A "#" character is not considered a comment in
	  _c_o_m_m_a_n_d, since the command may require that character.

     CCCCLLLLEEEEaaaarrrr
	  If the record	buffer has been	changed	 since	the  last
	  write,  a  warning  is printed and the user is asked to
	  confirm.   If	the user answers the confirmation request
	  with "yes", the the record buffer is cleared.

     CCCCLLLLOOOOsssseeee
	  Closes the log file, if any.

     EEEEVVVVaaaallll _Q_U_E_R_Y
	  Prints the value of the _Q_U_E_R_Y	 expression  (see  SYNTAX
	  DETAILS)  for	each record in the input set.  The record
	  number relative to the input file and	relative  to  the
	  set  of  input  files	 (if there is more than	one input
	  file)	is also	printed.

     FFFFrrrroooommmm _i_n_p_u_t_1, _i_n_p_u_t_2, ...
	  Closes an existing input files, if any  are  open,  and
	  opens	the new	ones.  All input files must be FEA files.
	  Note that an initial set of input files can  be  speci-
	  fied on the command line.

     HHHHEEEEAAAAddddeeeerrrr _f_l_a_g_s
	  Prints the headers of	the current set	of  input  files,
	  using	 _p_s_p_s(1-ESPS) with the ----xxxx flag.	 The _p_s_p_s flags	----
	  ffffrrrrhhhhvvvv may  also  be  specified.   The	outputs	 are  run
	  through the _m_o_r_e program (unless PAGER is set	to a dif-
	  ferent program name; see ENVIRONMENT).  The  output  is
	  not written to the log file.

     HHHHEEEELLLLpppp Prints a summary of the commands  accepted  by  _s_e_l_e_c_t.
	  The  help  file is run through the _m_o_r_e program (unless
	  PAGER	is set to a different program name; see	 ENVIRON-
	  MENT).




	Copyright Entropic Research Laboratory,	Inc. 3G3	3






SELECT(1-ESPS)				    ENTROPIC RESEARCH LAB



     LLLLoooogggg _l_o_g_f_i_l_e
	  Specifies that the dialog with the user will	be  saved
	  on  _l_o_g_f_i_l_e (equivalent to the ----llll command line option).
	  If a log file	is already open,  the  old  log	 file  is
	  closed  and  a new file is started.  If the argument is
	  omitted, the command is equivalent to	Show Log.

     SSSSeeeelllleeeecccctttt _Q_U_E_R_Y
	  Processes the	input files one	at a  time,  selects  all
	  records that satisfy the _Q_U_E_R_Y, and appends them to the
	  record buffer. During	queries	that scan more than  1000
	  records,  a  dot  will be printed for	each 1000 records
	  scanned.  The	number of records selected from	each file
	  and  the  total  number  selected  are printed when the
	  select is complete or	interrupted.

     SSSSHHHHoooowwww BBBBuuuuffffffffeeeerrrr
	  Prints the records in	the record buffer. The output  is
	  run  through the _m_o_r_e	program	(unless	PAGER is set to	a
	  different program name; see ENVIRONMENT).

     SSSSHHHHoooowwww FFFFIIIIeeeellllddddssss
	  Prints the field definitions of _i_n_p_u_t.

     SSSSHHHHoooowwww FFFFRRRRoooommmm _f_l_a_g_s
	  Runs _p_s_p_s on the current set of input	 files.	  Any  of
	  the  _p_s_p_s  flags  may	 be specified.	The output is run
	  through the _m_o_r_e program (unless PAGER is set	to a dif-
	  ferent program name; see ENVIRONMENT).

     SSSSHHHHoooowwww LLLLOOOOgggg
	  This command tells whether a	log  file  is  open,  and
	  gives	its name if there is an	open file.

     SSSSHHHHoooowwww LLLLAAAAsssstttt
	  Prints the last record in the	select buffer.

     SSSSHHHHoooowwww SSSSeeeelllleeeecccctttt _Q_U_E_R_Y