Miriade

clients

Solar System Object Ephemeris Generator

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 Miriade 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 Miriade 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, via the HTTP protocol, all the methods of the Miriade Web service. 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 Miriade Web service methods from a service or a Web form.

Usage:

$> php client_<method>.php

Available methods:

  • ephemcc, ephemsys
  • ephemph, psv
  • rts, vision
  • getMiriadeData
  • getAvailability

Download:

Bash client

The proposed scripts allow to invoke, via the HTTP protocol, some methods of the Miriade Web service (positional ephemerides, rts, vision). They are written in Unix shell script language (bash), and use the external data transfert command line tool wget or curl.

Application: the scripts can easily be modified into more complexe shell scripts to fit your requirements.

Usage:

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

Available methods:

  • ephemcc
  • ephemsys-get, ephemsys
  • rts, vision

Download:

Python client

To query the Miriade service in Python scripts, you can implement HTTP requests with the module http.client or requests. But you will certainly prefer to use the Astroquery affiliated package of astropy.

Usage: The most minimalistic get_ephemerides query looks like this:

>>> from astroquery.miriade import Miriade
>>> Miriade.get_ephemerides('Ceres')

More info: read the MiriadeClass documentation

Available method:

  • ephemcc

Fortran client

The proposed Fortran client allows to invoke, via the HTTP protocol, the ephemcc method (positional ephemerides) of the Miriade Web service. It is written in Fortran 2003 programming language, and requires the use of an external program of data transfert such as wget or curl.

Compilation:

$> gfortran -o client_ephemcc client_ephemcc.f90

Usage:

$> ./client_ephemcc

Available method:

  • ephemcc

Download:

Java client

This client is intended to be used as an Aladin plugin. It allows the computation of the celestial coordinates and the apparent physical aspect of the solar system objects (SSO). The results are displayed in Aladin as marks in a dedicated stack which show the position of the SSO on the celestial sphere (positional ephemeris) or as a FITS image which show the simulated aspect of the SSO as seen from the observer.

Application: Computation of the celestial coordinates and the apparent physical aspect of the solar system objects

Installation

  1. Download the plugin class or jarfile
  2. Copy it into your dedicated Aladin plugin directory
    ($HOME/.aladin/Plugins or C:\Documents and Settings\<USER>\.aladin\Plugins)
  3. Launch Aladin
  4. Open the "Plugin controller" (Menu Tool → Plugins in Aladin) and load the class/jar file
or
  1. Download the plugin class or jarfile
  2. Launch Aladin
  3. Open the "Plugin controller" (Menu Tool → Plugins in Aladin)
  4. Drag and drop the plugin class/jar file directly from your OS desktop into the Aladin plugin list

Usage: Once it is installed, open the menu
Tool → Plugins → Plugins controler → ssoEphemerisCalculator
and start it, or launch it directly from the Tool → Plugins menu.

Download: