Download inpop21a

Reference

A. Fienga, P. Deram, A. Di Ruscio, V. Viswanathan, J.I.B. Camargo, L. Bernus, M. Gastineau and J. Laskar, “inpop21a planetary ephemerides”, 2021.

Scientific notes:

Data used to built INPOP ephemerides are available on the APDB data base and on http://www.geoazur.fr/astrogeo/?href=observations/donnees/luneRG for the Moon. For this latest, direct computation of residuals are proposed to the users.

Solutions

The orbital solutions of the Sun, the eight planets, the dwarf planet Pluto and the Moon, the libration of the Moon are available as binary or text data files. These orbital solutions are expressed in the TDB and TCB time scales. The time scale transformations TT‑TDB and TCG‑TCB are available in the binary or text data files.

The binary and text data files provide the rectangular coordinates (x,y,z) in kilometers of the bodies with respect to the International Celestial Reference Frame (ICRF). The librations are given in radians. The time scale transformation TT‑TDB and TCG‑TCB is given in seconds for the files including it.

These inpop21a ephemeris files are provided in four file formats:

Binary files

These inpop21a ephemeris files extend the internal format of the binary JPL DExxx ephemeris files (http://ssd.jpl.nasa.gov/?ephemerides) by including the time scale transformation TT‑TDB or TCB-TCG. These binary files are encoded using the “INPOP binary ephemeris file format – version 2.0”. These files provide the orbital solution expressed in the TDB and TCB time scale. The coordinates in the data files are expressed as the coefficients of the Chebychev polynomials. These inpop21a ephemeris files don’t include the coefficients for the nutation.

Time period
(years from J2000)
TDB time scale TCB time scale
− 100 to 100 binary file (18 Mbytes) binary file (18 Mbytes)
− 1000 to 1000 binary file (178 Mbytes) binary file (178 Mbytes)

Usage

These files can’t be read using the older programs based on the “testeph.f” program. These files must be read with the CALCEPH Library which provides a compatible C, Fortran, Python and Matlab Application Programming Interface.

Text files

These inpop21a ephemeris files are encoded as plain text files: the coordinates in the ascii data files are expressed as the coefficients of the Chebychev polynomials. These files provide the orbital solution expressed in the TDB and TCB time scale. These files don’t include the coefficients for the nutation but they include the time scale transformation TT‑TDB or TCG‑TCB.

The ascii testpo files are provided to check that your software is able to read the files and return the correct values. The testpo files use the same format as the JPL program testeph.f.

Time period
(years from J2000)
TDB time scale TCB time scale
− 100 to 100 binary file (64 Mbytes) binary file (64 Mbytes)
− 1000 to 1000 binary file (642 Mbytes) binary file (642 Mbytes)

SPICE data files

These inpop21a ephemeris files uses the internal format of the SPICE data files (kernels) (http://naif.jpl.nasa.gov/naif/). These files provide the orbital solution expressed only in the TDB time scale. The coordinates in the data files are expressed as the coefficients of the Chebychev polynomials. These files don’t include the coefficients for the nutation but they include the time scale transformation TT‑TDB.

Time period
(years from J2000)
TDB time scale
− 100 to 100 binary file (18 Mbytes)
− 1000 to 1000 binary file (178 Mbytes)

Usage

These files could be read using the CALCEPH Library, which provides a compatible C and Fortran Application Programming Interface, or with the SPICE toolkit library. The CALCEPH Library allow to access to the multiple ephemeris files at the same time.

Binary files compatible with the JPL file format

These inpop21a ephemeris files use the same internal format as the binary JPL DExxx ephemeris files (http://ssd.jpl.nasa.gov/?ephemerides): the coordinates in the data files are expressed as the coefficients of the Chebychev polynomials. These files provide the orbital solution expressed in the TDB and TCB time scale. These files don’t include the coefficients for the nutation and the time scale transformation TT‑TDB or TCG‑TCB. So these files could be read with the same programs (such as the JPL software package) which read the binary JPL ephemeris files.

The internal format is described in the paper:
David Hoffman: 1998, “A Set of C Utility Programs for Processing JPL Ephemeris Data”,
https://ssd.jpl.nasa.gov/pub/eph/planets/C-versions/hoffman/EphemUtilVer0.1.tar

Due to the problem of the endianess in the computer (order in which integers are stored as bytes in computer memory), the binary files are available into two formats:

  • Little-endian for Intel x86, IA64 or Alpha based processors (and their clones)
  • Big-endian for Motorola PowerPC, IBM Power or Sparc based processors (and their clones)

The ascii header files are provided to show the content of the two first records of the binary ephemeris files. The file format of these ascii files is the same as described in (Hoffman, 1998).

The ascii testpo files are provided to check that your software is able to read the files and return the correct values. The testpo files is compliant with the format requested by the JPL program testeph.f and could be used with it.

TDB time scale
Time period
(years from J2000)
Little-endian files
(Intel or AMD x86, x86_64 or arm processors)
Big-endian files
(Motorola PowerPC, IBM Power processors)
Value of KSIZE
(for the program “testeph.f”)
Ascii header files
(for information)
Testpo files
(for checking)
− 100 to 100 binary file (17 Mbytes) binary file (17 Mbytes) 1876 ascii file ascii file
− 1000 to 1000 binary file (168 Mbytes) binary file (168 Mbytes) 1876 ascii file ascii file
TCB time scale
Time period
(years from J2000)
Little-endian files
(Intel or AMD x86, x86_64 or arm processors)
Big-endian files
(Motorola PowerPC, IBM Power processors)
Value of KSIZE
(for the program “testeph.f”)
Ascii header files
(for information)
Testpo files
(for checking)
− 100 to 100 binary file (17 Mbytes) binary file (17 Mbytes) 1876 ascii file ascii file
− 1000 to 1000 binary file (168 Mbytes) binary file (168 Mbytes) 1876 ascii file ascii file

Usage

To use these data files instead of the JPL ephemeris files, you only have to change the name of the files in your software program.

If you use a program based on the “testeph.f” program from the JPL, then you may have to set the variable NRECL (and KSIZE if you don’t use the subroutine FSIZER2). The prefered method is to read the beginning of the first record and then to compute the length of the records (same as KSIZE) with the libration’s triplet (which contains the location, order and time-coverage of Chebychev polynomial).

We provide the open-source CALCEPH Library, which provides a compatible C, Fortran and Python Application Programming Interface. This library avoids the problems with the variables (NRECL and KSIZE) and the endianess. It supports the access to the multiple ephemeris files at the same time.

Contact

For all comments concerning these pages, contact the authors: inpop.imcce@obspm.fr.

Last update Monday 19 July 2021