net.cds
Class Vizier

java.lang.Object
  extended by net.cds.CDSParser
      extended by net.cds.Vizier

public class Vizier
extends CDSParser

This class uses the catalogue-retrieval capabilities of the VizeR database via a network-access to the AXIS services provides by CDS. For this class to run, one needs the AXIS-jar extensions, at least the axis.jar, jaxrpc.jar, saaj.jar, commons-logging.jar, commons-discovery.jar, wsdl4j.jar. Additionally, an access package must be created, in this case by issuing the command: java org.apache.axis.wsdl.WSDL2Java http://cdsws.u-strasbg.fr/axis/services/VizieR?wsdl. Additional info is available at CDS.

A typicla output looks like this:

 
 
  
    VizieR Astronomical Server: vizier.u-strasbg.fr     2004-09-23T12:29:15
    Explanations and Statistics of UCDs:                        See LINK below
    In case of problem, please report to:       question@simbad.u-strasbg.fr
  
 
 
 
   
 
 
 
 
 
 
   1 catalogues with potential matches were examined
 
 
 
 
   UCAC2 Catalogue (Zacharias+ 2003)
   
   The Second U.S. Naval Observatory CCD Astrograph Catalog
       [00000001,48330571] UCAC designation (1)
       
     
       Right ascension (degrees), ICRS, Ep=J2000 (2)
     
       Declination (degrees), ICRS, Ep=J2000 (2)
     
       Minimal mean error on RAdeg (3)
     
       Minimal mean error on DEdeg (3)
     
       Magnitude in UCAC system (579-642nm) (5)
     
       Number of UCAC observations for the star
     
       Number of catalog positions used for pmRA, pmDE
     
       Proper motion in RA(*cos(Dec)) (7)
     
       Proper motion in Dec
     
       2MASS (II/246) Unique source identifier
       
     
       ? J magnitude (1.2um) from 2MASS
     
       ? K magnitude (2.2um) from 2MASS
           
 
42519943004.4063798+30.9222120597715.97321.2-3.493636153914.52214.125
42519948004.4164998+30.9472417283712.5182-16.4-2.593636158211.38810.938
42519955004.4315727+30.8866375222113.43824.3-6.993636146812.45012.037
42519966004.4720792+30.9852728293416.0732-2.3-5.993636165814.28513.655
42519969004.4833598+30.8836067365015.14325.4-7.593636146113.64713.012
42519970004.4855871+30.9598645634815.01328.10.913790765313.69013.057
42519971004.4857492+30.8284062261512.5083-19.3-17.813790744511.55411.186
42519972004.4888100+30.9818275431515.12320.7-19.513790768913.90913.420
42519980004.5191324+30.9576320554115.1732-8.73.313790765014.10813.841
42519983004.5249736+30.9117320354715.02324.8-16.613790757613.76713.269
42519985004.5407618+30.8335375364715.03322.0-10.513790745513.82413.380
42519986004.5443833+30.7970012161913.20824.0-7.013790739612.26811.948
42519989004.5571065+30.9682989152713.39823.3-2.313790767312.32511.863
42519990004.5601650+30.8166845545215.6032-11.3-14.313790742814.22113.679
42519992004.5718380+30.8267864222813.66723.1-4.113790744412.65612.307
42519996004.5801356+30.9249003272813.738219.8-25.413790760112.07311.421
42519998004.5870474+30.9561439788.7059145.9-172.61379076467.0156.387
42519999004.5892424+30.8352198262313.857219.15.513790745912.54512.069
42520000004.5999777+30.8258242303414.32621.5-1.913790744212.96112.481
42520002004.6034053+30.7914417192314.40525.20.613790738813.08212.596
42520005004.6123386+30.8990762735015.70322.5-17.313790755314.17213.704
42520006004.6158406+30.9418328315214.5252-1.6-10.813790762213.31712.897
42520007004.6178659+30.9895684415015.5742-16.4-17.213790770413.70112.977
42520008004.6190615+30.8503328905816.0432-2.1-5.413790748214.50214.078
42520010004.6274539+30.8158300274814.86327.02.213792554513.41012.845
42520012004.6287106+30.96334141046216.19222.8-1.013792525414.76514.439
42520013004.6299745+30.9207692222915.7032-1.8-1.913792534414.29313.968
42520014004.6421874+30.9243462154215.7332-5.6-6.113792533714.39713.869
42520016004.6465395+30.8786295162715.5932-10.21.113792542214.35514.004
42520017004.6537727+30.8107053502515.4732-4.1-3.813792555214.17213.729
42520019004.6675898+30.8899809701916.1932-3.86.713792539514.52714.029
42520020004.6782086+30.8203162678.48688.0-4.31379255296.7756.230
42520021004.6893606+30.9220270484415.09426.7-5.513792534013.98113.554
42520025004.7049548+30.9756870285414.9652-0.2-9.013792522813.86013.406
42520026004.7106295+30.8290217453015.04427.21.413792550713.79513.365
42520032004.7366433+30.9451381602016.1142-0.2-4.513792528414.59414.208
42520034004.7493589+30.8837612442015.82222.5-2.913792541014.37814.031
42520039004.7638383+30.9426017662114.77328.52.013792899813.77513.368
42520040004.7681939+30.9141628344914.8842-0.2-2.513792895413.51712.873
42520044004.7760892+30.96114591185116.622221.3-21.413792902413.96713.147
42693983004.4040730+31.0105784153216.30221.6-10.493636172915.05114.615
42693988004.4068036+31.0183664151515.2422-7.1-8.993636174514.07213.606
42693997004.4471459+31.0621970153414.8422-0.3-8.493636184513.78513.403
42694003004.4600309+31.0429812325914.863215.6-2.193636180013.49613.034
42694017004.5448695+31.0126300404015.85424.5-3.713790774114.41013.912
42694021004.5520650+31.0037309491516.3632-8.2-8.213790772714.57513.998
42694024004.5632068+31.0615075375713.8742-5.2-10.513790782112.25211.588
42694025004.5681021+31.0611939155313.8042-2.5-11.113790781912.98312.659
42694034004.5883589+31.0730639869215.0422-2.6-0.513790784213.95113.505
42694037004.5973112+31.1209370205712.5942-3.8-20.313790791211.14110.498
42694039004.5978718+31.0909395365414.383214.4-9.913790787213.20612.752
42694040004.6022018+31.0335112151515.5722-7.30.613790777214.39414.000
42694042004.6118256+31.1055725206214.074210.4-13.413790789312.30111.542
42694043004.6120848+31.0949381196016.4922-3.30.413790788114.86114.214
42694046004.6434974+31.0353575947216.0422-2.1-14.013792512514.33213.837
42694052004.6570400+31.00398649510816.64229.8-11.913792518415.25714.729
42694053004.6792483+31.0672214385616.13223.61.013792505814.55314.158
42694055004.6813012+31.0817123503815.56325.1-5.613792503113.90813.329
42694064004.7021315+31.0063053272414.40826.1-13.113792517613.32012.922
42694066004.7059380+31.0269642192214.40523.5-5.413792514113.25212.889
Currently, only few parts of the data returned is actually used. Mainly the various getTables(java.lang.String) and getTableByName(java.lang.String, java.lang.String) methods are important, see there.

This software uses source code created at the Centre de Donn�es astronomiques de Strasbourg, France.


Nested Class Summary
static class Vizier.MetaData
           Titre : VizieR Client
static class Vizier.Test
          Test class.
 
Field Summary
private static VizieR_pkg.VizieRService locate
          The AXIS-enhanced VizieR service object.
private static Vizier resolve
          The reference to the only living name-resolver object.
private static VizieR_pkg.VizieR vizierquery
          The access object created from the sesam service provider.
private static double VIZIERRADIUS
          The default serach radius.
private static String VIZIERTEXT
          The default search text in the VizieR catalogs.
private static String VIZIERUNIT
          The default unit for radius queries.
 
Constructor Summary
private Vizier()
          Constructs a new VizieR catalogue.
 
Method Summary
private  boolean checkArguments(String target, double radius, String unit, String text)
          Convenience method that transfers the arguments into a argument list which is then passed to the parental CDSParser.checkCache(java.util.List) method.
static VizierTable getTableByName(String id, String ask)
          Retrieves the table that matches the given table ID.
static VizierTable getTableByName(String id, String ask, double r)
          Retrieves the table that matches the given table ID.
static VizierTable getTableByName(String id, String ask, double r, String text)
          Retrieves the table that matches the given table ID.
static VizierTable getTableByName(String id, String ask, double r, String unit, String text)
          Retrieves the table that matches the given table ID.
static List getTables(String ask)
          This method returns all tables returned from the vizier service as a List of Tables.
static List getTables(String ask, double r)
          Retrieves all tables matching the field-of-view supplied around the target.
static List getTables(String ask, double r, String text)
          Retrieves all tables matching the field-of-view supplied around the target.
static List getTables(String ask, double r, String unit, String text)
          Retrieves all tables matching the field-of-view supplied around the target.
protected  boolean isRetrievable()
          Returns true if the web-service is available.
protected  String query(List arg)
          This method is called if the cache needs to be updated.
 
Methods inherited from class net.cds.CDSParser
checkCache, getParsed
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

VIZIERRADIUS

private static final double VIZIERRADIUS
The default serach radius.

See Also:
Constant Field Values

VIZIERUNIT

private static final String VIZIERUNIT
The default unit for radius queries.

See Also:
Constant Field Values

VIZIERTEXT

private static final String VIZIERTEXT
The default search text in the VizieR catalogs.

See Also:
Constant Field Values

locate

private static VizieR_pkg.VizieRService locate
The AXIS-enhanced VizieR service object.


vizierquery

private static VizieR_pkg.VizieR vizierquery
The access object created from the sesam service provider.


resolve

private static Vizier resolve
The reference to the only living name-resolver object.

Constructor Detail

Vizier

private Vizier()
Constructs a new VizieR catalogue. The only living instance of a VizieR catalog should be constructed at class load.

Method Detail

getTables

public static List getTables(String ask)
This method returns all tables returned from the vizier service as a List of Tables. The table-id stems from the CDSConstants.TABLEID attribute, its name from CDSConstants.TABLENAME. The table description is the CDSConstants.DESCRIPTION element found in the CDSConstants.TABLE element, while the data description is the CDSConstants.DESCRIPTION element in the appropriate CDSConstants.FIELD entries. These CDSConstants.FIELD also provide two attributes, the CDSConstants.FIELDNAME which is used as the key in the table data mapping and the CDSConstants.FIELDDATATYPE which defines the Java-class to instantiate with the appropriate string value found in the DOM-table.

Parameters:
ask - The target name or position.

getTables

public static List getTables(String ask,
                             double r)
Retrieves all tables matching the field-of-view supplied around the target. The text specifies the catalogues to be queried, the wavelength is the name of the wavelength.

Parameters:
ask - The target name or position in sexagesimal notation.
r - The filed-of-view around the target.
Returns:
null, if service not available or a List of Tables.
See Also:
getTables(String)

getTables

public static List getTables(String ask,
                             double r,
                             String text)
Retrieves all tables matching the field-of-view supplied around the target. The text specifies the catalogues to be queried, the wavelength is the name of the wavelength.

Parameters:
ask - The target name or position in sexagesimal notation.
r - The filed-of-view around the target.
text - The catalog specification.
Returns:
null, if service not available or a List of Tables.
See Also:
getTables(String)

getTables

public static List getTables(String ask,
                             double r,
                             String unit,
                             String text)
Retrieves all tables matching the field-of-view supplied around the target. The text specifies the catalogues to be queried, the wavelength is the name of the wavelength.

Parameters:
ask - The target name or position in sexagesimal notation.
r - The filed-of-view around the target.
unit - The name of the unit of the radius.
text - The catalog specification.
Returns:
null, if service not available or a List of Tables.
See Also:
getTables(String)

getTableByName

public static VizierTable getTableByName(String id,
                                         String ask)
Retrieves the table that matches the given table ID. First retrieves all tables according to the VizieR query, and then checks for the table with the correct ID. Note that the unique id is checked, not the name of the table.

Parameters:
id - The unique table ID.
ask - The target name or position in sexagesimal notation.
See Also:
getTables(String)

getTableByName

public static VizierTable getTableByName(String id,
                                         String ask,
                                         double r)
Retrieves the table that matches the given table ID. First retrieves all tables according to the VizieR query, and then checks for the table with the correct ID. Note that the unique id is checked, not the name of the table.

Parameters:
id - The unique table ID.
ask - The target name or position in sexagesimal notation.
r - The filed-of-view around the target.
Returns:
null, if service not available or the table was not found.
See Also:
getTables(String)

getTableByName

public static VizierTable getTableByName(String id,
                                         String ask,
                                         double r,
                                         String text)
Retrieves the table that matches the given table ID. First retrieves all tables according to the VizieR query, and then checks for the table with the correct ID. Note that the unique id is checked, not the name of the table.

Parameters:
id - The unique table ID.
ask - The target name or position in sexagesimal notation.
r - The filed-of-view around the target.
text - The catalog specification.
Returns:
null, if service not available or the table was not found.
See Also:
getTables(String)

getTableByName

public static VizierTable getTableByName(String id,
                                         String ask,
                                         double r,
                                         String unit,
                                         String text)
Retrieves the table that matches the given table ID. First retrieves all tables according to the VizieR query, and then checks for the table with the correct ID. Note that the unique id is checked, not the name of the table.

Parameters:
id - The unique table ID.
ask - The target name or position in sexagesimal notation.
r - The filed-of-view around the target.
unit - The name of the unit of the radius.
text - The catalog specification.
wavelength - The cataloge wavelength to consider.
Returns:
null, if service not available or the table was not found.
See Also:
getTables(String)

isRetrievable

protected boolean isRetrievable()
Returns true if the web-service is available. Checks if the static reference to vizierquery is alive.

Specified by:
isRetrievable in class CDSParser

query

protected String query(List arg)
This method is called if the cache needs to be updated. The list is a five-element list consitsing of the target (name or position), the field-of-view radius, the unit of the radius as a String, the text for identifying the catalogue to retrieve, and the name of the wavelength to be considered. The result of the query, an XML-string is returned.

Specified by:
query in class CDSParser

checkArguments

private boolean checkArguments(String target,
                               double radius,
                               String unit,
                               String text)
Convenience method that transfers the arguments into a argument list which is then passed to the parental CDSParser.checkCache(java.util.List) method.