Computes the topocentric place of a planet, given the location of the observer.

Namespace: ASCOM.Astrometry.NOVAS
Assembly: ASCOM.Astrometry (in ASCOM.Astrometry.dll) Version: 6.0.0.0 (6.1.1.2619)

Syntax

C#
public static short TopoPlanet(
	double tjd,
	ref BodyDescription ss_object,
	ref BodyDescription earth,
	double deltat,
	ref SiteInfo location,
	ref double ra,
	ref double dec,
	ref double dis
)
Visual Basic
Public Shared Function TopoPlanet ( _
	tjd As Double, _
	ByRef ss_object As BodyDescription, _
	ByRef earth As BodyDescription, _
	deltat As Double, _
	ByRef location As SiteInfo, _
	ByRef ra As Double, _
	ByRef dec As Double, _
	ByRef dis As Double _
) As Short
Visual C++
public:
static short TopoPlanet(
	double tjd, 
	BodyDescription% ss_object, 
	BodyDescription% earth, 
	double deltat, 
	SiteInfo% location, 
	double% ra, 
	double% dec, 
	double% dis
)

Parameters

tjd
Type: System..::..Double
TT (or TDT) Julian date for topocentric place.
ss_object
Type: ASCOM.Astrometry..::..BodyDescription%
structure containing the body designation for the solar system body
earth
Type: ASCOM.Astrometry..::..BodyDescription%
structure containing the body designation for the Earth
deltat
Type: System..::..Double
Difference TT(or TDT)-UT1 at 'tjd', in seconds.
location
Type: ASCOM.Astrometry..::..SiteInfo%
structure containing observer's location
ra
Type: System..::..Double%
OUT: Apparent right ascension in hours, referred to true equator and equinox of date 'tjd'.
dec
Type: System..::..Double%
OUT: Apparent declination in degrees, referred to true equator and equinox of date 'tjd'.
dis
Type: System..::..Double%
OUT: True distance from Earth to planet at 'tjd' in AU.

Return Value

  0...Everything OK.
 >0...See error description in function 'ephemeris'.
 

Remarks

Note: This function only supports Earth, which is a consequence of the implementation used. Please use the NOVAS3.1 or later classes in applications that require planetary or moon ephemeredes as these classes can access the JPL 421 planetary ephemeris data provided as part of the ASCOM distribution.

See Also