PICTUNER

Uses hardware to Tuner/Filter/Decimate from/to files

<device name>   PIC alias in HW file (i.e. PIC, PIC1, PIC2, ...)
<infile> 	File of archived data to run through tuners
<outfile> 	Output file name (or prefix for multi)
<bandwidth> 	Tuner bandwidth in Hz
<freq>		Tuner center frequency in Hz
<gain>		Tuner gain in dB
<format> 	Output format (SI|CI)
<listfile>	List file for multi-channel tuning

Uses device resources to Tuner/Filter/Decimate one or more signals
from a file on disk.  Output format is SI or CI.

If <listfile> is specified, multiple signals can be extracted from the
input in a single call. The macro will use as many tuners per pass as 
possible and keep executing passes until the list is completed.

If <listfile> is not used, all other parameters must be specified.  
The parameter defaults are record names for the listfile.

In list mode, the <outfile> <bandwidth> <freq> <gain> and <format> parameters
can be retrieved from the type 3000 list file on a signal by signal basis
or specified directly to be applied to all signals in the list.  To get
the parameter from the file, specify the record name preceded by a tilde.

For example, to tune 5 signals with different freq and bandwidths:

   PICTUNER pic1 datafile tunfile_ ~BW ~FREQ 0 SI mylist

where mylist is a 3000 file with the subrecords BW and FREQ.

	FREQ		BW	NAME		JJ	index	
	1000000		10000	SIGNAL_A	-3	1
	1010000		10000	SIGNAL_B	6	2
	1020000		10000	SIGNAL_X	0	3
	1030000		10000	SIGNAL_CC	0	4
	1100000		50000	SIGNAL_T	0	5

In this case, the NAME field is ignored and the name is constructed by
appending the index to tunefile_  (tunfile_1, tunfile_2 ...)

To use the NAME field for the filename, as well as JJ for the gain:

   PICTUNER pic1 datafile ~NAME ~BW ~FREQ ~JJ SI mylist

In this list case, the index is NOT appended to the name in the file.

If <bandwidth> is the same for all channels, it should be specified on the 
command line so the macro can use more tuners per pass on the hardware.
This could be up to 4 times faster.

Switches:

  /GEN	    - generate a default list and throw it up in an editor
  /PBRATE=n - set playback rate to n MHz
  /ECHO     - echo parameters used for each file