Function lupnt::cheby_segment

Function Documentation

int lupnt::cheby_segment(SpiceInt daf, SpiceDouble *dc, SpiceInt *ic, segment_t *s)

Load one segment of an SPK file, which covers one target over a range of epochs. Save the target code, reference location code for the target position, and the reference frame code. Load the segment and verify its structure. On success return 0. If there is an error, return 1 and set s->seg to NULL.

Read one Chebyshev-position-only SPK segment from an open DAF file into s, verifying its structure via cheby_verify.

Called by spk_extract for each Type-2 (Chebyshev position-only) segment found while scanning an SPK file.

Parameters:

  • daf – DAF file handle (from dafopr_c)

  • dc – Segment descriptor’s double-precision components (start/end epoch [s past J2000])

  • ic – Segment descriptor’s integer components (target/center/frame codes, representation type, data address range)

  • s – Output: populated segment descriptor (s->seg is heap-allocated)

Returns:

0 on success; 1 on error (with s->seg left as nullptr)