public class NOVAS
extends java.lang.Object
Underlying JNI code and documentation is based on
Naval Observatory Vector Astrometry Software (NOVAS), C Edition, Version 3.1Ephemerides file is based onU. S. Naval Observatory
Astronomical Applications Dept.
Washington, DC
http://www.usno.navy.mil/USNO/astronomical-applications
JPL planetary and lunar ephemeris DE421William Folkner
JPL m/s 301-150; Pasadena, CA 91109
TEL: 818-354-0443
FAX: 818-393-7631
e-mail: William.Folkner@jpl.nasa.gov
Modifier and Type | Class and Description |
---|---|
static class |
NOVAS.CatalogEntry
Wrapper for "struct cat_entry".
|
static class |
NOVAS.CelestialObject
Wrapper for "struct object".
|
static class |
NOVAS.DoubleRef
Wrapper for output parameters.
|
static class |
NOVAS.Observer
Wrapper for "struct observer".
|
static class |
NOVAS.PositionInSpace
Wrapper for "struct in_space".
|
static class |
NOVAS.PositionOnSurface
Wrapper for "struct on_surface".
|
static class |
NOVAS.SkyPosition
Wrapper for "struct sky_pos".
|
Modifier and Type | Field and Description |
---|---|
static int |
EPH_DE_NO
JPL Planetary and Lunar Ephemerides file number (421 for DE421).
|
static double |
EPH_JD_BEGIN
JPL Ephemerides file start date.
|
static double |
EPH_JD_END
JPL Ephemerides file end date.
|
Constructor and Description |
---|
NOVAS() |
Modifier and Type | Method and Description |
---|---|
static short |
appPlanet(double ttDate,
NOVAS.CelestialObject body,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec,
NOVAS.DoubleRef distance)
Compute the apparent place of a solar system body.
|
static short |
appStar(double ttDate,
NOVAS.CatalogEntry star,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec)
Compute the apparent place of a star at date
ttDate , given its
catalog mean place, proper motion, parallax, and radial velocity. |
static short |
astroPlanet(double ttDate,
NOVAS.CelestialObject body,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec,
NOVAS.DoubleRef distance)
Compute the astrometric place of a solar system body.
|
static short |
astroStar(double ttDate,
NOVAS.CatalogEntry star,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec)
Compute the astrometric place of a star at date
ttDate , given
its catalog mean place, proper motion, parallax, and radial velocity. |
static void |
equatorialToHorizontal(double ut1Date,
double deltaT,
int accuracy,
double xp,
double yp,
NOVAS.PositionOnSurface position,
double ra,
double dec,
int refOption,
NOVAS.DoubleRef zd,
NOVAS.DoubleRef ad,
NOVAS.DoubleRef rar,
NOVAS.DoubleRef decr)
Transform topocentric right ascension and declination to zenith distance
and azimuth.
|
static short |
localPlanet(double ttDate,
NOVAS.CelestialObject body,
double deltaT,
NOVAS.PositionOnSurface position,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec,
NOVAS.DoubleRef distance)
Compute the local place of a solar system body.
|
static short |
localStar(double ttDate,
double deltaT,
NOVAS.CatalogEntry star,
NOVAS.PositionOnSurface position,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec)
Compute the local place of a star at date
ttDate , given its
catalog mean place, proper motion, parallax, and radial velocity. |
static short |
place(double ttDate,
NOVAS.CelestialObject object,
NOVAS.Observer location,
double deltaT,
int coordinateSystem,
int accuracy,
NOVAS.SkyPosition output)
Compute the apparent direction of a star or solar system body at a
specified time and in a specified coordinate system.
|
static short |
siderealTime(double ttDate,
double deltaT,
int gstType,
int method,
int accuracy,
NOVAS.DoubleRef gst)
Computes the Greenwich sidereal time, either mean or apparent, at Julian
date.
|
static short |
topoPlanet(double ttDate,
NOVAS.CelestialObject body,
double deltaT,
NOVAS.PositionOnSurface position,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec,
NOVAS.DoubleRef distance)
Compute the topocentric place of a solar system body.
|
static short |
topoStar(double ttDate,
double deltaT,
NOVAS.CatalogEntry star,
NOVAS.PositionOnSurface position,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec)
Compute the topocentric place of a star at date
ttDate , given
its catalog mean place, proper motion, parallax, and radial velocity. |
static short |
transformCatalogEntry(int option,
double inDate,
NOVAS.CatalogEntry inEntry,
double outDate,
java.lang.String outCatalog,
NOVAS.CatalogEntry OutEntry)
Transform a star's catalog quantities for a change of epoch and/or equator
and equinox.
|
static void |
transformHipparcosEntry(NOVAS.CatalogEntry hipparcos,
NOVAS.CatalogEntry hip2000)
Convert Hipparcos catalog data at epoch J1991.25 to epoch J2000.0, for use
within NOVAS.
|
static short |
virtualPlanet(double ttDate,
NOVAS.CelestialObject body,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec,
NOVAS.DoubleRef distance)
Compute the virtual place of a solar system body.
|
static short |
virtualStar(double ttDate,
NOVAS.CatalogEntry star,
int accuracy,
NOVAS.DoubleRef ra,
NOVAS.DoubleRef dec)
Compute the virtual place of a star at date
ttDate , given its
catalog mean place, proper motion, parallax, and radial velocity. |
public static int EPH_DE_NO
public static double EPH_JD_BEGIN
public static double EPH_JD_END
public static short place(double ttDate, NOVAS.CelestialObject object, NOVAS.Observer location, double deltaT, int coordinateSystem, int accuracy, NOVAS.SkyPosition output)
Wrapper for place() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-48.
ttDate
- TT Julian date for place.object
- the celestial object of interestlocation
- the location of the observerdeltaT
- difference TT-UT1 at ttDate
in seconds of timecoordinateSystem
- code specifying coordinate system of the output position:
0 → GCRS or "local GCRS"
1 → true equator and equinox of date
2 → true equator and CIO of date
3 → astrometric coordinates, i.e., without light deflection or aberration)
accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
output
- output data specifying object's place on the sky at
ttDate
, with respect to the specified output
coordinate system0 → no problems
1 → invalid value of 'coord_sys'
2 → invalid value of 'accuracy'
3 → Earth is the observed object, and the observer is either at the geocenter or on the Earth's surface (not permitted)
> 10, < 40 → 10 + error from function 'ephemeris'
> 40, < 50 → 40 + error from function 'geo_posvel'
> 50, < 70 → 50 + error from function 'light_time'
> 70, < 80 → 70 + error from function 'grav_def'
> 80, < 90 → 80 + error from function 'cio_location'
> 90, < 100 → 90 + error from function 'cio_basis'
public static short transformCatalogEntry(int option, double inDate, NOVAS.CatalogEntry inEntry, double outDate, java.lang.String outCatalog, NOVAS.CatalogEntry OutEntry)
Wrapper for tansform_cat() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-57.
option
- Transformation option: 1 → change epoch; same equator and equinox
2 → change equator and equinox; same epoch
3 → change equator and equinox and epoch
4 → change equator and equinox J2000.0 to ICRS
5 → change ICRS to equator and equinox of J2000.0
inDate
- TT Julian date, or year, of input catalog data.inEntry
- an entry from the input catalog, with units as given in the class
definition.outDate
- TT Julian date, or year, of transformed catalog data.outCatalog
- Catalog identifier (e.g. HIP = Hipparcos, TY2 = Tycho-2).OutEntry
- The transformed catalog entry, with units as given in the class
definition0 → no problems
1 → Invalid value of an input date for option 2 or 3
2 → length of 'newcat_id' out of bounds
public static void transformHipparcosEntry(NOVAS.CatalogEntry hipparcos, NOVAS.CatalogEntry hip2000)
Wrapper for transform_hip() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-59.
hipparcos
- an entry from the Hipparcos catalog, at epoch J1991.25, with all
members having Hipparcos catalog units. Epoch: J1991.25
Right ascension (RA): degrees
Declination (Dec): degrees
Proper motion in RA: milliarcseconds per year
Proper motion in Dec: milliarcseconds per year
Parallax: milliarcseconds
Radial velocity: kilometers per second (not in catalog)
hip2000
- the transformed input entry, at epoch J2000.0. Epoch: J2000.0
Right ascension: hours
Declination: degrees
Proper motion in RA: milliarcseconds per year
Proper motion in Dec: milliarcseconds per year
Parallax: milliarcseconds
Radial velocity: kilometers per second
public static short appStar(double ttDate, NOVAS.CatalogEntry star, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec)
ttDate
, given its
catalog mean place, proper motion, parallax, and radial velocity.
Wrapper for app_start() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-61.
ttDate
- TT Julian date for apparent place.star
- catalog data for the object in the ICRS.accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Apparent right ascension in hours, referred to true equator and
equinox of date ttDate
.dec
- Apparent declination in degrees, referred to true equator and
equinox of date ttDate
.0 → no problems
> 10 → Error code from function 'make_object'.
> 20 → Error code from function 'place'.
public static short virtualStar(double ttDate, NOVAS.CatalogEntry star, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec)
ttDate
, given its
catalog mean place, proper motion, parallax, and radial velocity.
Wrapper for virtual_star() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-64.
ttDate
- TT Julian date for apparent place.star
- catalog data for the object in the ICRS.accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Virtual right ascension in hours, referred to the GCRS.dec
- Virtual declination in degrees, referred to the GCRS.0 → no problems
> 10 → Error code from function 'make_object'.
> 20 → Error code from function 'place'.
public static short astroStar(double ttDate, NOVAS.CatalogEntry star, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec)
ttDate
, given
its catalog mean place, proper motion, parallax, and radial velocity.
Wrapper for astro_star() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-66.
ttDate
- TT Julian date for astrometric place.star
- catalog data for the object in the ICRS.accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Astrometric right ascension in hours (referred to the ICRS,
without light deflection or aberration).dec
- Astrometric declination in degrees (referred to the ICRS, without
light deflection or aberration).0 → no problems
> 10 → Error code from function 'make_object'.
> 20 → Error code from function 'place'.
public static short localStar(double ttDate, double deltaT, NOVAS.CatalogEntry star, NOVAS.PositionOnSurface position, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec)
ttDate
, given its
catalog mean place, proper motion, parallax, and radial velocity.
Wrapper for local_star() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-65.
ttDate
- TT Julian date for local place.deltaT
- Difference TT-UT1 at ttDate
, in seconds of time.star
- catalog data for the object in the ICRS.position
- the position of the observeraccuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Local right ascension in hours, referred to the 'local GCRS'.dec
- Local declination in degrees, referred to the 'local GCRS'.0 → no problems
1 → Invalid value of 'where' in structure 'position'.
> 10 → Error code from function 'make_object'.
> 20 → Error code from function 'place'.
public static short topoStar(double ttDate, double deltaT, NOVAS.CatalogEntry star, NOVAS.PositionOnSurface position, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec)
ttDate
, given
its catalog mean place, proper motion, parallax, and radial velocity.
Wrapper for topo_star() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-62.
ttDate
- TT Julian date for topocentric place.deltaT
- Difference TT-UT1 at ttDate
, in seconds of time.star
- catalog data for the object in the ICRS.position
- the position of the observeraccuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Topocentric right ascension in hours, referred to true equator and
equinox of date ttDate
.dec
- Topocentric declination in degrees, referred to true equator and
equinox of date ttDate
.0 → no problems
1 → Invalid value of 'where' in structure 'position'.
> 10 → Error code from function 'make_object'.
> 20 → Error code from function 'place'.
public static short appPlanet(double ttDate, NOVAS.CelestialObject body, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec, NOVAS.DoubleRef distance)
Wrapper for app_planet() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-67.
ttDate
- TT Julian date for topocentric place.body
- structure containing the body designation for the solar system
body.accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Apparent right ascension in hours, referred to true equator and
equinox of date.dec
- Apparent declination in degrees, referred to true equator and
equinox of date.distance
- True distance from Earth to the body at ttDate
in AU.0 → no problems
1 → Invalid value of 'type' in structure 'body'.
> 10 → Error code from function 'place'.
public static short virtualPlanet(double ttDate, NOVAS.CelestialObject body, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec, NOVAS.DoubleRef distance)
Wrapper for virtual_planet() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-70.
ttDate
- TT Julian date for virtual place.body
- structure containing the body designation for the solar system
body.accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Virtual right ascension in hours, referred to the GCRS.dec
- Virtual declination in degrees, referred to the GCRS.distance
- True distance from Earth to the body in AU.0 → no problems
1 → Invalid value of 'type' in structure 'body'.
> 10 → Error code from function 'place'.
public static short astroPlanet(double ttDate, NOVAS.CelestialObject body, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec, NOVAS.DoubleRef distance)
Wrapper for astro_planet() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-73.
ttDate
- TT Julian date for astrometric place.body
- structure containing the body designation for the solar system
body.accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Astrometric right ascension in hours (referred to the ICRS,
without light deflection or aberration).dec
- Astrometric declination in degrees (referred to the ICRS, without
light deflection or aberration).distance
- True distance from Earth to the body in AU.0 → no problems
1 → Invalid value of 'type' in structure 'body'.
> 10 → Error code from function 'place'.
public static short localPlanet(double ttDate, NOVAS.CelestialObject body, double deltaT, NOVAS.PositionOnSurface position, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec, NOVAS.DoubleRef distance)
Wrapper for local_planet() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-71.
ttDate
- TT Julian date for local place.body
- structure containing the body designation for the solar system
body.deltaT
- Difference TT-UT1 at ttDate
, in seconds of time.position
- the position of the observeraccuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Local right ascension in hours, referred to the 'local GCRS'.dec
- Local declination in degrees, referred to the 'local GCRS'.distance
- True distance from Earth to the body in AU.0 → no problems
1 → Invalid value of 'where' in structure 'position'.
> 10 → Error code from function 'place'.
public static short topoPlanet(double ttDate, NOVAS.CelestialObject body, double deltaT, NOVAS.PositionOnSurface position, int accuracy, NOVAS.DoubleRef ra, NOVAS.DoubleRef dec, NOVAS.DoubleRef distance)
Wrapper for topu_planet() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-68.
ttDate
- TT Julian date for topocentric place.body
- structure containing the body designation for the solar system
body.deltaT
- Difference TT-UT1 at ttDate
, in seconds of time.position
- the position of the observeraccuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
ra
- Topocentric right ascension in hours, referred to true equator and
equinox of date.dec
- Topocentric declination in degrees, referred to true equator and
equinox of date.distance
- True distance from Earth to the body at ttDate
in AU.0 → no problems
1 → Invalid value of 'where' in structure 'position'.
> 10 → Error code from function 'place'.
public static void equatorialToHorizontal(double ut1Date, double deltaT, int accuracy, double xp, double yp, NOVAS.PositionOnSurface position, double ra, double dec, int refOption, NOVAS.DoubleRef zd, NOVAS.DoubleRef ad, NOVAS.DoubleRef rar, NOVAS.DoubleRef decr)
Wrapper for equ2hor() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-55.
ut1Date
- UT1 Julian date.deltaT
- difference TT-UT1 at ut1Date
, in seconds.accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
xp
- conventionally-defined xp coordinate of celestial intermediate
pole with respect to ITRS reference pole, in arcseconds.yp
- conventionally-defined yp coordinate of celestial intermediate
pole with respect to ITRS reference pole, in arcseconds.position
- observer's locationra
- topocentric right ascension of object of interest, in hours,
referred to true equator and equinox of date.dec
- topocentric declination of object of interest, in degrees,
referred to true equator and equinox of date.refOption
- refracion options 0 → no refraction
1 → include refraction, using 'standard' atmospheric conditions.
2 → include refraction, using atmospheric parameters input in the 'location' structure.
zd
- Topocentric zenith distance in degrees, affected by refraction if
refOption
is non-zero.ad
- Topocentric azimuth (measured east from north) in degrees.rar
- Topocentric right ascension of object of interest, in hours,
referred to true equator and equinox of date, affected by
refraction if refOption
is non-zero.decr
- Topocentric declination of object of interest, in degrees,
referred to true equator and equinox of date, affected by
refraction if refOption
is non-zero.public static short siderealTime(double ttDate, double deltaT, int gstType, int method, int accuracy, NOVAS.DoubleRef gst)
Wrapper for sidereal_time() method, for more information, see NOVAS_C3.1_Guide.pdf, page C-51.
ttDate
- UT1 Julian date for topocentric place.deltaT
- Difference TT-UT1 at ttDate
, in seconds of time.gstType
- Selection for type 0 → compute Greenwich mean sidereal time
1 → compute Greenwich apparent sidereal time
method
- Selection for method 0 → CIO-based method
1 → equinox-based method
accuracy
- code specifying the relative accuracy of the output position:
0 → full accuracy
1 → reduced accuracy
gst
- Greenwich (mean or apparent) sidereal time, in hours.0 → no problems
1 → Invalid value of 'accuracy'.
2 → Error code from function 'method'.
> 10 → 10 + error from function 'cio_rai'.