ubcone: Access to USNO catalog

The USNO B1.0 catalog is accessed with the ubcone code developed by Steve Levine. I use it in a variety of my scripts and codes (see notes in ubc01) that create object catalogs for WCS and other purposes. Here I document how to compile ubcone, how to set up access to the catalog files, and how to query the catalog with ubcone.



Some practical examples with ubcone
  1. Example0: Install and test ubcone: a basic run.
  2. Example1: Magnitude data.
  3. Example2: Overplotting targets with ds9.

The size and structure of catalog files are summarized below: 

For my installation of scohome:

% pwd
/home/sco/USNO/usnob

% ls
000/  016/  032/  048/  064/  080/  096/  112/  128/  144/  160/  176/
001/  017/  033/  049/  065/  081/  097/  113/  129/  145/  161/  177/
002/  018/  034/  050/  066/  082/  098/  114/  130/  146/  162/  178/
003/  019/  035/  051/  067/  083/  099/  115/  131/  147/  163/  179/
004/  020/  036/  052/  068/  084/  100/  116/  132/  148/  164/  checksum.md5sum*
005/  021/  037/  053/  069/  085/  101/  117/  133/  149/  165/  Copyright*
006/  022/  038/  054/  070/  086/  102/  118/  134/  150/  166/  README*
007/  023/  039/  055/  071/  087/  103/  119/  135/  151/  167/  UBC.1.5a.tgz*
008/  024/  040/  056/  072/  088/  104/  120/  136/  152/  168/
009/  025/  041/  057/  073/  089/  105/  121/  137/  153/  169/
010/  026/  042/  058/  074/  090/  106/  122/  138/  154/  170/
011/  027/  043/  059/  075/  091/  107/  123/  139/  155/  171/
012/  028/  044/  060/  076/  092/  108/  124/  140/  156/  172/
013/  029/  045/  061/  077/  093/  109/  125/  141/  157/  173/
014/  030/  046/  062/  078/  094/  110/  126/  142/  158/  174/
015/  031/  047/  063/  079/  095/  111/  127/  143/  159/  175/

The ubcone code is in UBC.1.5a.tgz. I also keep a copy of this tar file 
in my general c-code directory: 

% cd $codes/ubcone_with_tests/
% ls
Note_to_HETguys.Dec06_2011  README  README.54_ubcone  SAVE/  Tests/

The notes in "ubcone_with_tests" are fairly detailed and written in a historical context. I summarize here much of what these ASCII note files contain.



Compile and install ubcone.

The ubcone code allows one to easily query USNOB1.0. 

 
% cd $supbin
% mkdir install_ubcone_apr2014
% cd install_ubcone_apr2014
% cp $codes/c/ubcone_with_tests/SAVE/UBC.1.5b.tgz .
% tar xvzf UBC.1.5b.tgz
% cd UBCone1.5b
---> Note: May have to remove old Makefile sym link!
% ln -s Makefile.ubcone.linux Makefile
% make clean
% make all
---> All sorts of messages for a few seconds 

To install for general use:
% cp ubcone.1.5b $supbin/ubcone
% rehash
% cd 
% which ubcone
/home/sco/sco/bin/binc/support/ubcone


Run a test of ubcone.

The ubcone code allows one the easily query USNOB1.0. 

 
The environmental variable USNOBDIR must be set somewhere 
in the .cshrc file with something like: 
# Define path to USNO catalog
setenv USNOBDIR /home/sco/USNO/usnob

When this has been done, and the .cshrc has been sourced:
% echo $USNOBDIR
/home/sco/USNO/usnob

Run the test 

% cd $codes/c/ubcone_with_tests/Tests
% cp -r test1 test1_copy_2               (Use whatever name you want) 
% cd test1_copy_2

% ./RUN_TEST1

----> A lot of stuff whizzes by, but if the diff message 
      at the end indicates no difference with the old 
      test file (called "Tmp_usnob.asc_Dec06_2011"), as 
      id the case below, THEN THE TEST IS A SUCCESS!

.
.
.
ubc_eatit: Nchunks = 1 NRecs = 84698 
rdusnobc: ubnpts = 34 zone = 1700
rdusnobc: extraction done (npts = 34)
Found 174647 34 Entries
before ascii write 27Apr2014-13:26:01.628303
cat_sort - col2sort = 0(0x0) gzf = 0(0x0)
after all 27Apr2014-13:26:01.628727
  
 
The new test file (Tmp_usnob.asc) is constructed
   
Here is the diff with the standard: Tmp_usnob.asc_Dec06_2011


Examples of ubcone queries.

A good discussion of running ubcone is given here in Steve Levine's Manual.



Back to SCO CODES page