WCSTools programs

sucac3 Examples

Example 1. Search with results to standard output

Find the 10 brightest UCAC3 stars in a 1-degree square box centered on 10:00:00 +10:00:00 J2000 and sort them by right ascension.
sucac3 -shn 10 -r -1800 10:00:00 +10:00:00 J2000
produces the following:
sucac3 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
     ucac3 10:00:00.000 +10:00:00.00 J2000 +- +00:30:27.8 +00:30:00.0 at epoch 2000.0000
10 / 527 USNO UCAC3 Catalog Stars (Mag brighter than 11.64)
Number       RA2000       Dec2000       MagB   MagR   MagI   MagJ   MagH   MagK   MagM   MagA nim ncat  Arcsec
200.117639 09:58:00.597 +09:41:40.60    9.51   8.86   8.49   8.26   8.16   8.07   8.89   8.96   2    9  2079.11
201.115094 09:58:07.997 +10:01:52.74   10.71   9.83   9.36   9.42   9.15   9.12  10.29  10.28   4    3  1658.27
201.115121 09:58:28.100 +10:02:51.16   10.50   9.66   9.20   8.79   8.54   8.49   9.71   9.71   2    8  1368.20
201.115185 09:59:17.051 +10:10:03.01   10.45   9.72   9.17   8.94   8.80   8.64   9.68   9.69   2    8   875.17
200.117775 10:00:05.025 +09:38:23.40   11.28   9.58   8.79   7.91   7.28   7.07   9.76   9.78   2   11  1298.73
201.115243 10:00:14.418 +10:01:27.73   11.64  10.63  10.24   9.64   9.37   9.26  10.74  10.73   5    8   230.34
200.117820 10:00:59.905 +09:40:43.76   11.15  10.33   9.99   9.44   9.14   9.13  10.41  10.42   4    5  1456.28
201.115317 10:01:24.396 +10:04:24.73   11.48  10.68  10.06   9.85   9.59   9.57  10.83  10.82   3    6  1274.36
200.117853 10:01:42.736 +09:36:40.40   10.91   9.49   8.68   8.20   7.68   7.61   9.66   9.66   2    7  2065.15
201.115346 10:01:46.850 +10:12:57.37    9.79   8.93   8.28   8.14   7.91   7.83   9.02   9.07   2   12  1758.98

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
sucac3 -tswr 180 -o test 10:27:48.311 +47:27:28.98 B1950
produces file test.ucac3. Note inclusion of errors in position in arcseconds and proper motion in mas/year.
catalog ucac3
ra      10: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 sucac3 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
ucac3_id        ra1950          dec1950         raerr   decerr  magb    magr    magi    magj    magh    magk    magm    maga    pmra    pmdec   epmra   epmdec  ni      nc      arcsec
----------      ------------    ------------    -----   -----   -----   -----   -----   -----   -----   -----   -----   -----   ------  ------  -----   -----   --      --      ------
275.116927      10:27:54.010    +47:28:20.60    0.026   0.024   15.26   14.24   13.80   12.99   12.63   12.56   14.29   14.41      0.0     0.0   -1.0    -1.0    4       2      77.49
275.116928      10:27:54.916    +47:28:00.21    0.083   0.060   17.98   16.83   14.98   12.62   12.03   11.76   15.68   16.27    -57.4   -57.6    8.6     7.4    3       2      73.90
275.116934      10:27:58.399    +47:27:47.81    0.043   0.052   16.33   15.65   15.40   14.52   14.23   14.21   15.75   15.61      0.0     0.0   -1.0    -1.0    3       2      104.03
275.116933      10:27:58.412    +47:26:44.89    0.070   0.070   16.91   16.00   15.70   14.86   14.46   14.45   16.17   16.30      0.0     0.0   -1.0    -1.0    2       2      111.54

Example 3. Find closest star

Find the closest UCAC3 star to 10:00:00 +10:00:00 J2000
sucac3 -ha 10:00:00 +10:00:00 J2000
produces the following:
sucac3 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO  Find closest star
     ucac3 10:00:00.000 +10:00:00.00 J2000 r= +00:15:00.0 at epoch 2000.0000
Number       RA2000       Dec2000       MagB   MagR   MagI   MagJ   MagH   MagK   MagM   MagA nim ncat  Arcsec
200.117774 10:00:03.990 +09:59:00.51   15.25  13.80  13.36  12.53  12.01  11.88  14.49  14.39   4    2   83.75

Example 4. List selected stars from catalog

List UCAC3 Catalog stars 180.000001 through 180.000010
sucac3 -h 180.000001-180.000010x0.000001
produces the following:
sucac3 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
Number       RA2000       Dec2000       MagB   MagR   MagI   MagJ   MagH   MagK   MagM   MagA nim ncat
180.000001 00:00:00.810 -00:16:41.00   15.88  14.92  13.52  11.36  11.06  11.00  12.54  12.50   6    2
180.000002 00:00:01.233 -00:06:59.88   14.49  13.13  12.54  12.18  11.62  11.53  14.03  13.95   3    2
180.000003 00:00:02.582 -00:04:21.74   13.39  12.44  12.12  12.16  11.85  11.79  13.43  13.39   8    2
180.000004 00:00:02.587 -00:13:47.07   14.02  13.12  12.58  12.50  12.13  12.05  13.99  13.88   8    2
180.000005 00:00:03.288 -00:23:13.18   16.62  15.85  15.46  14.94  14.48  14.42  16.85  16.02   2    2
180.000006 00:00:03.381 -00:23:43.94   15.74  14.82  14.25  13.81  13.38  13.30  15.29  15.33   3    2
180.000007 00:00:04.374 -00:29:01.45   12.74  11.83  11.47  11.43  11.13  11.02  12.65  12.62   8    2
180.000008 00:00:05.158 -00:17:26.84   99.99  99.99  99.99  15.38  14.96  15.14  16.29  15.71   1    1
180.000009 00:00:05.842 -00:10:08.06   16.52  15.19  14.68  14.04  13.53  13.39  15.94  15.78   3    2
180.000010 00:00:06.080 -00:15:47.37   15.98  14.60  13.97  13.53  13.05  12.95  14.81  15.28   3    2

Example Example 5. Match stars in input catalog

Match the stars in the input catalog test.tab to the UCAC3 Catalog and list them one match per line.
sucac3 -tl @test.tab
produces the following:
catalog ucac3
search  test.tab
radecsys        fk5
equinox 2000.0000
epoch   2000.0000
radsec  900.00
rpmunit mas/yr
dpmunit mas/yr
program sucac3 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
ppm_id  srch_ra         srch_dec        s_mag   s_type  ucac3_id        ra              dec             raerr   decerr  magb    magr    magi    magj    magh    magk    magm    maga    pmra    pmdec   epmra   epmdec  ni      nc      n       dra         ddec    drad   
------- ------------    ------------    -----   ----    ----------      ------------    ------------    -----   -----   -----   -----   -----   -----   -----   -----   -----   -----   ------  ------  -----   -----   --      --      --      -------     ------- -------
240020  22:15:54.555    -11:36:56.13     9.80   __      157.291126      22:15:54.552    -11:36:56.25    0.018   0.017   10.64    9.51    9.14    9.16    8.75    8.72   10.13   10.13     10.4   -32.3    1.2     1.2    3       7      109       -0.04       -0.12    0.13
267313  17:47:51.210    -22:58:17.35     9.10   A0      135.248883      17:47:51.193    -22:58:17.31    0.017   0.017   16.74   16.35   30.00    8.03    7.89    7.83    8.75    8.82      0.2   -14.8    1.2     1.1    3       9      5250      -0.23        0.04    0.23
196784  13:42:07.204    -09:06:40.06     8.60   K0      162.127974      13:42:07.201    -09:06:40.06    0.013   0.018    8.56    7.90    6.89    6.97    6.51    6.42    8.26    8.40     10.9   -12.8    1.4     1.9    1      12      103       -0.05        0.00    0.05
127373  10:24:43.528    +11:21:21.15    10.20   K0      203.111465      10:24:43.509    +11:21:21.49    0.018   0.018   10.51    8.71    8.12    7.35    6.77    6.64    8.90    8.94     -5.4    -9.2    1.0     0.7    1      10      80        -0.28        0.34    0.44
095438  06:07:46.792    +23:28:44.76    10.30   K0      227.049224      06:07:46.837    +23:28:44.97    0.021   0.020    9.14    7.00    6.27    7.60    7.17    7.09    8.87    8.98     -2.6    -3.4    0.9     0.8    1      10      1103       0.62        0.21    0.66
where the columns are input catalog star name, RA, Dec, magnitude, spectral type, UCAC region.number, RA, Dec, RA and Dec errors in arcseconds, Supercosmos B, R, and I magnitudes, 2MASS J, H, and Ks magnitudes, UCAC ifit model and aperture magnitudes, 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 UCAC3 stars in a 3-arcminute circle centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.
setenv UCAC3_PATH http://xxx/cgi-bin/scat
sucac3 -s p -vn 10 -r 360 10:00:00 +30:00:00 J2000
produces the following:

With a local catalog,
sucac3 -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:
isucac3 WCSTools 3.8.0, 6 November 2009, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
Radius: +00:06:00.00
     ucac3 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 /    35  / 314481 sources from zone  240    
UCACREAD:    2 /    2:     8 /    41  / 311544 sources from zone  241    
UCACREAD: 2 zones: 8 / 626025 found
8 USNO UCAC3 Catalog Stars
Number       RA2000       Dec2000       MagB   MagR   MagI   MagJ   MagH   MagK   MagM   MagA nim ncat  Arcsec
241.102983 10:00:07.743 +30:00:04.93   13.82  12.44  11.78  11.15  10.70  10.59  12.76  12.71  15    4  100.71
240.103869 09:59:47.780 +29:57:19.19   16.50  15.13  14.66  14.05  13.62  13.46  15.43  15.50   5    2  225.99
241.102976 09:59:54.373 +30:03:52.08   15.48  14.80  14.35  13.84  13.54  13.51  15.40  15.23   3    2  243.32
241.102975 09:59:48.602 +30:03:35.69   16.50  15.51  15.06  14.44  13.97  13.94  16.09  16.07   3    2  261.60
240.103866 09:59:37.068 +29:58:13.60   16.44  14.47  12.99  11.81  11.18  10.96  14.88  14.91   7    2  316.37
240.103883 10:00:09.786 +29:54:57.58   13.39  11.97  11.32  10.40   9.82   9.70  12.09  12.06   8    5  328.07
241.102968 09:59:39.456 +30:03:41.82   14.39  13.42  12.82  12.33  11.94  11.87  13.81  13.77   7    4  346.96
241.102990 10:00:17.549 +30:04:30.73   14.13  13.19  12.62  12.35  12.05  12.01  13.71  13.66   7    4  353.87

Telescope Data Center

Last updated 6 November 2009 by Doug Mink

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