File: README

package info (click to toggle)
wstools 0.4.8d-2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 1,440 kB
  • ctags: 1,991
  • sloc: cpp: 13,880; makefile: 469
file content (148 lines) | stat: -rw-r--r-- 4,923 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
WS Tools 0.4.8
==============

All of these programs are command line driven and are not part of the main
WS Tools project. They are not needed to either build or run either JT44,
JT6M or FSK441. What they are designed for, is testing ideas that are used
within the main programs, and as such have been left lying around for later
experimentation.

In this release the JT6M code is not compiled (it doesn't work) and bulding
the tools will fail when you get to the JT6M specific tools. To stop this,
go to the top level directory and type "make JT6M" to build the JT6M
libraries and executable. Please note that the JT6M program that is built
does not work, but it will soon.

In order for these programs to link correctly, the FSK441, JT44 and JT6M
programs should be already built.

The current programs are:

AudioData:

Usage: AudioData <freq res> <sample rate> <filename>

This samples a WAV file at 11025 Hz and prints the mininum, maximum and
average values of the data in the file and also prints out details of the
centre frequency of the input data and the -3dB, -6dB and -10dB points. A
sort of text based audio spectrum analyser.

AudioMixerTest:

Usage: AudioMixerTest <frequency> <infile> <outfile>

This adds the frequency specified to the input WAV file and writed the new
audio to the output WAV file. A negative frequency gives a lowering of the
tone.

DopplerTest:

Usage: DopplerTest <startf> <endf> <infile> <outfile>

This simulates Doppler shift on the input WAV file and writes it to the
output WAV file. The Doppler can be increasing or decreasing depening on the
values of startf (start frequency) and endf (end frequency).

FFTPhase:

Usage: FFTPhase <sample rate> <number bins> <frequency>

This program is to investigate the response of the sine and cosine outputs
of an FFT when presented with frequencies that are not at the centre of the
bin.

FFTSpeed:

Usage: FFTSpeed <filename> <overlap> <FFT length> <SFFT first> <SFFT last>

This compares the speed of the sliding FFT against a full blown FFT.

FSK441Decoder:

Usage: FSK441Decoder <filename> <ratio>

This is the same decoder as used in the main FSK441 program, but operates
only on WAV files. The ratio is a minimum level to decode the data, it is a
certainty factor and is not calibrated in dB's.

FSK441Transmit:

Usage: FSK441Transmit <filename> <message>

The produces a WAV file of an FSK441 message of 29 seconds in length. This
could be mixed with noise and then fed into either FSK441 or FSK441Decoder3
for testing purposes.

Fade:

Usage: Fade <snr> <fade period> <infile> <outfile>

This adds AWGN and fading to an input WAV file with a specified (S+N)/N
ratio in dB's and fading period in seconds. The output can be fed into
another program for testing its weak signal response. This is based on work
by Phil Karn KA9Q.

JT44Decoder:

Usage: JT44Decoder <filename>

This is a copy of an older version of the JT44 decoder to be found in JT44.
Although it works, it does not report the correct values for the sync or the
signal itself. This may be upgraded at some future time.

JT44Transmit:

Usage: JT44Transmit <filename> <message>

This produces a WAV file of a valid JT44 message. This may be fed into JT44
or JT44Decoder for testing purposes.

JT6MTransmit:

Usage: JT6MTransmit <filename> <message>

This produces a WAV file of a valid JT6M message. This may be fed into JT6M
or JT6MDecoder for testing purposes.

Noise:

Usage: Noise <snr> <infile> <outfile>

This adds AWGN to an input WAV file with a specified (S+N)/N ratio in dB's.
The output can be fed into another program for testing its weak signal
response. This is based on work by Phil Karn KA9Q.

NoisyToneGenerator:

Usage: NoisyToneGenerator <frequency> <amplitude> <std dev> <length> <file>

This is test program for the NCO (Numerically Controlled Oscillator) with
Gaussian phase jitter added to try and produce wide signals, it generates
WAV files with single tones. The frequency is in Hertz and the length is in
seconds. The sample rate is fixed at 11025 Hz. The amplitude should be
between 0.0 and 1.0, negative values in the same range have the same effect.

SunAndMoon:

Usage: SunAndMoon <locator> <frequency>

This calls the Sun and Moon tracking classes and prints out the current
azimuth and elevation of the moon as seen from a given locator. Some extra
information is also displayed.

ToneGenerator:

Usage: ToneGenerator <frequency> <amplitude> <length> <file>

This is test program for the NCO (Numerically Controlled Oscillator), it
generates WAV files with single tones. The frequency is in Hertz and the
length is in seconds. The sample rate is fixed at 11025 Hz. The amplitude
should be between 0.0 and 1.0, negative values in the same range have the
same effect.

WAVEdit

Usage: WAVEdit <start time> <end time> <sample rate> <infile> <outfile>

This is a simple program for extracting sections of a WAV file for later
processing.