CALCEPH

Presentation

This library is designed to access the binary planetary ephemeris files, such INPOPxx, JPL DExxx and SPICE ephemeris files.

This library provides a C Application Programming Interface (API) and, optionally, Fortran 77/2003, Python 2/3 and octave/Matlab interfaces to be called by the application.

License

This software is an open-source product distributed under three distinct licenses giving you the choice of one of the three following sets of free software/open source licensing terms. This allows the use of our code in as wide a variety of software projects as possible.

This software is governed by the CECILL-C, CECILL-B or CECILL version 2.1 license under French law and abiding by the rules of distribution of free software. You can use, modify and/or redistribute the software under the terms of the CeCILL-C, CeCILL-B or CeCILL license as circulated by CEA, CNRS and INRIA at the following URL https://cecill.info/.

Installation

The installation steps for various programming languages are described in the following links.

Using binary packages

• C and Fortran interface
  
  
  • Linux
    Fedora, RHEL, Rocky Linux
    Ubuntu, Debian, Opensuse, Arch Linux IMCCE packages
  • MacOS
    
  • Windows
    
    
• Python interface
  • 
• Octave/Matlab interface
  • 

From sources

• C and Fortran interface
  • on Unix-like system(Linux, Mac OS X, BSD, cygwin, etc.)
  • on Windows system
• Python interface
  • on any operating system
• Octave/Matlab interface
  • on Unix-like system(Linux, Mac OS X, BSD, cygwin, etc.)
  • on Windows system

Download

Latest stable version

• Version 4.0.0 (April 2024)
  Sources
  calceph-4.0.0.tar.gz
  
  • Use cmake to compile the library. Binary ABI may be broken by this major change in the compilation process. The library remains compatible at the source level: the existing application therefore only needs a recompilation.
  • Add the function calceph_getidbyname and calceph_getnamebyidss.
  • Fix potential crash of fortran-90 interface only, on 32-bit OS, if ephemeris file does not exist.
  • Support frame name with any character except tab, space, comma, parenthese, equal, in the frame SPICE kernel file (files .tf)
  • Fix system error messages to be thread-safe (remove strerror).
  • Fix memory buffer overflow if the number of constants is greater than 400 in the original JPL files.
• Previous releases

Development version

The latest sources of the library are available using this gitlab repository.

Documentation

Reference manuals

• https://calceph.imcce.fr/latest/

Tutorials

External tutorials are available for various languages.

• Python interface
• Octave/Matlab interface

Other interfaces

The following interfaces for CALCEPH are available:

• Julia interface: CALCEPH.jl

Contact

The library is written by the research team Astronomie et systèmes dynamiques (CNRS/Observatoire de Paris/IMCCE).

To report issues, select the project CALCEPH in the bug tracker https://mantisbt.imcce.fr/ .

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