add an RBN line to progress
[spider.git] / html / filtering_en-6.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4  <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
5  <TITLE>The DXSpider User Filtering Primer v1.0: Filters to reject spots based on frequency</TITLE>
6  <LINK HREF="filtering_en-7.html" REL=next>
7  <LINK HREF="filtering_en-5.html" REL=previous>
8  <LINK HREF="filtering_en.html#toc6" REL=contents>
9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
10 </HEAD>
11 <BODY>
12 <A HREF="filtering_en-7.html">Next</A>
13 <A HREF="filtering_en-5.html">Previous</A>
14 <A HREF="filtering_en.html#toc6">Contents</A>
15 <HR>
16 <H2><A NAME="s6">6.</A> <A HREF="filtering_en.html#toc6">Filters to reject spots based on frequency</A></H2>
17
18 <P>
19 <BLOCKQUOTE><CODE>
20 <PRE>
21 Syntax: reject/spot [0-9] freq &lt;range>       
22
23 or
24
25 reject/spot [0-9] on &lt;range>
26 </PRE>
27 </CODE></BLOCKQUOTE>
28 </P>
29 <P>Important: both <EM>freq</EM> and <EM>on</EM> are exactly the same and can be 
30 used interchangeably - most persons use <EM>on</EM> (less typing.)</P>
31
32 <P>For range, you can specify a frequency like 7040, a range of frequencies like 
33 0/30000 ( the whole HF band) or use any of the "band" or "region" names defined 
34 in the show/bands command.</P>
35
36 <H2><A NAME="ss6.1">6.1</A> <A HREF="filtering_en.html#toc6.1">Bands Available</A>
37 </H2>
38
39 <P>
40 <BLOCKQUOTE><CODE>
41 <PRE>
42 73kHz:          71 -> 75
43 136kHz:         135 -> 138
44 160m:           1800 -> 2000
45 80m:            3500 -> 4000
46 60m:            5258 -> 5407
47 40m:            7000 -> 7400
48 30m:            10100 -> 10150
49 20m:            14000 -> 14350
50 17m:            18068 -> 18168
51 15m:            21000 -> 21450
52 12m:            24890 -> 24990
53 10m:            28000 -> 29700
54 military:       29700 -> 50000, 230000 -> 420000
55 band1:          47000 -> 49999, 52000 -> 68000
56 6m:             50000 -> 52000
57 pmrlow:         68000 -> 87500
58 4m:             70000 -> 70500
59 band2:          87500 -> 108000
60 aircraft:       108000 -> 137500
61 pmrmid:         138000 -> 165000
62 2m:             144000 -> 148000
63 pmrhigh:        165000 => 174000
64 band3:          176000 => 230000
65 220:            220000 => 222000
66 pmruhf:         425000 => 430000, 440000 => 471000
67 70cm:           430000 => 450000
68 band4:          471000 => 550000
69 band5:          550000 => 868000
70 23cm:           1240000 => 1325000
71 13cm:           2310000 => 2450000
72 9cm:            3400000 => 3475000
73 6cm:            5650000 => 5850000
74 3cm:            10000000 => 10500000
75 12mm:           24000000 => 24250000
76 6mm:            47000000 => 47200000
77 </PRE>
78 </CODE></BLOCKQUOTE>
79 </P>
80
81 <H2><A NAME="ss6.2">6.2</A> <A HREF="filtering_en.html#toc6.2">Regions Available</A>
82 </H2>
83
84 <P>
85 <BLOCKQUOTE><CODE>
86 <PRE>
87 all:            73khz 136khz 160m 80m 60m 40m 30m 20m 17m 15m 12m 10m 6m 4m 
88                 2m 220 70cm 23cm 9cm 6cm 3cm 12mm 6mm
89 vhfradio:       band1 band2
90 vhf:            6m 4m 2m 220
91 contesthf:      160m 80m 40m 20m 15m 10m
92 warc:           60m 30m 17m 12m
93 pmr:            pmrlow pmrmid pmrhigh pmruhf
94 spe:            10m 6m 4m 2m
95 shf:            23cm 13cm 9cm 6cm 3cm
96 vlf:            73khz 136khz
97 uhftv:          band4 band5
98 hf:             160m 80m 60m 40m 30m 20m 17m 15m 12m 10m
99 vhftv:          band1 band3
100 uhf:            70cm 23cm
101 </PRE>
102 </CODE></BLOCKQUOTE>
103 </P>
104
105 <H2><A NAME="ss6.3">6.3</A> <A HREF="filtering_en.html#toc6.3">Examples</A>
106 </H2>
107
108 <P>The following line will reject spots on 7,040 kHz and pass all others.</P>
109 <P>
110 <BLOCKQUOTE><CODE>
111 <PRE>
112 reject/spot 0 freq 7040
113 </PRE>
114 </CODE></BLOCKQUOTE>
115 </P>
116 <P>The next line will reject spots from 0 to 30,000 kHz and pass on all others.</P>
117 <P>
118 <BLOCKQUOTE><CODE>
119 <PRE>
120 reject/spot 1 on 0/30000
121 </PRE>
122 </CODE></BLOCKQUOTE>
123 </P>
124 <P>This next will trash all spots in the frequency range 144000 -> 148000 kHz and 
125 pass on all others.</P>
126 <P>
127 <BLOCKQUOTE><CODE>
128 <PRE>
129 reject/spot 2 freq 2m
130 </PRE>
131 </CODE></BLOCKQUOTE>
132 </P>
133 <P>This rule will reject all spots on 6m, 4m, 2m, and 220  and pass on all
134 others.</P>
135 <P>
136 <BLOCKQUOTE><CODE>
137 <PRE>
138 reject/spot 3 on vhf
139 </PRE>
140 </CODE></BLOCKQUOTE>
141 </P>
142 <P>This rule will dump all spots on the 160m, 80m, 60m, 40m, 30m, 20m, 17m, 15m,
143 12m, 10m bands and all spots on 70cm and  23cm bands passing all other spots.</P>
144 <P>
145 <BLOCKQUOTE><CODE>
146 <PRE>
147 reject/spot 4 freq hf and freq uhf
148 </PRE>
149 </CODE></BLOCKQUOTE>
150 </P>
151 <P>This is a special spot to be used only by members of the Yankee Clipper
152 Contest Club during contest weekends. Hi!</P>
153 <P>
154 <BLOCKQUOTE><CODE>
155 <PRE>
156 reject/spot on all
157 </PRE>
158 </CODE></BLOCKQUOTE>
159 </P>
160
161 <H2><A NAME="ss6.4">6.4</A> <A HREF="filtering_en.html#toc6.4">Sub-bands as part of range</A>
162 </H2>
163
164 <P>In conjunction with range, you can use the following sub-band names,</P>
165 <P>
166 <BLOCKQUOTE><CODE>
167 <PRE>
168 cw, rtty, data, ssb, and sstv
169 </PRE>
170 </CODE></BLOCKQUOTE>
171 </P>
172 <P>by using a forward-slash [(band or region)/sub-band] as part of the range 
173 definition.  For example ...</P>
174
175 <P>This rule will reject all HF phone spots passing on all others</P>
176 <P>
177 <BLOCKQUOTE><CODE>
178 <PRE>
179 reject/spot 0 freq hf/ssb
180 </PRE>
181 </CODE></BLOCKQUOTE>
182 </P>
183 <P>This filter rule will reject all HF CW spots but will not reject DATA and RTTY
184 spots in the CW range and will pass on all other spots.</P>
185 <P>
186 <BLOCKQUOTE><CODE>
187 <PRE>
188 reject/spot 1 on hf/cw and not (on hf/data or on hf/rtty)
189 </PRE>
190 </CODE></BLOCKQUOTE>
191 </P>
192
193 <H2><A NAME="ss6.5">6.5</A> <A HREF="filtering_en.html#toc6.5">Filters to reject spots based on the "info" data in the spot</A>
194 </H2>
195
196
197 <P>
198 <BLOCKQUOTE><CODE>
199 <PRE>
200 Syntax: reject/spot [0-9] info &lt;string>
201 </PRE>
202 </CODE></BLOCKQUOTE>
203 </P>
204 <P>This filter is used to key on information contained in the information section 
205 of the spot. One could use this to reject any spots containing IOTA, QSL OP or 
206 any other "key-word" used in the information string of the spot. </P>
207
208 <P>Examples ...</P>
209
210 <P>This filter will reject spots containing IOTA information and pass on all
211 others</P>
212 <P>
213 <BLOCKQUOTE><CODE>
214 <PRE>
215 reject/spot 0 info IOTA
216 </PRE>
217 </CODE></BLOCKQUOTE>
218 </P>
219 <P>This filter will reject all general CW spots on HF, but will still permit any
220 HF CW spots that contain iota information in addition to passing all others.</P>
221 <P>
222 <BLOCKQUOTE><CODE>
223 <PRE>
224 reject/spot 1 on hf/cw and not info iota
225 </PRE>
226 </CODE></BLOCKQUOTE>
227 </P>
228 <P>This next filter will reject spots asking or containing QSL information and 
229 pass on all others</P>
230 <P>
231 <BLOCKQUOTE><CODE>
232 <PRE>
233 reject/spot 2 info QSL
234 </PRE>
235 </CODE></BLOCKQUOTE>
236 </P>
237 <P>Note: The following series of filters are based on <EM>call</EM> and
238 <EM>by</EM>.  Call always references the callsign of the spotted DX station.  
239 By always references the callsign of the spotting station.</P>
240
241 <H2><A NAME="ss6.6">6.6</A> <A HREF="filtering_en.html#toc6.6">Filters to reject spots based on call</A>
242 </H2>
243
244 <P>
245 <BLOCKQUOTE><CODE>
246 <PRE>
247 Syntax: reject/spot [0-9] call &lt;prefixes>  
248 </PRE>
249 </CODE></BLOCKQUOTE>
250 </P>
251 <P>This filter is misleading in a way. It is strictly based on the spotted call 
252 sign letters or numbers entered and not based on countries or DXCC entities. 
253 One could filter on JIMSAM62 if desired.</P>
254
255 <P>Examples ...</P>
256
257 <P>This filter will reject spots for G1AAA, GJ2BBB, and GW3CCC and will pass on
258 spots for M0AAA.</P>
259 <P>
260 <BLOCKQUOTE><CODE>
261 <PRE>
262 reject/spot 0 call G
263 </PRE>
264 </CODE></BLOCKQUOTE>
265 </P>
266 <P>This next filter will reject spots for PA3AAA and pass on spots for PB4BBB</P>
267 <P>
268 <BLOCKQUOTE><CODE>
269 <PRE>
270 reject/spot 1 call PA
271 </PRE>
272 </CODE></BLOCKQUOTE>
273 </P>
274 <P>This filter will reject spots for K1AA, KC4AAA,  and KH6DDD and pass on spots
275 for W3BG and N3RD</P>
276 <P>
277 <BLOCKQUOTE><CODE>
278 <PRE>
279 reject/spot 2 call K
280 </PRE>
281 </CODE></BLOCKQUOTE>
282 </P>
283
284 <H2><A NAME="ss6.7">6.7</A> <A HREF="filtering_en.html#toc6.7">Filters to reject spots based on call_dxcc</A>
285 </H2>
286
287 <P>
288 <BLOCKQUOTE><CODE>
289 <PRE>
290 Syntax:  reject/spot [0-9] call_dxcc &lt;numbers or prefixes>   
291 </PRE>
292 </CODE></BLOCKQUOTE>
293 </P>
294 <P>This filter is based on DXCC entities and uses either the country prefix or 
295 the DXCC entity number, found by using the command <EM>show/prefix</EM>.</P>
296
297 <P>As in ...</P>
298 <P>
299 <BLOCKQUOTE><CODE>
300 <PRE>
301 show/prefix w
302 W DXCC: 226 ITU: 7 CQ: 4 LL: 43 0 N 87 54 W (W, United-States-W)
303 </PRE>
304 </CODE></BLOCKQUOTE>
305 </P>
306 <P>
307 <BLOCKQUOTE><CODE>
308 <PRE>
309 show/prefix VE
310 VE DXCC: 197 ITU: 9 CQ: 5 LL: 45 18 N 66 6 W (VE, New-Brunswick-VE)
311 DXCC: 197 ITU: 9 CQ: 5 LL: 48 30 N 56 0 W (VE, Newfoundland-VE)
312 DXCC: 197 ITU: 9 CQ: 5 LL: 44 36 N 63 36 W (VE, Nova-Scotia-VE)
313 DXCC: 197 ITU: 4 CQ: 5 LL: 45 30 N 73 36 W (VE, Quebec-VE)
314 DXCC: 197 ITU: 4 CQ: 4 LL: 43 42 N 79 24 W (VE, Ontario-VE)
315 DXCC: 197 ITU: 3 CQ: 4 LL: 49 54 N 97 6 W (VE, Manitoba-VE)
316 DXCC: 197 ITU: 3 CQ: 4 LL: 50 30 N 104 36 W (VE, Saskatchewan-VE)
317 DXCC: 197 ITU: 2 CQ: 3 LL: 51 0 N 114 6 W (VE, Alberta-VE)
318 DXCC: 197 ITU: 2 CQ: 3 LL: 49 18 N 123 6 W (VE, British-Columbia-VE)
319 DXCC: 197 ITU: 75 CQ: 1 LL: 60 42 N 135 6 W (VE, Yukon-VE)
320 </PRE>
321 </CODE></BLOCKQUOTE>
322 </P>
323 <P>Example ...</P>
324
325 <P>This spot filter will  reject all spots for US and Canada stations and pass on
326 all others.</P>
327 <P>
328 <BLOCKQUOTE><CODE>
329 <PRE>
330 reject/spot 0 call_dxcc 226,197
331 </PRE>
332 </CODE></BLOCKQUOTE>
333 </P>
334 <P>This spot filter will  reject all spots for US and Canada stations and pass on
335 all others including the special event station, W2WTC, who I want to work the
336 next time he is on the air.</P>
337 <P>
338 <BLOCKQUOTE><CODE>
339 <PRE>
340 reject/spot 1 call_dxcc w,ve not call w2wtc
341 </PRE>
342 </CODE></BLOCKQUOTE>
343 </P>
344
345 <H2><A NAME="ss6.8">6.8</A> <A HREF="filtering_en.html#toc6.8">Filters to reject spots based on call_itu</A>
346 </H2>
347
348 <P>Similarly, call_itu and call_zone use ITU regions that can also be obtained 
349 using the show/prefix &lt;prefix&gt; command (see above.)</P>
350 <P>
351 <BLOCKQUOTE><CODE>
352 <PRE>
353 Syntax:  accept/spot [0-9] call_itu &lt;numbers>  
354 </PRE>
355 </CODE></BLOCKQUOTE>
356 </P>
357 <P>Example ...</P>
358
359 <P>This spot filter will reject all spots for ITU region 7 and pass on all
360 others.</P>
361 <P>
362 <BLOCKQUOTE><CODE>
363 <PRE>
364 reject/spot 0  call_itu 7
365 </PRE>
366 </CODE></BLOCKQUOTE>
367 </P>
368
369 <H2><A NAME="ss6.9">6.9</A> <A HREF="filtering_en.html#toc6.9">Filters to reject spots based on call_zone</A>
370 </H2>
371
372 <P>
373 <BLOCKQUOTE><CODE>
374 <PRE>
375 Syntax:  reject/spot [0-9] call_zone &lt;numbers>  
376 </PRE>
377 </CODE></BLOCKQUOTE>
378 </P>
379 <P>This filter is based on CQ zones and uses the CQ zone number found by using the 
380 command <EM>show/prefix</EM> (see above.)</P>
381
382 <P>Example ...</P>
383
384 <P>This spot filter will  reject all spots for CQ zone 5 and pass on all others.</P>
385 <P>
386 <BLOCKQUOTE><CODE>
387 <PRE>
388 reject/spot 0 call_zone 5
389 </PRE>
390 </CODE></BLOCKQUOTE>
391 </P>
392
393 <H2><A NAME="ss6.10">6.10</A> <A HREF="filtering_en.html#toc6.10">Filters to reject spots based on call_state</A>
394 </H2>
395
396 <P>
397 <BLOCKQUOTE><CODE>
398 <PRE>
399 Syntax:  reject/spot [0-9] call_state &lt;state2-letter abbreviations>
400 </PRE>
401 </CODE></BLOCKQUOTE>
402 </P>
403 <P>This filter is based on the state of the call spotted, for those callsigns 
404 contained in the usdb database.  Use the command <EM>show/usdb</EM> to see an 
405 example of a listing in the database, like this ...</P>
406 <P>
407 <BLOCKQUOTE><CODE>
408 <PRE>
409 show/usdb k3ww
410 K3WW    -> Perkasie, PA
411 </PRE>
412 </CODE></BLOCKQUOTE>
413 </P>
414 <P>Example ...</P>
415
416 <P>This spot filter will  reject all spots for stations in the Mid-Atlantic
417 states and pass on all others.</P>
418 <P>
419 <BLOCKQUOTE><CODE>
420 <PRE>
421 reject/spot call_state nj,ny,pa,de,md
422 </PRE>
423 </CODE></BLOCKQUOTE>
424 </P>
425
426 <H2><A NAME="ss6.11">6.11</A> <A HREF="filtering_en.html#toc6.11">Filters to reject spots based on by</A>
427 </H2>
428
429 <P><EM>by</EM> filters are similar to and function exactly as call filters except 
430 that they act on the spotting station callsign and not the spotted callsign.</P>
431
432 <P>So ...</P>
433
434 <P>This filter is similar to and functions like the call &lt;prefixes&gt;      
435 (See above) except that it rejects spots generated by the spotting callsign 
436 and passes all other spots.</P>
437 <P>
438 <BLOCKQUOTE><CODE>
439 <PRE>
440 Syntax:  reject/spot [0-9] by &lt;prefixes>  
441 </PRE>
442 </CODE></BLOCKQUOTE>
443 </P>
444 <P>This next filter is based on DXCC entities and uses the DXCC entity number 
445 found by using the command  show/prefix &lt;prefix&gt; and it rejects spots 
446 generated within the spotting DXCC entity and passes all other spots.</P>
447 <P>
448 <BLOCKQUOTE><CODE>
449 <PRE>
450 Syntax:  reject/spot [0-9] by_dxcc &lt;numbers>
451 </PRE>
452 </CODE></BLOCKQUOTE>
453 </P>
454 <P>This next filter is based on ITU regions and uses the ITU region number found by
455 using the command <EM>show/prefix</EM> (see above), except that it rejects
456 spots generated by a spotting callsign within the ITU region and passes all
457 other spots.</P>
458 <P>
459 <BLOCKQUOTE><CODE>
460 <PRE>
461 Syntax:  reject/spot [0-9] by_itu &lt;numbers>
462 </PRE>
463 </CODE></BLOCKQUOTE>
464 </P>
465 <P>This filter is based on CQ zones and uses the CQ zone number found by using
466 the command <EM>show/prefix</EM> (see above), except that it rejects spots
467 generated by a spotting callsign within the CQ zone and passes all other
468 spots.</P>
469 <P>
470 <BLOCKQUOTE><CODE>
471 <PRE>
472 Syntax:  reject/spot [0-9] by_zone &lt;numbers>
473 </PRE>
474 </CODE></BLOCKQUOTE>
475 </P>
476 <P>This filter is based on the state of the spotting station found by using the
477 command <EM>show/usdb</EM> and passes all other spots.</P>
478 <P>
479 <BLOCKQUOTE><CODE>
480 <PRE>
481 Syntax:  reject/spot [0-9] by_state &lt;state2-letter postal codes 
482 </PRE>
483 </CODE></BLOCKQUOTE>
484 </P>
485
486 <HR>
487 <A HREF="filtering_en-7.html">Next</A>
488 <A HREF="filtering_en-5.html">Previous</A>
489 <A HREF="filtering_en.html#toc6">Contents</A>
490 </BODY>
491 </HTML>