Skybot3D

Clients

You will find in this page some scripts and programs written in various languages that you can download to help you to implement the methods of the SkyBoT Web service into your own application. If you develop a client or improve the code of a client, we would be grateful to you to send it to us to share it with the community of the SkyBoT users. For that, please document your code so that it is comprehensible, and send it to us by email with all information which you will consider useful.

PHP client

The proposed PHP clients allow to invoke the methods of the Skybot3D Web service via the HTTP protocol. They are written for PHP7 and use the native PHP SOAP protocol.

Application: the scripts can be used standalone, or easily transformed into functions or classes to call the SkyBoT Web service methods from a service or a Web form.

Usage:

$> php client_<method>.php

Available methods:

  • getAster
  • getComet
  • getPlanet
  • getSso

Download:

Python client

The proposed Python3 scripts allows to invoke the methods of the Skybot3D Web service via the HTTP protocol.

Usage:

./s3d-getsso.py --help

Example: Get a set of 100 NEA>Apollo in json format:

./s3d-getsso.py -d 2021-01-01T0:0:0 -l 100 -c "NEA>Apollo" -m json -o sso_NEA-Apollo.json
cat sso_NEA-Apollo.json | python -m json.tool

Example: Get all comets in CSV format:

./s3d-getsso.py -d 2021-01-01T0:0:0 -s comet -o comets.txt
# then download the data from the link provided by the field 'fileName' of the output:
wget "https://ssp.imcce.fr/webservices/skybot3d/proxy.php?o=compressed&q=tmp/webservices/skybot3d/comet_xxx.xml.bz2 -O comet_xxx.xml.bz2"
# then transfrom the XML output in CSV:
bzcat comet_xxx.xml.bz2 | ./myxml2csv.py

Download:

C client

The proposed C clients allow to invoke the methods of the SkyBoT Web service via the HTTP+SOAP protocol. To compile the programs, you have to install the gSOAP library.

Application: the C programs are standalone and provide a simple interface to the methods of SkyBoT Web-service. They provides snippets to develop your own application using SkyBoT.

Usage:

$> ./client_<method>.sh <args>

Available methods:

  • conesearch
  • resolver
  • status

Download:

GLU file

The following files provides the description of the Skybot3D Web service for the GLU system used by the Aladin Sky Atlas to query services.

Application: the GLU file allows to query the Skybot3D Web service from a dedicated tab of the server selector of Aladin software.

Usage:

java -jar Aladin.jar -glufile="skybot3d-sso.glu"

Available methods:

  • getSso to gather all SSOs
  • getAster to gather only asteroids
  • getComet to gather only comets
  • getPlanet to gather only planets and major natural satellites

Download: