net.cds

Class Vizier

java.lang.Object

net.cds.CDSParser

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
  
 

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
42519943
004.4063798
+30.9222120
59

 77
15.97
3
2
1.2
-3.4

 936361539
14.522
14.125
 
42519948
004.4164998
+30.9472417
28

 37
12.51
8
2
-16.4
-2.5

 936361582
11.388
10.938
 
42519955
004.4315727
+30.8866375
22

 21
13.43
8
2
4.3
-6.9

 936361468
12.450
12.037
 
42519966
004.4720792
+30.9852728
29

 34
16.07
3
2
-2.3
-5.9

 936361658
14.285
13.655
 
42519969
004.4833598
+30.8836067
36

 50
15.14
3
2
5.4
-7.5

 936361461
13.647
13.012
 
42519970
004.4855871
+30.9598645
63

 48
 
15.01
3
2
8.1
0.9
137907653
 
13.690
13.057
 
42519971
004.4857492
+30.8284062
26

 15
12.50
8
3
-19.3
-17.8

 137907445
11.554
11.186
 
42519972
004.4888100
+30.9818275
43

 15
15.12
3
2
0.7
-19.5

 137907689
13.909
13.420
 
42519980
004.5191324
+30.9576320
55

 41
15.17
3
2
-8.7
3.3

 137907650
14.108
13.841
 
42519983
004.5249736
+30.9117320
35

 47
15.02
3
2
4.8
-16.6

 137907576
13.767
13.269
 
42519985
004.5407618
+30.8335375
36

 47
15.03
3
2
2.0
-10.5

 137907455
13.824
13.380
 
42519986
004.5443833
+30.7970012
16

 19
13.20
8
2
4.0
-7.0

 137907396
12.268
11.948
 
42519989
004.5571065
+30.9682989
15

 27
13.39
8
2
3.3
-2.3

 137907673
12.325
11.863
 
42519990
004.5601650
+30.8166845
54

 52
15.60
3
2
-11.3
-14.3

 137907428
14.221
13.679
 
42519992
004.5718380
+30.8267864
22

 28
13.66
7
2
3.1
-4.1

 137907444
12.656
12.307
 
42519996
004.5801356
+30.9249003
27

 28
13.73
8
2
19.8
-25.4

 137907601
12.073
11.421
 
42519998
004.5870474
+30.9561439
7
8<
 /TD>
8.70
5
9
145.9
-172.6

 137907646
7.015
6.387
 
42519999
004.5892424
+30.8352198
26

 23
13.85
7
2
19.1
5.5

 137907459
12.545
12.069
 
42520000
004.5999777
+30.8258242
30

 34
14.32
6
2
1.5
-1.9

 137907442
12.961
12.481
 
42520002
004.6034053
+30.7914417
19

 23
 
14.40
5
2
5.2
0.6
137907388
 
13.082
12.596
 
42520005
004.6123386
+30.8990762
73

 50
15.70
3
2
2.5
-17.3

 137907553
14.172
13.704
 
42520006
004.6158406
+30.9418328
31

 52
14.52
5
2
-1.6
-10.8

 137907622
13.317
12.897
 
42520007
004.6178659
+30.9895684
41

 50
15.57
4
2
-16.4
-17.2

 137907704
13.701
12.977
 
42520008
004.6190615
+30.8503328
90

 58
16.04
3
2
-2.1
-5.4

 137907482
14.502
14.078
 
42520010
004.6274539
+30.8158300
27

 48
 
14.86
3
2
7.0
2.2
137925545
 
13.410
12.845
 
42520012
004.6287106
+30.9633414
104

 62
16.19
2
2
2.8
-1.0

 137925254
14.765
14.439
 
42520013
004.6299745
+30.9207692
22

 29
15.70
3
2
-1.8
-1.9

 137925344
14.293
13.968
 
42520014
004.6421874
+30.9243462
15

 42
15.73
3
2
-5.6
-6.1

 137925337
14.397
13.869
 
42520016
004.6465395
+30.8786295
16

 27
15.59
3
2
-10.2
1.1

 137925422
14.355
14.004
 
42520017
004.6537727
+30.8107053
50

 25
15.47
3
2
-4.1
-3.8

 137925552
14.172
13.729
 
42520019
004.6675898
+30.8899809
70

 19
16.19
3
2
-3.8
6.7

 137925395
14.527
14.029
 
42520020
004.6782086
+30.8203162
6
7<
 /TD>
8.48
6
8
8.0
-4.3
137925529
6.775
6.230
 
42520021
004.6893606
+30.9220270
48

 44
15.09
4
2
6.7
-5.5

 137925340
13.981
13.554
 
42520025
004.7049548
+30.9756870
28

 54
14.96
5
2
-0.2
-9.0

 137925228
13.860
13.406
 
42520026
004.7106295
+30.8290217
45

 30
 
15.04
4
2
7.2
1.4
137925507
 
13.795
13.365
 
42520032
004.7366433
+30.9451381
60

 20
16.11
4
2
-0.2
-4.5

 137925284
14.594
14.208
 
42520034
004.7493589
+30.8837612
44

 20
15.82
2
2
2.5
-2.9

 137925410
14.378
14.031
 
42520039
004.7638383
+30.9426017
66

 21
 
14.77
3
2
8.5
2.0
137928998
 
13.775
13.368
 
42520040
004.7681939
+30.9141628
34

 49
14.88
4
2
-0.2
-2.5

 137928954
13.517
12.873
 
42520044
004.7760892
+30.9611459
118

 51
16.62
2
2
21.3
-21.4

 137929024
13.967
13.147
 
42693983
004.4040730
+31.0105784
15

 32
16.30
2
2
1.6
-10.4

 936361729
15.051
14.615
 
42693988
004.4068036
+31.0183664
15

 15
15.24
2
2
-7.1
-8.9

 936361745
14.072
13.606
 
42693997
004.4471459
+31.0621970
15

 34
14.84
2
2
-0.3
-8.4

 936361845
13.785
13.403
 
42694003
004.4600309
+31.0429812
32

 59
14.86
3
2
15.6
-2.1

 936361800
13.496
13.034
 
42694017
004.5448695
+31.0126300
40

 40
15.85
4
2
4.5
-3.7

 137907741
14.410
13.912
 
42694021
004.5520650
+31.0037309
49

 15
16.36
3
2
-8.2
-8.2

 137907727
14.575
13.998
 
42694024
004.5632068
+31.0615075
37

 57
13.87
4
2
-5.2
-10.5

 137907821
12.252
11.588
 
42694025
004.5681021
+31.0611939
15

 53
13.80
4
2
-2.5
-11.1

 137907819
12.983
12.659
 
42694034
004.5883589
+31.0730639
86

 92
15.04
2
2
-2.6
-0.5

 137907842
13.951
13.505
 
42694037
004.5973112
+31.1209370
20

 57
12.59
4
2
-3.8
-20.3

 137907912
11.141
10.498
 
42694039
004.5978718
+31.0909395
36

 54
14.38
3
2
14.4
-9.9

 137907872
13.206
12.752
 
42694040
004.6022018
+31.0335112
15

 15
15.57
2
2
-7.3
0.6

 137907772
14.394
14.000
 
42694042
004.6118256
+31.1055725
20

 62
14.07
4
2
10.4
-13.4

 137907893
12.301
11.542
 
42694043
004.6120848
+31.0949381
19

 60
16.49
2
2
-3.3
0.4

 137907881
14.861
14.214
 
42694046
004.6434974
+31.0353575
94

 72
16.04
2
2
-2.1
-14.0

 137925125
14.332
13.837
 
42694052
004.6570400
+31.0039864
95

 108
16.64
2
2
9.8
-11.9

 137925184
15.257
14.729
 
42694053
004.6792483
+31.0672214
38

 56
 
16.13
2
2
3.6
1.0
137925058
 
14.553
14.158
 
42694055
004.6813012
+31.0817123
50

 38
15.56
3
2
5.1
-5.6

 137925031
13.908
13.329
 
42694064
004.7021315
+31.0063053
27

 24
14.40
8
2
6.1
-13.1

 137925176
13.320
12.922
 
42694066
004.7059380
+31.0269642
19

 22
14.40
5
2
3.5
-5.4

 137925141
13.252
12.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

Nested Classes

Modifier and Type	Class and Description
static class	Vizier.MetaData Titre : VizieR Client
static class	Vizier.Test Test class.

Field Summary

Fields

Modifier and Type	Field and Description
private static VizieRService	locate The AXIS-enhanced VizieR service object.
private static Vizier	resolve The reference to the only living name-resolver object.
private static 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

Constructors

Modifier	Constructor and Description
private	Vizier() Constructs a new VizieR catalogue.

Method Summary

Modifier and Type	Method and Description
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<java.lang.Object>) 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 DOMHelper.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 VizieRService locate

The AXIS-enhanced VizieR service object.

vizierquery

private static 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 DOMHelper.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 DOMHelper.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 DOMHelper.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 DOMHelper.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<java.lang.Object>) method.