test-fir.rme

Reference Implementation of G.711 standard and other voice codecs

-------------------------------------------------------------------------
testref.rme - Readme file for the test files for the FIR filter module
-------------------------------------------------------------------------

Description of files:
~~~~~~~~~~~~~~~~~~~~~
testref.rme:	This file
test-sun.zip:	ZIP-compatible archive with the test files in the Unix 
		byte orientation (high-byte first)
test-ref.sta:	Ascii file with statistics and CRC for the test files
test.src:	Gaussian pseudo-noise test file.
test001.ref:	Tx-side IRS-8kHz, other firdemo stages short-cut (0's)
test002.ref:	Tx-side IRS-16kHz, other firdemo stages short-cut (0's)
test003.ref:	Delta-SM , other firdemo stages short-cut (0's)
test004.ref:	High-quality 1:2, first up-stage of hqdemo
test005.ref:	High-quality 1:3, first up-stage of hqdemo
test006.ref:	High-quality 1:2, second up-stage of hqdemo
test007.ref:	High-quality 1:3, second up-stage of hqdemo
test008.ref:	High-quality 2:1, first down-stage of hqdemo
test009.ref:	High-quality 3:1, first down-stage of hqdemo
test010.ref:	High-quality 2:1, second down-stage of hqdemo
test011.ref:	High-quality 3:1, second down-stage of hqdemo
test012.ref:	High-quality cascade: 1:2 + 1:3 + 2:1 + 3:1
test013.ref:	High-quality cascade: 1:3 + 1:2 + 3:1 + 2:1
test014.ref:	Combined cascade: Tx-side IRS-8kHz + 1:2 + 1:3 + 2:1 + 3:1
test015.ref:	Combined cascade: Tx-side IRS-16kHz + 1:2 + 1:3 + 2:1 + 3:1
test016.ref:	Combined cascade: Tx-side IRS-8kHz+Delta-SM+1:2+1:3+2:1+3:1
test017.ref:	Combined cascade: Tx-side IRS-16kHz+Delta-SM+1:2+1:3+2:1+3:1
test018.ref:	Tx-side IRS-16kHz with modified characteristic
test019.ref:	Tx-side IRS-48kHz with modified characteristic
test020.ref:	Linear-phase G.712 1:2, first up-stage of hqdemo
test021.ref:	Linear-phase G.712 1:2, second up-stage of hqdemo
test022.ref:	Linear-phase G.712 2:1, first down-stage of hqdemo
test023.ref:	Linear-phase G.712 2:1, second down-stage of hqdemo
test024.ref:	Half-tilt Tx-side IRS@16kHz, other firdemo steps disabled (0's)
testp341.ref:   P.341 sending mask.
test-asy.ref:   cascade-form flat low-pass IIR asynchronization
test-cas.ref:   cascade-form flat low-pass IIR upsampling
test-sac.ref:   cascade-form flat low-pass IIR downsampling
testpcm1.ref:	IIR G.712 1:1, first stage of pcmdemo 
testpcmd.ref:	IIR G.712 2:1, first stage of pcmdemo 
testpcmu.ref:	IIR G.712 1:2, first stage of pcmdemo
test-pso.ref:	Psophometric filter
rxmirs16.ref:	Modified IRS *Receive*-side at 16 kHz sampling, 1:1
rxmirs8.ref:	Modified IRS *Receive*-side at 8 kHz sampling, 1:1

Notes:
~~~~~~
- firdemo (formerly hqdemo) does not implement the psophometric filter, but 
  can cascade several filtering options, while filter does implement it,
  but can run only one filtering at a time. Besides truncation problems,
  filter may implement the operations performed by firdemo by cascading
  several runs of filter.

- files test001.ref to test011.ref and test018.ref to test023.ref are used
  to test both filter and firdemo. Files test012.ref to test017.ref are used
  to test only firdemo, and files testpcm[1du].ref, test-pso.ref, test-asy.ref,
  test-cas.ref, and test-sac.ref are only used to test filter.c.

- automatic test procedure are available in the makefiles:
	make-vms.com - for VAX/VMS Vax-cc compiler or the VMS port of gcc
	makefile.bcc - for MSDOS Borland bcc
	makefile.djc - for MSDOS port of gcc
	makefile.unx - for Unix, using either cc, acc (Sun), or gcc

- all the binary files are in the Sun format (High-byte first), and to be
  used in VMS and MSDOS need to have every even and odd bytes swapped.

- the .ref files have been generated from test.src for the reference
  implementation of the programs compiled by Sun's cc compiler, with the 
  exception of:
  + test-pso.ref, whose reference implementation was compiled with 
    Sun's ANSI C compiler acc;
  + test024.ref, testp341.ref, test-asy.ref, test-cas.ref, test-sac,
    rxmirs16.ref, and rxmirs8.ref were generated by gcc on a HP
    workstation running HP-UX.
  You may expect that running the program in other platforms may generate 
  files that are not identical, but that may have some different samples, 
  due to rounding errors. Therefore, expect errors in the range of +-1 
  when comparing the reference files and your processed ones.

 - test019.ref was updated according to the modifications done on fir-irs.c for the modified IRS send-part filter (48 kHz). ** 3 december 2004

-- <[e-mail]> [13.Mar.2000] --