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

Last updated 6 November 2009 by Doug Mink

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