Chinese Lunar Calendar

It is a javascript program for Chinese lunnar calendar based on astronomical calculation. (Not completed yet)

A lunar month is the time between two successive syzygies. In Chinese lunar calendar, the time of new moon is used. Hence, the most important thing is to calculate the time of a straight-line configuration of Sun, Earth and Moon.

For more details, please see the wiki.

Principle

This project only use type(defined by contract function), function, and module(as namespace). Here I avoid any OOP or well-known design patterns.

Todo

Math

Basic Number System

• math.decimal: union of number and string; e.g. sum numbers or numbers represented as strings (2 implements:built-in number, high precision number using decimal.js library)
• math.vector: general vector calculation
• math.quaternion: rotation of coordinates
• math.dualnumber: a kind of extended number, like complex number
• math.dualquaternion: translation and rotation of coordinates

Tools

• math.angle: compute radian, degree, hour ...represented as strings
• math.polynomial: basic calculation about polynomial
• math.expression: a tool for complicated formula with decimal (because JavaScript does not allow to overload operators)

3d Coordinates

• math.coordinate.point: 3d point data type under cartesian coordinates system or spherical coordinates system
• math.coordinate.descartes: cartesian coordinates operations
• math.coordinate.sphere: spherical coordinates operations

Astronomy

Coordinates

• coordinate.point: data types of 4 kinds celestial coordinate system
• coordinate.first-equatorial: first equatorial coordinate system, HA-dec. system.
• coordinate.second-equatorial: equatorial coordinate system
• coordinate.ecliptic: ecliptic coordinate system
• coordinate.horizontal: horizontal coordinate system

Sun Position

• ephemeries.vsop87: translation from offical fortran code of VSOP87
  • Official Fortran Code: ftp://ftp.imcce.fr/pub/ephem/planets/vsop87/
• ephemeries.vsop2000: translation from offical fortran code of VSOP2000
  • Official Fortran Code: ftp://syrte.obspm.fr/pub/polac/transit/vsop2000/ not available
• ephemeries.vsop2010: translation from offical fortran code of VSOP2010
  • Official Fortran Code: ftp://ftp.imcce.fr/pub/ephem/planets/vsop2010/
• ephemeries.vsop2013: translation from offical fortran code of VSOP2013
  • Official Fortran Code: ftp://ftp.imcce.fr/pub/ephem/planets/vsop2013/
• ephemeries.vsop87.xjw: a simplified version of VSOP87 by Jianwei Xu included in his ShouXing Astronomical Calendar

Moon Position

• ephemeries.elp82b: translation from offical fortran code of ELP-82B

  • Official Fortran Code: ftp://cyrano-se.obspm.fr/pub/2_lunar_solutions/1_elp82b/

• ephemeries.elpmpp02: translation from offical fortran code of ELP-MPP02

  • Official Fortran Code: ftp://cyrano-se.obspm.fr/pub/2_lunar_solutions/2_elpmpp02/

• ephemeries.elpmpp02.xjw: a simplified version of ELP-MPP02 by Jianwei Xu included in his ShouXing Astronomical Calendar

Axial Precession (岁差)

• axial-precession.b03: Bretagnon, P., Fienga, A., & Simon, J.-L. 2003, A&A, 400, 785
• axial-precession.iau2000: IAU 1976 ecliptic precession (Lieske et al. 1977, A&A, 58, 1) and the precession part of the IAU 2000A equator adopted by IAU 2000 Resolution B1.6 (Mathews et al. 2002, J. Geophys. Res., 107, B4, 10.1029/2001JB000390)
• axial-precession.l77:Lieske, J. H., Lederle, T., Fricke, W., & Morando, B. 1977, A&A, 58, 1
• axial-precession.p03:Capitaine, N., Wallace, P. T., & Chapront, J. 2003b, A&A, 412, 567

Nutation (章动)

• nutation.wahr: John M. Wahr. The forced nutations of an elliptical, rotating, elastic and oceanless earth. Volume64, Issue3. March 1981. Pages 705-727
  • need more details
• nutation.mhb2000: Herring, T. A.; Mathews, P. M.; Buffett, B. A. Modeling of nutation-precession: Very long baseline interferometry results. Journal of Geophysical Research (Solid Earth), Volume 107, Issue B4, CiteID 2069, DOI 10.1029/2001JB000165
  • Offical Fortran Code: http://www-gpsg.mit.edu/~tah/mhb2000/
• nutation.mhb2000.truncated: need confirm
• nutation.iau2000A: Nutation, IAU 2000A model (MHB_2000 without FCN). Annexe to IERS Conventions 2000, Chapter 5
  • Offical Fortran Code: ftp://maia.usno.navy.mil/conventions/archive/2003/chapter5/NU2000A.f
• nutation.iau2000B: Nutation, IAU 2000B (truncated) model. Annexe to IERS Conventions 2000, Chapter 5
  • Offical Fortran Code: ftp://maia.usno.navy.mil/conventions/archive/2003/chapter5/NU2000B.f

Atmospheric Refraction (大气折射)

• atmospheric-refraction.Smart: Smart, W. M. 1965, Spherical Astronomy (Cambridge, Cambridge University), p.58
• atmospheric-refraction.Saemundsson: Sæmundsson
• atmospheric-refraction.Meeus
• atmospheric-refraction.Bennett
• atmospheric-refraction.Bennett.improved
• atmospheric-refraction.xjw: a formula used by Jianwei Xu included in his ShouXing Astronomical Calendar

Parallax (视差)

ΔT=TT-UT (地球时-世界时)

Aberration of Light (光行差)

Lunar

• solar term (节气)
• syzygy (朔望)
• intercalation (置闰)