html/filtering_en-7.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: Accept filters </TITLE>
   6  <LINK HREF="filtering_en-8.html" REL=next>
   7  <LINK HREF="filtering_en-6.html" REL=previous>
   8  <LINK HREF="filtering_en.html#toc7" REL=contents>
   9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
  10 </HEAD>
  11 <BODY>
  12 <A HREF="filtering_en-8.html">Next</A>
  13 <A HREF="filtering_en-6.html">Previous</A>
  14 <A HREF="filtering_en.html#toc7">Contents</A>
  15 <HR>
  16 <H2><A NAME="s7">7.</A> <A HREF="filtering_en.html#toc7">Accept filters </A></H2>
  17
  18 <P>An accept filter line means that if a spot matches pass it on to the user, send
  19 it down the line to the next rule or to the user, and trash, dump, all other
  20 spots that do not match to the next filter line. </P>
  21 <P>
  22 <BLOCKQUOTE><CODE>
  23 <PRE>
  24 Syntax: accept/spots [0-9]  &lt;pattern>
  25 </PRE>
  26 </CODE></BLOCKQUOTE>
  27 </P>
  28 <P>Any of the following patterns may be used in this line ...</P>
  29 <P>
  30 <BLOCKQUOTE><CODE>
  31 <PRE>
  32 freq &lt;range>
  33 on &lt;range>
  34 info &lt;string>
  35 call &lt;prefixes>
  36 call_dxcc &lt;numbers>
  37 call_itu &lt;numbers>
  38 call_zone &lt;numbers>
  39 call_state &lt;state2-letter abbreviations>
  40 by &lt;prefixes>
  41 by_dxcc &lt;numbers>
  42 by_itu &lt;numbers>
  43 by_zone &lt;numbers>
  44 by_state &lt;state2-letter abbreviations>
  45 origin &lt;prefixes>   Used primarily be SYSOPS,  not by users and not discussed.
  46 channel &lt;prefixes> Used primarily be SYSOPS,  not by users and not discussed.
  47 </PRE>
  48 </CODE></BLOCKQUOTE>
  49 </P>
  50 <P>Using these patterns, we can accept spots based upon ...</P>
  51 <P>
  52 <BLOCKQUOTE><CODE>
  53 <PRE>
  54 Frequency of the spot
  55 Callsign of the spot (country or zone)
  56 Callsign of the spotter (country or zone)
  57 Contents of the "information field" which comes with the spot
  58 </PRE>
  59 </CODE></BLOCKQUOTE>
  60 </P>
  61
  62 <H2><A NAME="ss7.1">7.1</A> <A HREF="filtering_en.html#toc7.1">Filters to accept spots based on frequency</A>
  63 </H2>
  64
  65 <P>
  66 <BLOCKQUOTE><CODE>
  67 <PRE>
  68 Syntax: accept/spot [0-9] freq &lt;range>
  69
  70 or
  71
  72 accept/spot [0-9] on &lt;range>
  73 </PRE>
  74 </CODE></BLOCKQUOTE>
  75 </P>
  76 <P>Important: as noted before, both <EM>freq</EM> and <EM>on</EM> are exactly
  77 the same and can be used interchangeably.</P>
  78
  79 <P>For range, you can specify a frequency like 7040, a range of frequencies
  80 like 0/30000 ( the whole HF spectrum) or use any of the band/region names
  81 defined in the SHOW/BANDS command (see above).</P>
  82
  83 <P>Examples...</P>
  84
  85 <P>This will pass on a HF spots only from 0 to 30,000 kHz and dump all others.</P>
  86 <P>
  87 <BLOCKQUOTE><CODE>
  88 <PRE>
  89 accept/spot 1 on 0/30000
  90 </PRE>
  91 </CODE></BLOCKQUOTE>
  92 </P>
  93 <P>This passes on all spots in the frequency range 144000 -> 148000 kHz and trash
  94 all others.</P>
  95 <P>
  96 <BLOCKQUOTE><CODE>
  97 <PRE>
  98 accept/spot 2 freq 2m
  99 </PRE>
 100 </CODE></BLOCKQUOTE>
 101 </P>
 102 <P>This rule will only pass on spots on 6m, 4m, 2m, and 220 and reject all
 103 others.</P>
 104 <P>
 105 <BLOCKQUOTE><CODE>
 106 <PRE>
 107 accept/spot 3 on vhf
 108 </PRE>
 109 </CODE></BLOCKQUOTE>
 110 </P>
 111 <P>This rule will pass on all spots on the 160m, 80m, 60m, 40m, 30m, 20m, 17m,
 112 15m, 12m, 10m bands and all spots on 70cm and 23cm bands only. All other
 113 spots are trashed.</P>
 114 <P>
 115 <BLOCKQUOTE><CODE>
 116 <PRE>
 117 accept/spot 4 freq hf and freq uhf
 118 </PRE>
 119 </CODE></BLOCKQUOTE>
 120 </P>
 121
 122 <H2><A NAME="ss7.2">7.2</A> <A HREF="filtering_en.html#toc7.2">Sub-bands as part of range</A>
 123 </H2>
 124
 125 <P>In conjunction with range, you can use the following sub-band names: CW, RTTY,
 126 DATA, SSB, and SSTV by using a back-slash [(band or region)/sub-band] as part
 127 of the range definition. </P>
 128
 129 <P>Examples ...</P>
 130
 131 <P>This rule will only accept and pass on HF phone spots rejecting all others</P>
 132 <P>
 133 <BLOCKQUOTE><CODE>
 134 <PRE>
 135 accept/spot 0 freq hf/ssb
 136 </PRE>
 137 </CODE></BLOCKQUOTE>
 138 </P>
 139 <P>This filter rule will accept all HF CW spots but will not include DATA and
 140 RTTY spots in the CW range. In addition all other spots will be dumped.</P>
 141 <P>
 142 <BLOCKQUOTE><CODE>
 143 <PRE>
 144 accept/spot 1 on hf/cw and not (on hf/data or on hf/rtty)
 145 </PRE>
 146 </CODE></BLOCKQUOTE>
 147  </P>
 148
 149 <H2><A NAME="ss7.3">7.3</A> <A HREF="filtering_en.html#toc7.3">Filters to accept spots based on info</A>
 150 </H2>
 151
 152 <P>
 153 <BLOCKQUOTE><CODE>
 154 <PRE>
 155 Syntax: accept/spot [0-9] info &lt;string>
 156 </PRE>
 157 </CODE></BLOCKQUOTE>
 158 </P>
 159 <P>This filter is used to key on information contained in the information section
 160 of the spot. One could use this to accept any spots containing IOTA, QSL OP or
 161 any other "key-word" used in the information string of the spot. </P>
 162
 163 <P>Examples ...</P>
 164
 165 <P>This filter will accept spots containing IOTA information only and reject all
 166 others</P>
 167 <P>
 168 <BLOCKQUOTE><CODE>
 169 <PRE>
 170 accept/spot 0 info IOTA
 171 </PRE>
 172 </CODE></BLOCKQUOTE>
 173 </P>
 174 <P>This filter will accept only 10m SSB spots, but will still permit any spots
 175 that contain iota information in addition - rejecting all other spots.</P>
 176 <P>
 177 <BLOCKQUOTE><CODE>
 178 <PRE>
 179 accept/spot 1 on 10m/ssb and info iota
 180 </PRE>
 181 </CODE></BLOCKQUOTE>
 182 </P>
 183 <P>This next filter will accept spots asking or containing QSL information and dump
 184 all other spots</P>
 185 <P>
 186 <BLOCKQUOTE><CODE>
 187 <PRE>
 188 accept/spot 2 info QSL
 189 </PRE>
 190 </CODE></BLOCKQUOTE>
 191 </P>
 192 <P>Note: The following series of filters are based on <EM>call</EM> and
 193 <EM>by</EM>.  Call always references the callsign of the spotted DX station.
 194 By always references the callsign of the spotting station.</P>
 195
 196 <H2><A NAME="ss7.4">7.4</A> <A HREF="filtering_en.html#toc7.4">Filters to accept spots based on call</A>
 197 </H2>
 198
 199 <P>
 200 <BLOCKQUOTE><CODE>
 201 <PRE>
 202 Syntax: accept/spot [0-9] call &lt;prefixes>
 203 </PRE>
 204 </CODE></BLOCKQUOTE>
 205 </P>
 206 <P>This filter is misleading in a way. It is strictly based on the spotted call
 207 sign letters or numbers entered and not based on countries or DXCC entities. </P>
 208
 209 <P>Examples ...</P>
 210
 211 <P>This filter will accept spots for G1AAA, GJ2BBB, and GW3CCC and reject all
 212 others, including M0AAA.</P>
 213 <P>
 214 <BLOCKQUOTE><CODE>
 215 <PRE>
 216 accept/spot 0 call G
 217 </PRE>
 218 </CODE></BLOCKQUOTE>
 219 </P>
 220 <P>This next filter will accept spots for PA3AAA and reject spots for PB4BBB as
 221 well as all others.</P>
 222 <P>
 223 <BLOCKQUOTE><CODE>
 224 <PRE>
 225 accept/spot 1 call PA
 226 </PRE>
 227 </CODE></BLOCKQUOTE>
 228 </P>
 229 <P>This filter will accept spots for callsigns beginning with "K", i.e., K1AA,
 230 KC4AAA,  KH6DDD and reject spots for W3BG and N3RD as well as all other
 231 spots.</P>
 232 <P>
 233 <BLOCKQUOTE><CODE>
 234 <PRE>
 235 accept/spot 2 call K
 236 </PRE>
 237 </CODE></BLOCKQUOTE>
 238 </P>
 239
 240 <H2><A NAME="ss7.5">7.5</A> <A HREF="filtering_en.html#toc7.5">Filters to accept spots based on call_dxcc</A>
 241 </H2>
 242
 243 <P>
 244 <BLOCKQUOTE><CODE>
 245 <PRE>
 246 Syntax:  accept/spot [0-9] call_dxcc &lt;numbers or prefixes>
 247 </PRE>
 248 </CODE></BLOCKQUOTE>
 249 </P>
 250 <P>This filter is based on DXCC entities and uses either the country prefixes or
 251 the DXCC entity number found by using the command <EM>show/prefix</EM>. See
 252 example of <EM>show/prefix</EM> above.</P>
 253
 254 <P>Examples ...</P>
 255 <P>
 256 <BLOCKQUOTE><CODE>
 257 <PRE>
 258 accept/spot 0 call_dxcc 226,197
 259
 260 or
 261
 262 accept/spot 0 call_dxcc ve,w
 263 </PRE>
 264 </CODE></BLOCKQUOTE>
 265 </P>
 266 <P>(Both will work) These spot filters will accept all spots for US and Canada
 267 stations and trash all others.</P>
 268
 269 <P>The folowing spot filter will accept all spots for US stations and yet reject
 270 any spots for W3FM who is always being spotted by Europeans and filling up my
 271 screen.</P>
 272 <P>
 273 <BLOCKQUOTE><CODE>
 274 <PRE>
 275 accept/spot 1 call_dxcc w not call w3fm
 276 </PRE>
 277 </CODE></BLOCKQUOTE>
 278 </P>
 279
 280 <H2><A NAME="ss7.6">7.6</A> <A HREF="filtering_en.html#toc7.6">Filters to accept spots based on call_itu</A>
 281 </H2>
 282
 283 <P>Similarly, call_itu and call_zone use ITU regions that can also be obtained
 284 using the <EM>show/prefix</EM> command (see above.)</P>
 285 <P>
 286 <BLOCKQUOTE><CODE>
 287 <PRE>
 288 Syntax:  accept/spot [0-9] call_itu &lt;numbers>
 289 </PRE>
 290 </CODE></BLOCKQUOTE>
 291 </P>
 292 <P>Example ...</P>
 293
 294 <P>This spot filter will  accept all spots for  ITU region 7 and reject all
 295 others.</P>
 296 <P>
 297 <BLOCKQUOTE><CODE>
 298 <PRE>
 299 accept/spot 0  call_itu 7
 300 </PRE>
 301 </CODE></BLOCKQUOTE>
 302 </P>
 303
 304 <H2><A NAME="ss7.7">7.7</A> <A HREF="filtering_en.html#toc7.7">Filters to accept spots based on call_zone</A>
 305 </H2>
 306
 307 <P>
 308 <BLOCKQUOTE><CODE>
 309 <PRE>
 310 Syntax:  accept/spot [0-9] call_zone &lt;numbers>
 311 </PRE>
 312 </CODE></BLOCKQUOTE>
 313 </P>
 314 <P>This filter is based on CQ zones and uses the CQ zone number found by using
 315 the command <EM>show/prefix</EM> (see above.)</P>
 316
 317 <P>Example ...</P>
 318
 319 <P>This spot filter will  accept all spots for CQ zone 5 and reject all others.</P>
 320 <P>
 321 <BLOCKQUOTE><CODE>
 322 <PRE>
 323 accept/spot 0 call_zone 5
 324 </PRE>
 325 </CODE></BLOCKQUOTE>
 326 </P>
 327
 328 <H2><A NAME="ss7.8">7.8</A> <A HREF="filtering_en.html#toc7.8">Filters to accept spots based on call_state</A>
 329 </H2>
 330
 331 <P>
 332 <BLOCKQUOTE><CODE>
 333 <PRE>
 334 Syntax:  accept/spot [0-9] call_state &lt;state2-letter postal codes>
 335 </PRE>
 336 </CODE></BLOCKQUOTE>
 337 </P>
 338 <P>This filter is based on state of the call spotted for those callsigns contained
 339 in the usdb database.  </P>
 340
 341 <P>Example ...</P>
 342
 343 <P>This spot filter will  accept all spots of stations located in the
 344 Commonwealth of Pennsylvania and reject all others. It's the PA QSO Party
 345 Weekend.</P>
 346 <P>
 347 <BLOCKQUOTE><CODE>
 348 <PRE>
 349 accept/spot 0  call_state pa
 350 </PRE>
 351 </CODE></BLOCKQUOTE>
 352 </P>
 353
 354 <H2><A NAME="ss7.9">7.9</A> <A HREF="filtering_en.html#toc7.9">Filters to accept spots based on by</A>
 355 </H2>
 356
 357 <P><EM>by</EM> filters are similar to and function exactly as call filters except
 358 that they act on the spotting station callsign and not the spotted callsign</P>
 359
 360 <P>So ...</P>
 361
 362 <P>This filter is similar to and functions like the  call &lt;prefixes&gt; (See above)
 363 except that it accepts spots generated by the spotting callsign and dumps all
 364 other spots.</P>
 365 <P>
 366 <BLOCKQUOTE><CODE>
 367 <PRE>
 368 Syntax: accept/spot [0-9] by &lt;prefixes>
 369 </PRE>
 370 </CODE></BLOCKQUOTE>
 371 </P>
 372 <P>This filter is based on DXCC entities and uses the DXCC entity number found
 373 by using the command <EM>show/prefix</EM> and it accepts spots generated
 374 within the spotting DXCC entity and rejects other spots.</P>
 375 <P>
 376 <BLOCKQUOTE><CODE>
 377 <PRE>
 378 Syntax:  accept/spot [0-9] by_dxcc &lt;numbers>
 379 </PRE>
 380 </CODE></BLOCKQUOTE>
 381 </P>
 382 <P>This next filter is based on ITU regions and uses the ITU region number found by
 383 using the command <EM>show/prefix</EM> (see above), except that it accepts
 384 spots generated by a spotting callsign within the ITU region and rejects all
 385 other spots.</P>
 386 <P>
 387 <BLOCKQUOTE><CODE>
 388 <PRE>
 389 Syntax:  accept/spot [0-9] call_itu &lt;numbers>
 390 </PRE>
 391 </CODE></BLOCKQUOTE>
 392 </P>
 393 <P>This filter is based on CQ zones and uses the CQ zone number found by using
 394 the command <EM>show/prefix</EM> (see above), except that it accepts spots
 395 generated by a spotting callsign within the CQ zone and rejects all other
 396 spots.</P>
 397 <P>
 398 <BLOCKQUOTE><CODE>
 399 <PRE>
 400 Syntax:  accept/spot [0-9] call_zone &lt;numbers>
 401 </PRE>
 402 </CODE></BLOCKQUOTE>
 403 </P>
 404 <P>This filters is based on the state location of the spotting station found
 405 by using the command <EM>show/usdb</EM> and accepts only those spots
 406 generated by stations from the states(s) specified rejecting all other spots.</P>
 407 <P>
 408 <BLOCKQUOTE><CODE>
 409 <PRE>
 410 Syntax:  accept/spot [0-9] by_state &lt;state2-letter postal codes>
 411 </PRE>
 412 </CODE></BLOCKQUOTE>
 413 </P>
 414
 415 <HR>
 416 <A HREF="filtering_en-8.html">Next</A>
 417 <A HREF="filtering_en-6.html">Previous</A>
 418 <A HREF="filtering_en.html#toc7">Contents</A>
 419 </BODY>
 420 </HTML>