libTheSky
Routines to compute sky positions of Sun, Moon, planets and more
All Namespaces Files Functions Variables Pages
thesky_nutation Module Reference

Procedures for nutation. More...

Functions/Subroutines

subroutine nutation (t, dpsi, eps0, deps)
 Calculate nutation - cheap routine from Meeus - as well as the mean obliquity of the ecliptic.
 
subroutine nutation2000 (jd, dpsi_tot, deps_tot, eps0)
 Compute nutation using the IAU 2000 model. Add the mean obliquity of the ecliptic by Laskar (1986).
 
subroutine ls_nut (jd, dpsi_ls, deps_ls)
 Compute the MHB_2000 luni-solar contributions the nutations in longitude and obliquity.
 
subroutine ls_angles (epoch, ls_arg)
 compute the value of the fundamental argument for Brown's arguments.
 
subroutine eval_ls_nut (epoch, ls_arg, dpsi_ls, deps_ls)
 Compute the nutations in longitude and obliquity by summing over all terms in the nutations series.
 
subroutine out_plan_nut ()
 Write the planetary contribution to the nutations to stdout.
 
subroutine plan_nut (jd, dpsi, deps)
 Compute the planetary contribution to the nutations.
 
subroutine eval_plan_nut (plan_arg, plan_rat, dpsi, deps, out)
 Compute the planetary nutations by summing over the KS1990 coefficients.
 
subroutine plan_angles (epoch, plan_arg, plan_rat)
 Compute of planetary arguments for planetary nutation.
 
subroutine fcn_nut (jd, dpsi_fcn, deps_fcn)
 Compute the consttributions of the freely excited FCN mode to the nutations in longitude and obliquity.
 
subroutine prec_nut (jd, dpsi_prec, deps_prec)
 Evaluate the corrections to the nutations in longitude and obliquity due to the corrections to the IAU-1976 Luni-solar precession constant and the secular rate of change of the obliquity of the ecliptic.
 
subroutine ls_iau76 (epoch, ls_arg)
 Compute the value of the fundamental argument for Brown's arguments.
 

Detailed Description

Procedures for nutation.

Function/Subroutine Documentation

◆ eval_ls_nut()

subroutine thesky_nutation::eval_ls_nut ( real(double), intent(in) epoch,
real(double), dimension(5), intent(in) ls_arg,
real(double), intent(out) dpsi_ls,
real(double), intent(out) deps_ls )

Compute the nutations in longitude and obliquity by summing over all terms in the nutations series.

Parameters
epochJulian day for arguments (input)
ls_argBrown's arguments (input; rad)
dpsi_lsNutation in longitude (output; milliarcsec)
deps_lsNutation in obliquity (output; milliarcsec)

Definition at line 520 of file nutation.f90.

Referenced by ls_nut().

◆ eval_plan_nut()

subroutine thesky_nutation::eval_plan_nut ( real(double), dimension(14), intent(in) plan_arg,
real(double), dimension(14), intent(in) plan_rat,
real(double), intent(out) dpsi,
real(double), intent(out) deps,
character, dimension(*), intent(in) out )

Compute the planetary nutations by summing over the KS1990 coefficients.

Parameters
plan_argPlanetary arguments including pa as given (KS1990) (input; rad)
plan_ratPlanetary argument rates (input; rad/yr)
dpsiContribution to nutations in longitude (output; mas)
depsContribution to nutations in obliquity (output; mas)
out'YES' to write data to stdout (input)

Definition at line 1572 of file nutation.f90.

Referenced by out_plan_nut(), and plan_nut().

◆ fcn_nut()

subroutine thesky_nutation::fcn_nut ( real(double), intent(in) jd,
real(double), intent(out) dpsi_fcn,
real(double), intent(out) deps_fcn )

Compute the consttributions of the freely excited FCN mode to the nutations in longitude and obliquity.

Parameters
jdJulian day (input)
dpsi_fcnContribution to the nutation in longitude (output; milliarcsec)
deps_fcnContribution to the nutation in obliquity (output; milliarcsec)

Definition at line 2701 of file nutation.f90.

Referenced by nutation2000().

◆ ls_angles()

subroutine thesky_nutation::ls_angles ( real(double), intent(in) epoch,
real(double), dimension(5), intent(out) ls_arg )

compute the value of the fundamental argument for Brown's arguments.

Parameters
epochJulian day for arguments (input)
ls_argBrown's arguments (rad)

Definition at line 382 of file nutation.f90.

Referenced by ls_nut().

◆ ls_iau76()

subroutine thesky_nutation::ls_iau76 ( real(double), intent(in) epoch,
real(double), dimension(5), intent(out) ls_arg )

Compute the value of the fundamental argument for Brown's arguments.

Parameters
epochJulian day (input)
ls_argBrown's arguments (output; rad)

Definition at line 2990 of file nutation.f90.

◆ ls_nut()

subroutine thesky_nutation::ls_nut ( real(double), intent(in) jd,
real(double), intent(out) dpsi_ls,
real(double), intent(out) deps_ls )

Compute the MHB_2000 luni-solar contributions the nutations in longitude and obliquity.

Parameters
jdJulian day
dpsi_lsNutation in longitude (milliarcsec)
deps_lsNutation in obliquity (milliarcsec)

Definition at line 239 of file nutation.f90.

References eval_ls_nut(), and ls_angles().

Referenced by nutation2000().

Here is the call graph for this function:

◆ nutation()

subroutine thesky_nutation::nutation ( real(double), intent(in) t,
real(double), intent(out) dpsi,
real(double), intent(out) eps0,
real(double), intent(out) deps )

Calculate nutation - cheap routine from Meeus - as well as the mean obliquity of the ecliptic.

Parameters
tTime in Julian Millennia since 2000.0 in dynamical time
dpsiNutation in longitude (output)
eps0Obliquity of the ecliptic (output)
depsNutation in obliquity (output)
See also
  • IAU 1980 nutation model: Seidelmann (1981);
  • Abbreviated by Meeus, Astronomical Algorithms, 1998, Ch. 22.

Definition at line 45 of file nutation.f90.

References thesky_constants::nutationdat.

Referenced by thesky_coordinates::aberration_eq(), thesky_stars::calcstars(), thesky_coordinates::calcsunxyz(), thesky_comets::cometgc(), thesky_comets::cometxyz(), and thesky_planets::planet_position().

◆ nutation2000()

subroutine thesky_nutation::nutation2000 ( real(double), intent(in) jd,
real(double), intent(out) dpsi_tot,
real(double), intent(out) deps_tot,
real(double), intent(out), optional eps0 )

Compute nutation using the IAU 2000 model. Add the mean obliquity of the ecliptic by Laskar (1986).

Parameters
jdJulian day of computation
dpsi_totTotal nutation in longitude (rad)
deps_totTotal nutation in obliquity (rad)
eps0Mean obliquity of the ecliptic (rad; optional)
See also
http://geoweb.mit.edu/~tah/mhb2000/

Definition at line 101 of file nutation.f90.

References fcn_nut(), ls_nut(), plan_nut(), and prec_nut().

Referenced by thesky_planets::planet_position().

Here is the call graph for this function:

◆ out_plan_nut()

subroutine thesky_nutation::out_plan_nut

Write the planetary contribution to the nutations to stdout.

Definition at line 1398 of file nutation.f90.

References eval_plan_nut(), and plan_angles().

Here is the call graph for this function:

◆ plan_angles()

subroutine thesky_nutation::plan_angles ( real(double), intent(in) epoch,
real(double), dimension(14), intent(out) plan_arg,
real(double), dimension(14), intent(out) plan_rat )

Compute of planetary arguments for planetary nutation.

Parameters
epochJulian day (input)
plan_argPlanetary arguments for longtitudes of L, L', F, D, Om, Mercury, Ven, Ear, Mar, Jup, Sat, Ura, Ura(?), pa.
plan_ratPlanetary argument rates (rads/year)

Definition at line 2530 of file nutation.f90.

Referenced by out_plan_nut(), and plan_nut().

◆ plan_nut()

subroutine thesky_nutation::plan_nut ( real(double), intent(in) jd,
real(double), intent(out) dpsi,
real(double), intent(out) deps )

Compute the planetary contribution to the nutations.

Parameters
jdJulian day (input)
dpsiContribution to the nutation in longitude (output; mas)
depsContribution to the nutation in obliquity (output; mas)

Definition at line 1465 of file nutation.f90.

References eval_plan_nut(), and plan_angles().

Referenced by nutation2000().

Here is the call graph for this function:

◆ prec_nut()

subroutine thesky_nutation::prec_nut ( real(double), intent(in) jd,
real(double), intent(out) dpsi_prec,
real(double), intent(out) deps_prec )

Evaluate the corrections to the nutations in longitude and obliquity due to the corrections to the IAU-1976 Luni-solar precession constant and the secular rate of change of the obliquity of the ecliptic.

Parameters
jdJulian day (input)
dpsi_precContribution to the nutation in longitude (output; mas)
deps_precContribution to the nutation in obliquity (output; mas)

Definition at line 2892 of file nutation.f90.

Referenced by nutation2000().