spsamo.1

speech signal process tools

.\" @(#)spsamo.1	1.1	4/25/86
.TH SPSAMO 1\-SPS 4/25/86
.ds ]W "\fI\s+4\ze\h'0.05'e\s-4\v'-0.4m'\fP\(*p\v'0.4m'\ Entropic Processing, Inc.
.SH NAME
spsamo \- convert sampled data from SPS file to an AM object file
.SH SYNOPSIS
.B spsamo
[
.BI \-s " start"
] [
.BI \-n " npoints"
] [
.BI \-l " dmem-loc"
] [
] [
.BI \-g " gain"
.I ifile
] [
.I ofile
]
.SH DESCRIPTION
.PP
.I Sdsamo
writes data from an SPS sampled data file in the form of an object file for
the DSP Abstract Machine (AM). This object file may be loaded by AMSIM, the
AM simulator; the effect is to store the sampled data
in DMEM.
.PP
By default, the first 65536 points of the data file (or all of them, if there
are fewer points in the file) are written into the object file, and the data
is loaded at DMEM address zero. The
.B \-s
option, followed by an integer, specifies a different starting point (default
1, the first point in the file). The
.B \-l
option, followed by a hexadecimal value, specifies the starting point in the
AM's data memory where the data are to be loaded (default: 0). The
.B \-n
option, followed by an integer, specifies the number of points to write. The
default is to write from the starting point to either the end of the input
file or the end of the AM's data memory, which holds 65536 values. The
.B \-g
option, followed by a real number, specifies a gain. The data from the SPS
file are multiplied by the gain.
.PP
The data are rounded to the nearest integer before writing.
.SH SPS PARAMETERS
The SPS parameter file is not used.
.SH DIAGNOSTICS
A fatal error occurs if the input file does not exist or is not an SPS
sampled data file.
.SH EXPECTED CHANGES
A scale factor might be added.