WCSTools programs

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.6.9, 6 July 2007, 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  Arcsec
200.077196  09:58:00.597 +09:41:40.62   8.26   8.16   8.07   9.06  2079.10
201.075157  09:58:28.100 +10:02:51.17   8.79   8.54   8.49   9.75  1368.21
201.075159  09:58:28.737 +10:25:28.51   8.20   7.97   7.86   9.26  2037.51
201.075192  09:59:10.688 +10:04:23.55   8.75   8.14   7.96  10.39   774.58
201.075196  09:59:17.051 +10:10:03.02   8.94   8.80   8.64   9.79   875.18
201.075202  09:59:24.702 +10:02:51.43   9.32   8.71   8.57  11.01   548.85
200.077278  10:00:05.026 +09:38:23.41   7.91   7.28   7.07   9.81  1298.71
200.077325  10:01:42.737 +09:36:40.39   8.20   7.68   7.61   9.73  2065.16
201.075298  10:01:46.850 +10:12:57.37   8.14   7.91   7.83   9.21  1758.97
200.077333  10:01:51.501 +09:35:04.90   9.25   8.73   8.60  10.74  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:
catalog USNO-UCAC2
ra      13:27:48.311
dec     +47:27:28.98
radecsys        fk4
equinox 1950.0000
epoch   1950.0000
rpmunit mas/year
dpmunit mas/year
radsec  180.00
catsort ra
program sucac2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
ucac2_id        ra1950          dec1950         magj    magh    magk    magc    pmra    pmdec   arcsec
----------      ------------    ------------    -----   -----   -----   -----   ------  ------  ------
275.066612      13:27:49.138    +47:25:33.39    12.86   12.24   12.14   14.77    -39.6   -21.7  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.6.9, 6 July 2007, 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  Arcsec
200.077277  10:00:03.989 +09:59:00.50  12.53  12.01  11.88  13.98   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.6.9, 6 July 2007, Doug Mink SAO
UCAC2_num     RA2000       Dec2000      MagJ   MagH   MagK   MagC
180.000001  00:00:00.810 -00:16:40.99  11.36  11.06  11.00  12.24
180.000002  00:00:02.582 -00:04:21.74  12.16  11.85  11.79  13.10
180.000003  00:00:02.588 -00:13:47.10  12.50  12.13  12.05  13.58
180.000004  00:00:03.380 -00:23:43.95  13.81  13.38  13.30  15.13
180.000005  00:00:04.373 -00:29:01.45  11.43  11.13  11.02  12.37
180.000006  00:00:05.842 -00:10:08.03  14.04  13.53  13.39  15.95
180.000007  00:00:06.082 -00:15:47.40  13.53  13.05  12.95  15.15
180.000008  00:00:07.347 -00:00:22.66  14.43  14.09  13.92  15.78
180.000009  00:00:07.826 -00:07:54.78  14.03  13.67  13.61  15.52
180.000010  00:00:08.984 -00:03:53.33   9.48   9.16   9.08  10.51

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
radecsys        fk5
equinox 2000.0000
epoch   2000.0000
radsec  900.00
rpmunit mas/yr
dpmunit mas/yr
program sucac2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
ppm_id  srch_ra         srch_dec        s_mag   s_TYPE  ucac2_id        ra              dec             magj    magh    magk    magc    pmra    pmdec   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     9.16    8.75    8.72   10.12     10.9   -32.2  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     8.03    7.89    7.83    9.02     -0.6   -15.5  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     6.97    6.51    6.42    8.55     11.9   -13.2  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     7.35    6.77    6.64    9.16     -6.4    -9.9  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     7.60    7.17    7.09    9.11     -3.2    -3.4  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, 2MASS J magnitude, 2MASS H magnitude, 2MASS Ks magnitude, UCAC magnitude, 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.6.9, 6 July 2007, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
Radius: +00:06:00.00
USNO-UCAC2 10:00:00.000 +30:00:00.00 J2000 r= +00:06:00.0 at epoch 2000.0000
http://tdc-www.harvard.edu/cgi-bin/scat?catalog=ucac2&ra=150.0000000&dec=30.0000000&system=J2000&rad=360.000&sort=distance&epoch=2000.00000&nstar=10
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
TABREAD: Catalog http://tdc-www.harvard.edu/cgi-bin/scat : 7 / 8 / 7 found
7 USNO UCAC2 Catalog Stars
241.064065  10:00:07.743 +30:00:04.93  11.15  10.70  10.59  12.40  100.70
240.063601  09:59:47.777 +29:57:19.19  14.05  13.62  13.46  15.54  226.01
241.064060  09:59:54.375 +30:03:52.05  13.84  13.54  13.51  15.16  243.28
240.063598  09:59:37.069 +29:58:13.61  11.81  11.18  10.96  14.65  316.35
240.063609  10:00:09.784 +29:54:57.57  10.40   9.82   9.70  11.83  328.07
241.064055  09:59:39.456 +30:03:41.81  12.33  11.94  11.87  13.37  346.95
241.064069  10:00:17.548 +30:04:30.73  12.35  12.05  12.01  13.29  353.86
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.6.9, 6 July 2007, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
Radius: +00:06:00.00
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 /    19  / 173332 sources from zone  240    
UCACREAD:    2 /    2:     7 /    25  / 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  100.71
240.063601  09:59:47.777 +29:57:19.19  14.05  13.62  13.46  15.54  226.02
241.064060  09:59:54.375 +30:03:52.05  13.84  13.54  13.51  15.16  243.27
240.063598  09:59:37.069 +29:58:13.61  11.81  11.18  10.96  14.65  316.36
240.063609  10:00:09.784 +29:54:57.57  10.40   9.82   9.70  11.83  328.07
241.064055  09:59:39.456 +30:03:41.81  12.33  11.94  11.87  13.37  346.95
241.064069  10:00:17.548 +30:04:30.73  12.35  12.05  12.01  13.29  353.87

Telescope Data Center

Last updated 11 July 2007 by Doug Mink

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