### Example 1. Search with results to standard output

Find the 10 brightest (in R2) USNO-B1.0 stars in a 1-degree square box centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.
sub1 -hn 10 -s m4 -r -1800 10:00:00 +30:00:00 J2000
produces the following, where PM is the probability that there is a proper motion from 0=none to 9=probable and ID is the number of plates, out of 5, on which the star was found (0 means it is bright and from the Tycho-2 catalog):
```sub1 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
USNO-B1.0 10:00:00.000 +30:00:00.00 J2000 +- +00:34:38.5 +00:30:00.0 at epoch 2000.0000
10 / 6370 USNO-B1.0 Sources (MagR2 brighter than 9.66)
USNO_B1_number  RA2000       Dec2000     MagB1  MagR1  MagB2  MagR2  MagN  PM NI SG  Arcsec
1196.0179331 09:59:36.214 +29:38:42.83    6.99   5.16   6.30   5.10   4.61 10  0 12  1314.15
1195.0176556 09:58:29.831 +29:32:03.95    9.21   7.47   8.55   7.41   6.94 10  0 12  2046.36
1204.0178692 09:59:07.128 +30:25:18.94    9.78   7.51   8.91   7.44   6.76 10  0 12  1666.40
1198.0180130 09:59:15.755 +29:52:46.95   10.70   8.50   9.85   8.43   7.79 10  0 12   719.92
1199.0177782 09:58:19.171 +29:55:34.88   10.25   8.70   9.69   8.64   8.21 10  0 12  1336.84
1202.0177596 10:00:52.275 +30:12:16.50   10.72   9.14  10.14   9.09   8.65 10  0 12  1001.31
1200.0179599 10:01:49.216 +30:00:35.48   11.38   9.50  10.66   9.44   8.93 10  0 12  1419.13
1196.0179473 10:00:51.334 +29:41:03.72   10.45   9.51  10.16   9.47   9.19 10  0 12  1318.04
1200.0179274 09:59:19.887 +30:00:27.47   10.36   9.62  10.13   9.60   9.37 10  0 12   521.78
1204.0178926 10:00:24.300 +30:25:51.43   11.32   9.71  10.73   9.66   9.22 10  0 12  1583.08
```

### Example 2. Search with results to a file

Find all USNO A stars within 3 arcminutes of M51 and write RA-sorted results to a file
sub1 -ts r -wr 180 -o m51 13:27:48.311 +47:27:28.98 B1950
produces file m51.ub1:
```catalog USNO-B1.0
ra      13:27:48.311
dec     +47:27:28.98
equinox 1950.0000
epoch   1950.0000
rpmunit mas/year
dpmunit mas/year
catsort ra
program sub1 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
usnob1_id       ra1950          dec1950         magb1   magr1   magb2   magr2   magn    pm      ni      sg      pmra    pmdec   arcsec
------------    ------------    ------------    -----   -----   -----   -----   -----   --      --      --      ------  ------  ------
1371.0282379    13:27:31.970    +47:26:32.41    16.32   99.99   99.99   99.99   17.74    0       2      10         0.0     0.0  175.14
1371.0282384    13:27:33.248    +47:25:59.82    19.19   18.00   99.99   99.99   18.73    7       3       7        39.3    61.9  176.91
1371.0282382    13:27:33.337    +47:26:01.32    17.40   99.99   99.99   99.99   18.14    0       2      10         0.0     0.0  175.37
1372.0290336    13:27:33.715    +47:28:25.46    99.99   16.92   99.99   99.99   17.54    0       2      10         0.0     0.0  158.42
1371.0282386    13:27:34.111    +47:27:19.48    19.70   99.99   99.99   99.99   18.29    0       2      10         0.0     0.0  144.34
. . .

1372.0290378    13:28:02.568    +47:29:03.42    18.15   17.74   99.99   99.99   99.99    0       2       1         0.0     0.0  172.67
1371.0282503    13:28:03.011    +47:25:57.51    19.18   19.65   17.83   18.33   99.99    0       4       2         0.0     0.0  174.94
1371.0282504    13:28:03.173    +47:25:59.04    19.85   99.99   19.41   99.99   99.99    0       2       1         0.0     0.0  175.56
1372.0290380    13:28:04.408    +47:27:48.71    99.99   19.25   99.99   99.99   18.72    0       2      11         0.0     0.0  164.43
1372.0290381    13:28:05.181    +47:27:42.70    99.99   99.99   99.99   19.75   18.51    0       2      13         0.0     0.0  171.63
```
(56 stars in file)

### Example 3. Find closest star

Find the closest USNO B-1.0 star to 10:00:00 +50:00:00 J2000
sub1 -a 10:00:00 +50:00:00 J2000
produces the following:
```1399.0209660 10:00:00.086 +49:59:45.73   21.05  19.91  99.99  99.99  99.99  0  2   14.29
```

### Example 4. List selected stars from catalog

List USNO-B1.0 Catalog stars 1350.00000001 through 1350.00000010
sub1 -s n -h 1350.0000001-1350.0000010x0.0000001
produces the following:
```sub1 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
USNO_B1_number  RA2000       Dec2000     MagB1  MagR1  MagB2  MagR2  MagN  PM NI SG
1350.0000001 00:00:00.001 +45:02:44.55   20.41  99.99  21.06  20.30  19.04  0  4 10
1350.0000002 00:00:00.063 +45:05:28.45   19.78  18.67  19.30  18.11  17.80  0  5  7
1350.0000003 00:00:00.112 +45:05:07.60   20.41  18.46  20.60  18.46  17.83  9  5  8
1350.0000004 00:00:00.223 +45:01:04.77   99.99  20.03  21.12  19.62  18.50  0  4  7
1350.0000005 00:00:00.350 +45:04:10.92   99.99  20.01  21.12  20.30  99.99  9  3  3
1350.0000006 00:00:00.469 +45:03:57.53   99.99  99.99  21.09  20.46  99.99  0  2  6
1350.0000007 00:00:00.531 +45:02:32.74   19.48  16.68  18.26  16.53  15.22  9  5  8
1350.0000008 00:00:00.563 +45:00:16.87   20.41  99.99  21.01  20.22  99.99  8  3  5
1350.0000009 00:00:00.757 +45:01:10.75   99.99  99.99  20.97  20.05  18.96  8  3  7
1350.0000010 00:00:01.044 +45:02:23.97   99.99  19.80  21.00  19.86  18.89  9  4  7
```
where the columns are USNO-B1.0 region.number, RA, Dec, B1 magnitude, R1 magnitude, B2 magnitude, R2 magnitude, N magnitude, proper motion probability (0-9, 10=Tycho), the number of plate ID's (0=Tycho-2, 2-5), and the closeness to a star PSF (1-11, Tycho-2=12).

### Example 5. Match stars in input catalog

Match the stars in the input catalog test.tab to the USNO-B1.0 Catalog and list them one match per line.
sub1 -tl @test.tab
produces the following:
```catalog USNO-B1.0
search  test.tab
equinox 2000.0000
epoch   2000.0000
rpmunit mas/yr
dpmunit mas/yr
program sub1 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
ppm_id  srch_ra         srch_dec        s_mag   s_TYPE  usnob1_id       ra              dec             magb1   magr1   magb2   magr2   magn    pmra    pmdec   pm      ni      sg       n       dra     ddec    drad
------- ------------    ------------    -----   ----    ------------    ------------    ------------    -----   -----   -----   -----   -----   ------  ------  --      --      --       --      ---     ------- ------- -------
240020  22:15:54.555    -11:36:56.13     9.80   __      0783.0692289    22:15:54.555    -11:36:56.23    10.87    9.79   10.52    9.76    9.44     12.0     0.0  10       0      12       69        -0.00   -0.10    0.10
267313  17:47:51.210    -22:58:17.35     9.10   A0      0670.0635263    17:47:51.194    -22:58:17.30     9.22    8.70    9.05    8.68    8.53     -2.0   188.0  10       0      12       1038      -0.22    0.05    0.23
196784  13:42:07.204    -09:06:40.06     8.60   K0      0808.0255760    13:42:07.200    -09:06:40.06     9.52    8.08    9.01    8.02    7.62     10.0    24.0  10       0      12       70        -0.06    0.00    0.06
127373  10:24:43.528    +11:21:21.15    10.20   K0      1013.0184462    10:24:43.507    +11:21:21.50    10.70    8.77    9.96    8.70    8.18     -8.0     0.0  10       0      12       33        -0.31    0.35    0.47
095438  06:07:46.792    +23:28:44.76    10.30   K0      1134.0106037    06:07:46.837    +23:28:44.94    10.34    8.73    9.75    8.68    8.24     -4.0   140.0  10       0      12       157        0.61    0.18    0.64
```
where the columns are input catalog star name, RA, Dec, magnitude, spectral type, B1.0 region.number, RA, Dec, B1 magnitude, R1 magnitude, B2 magnitude, R2 magnitude, N magnitude, B1.0 RA proper motion, B1.0 Dec proper motion, proper motion probability (0-9, 10=Tycho), number of plate ID's (0=Tycho-2, 2-5), closeness to a star PSF (1-11, Tycho-2=12), number of stars in the 120-arcsecond radius default search region, and catalog - search dra, ddec, and dr (in arcseconds).

### Example 6. Search over the web with results to standard output

Find the 10 closest USNO A-2.0 stars in a 3-arcminute circle centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.
setenv UB1_PATH server_URL/cgi-bin/scat
sub1 -hs p -vn 10 -r 180 10:00:00 +30:00:00 J2000
produces the following:
```sub1 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
USNO-B1.0 10:00:00.000 +30:00:00.00 J2000 r= +00:03:00.0 at epoch 2000.0000
SearchLim: RA: 09:59:46.144 - 10:00:13.856  Dec: +29:57:00.00 - +30:03:00.00
RefLim: RA: 09:59:46.137 - 10:00:13.863  Dec: +29:57:00.00 - +30:03:00.00
TABREAD: Catalog http://tdc-www.harvard.edu/cgi-bin/scat : 10 / 11 / 10 found
10 USNO-B1.0 Sources
USNO_B1_number  RA2000       Dec2000     MagB1  MagR1  MagB2  MagR2  MagN  PM NI SG  Arcsec
1199.0178018 09:59:57.821 +29:59:42.02   18.52  19.10  19.07  19.08  17.89  0  5  0  33.53
1199.0178017 09:59:57.361 +29:59:59.15   99.99  18.46  19.89  18.77  17.51  0  4  0  34.29
1200.0179369 10:00:03.012 +30:00:08.37   18.56  20.01  19.85  19.67  99.99  9  4  0  40.01
1200.0179371 10:00:04.152 +30:00:05.71   99.99  19.96  20.24  99.99  99.99  0  2  0  54.24
1200.0179370 10:00:03.634 +30:00:32.17   99.99  20.56  21.52  20.09  99.99  8  3  0  57.12
1199.0178024 10:00:01.693 +29:58:54.63   23.38  99.99  21.53  99.99  99.99  0  2  0  68.97
1199.0178027 10:00:04.420 +29:59:18.96   24.29  19.81  99.99  99.99  99.99  0  2  0  70.58
1200.0179355 09:59:55.628 +30:00:56.79   99.99  20.54  21.50  99.99  99.99  0  2  0  80.31
1199.0178021 09:59:59.035 +29:58:39.72   99.99  19.41  20.63  18.87  18.33  9  4  0  81.25
1200.0179363 10:00:00.151 +30:01:21.71   99.99  20.30  20.93  20.35  99.99  9  3  0  81.73
```

### Example 7. Return objects found on 4 or more plates

Find objects within 2 arcminutes of 10:00:0 +10:00:00 J2000 which appear on at least 4 of the surveyed plates and sort them by the second epoch R magnitude.
sub1 -s m4 -hr 120 10:00 10:00 J2000 minid=4
produces the following:
```sub1 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
USNO-B1.0 10:00:00.000 +10:00:00.00 J2000 r= +00:02:00.0 at epoch 2000.0000
USNO_B1_number  RA2000       Dec2000     MagB1  MagR1  MagB2  MagR2  MagN  PM NI SG  Arcsec
0999.0188143 10:00:03.992 +09:59:00.61   15.60  14.03  15.12  14.08  13.47  9  5  0   83.69
1000.0183182 10:00:04.883 +10:01:22.79   20.18  17.91  19.48  17.62  17.08  9  5  0  109.80
1000.0183184 10:00:05.283 +10:01:19.44   18.31  17.66  17.53  17.73  17.80  0  5  0  111.36
0999.0188141 10:00:03.517 +09:58:42.26   19.64  18.51  18.64  18.26  18.18  0  5  0   93.50
0999.0188137 10:00:01.906 +09:58:24.17   99.99  19.34  20.01  18.97  18.19  0  4  0   99.88
1000.0183168 09:59:57.108 +10:00:42.33   99.99  19.81  21.41  19.45  18.65  0  4  0   60.14
1000.0183153 09:59:54.415 +10:01:12.16   20.59  19.91  20.88  19.65  99.99  0  4  0  109.61
0999.0188146 10:00:05.085 +09:58:42.16   99.99  19.63  21.01  19.78  18.98  9  4  0  108.18

```