org.minetti.astrodevice.common.orb
Interface SelectedObservingSiteOrbProcess

All Superinterfaces:

Remote

public interface SelectedObservingSiteOrbProcess
extends Remote

ORB process on selected observing site.

Author:

Jean-Philippe MINETTI

Method Summary

short	getElevation(Locale locale) Returns the elevation above mean sea level of the selected observing site.
Long	getId(Locale locale) Returns the identifier of selected observing site.
Coordinate	getLatitude(Locale locale) Returns the latitude φ of the selected observing site.
Coordinate	getLongitude(Locale locale) Returns the longitude λ of the selected observing site.
String	getName(Locale locale) Returns the name given to selected observing site.
void	select(Locale locale, long id) Selects an observing site.
TimeSynchronization	synchronizeSiderealTime(Locale locale, long clientTransmitTime) Synchronizes the local apparent sidereal time at selected observing site.
EquatorialCoordinates	toEquatorialCoordinates(Locale locale, HorizontalCoordinates horizontalCoordinates) Converts horizontal coordinates at the selected observing site in equatorial coordinates.
HorizontalCoordinates	toHorizontalCoordinates(Locale locale, EquatorialCoordinates equatorialCoordinates) Converts an equatorial coordinates in horizontal coordinates at the selected observing site.

Method Detail

select

void select(Locale locale,
            long id)
            throws RemoteException

Selects an observing site.

Parameters:

locale - Locale for select messages in the language of user.

id - Identifier of observing site.

Throws:

RemoteException - Exception if an error occurred.

getId

Long getId(Locale locale)
           throws RemoteException

Returns the identifier of selected observing site.

Parameters:

locale - Locale for select messages in the language of user.

Returns:

Identifier of selected observing site.

Throws:

RemoteException - Exception if an error occurred.

getName

String getName(Locale locale)
               throws RemoteException

Returns the name given to selected observing site.

Parameters:

locale - Locale for select messages in the language of user.

Returns:

Name given to selected observing site.

Throws:

RemoteException - Exception if an error occurred.

getLatitude

Coordinate getLatitude(Locale locale)
                       throws RemoteException

Returns the latitude φ of the selected observing site. The range of values is:

• 0 to +90° for north hemisphere,
• 0 to -90° for south hemisphere.

Parameters:

locale - Locale for select messages in the language of user.

Returns:

Latitude φ of the selected observing site in degrees (°).

Throws:

RemoteException - Exception if an error occurred.

getLongitude

Coordinate getLongitude(Locale locale)
                        throws RemoteException

Returns the longitude λ of the selected observing site. The range of values is:

• 0 to +180° for east meridians,
• 0 to -180° for west meridians.

Parameters:

locale - Locale for select messages in the language of user.

Returns:

Longitude λ of the selected observing site in degrees (°).

Throws:

RemoteException - Exception if an error occurred.

getElevation

short getElevation(Locale locale)
                   throws RemoteException

Returns the elevation above mean sea level of the selected observing site.

Parameters:

locale - Locale for select messages in the language of user.

Returns:

Elevation of the selected observing site in meters (m).

Throws:

RemoteException - Exception if an error occurred.

synchronizeSiderealTime

TimeSynchronization synchronizeSiderealTime(Locale locale,
                                            long clientTransmitTime)
                                            throws RemoteException

Synchronizes the local apparent sidereal time at selected observing site.

Parameters:

locale - Locale for select messages in the language of user.

clientTransmitTime - Transmission sidereal time of the request by the client.

Returns:

Object containing all informations used for sidereal time synchronization.

Throws:

RemoteException - Exception if an error occurred.

toHorizontalCoordinates

HorizontalCoordinates toHorizontalCoordinates(Locale locale,
                                              EquatorialCoordinates equatorialCoordinates)
                                              throws RemoteException

Converts an equatorial coordinates in horizontal coordinates at the selected observing site.

Parameters:

locale - Locale for select messages in the language of user.

equatorialCoordinates - Equatorial coordinates to convert.

Returns:

Horizontal coordinates on the selected observing site.

Throws:

RemoteException - Exception if an error occurred.

toEquatorialCoordinates

EquatorialCoordinates toEquatorialCoordinates(Locale locale,
                                              HorizontalCoordinates horizontalCoordinates)
                                              throws RemoteException

Converts horizontal coordinates at the selected observing site in equatorial coordinates.

Parameters:

locale - Locale for select messages in the language of user.

horizontalCoordinates - Horizontal coordinates at the selected observing site.

Returns:

Equatorial coordinates.

Throws:

RemoteException - Exception if an error occurred.