N16 QUICK START FOR THE EPHEMERIS LANGUAGE CORES
================================================

1. Extract the correct program
------------------------------

Use the package for your operating system and processor architecture. Python,
CSPICE and a separate .NET installation are not required.

2. Generate the N16 data
------------------------

Windows example:

  .\Ephemeris-N16-Generator.exe --output D:\Ephemeris-N16

Linux or macOS example:

  chmod +x Ephemeris-N16-Generator
  ./Ephemeris-N16-Generator --output ./Ephemeris-N16

The program downloads official object-specific SPK files from JPL Horizons and
uses them to generate the N16 states locally. Precomputed N16 data are not
distributed in the download package.

3. Verify the result
--------------------

Windows:

  .\Ephemeris-N16-Generator.exe --verify --output D:\Ephemeris-N16

Linux or macOS:

  ./Ephemeris-N16-Generator --verify --output ./Ephemeris-N16

4. Use the correct files
------------------------

The generator writes two forms of the data:

  n16-states-f64.bin
      Complete language-neutral intermediate table.

  core-data/n16/
      Nine files already split for the released Ephemeris language cores,
      covering their fixed 2000 through 2040 interval.

The language cores require the complete core-data/n16 directory. Copy it as
the n16 subdirectory next to the existing planets directory:

  ephemeris-data/
    planets/
      de440s-2000-2004.bin
      ...
    n16/
      n16-2000-2004.bin
      ...
      n16-2040-2040.bin
      index.json

Pass ephemeris-data as the data root to the calculation core and then enable
includeN16. The constructor, function name and exact syntax are documented in
the English manual for the selected language package.

5. Important boundary
---------------------

The N16 generator creates data only for the 16 massive asteroids. It does not
create planet files. The planets directory must already be complete. N16 is
optional: the planet model works without N16, while includeN16 must be enabled
only with a complete and successfully verified N16 data set.

Complete help:

  README.txt
  Ephemeris-N16-Generator --help

Release website:

  https://www.jostjahn.de/amrum-software/ephemeris/en.html
