sucac2 Examples

Example 1. Search with results to standard output

Find the 10 brightest UCAC2 stars in a 1-degree square box centered on 10:00:00 +10:00:00 J2000 and sort them by right ascension.
sucac2 -shn 10 -r -1800 10:00:00 +10:00:00 J2000
produces the following:
```sucac2 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
USNO-UCAC2 10:00:00.000 +10:00:00.00 J2000 +- +00:30:27.8 +00:30:00.0 at epoch 2000.0000
10 / 323 USNO UCAC2 Catalog Stars (Mag brighter than 9.32)
UCAC2_num     RA2000       Dec2000      MagJ   MagH   MagK   MagC nim ncat  Arcsec
200.077196  09:58:00.597 +09:41:40.62   8.26   8.16   8.07   9.06   2    8  2079.10
201.075157  09:58:28.100 +10:02:51.17   8.79   8.54   8.49   9.75   2    7  1368.21
201.075159  09:58:28.737 +10:25:28.51   8.20   7.97   7.86   9.26   2    8  2037.51
201.075192  09:59:10.688 +10:04:23.55   8.75   8.14   7.96  10.39   4    4   774.58
201.075196  09:59:17.051 +10:10:03.02   8.94   8.80   8.64   9.79   3    8   875.18
201.075202  09:59:24.702 +10:02:51.43   9.32   8.71   8.57  11.01   4    4   548.85
200.077278  10:00:05.026 +09:38:23.41   7.91   7.28   7.07   9.81   3   11  1298.71
200.077325  10:01:42.737 +09:36:40.39   8.20   7.68   7.61   9.73   3    7  2065.16
201.075298  10:01:46.850 +10:12:57.37   8.14   7.91   7.83   9.21   2   12  1758.97
200.077333  10:01:51.501 +09:35:04.90   9.25   8.73   8.60  10.74   4    8  2225.25
```

Example 2. Search with results to a file

Find all UCAC2 stars within 3 arcminutes of M51 and write RA-sorted results to a file
sucac2 -tswr 180 -o m51 13:27:48.311 +47:27:28.98 B1950
produces file m51.ucac2. Note inclusion of errors in position in arcseconds and proper motion in mas/year.
```catalog USNO-UCAC2
ra      13:27:48.311
dec     +47:27:28.98
equinox 1950.0000
epoch   1950.0000
rpmunit mas/year
dpmunit mas/year
catsort ra
gabrielle 465 > head -20 m51.ucac2
catalog USNO-UCAC2
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 sucac2 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
ucac2_id        ra1950          dec1950         raerr   decerr  magj    magh    magk    magc    pmra    pmdec   epmra   epmdec  ni      nc      arcsec
----------      ------------    ------------    -----   -----   -----   -----   -----   -----   ------  ------  -----   -----   --      --      ------
275.066612      13:27:49.138    +47:25:33.39    0.143   0.144   12.86   12.24   12.14   14.77    -39.6   -21.7   17.1    17.2    2       2      115.89
...
```

Example 3. Find closest star

Find the closest UCAC2 star to 10:00:00 +10:00:00 J2000
sucac2 -ha 10:00:00 +10:00:00 J2000
produces the following:
```sucac2 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO  Find closest star
USNO-UCAC2 10:00:00.000 +10:00:00.00 J2000 r= +00:15:00.0 at epoch 2000.0000
UCAC2_num     RA2000       Dec2000      MagJ   MagH   MagK   MagC nim ncat  Arcsec
200.077277  10:00:03.989 +09:59:00.50  12.53  12.01  11.88  13.98   4    2   83.75
```

Example 4. List selected stars from catalog

List UCAC2 Catalog stars 180.000001 through 180.000010
sucac2 -h 180.000001-180.000010x0.000001
produces the following:
```sucac2 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
UCAC2_num     RA2000       Dec2000      MagJ   MagH   MagK   MagC nim ncat
180.000001  00:00:00.810 -00:16:40.99  11.36  11.06  11.00  12.24   4    2
180.000002  00:00:02.582 -00:04:21.74  12.16  11.85  11.79  13.10   4    2
180.000003  00:00:02.588 -00:13:47.10  12.50  12.13  12.05  13.58   4    2
180.000004  00:00:03.380 -00:23:43.95  13.81  13.38  13.30  15.13   2    2
180.000005  00:00:04.373 -00:29:01.45  11.43  11.13  11.02  12.37   4    2
180.000006  00:00:05.842 -00:10:08.03  14.04  13.53  13.39  15.95   2    2
180.000007  00:00:06.082 -00:15:47.40  13.53  13.05  12.95  15.15   2    2
180.000008  00:00:07.347 -00:00:22.66  14.43  14.09  13.92  15.78   2    2
180.000009  00:00:07.826 -00:07:54.78  14.03  13.67  13.61  15.52   2    2
180.000010  00:00:08.984 -00:03:53.33   9.48   9.16   9.08  10.51   4    5
```

Example Example 5. Match stars in input catalog

Match the stars in the input catalog test.tab to the UCAC2 Catalog and list them one match per line.
sucac2 -tl @test.tab
produces the following:
```catalog USNO-UCAC2
search  test.tab
equinox 2000.0000
epoch   2000.0000
rpmunit mas/yr
dpmunit mas/yr
program sucac2 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
ppm_id  srch_ra         srch_dec        s_mag   s_type  ucac2_id        ra              dec             raerr   decerr  magj    magh    magk    magc    pmra    pmdec   epmra   epmdec  ni      nc      n       dra     ddec    drad
------- ------------    ------------    -----   ----    ----------      ------------    ------------    -----   -----   -----   -----   -----   -----   ------  ------  -----   -----   --      --      --      ------- ------- -------
240020  22:15:54.555    -11:36:56.13     9.80   __      157.176207      22:15:54.552    -11:36:56.24    0.152   0.142    9.16    8.75    8.72   10.12     10.9   -32.2   14.4    14.0    4       6      63        -0.05   -0.11    0.12
267313  17:47:51.210    -22:58:17.35     9.10   A0      135.149678      17:47:51.193    -22:58:17.31    0.154   0.142    8.03    7.89    7.83    9.02     -0.6   -15.5   15.2    14.0    3       8      1412      -0.23    0.04    0.23
196784  13:42:07.204    -09:06:40.06     8.60   K0      162.080730      13:42:07.202    -09:06:40.06    0.140   0.139    6.97    6.51    6.42    8.55     11.9   -13.2   14.2    14.1    2      11      68        -0.03    0.00    0.03
127373  10:24:43.528    +11:21:21.15    10.20   K0      203.072408      10:24:43.509    +11:21:21.47    0.145   0.142    7.35    6.77    6.64    9.16     -6.4    -9.9   14.3    14.0    2      10      60        -0.28    0.32    0.43
095438  06:07:46.792    +23:28:44.76    10.30   K0      227.033497      06:07:46.836    +23:28:44.96    0.154   0.140    7.60    7.17    7.09    9.11     -3.2    -3.4   14.7    13.5    2       9      704        0.61    0.20    0.64
```
where the columns are input catalog star name, RA, Dec, magnitude, spectral type, UCAC region.number, RA, Dec, RA and Dec errors in arcseconds, 2MASS J, H, and Ks magnitudes, UCAC magnitude, RA and Dec proper motion in milliarcseconds per year, RA and Dec proper motion errors in mas/year, number of images used, number of catalogs used, number of stars in the 120-arcsecond radius default search region, and catalog - search dra, ddec, and dr (in arcseconds).

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

Find the 10 closest UCAC2 stars in a 3-arcminute circle centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.
setenv UCAC2_PATH http://xxx/cgi-bin/scat
sucac2 -s p -vn 10 -r 360 10:00:00 +30:00:00 J2000
produces the following:
```sucac2 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
USNO-UCAC2 10:00:00.000 +30:00:00.00 J2000 r= +00:06:00.0 at epoch 2000.0000
SearchLim: RA: 09:59:32.287 - 10:00:27.713  Dec: +29:54:00.00 - +30:06:00.00
RefLim: RA: 09:59:32.259 - 10:00:27.741  Dec: +29:54:00.00 - +30:06:00.00
UCACZONES: searching 2 zones: 240 - 241
UCACZONES: Dec: 29.90000 - 30.10000
UCACREAD:    1 /    2:     3 /    24  / 173332 sources from zone  240
UCACREAD:    2 /    2:     7 /    30  / 173703 sources from zone  241
UCACREAD: 2 zones: 7 / 347035 found
7 USNO UCAC2 Catalog Stars
241.064065  10:00:07.743 +30:00:04.93  11.15  10.70  10.59  12.40  17    3  100.71
240.063601  09:59:47.777 +29:57:19.19  14.05  13.62  13.46  15.54   5    2  226.02
241.064060  09:59:54.375 +30:03:52.05  13.84  13.54  13.51  15.16   4    2  243.27
240.063598  09:59:37.069 +29:58:13.61  11.81  11.18  10.96  14.65   7    2  316.36
240.063609  10:00:09.784 +29:54:57.57  10.40   9.82   9.70  11.83  12    4  328.07
241.064055  09:59:39.456 +30:03:41.81  12.33  11.94  11.87  13.37   9    3  346.95
241.064069  10:00:17.548 +30:04:30.73  12.35  12.05  12.01  13.29   9    3  353.87
```
With a local catalog,
```sucac2 -hs p -vn 10 -r 360 10:00:00 +30:00:00 J2000
```
Called locally, scat returns the same result, with occasional roundoff differences in the last digit:
```sucac2 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
USNO-UCAC2 10:00:00.000 +30:00:00.00 J2000 r= +00:06:00.0 at epoch 2000.0000
SearchLim: RA: 09:59:32.287 - 10:00:27.713  Dec: +29:54:00.00 - +30:06:00.00
RefLim: RA: 09:59:32.259 - 10:00:27.741  Dec: +29:54:00.00 - +30:06:00.00
UCACZONES: searching 2 zones: 240 - 241
UCACZONES: Dec: 29.90000 - 30.10000
UCACREAD:    1 /    2:     3 /    24  / 173332 sources from zone  240
UCACREAD:    2 /    2:     7 /    30  / 173703 sources from zone  241
UCACREAD: 2 zones: 7 / 347035 found
7 USNO UCAC2 Catalog Stars
241.064065  10:00:07.743 +30:00:04.93  11.15  10.70  10.59  12.40  17    3  100.71
240.063601  09:59:47.777 +29:57:19.19  14.05  13.62  13.46  15.54   5    2  226.02
241.064060  09:59:54.375 +30:03:52.05  13.84  13.54  13.51  15.16   4    2  243.27
240.063598  09:59:37.069 +29:58:13.61  11.81  11.18  10.96  14.65   7    2  316.36
240.063609  10:00:09.784 +29:54:57.57  10.40   9.82   9.70  11.83  12    4  328.07
241.064055  09:59:39.456 +30:03:41.81  12.33  11.94  11.87  13.37   9    3  346.95
241.064069  10:00:17.548 +30:04:30.73  12.35  12.05  12.01  13.29   9    3  353.87
```

Last updated 6 November 2009 by Doug Mink

[WCSTools] [WCSTools programs] [scat] [sucac3] [sucac2] [sucac1] [sucac3 examples] [sucac1 examples]