Developer’s corner

The VizieR Catalogues XML Web Service. How to consume it in Java ?

This XML Web Service gives an access to VizieR Catalogues.

XML Web Service URL at CDS : http://cdsws.u-strasbg.fr/axis/services/VizieR

                  a second server is available at CDS : http://cdsws2.u-strasbg.fr
                  

Available methods : . metaAll() Parameter(s) : none

Result : all metadata about catalogues in VizieR (VOTable format)

Get the SOAP result for metaAll request

. cataloguesData(String target, double radius, String unit, String text)

Parameter(s) :

  • target (example : M31)
  • radius (example : 1.0)
  • unit (example : arcmin)
  • text (author, …, example : Ochsenbein)

Result : data about catalogues depending on the given parameters (VOTable format)

Get the SOAP result for target=m31 radius=1.0 unit=arcmin text=Dixon

. cataloguesData(String target, double radius, String unit, String text, String wavelength)

Parameter(s) :

  • target (example : M31)
  • radius (example : 1.0)
  • unit (example : arcmin)
  • text (author, …, example : Ochsenbein)
  • wavelength (example : optical, Radio, like in the VizieR Web interface)

Result : data about catalogues depending on the given parameters (VOTable format)

Get the SOAP result for target=m31 radius=1.0 unit=arcmin text=Dixon wavelength=Radio

. cataloguesMetaData(String target, double radius, String unit, String text)

Parameter(s) :

  • target (example : M31)
  • radius (example : 1.0)
  • unit (example : arcmin)
  • text (author, …, example : Ochsenbein)

Result : metadata about catalogues depending on the given parameters (VOTable format)

Get the SOAP result for target=m31 radius=1.0 unit=arcmin text=Dixon

. cataloguesMetaData(String target, double radius, String unit, String text, String wavelength)

Parameter(s) :

  • target (example : M31)
  • radius (example : 1.0)
  • unit (example : arcmin)
  • text (author, …, example : Ochsenbein)
  • wavelength (example : optical, Radio, like in the VizieR Web interface)

Result : metadata about catalogues depending on the given parameters (VOTable format)

Get the SOAP result for target=m31 radius=1.0 unit=arcmin text=Dixon wavelength=Radio

.getAvailability()

Parameter(s) : none

Result : returns an XML file conform to the “availability 0.2” schema (IVOA Support Interfaces and Basic Profile)

In the following example(s) the user has not to manipulate the SOAP code…

Example for target = M31, radius = 10.0, unit = arcmin, text = Dixon (cataloguesData(“M31”, 10.0, “arcmin”, “Dixon”)) :

Query :

<?xml version="1.0" encoding="UTF-8" standalone="no"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="urn:VizieR" xmlns:intf="urn:VizieR" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
<SOAP-ENV:Body>
<mns:cataloguesMetaData xmlns:mns="urn:VizieR" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<target xsi:type="xsd:string">M31</target>
<radius xsi:type="xsd:double">10.0</radius>
<unit xsi:type="xsd:string">arcmin</unit>
<text xsi:type="xsd:string">Dixon</text>
</mns:cataloguesMetaData>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Result :

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
 <ns1:cataloguesMetaDataResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:VizieR">
 <return xsi:type="xsd:string"><?xml version="1.0" encoding="UTF-8"?>
<VOTABLE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:noNamespaceSchemaLocation="http://vizier.u-strasbg.fr/xml/VOTable.xsd">
 <DESCRIPTION>
 VizieR Astronomical Server: vizier.u-strasbg.fr 2003-11-18T10:50:22
 Explanations and Statistics of UCDs: See LINK below
 In case of problem, please report to: question@simbad.u-strasbg.fr
 </DESCRIPTION>
<!-- VOTable description at http://vizier.u-strasbg.fr/doc/VOTable/ -->

<DEFINITIONS>
 <COOSYS ID="J2000" system="eq_FK5" equinox="J2000"/>
</DEFINITIONS>


<!-- Parameters used for the Query:
 -c=M31
 -c.r=10.0
 -c.u=arcmin
 -words=Dixon
 -->
<INFO ID="Ref" name="-ref" value="VOTx28581" />
<INFO ID="CatalogsExamined" value="1">
 1 catalogues with potential matches were examined
</INFO>
<INFO ID="Target" name="-c" value="010.684625+41.269278,rm=10."/>

<RESOURCE ID="yCat_7002" name="VII/2A">
 <DESCRIPTION>Master list of radio sources, updated 1978 (Dixon, 1970)</DESCRIPTION>
 <COOSYS ID="B1950" system="eq_FK4" equinox="J1950"/>
 <TABLE ID="VII_2A_master" name="VII/2A/master">
 <DESCRIPTION>The Master List</DESCRIPTION>
 <!-- MatchedRows: 999 (upper limit) -->
 <!-- Now comes the definition of each field -->
 <FIELD name="recno" ucd="RECORD" datatype="int" width="8" type="hidden">
 <DESCRIPTION>Record number within the original table (starting from 1)</DESCRIPTION>
 <LINK href="http://vizier.u-strasbg.fr/cgi-bin/VizieR-5?-info=XML&amp;-out.add=.&amp;-source=VII/2A/master&amp;recno=${recno}"/>
 </FIELD>
 <FIELD name="Name" ucd="ID_MAIN" datatype="char" arraysize="13*">
 <DESCRIPTION>Name of the object as assigned by the original author (1)</DESCRIPTION>
 <LINK href="http://vizier.u-strasbg.fr/cgi-bin/VizieR-5?-info=XML&amp;-out.add=.&amp;-source=VII/2A/master&amp;recno=${recno}"/>
 </FIELD>
 <FIELD name="RA1950" ucd="POS_EQ_RA_MAIN" ref="B1950" datatype="char" arraysize="12" unit="&quot;h:m:s&quot;">
 <DESCRIPTION>Right Ascension 1950 (hours)</DESCRIPTION>
 </FIELD>
 <FIELD name="DE1950" ucd="POS_EQ_DEC_MAIN" ref="B1950" datatype="char" arraysize="13" unit="&quot;d:m:s&quot;">
 <DESCRIPTION>Declination 1950 (sign)</DESCRIPTION>
 </FIELD>
 <FIELD name="Epoch" ucd="TIME_EPOCH" datatype="float" width="6" precision="1" unit="yr">
 <DESCRIPTION>[1950.0]?</DESCRIPTION>
 </FIELD>
 <FIELD name="Freq" ucd="OBS_FREQUENCY" datatype="int" width="5" unit="MHz">
 <DESCRIPTION>? Frequency (2)</DESCRIPTION>
 </FIELD>
 <FIELD name="l_S" ucd="CODE_LIMIT" datatype="char">
 <DESCRIPTION>[LG] Limit flag on S: L = less than (&lt;), G = greater than (&gt;)</DESCRIPTION>
 </FIELD>
<DATA><TABLEDATA>
<TR><TD>2514</TD><TD>WE 0039+40W2</TD><TD>00 39 37.670</TD><TD>+40 51 31.900</TD><TD>1950.0</TD><TD>1415</TD><TD> </TD></TR>
<TR><TD>2526</TD><TD>OB+467</TD><TD>00 39 51.000</TD><TD>+41 03 00.000</TD><TD>1950.0</TD><TD>1415</TD><TD> </TD></TR>
<TR><TD>2530</TD><TD>OA035.3</TD><TD>00 39 54.000</TD><TD>+41 02 00.000</TD><TD>1950.0</TD><TD>1415</TD><TD> </TD></TR>
<TR><TD>2545</TD><TD>W02</TD><TD>00 40 00.000</TD><TD>+41 00 00.000</TD><TD>1950.0</TD><TD>1390</TD><TD> </TD></TR>
<TR><TD>2546</TD><TD>DA021</TD><TD>00 40 00.000</TD><TD>+41 00 00.000</TD><TD>1950.0</TD><TD>1420</TD><TD> </TD></TR>
<TR><TD>2548</TD><TD>DGVW004</TD><TD>00 40 00.000</TD><TD>+41 00 00.000</TD><TD>1950.0</TD><TD>400</TD><TD> </TD></TR>
<TR><TD>2551</TD><TD>5C3.110</TD><TD>00 40 01.800</TD><TD>+40 59 46.000</TD><TD>1950.0</TD><TD>408</TD><TD> </TD></TR>
<TR><TD>2552</TD><TD> DITTO</TD><TD>00 40 01.800</TD><TD>+40 59 46.000</TD><TD>1950.0</TD><TD>1407</TD><TD> </TD></TR>
<TR><TD>2606</TD><TD>5C3.116</TD><TD>00 40 33.700</TD><TD>+41 01 04.000</TD><TD>1950.0</TD><TD>408</TD><TD> </TD></TR>
<TR><TD>2607</TD><TD>WE 0040+41W2</TD><TD>00 40 33.710</TD><TD>+41 00 58.400</TD><TD>1950.0</TD><TD>1415</TD><TD> </TD></TR>
</TABLEDATA>
</DATA>
 </TABLE>

<INFO name="Error" value="++++meta_init: connection to ReferenceDirectory already done"/>
</RESOURCE>
</VOTABLE>
</return>
 </ns1:cataloguesMetaDataResponse>
 </soapenv:Body>
</soapenv:Envelope>
viziercatalogues.txt · Last modified: 2011/11/28 10:02 by administrator

Thanks for acknowledging the CDS developer’s resources (libraries, source code, etc.)

© UDS/CNRS

Contact