Module JNISpice
Package spice.basic

Class CSPICE


  • public class CSPICE
    extends java.lang.Object
    Class CSPICE provides a native API enabling higher-level JNISpice methods to call selected CSPICE and DSKLIB_C routines.

    In many cases the functionality provided here is also provided in an object-oriented fashion by a higher-level API. Users should consult in particular the documentation for the package spice.basic before resorting to direct calls to methods in this package.

    Unlike the rest of the rest of the JNISpice system, the methods of this class have interfaces that rely, with few exceptions, on primitive scalars and arrays of primitive types. The method interfaces tend to parallel those of the corresponding native functions, but differences exist where slavish adherence to parallel structure would result in (even more) unwieldy calling sequences. For example, coordinate conversion routines typically return their outputs as a double precision array.

    Output arguments pose a challenge: many CSPICE functions return multiple output arguments, yet Java has no mechanism expressly meant to handle output arguments. In Java, compound data to be returned from a method are typically packaged as an object. Output arguments may be clumsily simulated by use of arrays; this is the work-around employed by JNISpice. If an underlying C function returns multiple arguments, then (with few exceptions), the corresponding method provides "output" arguments in the form of arrays whose contents are modified by the native C function. Scalar output arguments that would be passed by reference in C are passed as arrays of length 1 here.

    Concerning error handling: this class uses static initialization code to set the CSPICE error handling system to RETURN mode and the CSPICE error output device to NULL. When a SPICE error is signaled by CSPICE, the calling JNISpice wrapper will capture error messages, reset the CSPICE error status, then throw a SpiceErrorException reflecting the CSPICE error. After the calling application has caught and handled the exception, the CSPICE system normally is ready to resume operation.

    All methods in this class are static and synchronized.

    Version 4.0.0 25-JAN-2017 (NJB)

     Changed argument list of  *
     CSPICE.dskw02
    
     Added methods:
    
     CSPICE.dasac
     CSPICE.dasdc
     CSPICE.dashfn
     CSPICE.dasopw
     CSPICE.dasrfr
     CSPICE.dlabbs
     CSPICE.dlafps
     CSPICE.dskgtl
     CSPICE.dskmi2
     CSPICE.dskobj
     CSPICE.dskrb2
     CSPICE.dsksrf
     CSPICE.dskstl
     CSPICE.dskxsi
     CSPICE.dskxv
     CSPICE.illumf
     CSPICE.inedpl
     CSPICE.latsrf
     CSPICE.limbpt
     CSPICE.occult
     CSPICE.oscltx
     CSPICE.pckcls
     CSPICE.pckfrm
     CSPICE.pckobj
     CSPICE.pckopn
     CSPICE.pckw02
     CSPICE.pltar
     CSPICE.pltexp
     CSPICE.pltnp
     CSPICE.pltnrm
     CSPICE.pltvol
     CSPICE.pxfrm2
     CSPICE.spkcpo
     CSPICE.spkcpt
     CSPICE.spkcvo
     CSPICE.spkcvt
     CSPICE.srfc2s
     CSPICE.srfcss
     CSPICE.srfnrm
     CSPICE.srfs2c
     CSPICE.srfscc
     CSPICE.termpt
     CSPICE.tparse
    
     

    Version 3.0.0 16-JUN-2014 (NJB)

     Changed argument list of method llgridPl02. The input
     grid is now 2-dimensional.
     

    Last update was 11-MAR-2014 (NJB)(EDW)

     Added methods:
    
     CSPICE.ccifrm
     CSPICE.gfilum
     CSPICE.gfpa
     CSPICE.gfrr
     CSPICE.gfstol
     

    27-FEB-2014 (NJB)

     Added method CSPICE.gfilum.
     

    Version 2.0.0 19-AUG-2013 (NJB)

     Added method CSPICE.getfat.
     

    Version 1.0.0 24-DEC-2009 (NJB)

    • Constructor Summary

      Constructors 
      Constructor Description
      CSPICE()  
    • Method Summary

      Modifier and Type Method Description
      static double[][] axisar​(double[] axis, double angle)
      Compute a rotation matrix from a rotation axis and angle.
      static double b1900()
      Return the Julian Date corresponding to Besselian Date 1900.0.
      static double b1950()
      Return the Julian Date corresponding to Besselian Date 1950.0.
      static boolean badkpv​(java.lang.String caller, java.lang.String name, java.lang.String comp, int size, int divby, java.lang.String type)
      Throw an exception if a given kernel variable does not have specified attributes.
      static java.lang.String bodc2n​(int code)
      Translate the SPICE integer code of a body into a common name for that body.
      static java.lang.String bodc2s​(int code)
      Translate the SPICE integer code of a body into a common name for that body, or a string representation of the code if no name is associated with the code.
      static boolean bodfnd​(int code, java.lang.String item)
      Determine whether values exist for some item for any body in the kernel pool.
      static int bodn2c​(java.lang.String name)
      Translate the name of a body into the SPICE integer ID code for that body.
      static int bods2c​(java.lang.String name)
      Translate the name of a body into the SPICE integer ID code for that body; translate a string representation of an integer to an integer.
      static double[] bodvcd​(int body, java.lang.String item)
      Return the values of some item for any body in the kernel pool.
      static void ccifrm​(int frclss, int clssid, int[] frcode, java.lang.String[] frname, int[] center, boolean[] found)
      Map a frame class and frame class ID to a reference frame ID code, name, and center.
      static double[] cgv2el​(double[] center, double[] gv1, double[] gv2)
      Create a SPICE ellipse from a center and generating vectors.
      static void ckcls​(int handle)
      Close a CK file.
      static double[] ckcov​(java.lang.String ck, int idcode, boolean needav, java.lang.String level, double tol, java.lang.String timsys, int size, double[] cover)
      Return a coverage window for a specified instrument and CK file.Add this coverage to that contained in an input window.
      static void ckgp​(int inst, double sclkdp, double tol, java.lang.String ref, double[][] cmat, double[] clkout, boolean[] found)
      Get instrument pointing for a specified spacecraft clock time.
      static void ckgpav​(int inst, double sclkdp, double tol, java.lang.String ref, double[][] cmat, double[] av, double[] clkout, boolean[] found)
      Get instrument pointing and angular velocity for a specified spacecraft clock time.
      static int ckmeta​(int CKID, java.lang.String meta)
      Return the SCLK or SPK ID associated with an instrument ID code.
      static int[] ckobj​(java.lang.String file, int size, int[] ids)
      Return an ordered array of unique ID codes of instruments for which a specified CK file contains data.
      static int ckopn​(java.lang.String fname, java.lang.String ifname, int ncomch)
      Open a new CK file.
      static void ckupf​(int handle)
      Unload a CK from the CKBSR system.
      static void ckw01​(int handle, double begtim, double endtim, int inst, java.lang.String ref, boolean avflag, java.lang.String segid, int nrec, double[] sclkdp, double[] quats, double[] avvs)
      Write a type 1 segment to a CK file.
      static void ckw02​(int handle, double begtim, double endtim, int inst, java.lang.String ref, java.lang.String segid, int nrec, double[] start, double[] stop, double[] quats, double[] avvs, double[] rates)
      Write a type 2 segment to a CK file.
      static void ckw03​(int handle, double begtim, double endtim, int inst, java.lang.String ref, boolean avflag, java.lang.String segid, int nrec, double[] sclkdp, double[] quats, double[] avvs, int nints, double[] starts)
      Write a type 3 segment to a CK file.
      static double clight()
      Return the speed of light.
      static void clpool()
      Clear the kernel pool.
      static double[] conics​(double[] elts, double et)
      Convert conic elements to a state at a given epoch.
      static double convrt​(double x, java.lang.String in, java.lang.String out)
      Convert a measurement from one physical unit to another.
      static boolean cvpool​(java.lang.String agent)
      Determine whether or not any of the variables that are to be watched and have a specified agent on their distribution list have been updated.
      static double[] cyllat​(double r, double lon, double z)
      Convert from cylindrical coordinates to latitudinal coordinates.
      static double[] cylrec​(double r, double lon, double z)
      Convert from cylindrical coordinates to rectangular coordinates.
      static double[] cylsph​(double r, double lon, double z)
      Convert from cylindrical coordinates to spherical coordinates.
      static void dafac​(int handle, java.lang.String[] buffer)
      Add comments from a buffer to a DAF.
      static void dafbbs​(int handle)
      Begin a backward search for arrays in a DAF.
      static void dafbfs​(int handle)
      Begin a forward search for arrays in a DAF.
      static void dafcls​(int handle)
      Close the DAF associated with a given handle.
      static void dafcs​(int handle)
      Select a DAF that already has a search in progress as the one to continue searching.
      static void dafdc​(int handle)
      Delete comments from a DAF.
      static void dafec​(int handle, int bufsiz, int lenout, int[] n, java.lang.String[] buffer, boolean[] done)
      Extract comments from a DAF into a buffer.
      static boolean daffna()
      Find the next (forward) array in the current DAF.
      static boolean daffpa()
      Find the previous (backward) array in the current DAF.
      static double[] dafgda​(int handle, int begin, int end)
      Return double precision data from the specified address range.
      static java.lang.String dafgn()
      Return (get) the name for the current array in the current DAF.
      static double[] dafgs​(int size)
      Return (get) the summary for the current array in the current DAF.
      static double[] dafgsr​(int handle, int recno, int begin, int end)
      Return the specified summary record.
      static int dafopr​(java.lang.String fname)
      Open a DAF for subsequent read requests.
      static int dafopw​(java.lang.String fname)
      Open a DAF for writing.
      static java.lang.String dafrcr​(int handle, int recno)
      Read a DAF character record.
      static void dafrfr​(int handle, int[] nd, int[] ni, java.lang.String[] ifname, int[] fward, int[] bward, int[] free)
      Obtain a file record object from a DAF.
      static void dafus​(double[] sum, int nd, int ni, double[] dc, int[] ic)
      Unpack a DAF summary.
      static void dasac​(int handle, java.lang.String[] buffer)
      Append buffered comments to a DAS file.
      static void dascls​(int handle)
      Close the DAS file associated with a given handle.
      static void dasdc​(int handle)
      Delete comments from a DAS file.
      static void dasec​(int handle, int bufsiz, int lenout, int[] n, java.lang.String[] buffer, boolean[] done)
      Extract comments from a DAS file into a buffer.
      static java.lang.String dashfn​(int handle)
      Map a DAS file handle to the corresponding file name.
      static int dasopr​(java.lang.String fname)
      Open a DAS file for subsequent read requests.
      static int dasopw​(java.lang.String fname)
      Open a DAS file for write access.
      static void dasrfr​(int handle, java.lang.String[] idword, java.lang.String[] ifname, int[] nresvr, int[] nresvc, int[] ncomr, int[] ncomc)
      Read file record paramters from a DAS file.
      static double[][] dcyldr​(double x, double y, double z)
      Return the Jacobian matrix of the rectangular to cylindrical transformation.
      static double deltet​(double epoch, java.lang.String eptype)
      Return the difference between TDB and UTC at a specified epoch.
      static double det​(double[][] m)
      Return the determinant of a 3x3 matrix.
      static double[][] dgeodr​(double x, double y, double z, double re, double f)
      Return the Jacobian matrix of the rectangular to geodetic transformation.
      static void dlabbs​(int handle, int[] descr, boolean[] found)
      Begin a backward search for arrays in a DLA.
      static void dlabfs​(int handle, int[] descr, boolean[] found)
      Begin a forward search for arrays in a DLA.
      static void dlafns​(int handle, int[] descr, int[] nxtdsc, boolean[] found)
      Find the next (forward) segment in a DLA.
      static void dlafps​(int handle, int[] descr, int[] prvdsc, boolean[] found)
      Find the previous (backward) segment in a DLA.
      static double[][] dlatdr​(double x, double y, double z)
      Return the Jacobian matrix of the rectangular to latitudinal transformation.
      static double[][] dpgrdr​(java.lang.String body, double x, double y, double z, double re, double f)
      Return the Jacobian matrix of the rectangular to planetographic transformation.
      static double dpr()
      Return the number of degrees per radian.
      static double[][] drdcyl​(double radius, double longitude, double z)
      Return the Jacobian matrix of the cylindrical to rectangular transformation.
      static double[][] drdgeo​(double longitude, double latitude, double altitude, double re, double f)
      Return the Jacobian matrix of the geodetic to rectangular transformation.
      static double[][] drdlat​(double radius, double longitude, double latitude)
      Return the Jacobian matrix of the latitudinal to rectangular transformation.
      static double[][] drdpgr​(java.lang.String body, double longitude, double latitude, double altitude, double re, double f)
      Return the Jacobian matrix of the planetographic to rectangular transformation.
      static double[][] drdsph​(double radius, double colatitude, double longitude)
      Return the Jacobian matrix of the spherical to rectangular transformation.
      static void dskb02​(int handle, int[] dladsc, int[] nv, int[] np, int[] nvxtot, double[][] vtxbds, double[] voxsiz, double[] voxori, int[] vgrext, int[] cgscal, int[] vtxnpl, int[] voxnpt, int[] voxnpl)
      Return bookkeeping data from a DSK type 2 segment.
      static double[] dskd02​(int handle, int[] dladsc, int item, int start, int room)
      Fetch double precision data from a type 2 DSK segment.
      static double[] dskgd​(int handle, int[] dladsc)
      Return the DSK descriptor from a DSK segment identified by a DAS handle and DLA descriptor.
      static double dskgtl​(int keywrd)
      Retrieve the value of a specified DSK tolerance or margin parameter.
      static int[] dski02​(int handle, int[] dladsc, int item, int start, int room)
      Fetch integer data from a type 2 DSK segment.
      static void dskmi2​(int nv, double[] vrtces, int np, int[] plates, double finscl, int corscl, int worksz, int voxpsz, int voxlsz, boolean makvtl, int spxisz, double[] spaixd, int[] spaixi)
      Make spatial index for a DSK type 2 segment.The index is returned as a pair of arrays, one of type SpiceInt and one of type SpiceDouble.These arrays are suitable for use with the DSK type 2 writer CSPICE.dskw02.
      static double[] dskn02​(int handle, int[] dladsc, int plid)
      Compute the unit normal vector for a specified plate from a type 2 DSK segment.
      static int[] dskobj​(java.lang.String dsk, int size, int[] ids)
      Find the set of body ID codes of all objects for which topographic data are provided in a specified DSK file.
      static int dskopn​(java.lang.String fname, java.lang.String ifname, int ncomch)
      Open a new DSK file for subsequent write operations.
      static int[][] dskp02​(int handle, int[] dladsc, int start, int room)
      Fetch plates from a type 2 DSK segment.
      static void dskrb2​(int nv, double[] vrtces, int np, int[] plates, int corsys, double[] corpar, double[] mncor3, double[] mxcor3)
      Derive range bounds on third coordinate for a plate set.Note that the plate and vertex arrays are 1-dimensional.
      static int[] dsksrf​(java.lang.String dsk, int bodyid, int size, int[] srfids)
      Find the set of surface ID codes for all surfaces associated with a given body in a specified DSK file.
      static void dskstl​(int keywrd, double dpval)
      Set the value of a specified DSK tolerance or margin parameter.
      static double[][] dskv02​(int handle, int[] dladsc, int start, int room)
      Fetch vertices from a type 2 DSK segment.
      static void dskw02​(int handle, int center, int surfce, int dclass, java.lang.String frame, int corsys, double[] corpar, double mncor1, double mxcor1, double mncor2, double mxcor2, double mncor3, double mxcor3, double first, double last, int nv, double[] vrtces, int np, int[] plates, double[] spaixd, int[] spaixi)
      Write a type 2 segment to a DSK file.Note that the plate and vertex arrays are 1-dimensional.
      static void dskx02​(int handle, int[] dladsc, double[] vertex, double[] raydir, int[] plid, double[] xpt, boolean[] found)
      Determine the plate ID and body-fixed coordinates of the intersection of a specified ray with the surface defined by a type 2 DSK plate model.
      static void dskxsi​(boolean pri, java.lang.String target, int nsurf, int[] srflst, double et, java.lang.String fixref, double[] vertex, double[] raydir, int maxd, int maxi, double[] xpt, int[] handle, int[] dladsc, double[] dskdsc, double[] dc, int[] ic, boolean[] found)
      Compute a ray-surface intercept using data provided by multiple loaded DSK segments.Return information about the source of the data defining the surface on which the intercept was found: DSK handle, DLA and DSK descriptors, and DSK data type-dependent parameters.
      static void dskxv​(boolean pri, java.lang.String target, int nsurf, int[] srflst, double et, java.lang.String fixref, int nrays, double[][] vtxarr, double[][] dirarr, double[][] xptarr, boolean[] fndarr)
      Compute ray-surface intercepts for a set of rays, using data provided by multiple loaded DSK segments.
      static void dskz02​(int handle, int[] dladsc, int[] nv, int[] np)
      Return plate model size parameters---plate count and vertex count---for a type 2 DSK segment.
      static double[][] dsphdr​(double x, double y, double z)
      Return the Jacobian matrix of the rectangular to spherical transformation.
      static void dtpool​(java.lang.String name, boolean[] found, int[] n, java.lang.String[] type)
      Return type and dimension attributes of a kernel pool variable.
      static double[] dvcrss​(double[] s1, double[] s2)
      Return the derivative of the cross product of two vectors.
      static double dvdot​(double[] s1, double[] s2)
      Return the derivative of the dot product of two vectors.
      static double[] dvhat​(double[] s1)
      Return the unit vector defined by a state vector and corresponding derivative.
      static void dvpool​(java.lang.String name)
      Delete a kernel pool variable.
      static double dvsep​(double[] s1, double[] s2)
      Return the derivative of the angular separation of two vectors.
      static double[] edlimb​(double a, double b, double c, double[] viewpt)
      Find the limb of a tri-axial ellipsoid as seen from a specified point.
      static void el2cgv​(double[] ellipse, double[] center, double[] smajor, double[] sminor)
      Create a center and generating vectors from a SPICE ellipse.
      static boolean eqstr​(java.lang.String a, java.lang.String b)
      Deprecated.
      static java.lang.String erract​(java.lang.String op, java.lang.String action)
      Set or retrieve the default error action.
      static java.lang.String errdev​(java.lang.String op, java.lang.String device)
      Set or retrieve the default error device.
      static void et2lst​(double et, int body, double lon, java.lang.String type, int[] hr, int[] min, int[] sec, java.lang.String[] time, java.lang.String[] ampm)
      Convert an input time from ephemeris seconds past J2000 to local solar time at a specified location on a specified body.
      static java.lang.String et2utc​(double et, java.lang.String format, int prec)
      Convert an input time from ephemeris seconds past J2000 to Calendar, Day-of-Year, or Julian Date format, UTC.
      static java.lang.String etcal​(double et)
      Convert an input time from ephemeris seconds past J2000 to a fixed format calendar TDB string.
      static double[][] eul2m​(double[] angles, int[] axes)
      Convert a sequence of Euler angles and axes to a rotation matrix.
      static double[] eul2xf​(double[] angles, int[] axes)
      Convert a sequence of Euler angles, rates, and axes to a state transformation matrix.
      static void frinfo​(int frameID, int[] centerID, int[] frclass, int[] frclassID, boolean[] found)
      Look up the frame specification parameters associated with a frame ID code.
      static java.lang.String frmnam​(int code)
      Look up the frame name associated with a frame ID code.
      static void furnsh​(java.lang.String file)
      Furnish a program with the kernels and related data needed to carry out the program's computations.
      static java.lang.String[] gcpool​(java.lang.String name, int start, int room)
      Return the character value of a kernel variable from the kernel pool.
      static double[] gdpool​(java.lang.String name, int start, int room)
      Return the double precision value of a kernel variable from the kernel pool.
      static double[] georec​(double longitude, double latitude, double altitude, double re, double f)
      Convert from geodetic coordinates to rectangular coordinates.
      static void getfat​(java.lang.String file, java.lang.String[] arch, java.lang.String[] type)
      Determine the file architecture and file type of most SPICE kernel files.
      static void getfov​(int instID, java.lang.String[] shape, java.lang.String[] ref, double[] bsight, int[] size, double[] bounds)
      Return the field-of-view (FOV) configuration for a specified instrument.
      static boolean gfbail()
      Indicate whether an interrupt was detected.
      static void gfclrh()
      Clear interrupt status.
      static double[] gfdist​(java.lang.String target, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF distance search.
      static double[] gfilum​(java.lang.String method, java.lang.String angtyp, java.lang.String target, java.lang.String illmn, java.lang.String fixref, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF illumination angle search.
      static double[] gfocce​(java.lang.String occtyp, java.lang.String front, java.lang.String fshape, java.lang.String fframe, java.lang.String back, java.lang.String bshape, java.lang.String bframe, java.lang.String abcorr, java.lang.String obsrvr, int nintvls, double[] cnfine, GFSearchUtils utils)
      Perform a custom GF occultation search using user-specified step and refinement functions.
      static double[] gfoclt​(java.lang.String occtyp, java.lang.String front, java.lang.String fshape, java.lang.String fframe, java.lang.String back, java.lang.String bshape, java.lang.String bframe, java.lang.String abcorr, java.lang.String obsrvr, double step, int nintvls, double[] cnfine)
      Perform a GF occultation search.
      static double[] gfpa​(java.lang.String target, java.lang.String illum, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF phase angle search.
      static double[] gfposc​(java.lang.String target, java.lang.String frame, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String crdsys, java.lang.String coord, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF position vector coordinate search.
      static double gfrefn​(double t1, double t2, boolean s1, boolean s2)
      Get a refined GF root estimate.
      static void gfrepf()
      Finalize a GF progress report.
      static void gfrepi​(double[] window, java.lang.String begmsg, java.lang.String endmsg)
      Initialize a GF progress report.
      static void gfrepu​(double ivbeg, double ivend, double time)
      Update a GF progress report.
      static double[] gfrfov​(java.lang.String inst, double[] raydir, java.lang.String rframe, java.lang.String abcorr, java.lang.String obsrvr, double step, int nintvls, double[] cnfine)
      Perform a GF ray in FOV search.
      static double[] gfrr​(java.lang.String target, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF range rate search.
      static double[] gfsep​(java.lang.String targ1, java.lang.String shape1, java.lang.String frame1, java.lang.String targ2, java.lang.String shape2, java.lang.String frame2, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF angular separation coordinate search.
      static double[] gfsntc​(java.lang.String target, java.lang.String fixref, java.lang.String method, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String dref, double[] dvec, java.lang.String crdsys, java.lang.String coord, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF surface intercept coordinate search.
      static void gfsstp​(double step)
      Set the GF step size.
      static double gfstep​(double et)
      Get the current GF step size.
      static void gfstol​(double tol)
      Set the GF tolerance.
      static double[] gfsubc​(java.lang.String target, java.lang.String fixref, java.lang.String method, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String crdsys, java.lang.String coord, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF sub-observer point coordinate search.
      static double[] gftfov​(java.lang.String inst, java.lang.String target, java.lang.String tshape, java.lang.String tframe, java.lang.String abcorr, java.lang.String obsrvr, double step, int nintvls, double[] cnfine)
      Perform a GF target in FOV search.
      static double[] gfuds​(GFScalarQuantity quant, java.lang.String relate, double refval, double adjust, double step, int nintvls, double[] cnfine)
      Perform a GF user-defined scalar quantity search.
      static int[] gipool​(java.lang.String name, int start, int room)
      Return the integer value of a kernel variable from the kernel pool.
      static java.lang.String[] gnpool​(java.lang.String template, int start, int room)
      Retrieve the names of kernel variables matching a specified template.
      static void illumf​(java.lang.String method, java.lang.String target, java.lang.String ilusrc, double et, java.lang.String fixref, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, double[] trgepc, double[] srfvec, double[] angles, boolean[] visibl, boolean[] lit)
      Compute the illumination angles---phase, incidence, and emission---at a specified point on a target body.Return logical flags indicating whether the surface point is visible from the observer's position and whether the surface point is illuminated.The target body's surface is represented using topographic data provided by DSK files, or by a reference ellipsoid.The illumination source is a specified ephemeris object.
      static void illumPl02​(int handle, int[] dladsc, java.lang.String target, double et, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, double[] trgepc, double[] srfvec, double[] angles)
      Compute the illumination angles---phase, solar incidence, and emission---at a specified point on a target body at a particular epoch, optionally corrected for light time and stellar aberration.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.
      static void ilumin​(java.lang.String method, java.lang.String target, double et, java.lang.String fixref, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, double[] trgepc, double[] srfvec, double[] angles)
      Find the illumination angles at a specified surface point of a target body.
      static void inedpl​(double a, double b, double c, double[] plane, double[] ellipse, boolean[] found)
      Find the intersection of a plane and a triaxial ellipsoid.
      static void inelpl​(double[] ellipse, double[] plane, int[] nxpts, double[] xpt1, double[] xpt2)
      Find the intersection of an ellipse and a plane.
      static void inrypl​(double[] vertex, double[] dir, double[] plane, int[] nxpts, double[] xpt)
      Find the intersection of a ray and a plane.
      static double[][] invert​(double[][] m)
      Return the inverse of a nonsingular 3x3 matrix.
      static boolean isrot​(double[][] m, double ntol, double dtol)
      Indicate whether a given matrix is a rotation matrix.
      static double j1900()
      Return the Julian Date of 1899 DEC 31 12:00:00 (1900 JAN 0.5).
      static double j1950()
      Return the Julian Date of 1950 JAN 01 00:00:00 (1950 JAN 1.0).
      static double j2000()
      Return the Julian Date of 2000 JAN 01 12:00:00 (2000 JAN 1.5).
      static double j2100()
      Return the Julian Date of 2100 JAN 01 12:00:00 (2100 JAN 1.5).
      static double jyear()
      Return the number of seconds in a Julian year.
      static void kclear()
      Clear the keeper system and kernel pool.
      static void kdata​(int which, java.lang.String kind, java.lang.String[] file, java.lang.String[] filtyp, java.lang.String[] source, int[] handle, boolean[] found)
      Return data for a kernel of specified type and index loaded in the keeper system.
      static void kinfo​(java.lang.String file, java.lang.String[] filtyp, java.lang.String[] source, int[] handle, boolean[] found)
      Return data for a kernel, specified by name, that is loaded in the keeper system.
      static int ktotal​(java.lang.String kind)
      Return the count of kernels of a specified type loaded in the keeper system.
      static double[] latcyl​(double radius, double longitude, double latitude)
      Convert from latitudinal coordinates to cylindrical coordinates.
      static double[] latrec​(double radius, double longitude, double latitude)
      Convert from latitudinal coordinates to rectangular coordinates.
      static double[] latsph​(double radius, double longitude, double latitude)
      Convert from latitudinal coordinates to spherical coordinates.
      static double[][] latsrf​(java.lang.String method, java.lang.String target, double et, java.lang.String fixref, int npts, double[][] lonlat)
      Map array of planetocentric longitude/latitude coordinate pairs to surface points on a specified target body.The surface of the target body may be represented by a triaxial ellipsoid or by topographic data provided by DSK files.
      static void ldpool​(java.lang.String filename)
      Load a text kernel into the kernel pool.
      static void limbPl02​(int handle, int[] dladsc, java.lang.String target, double et, java.lang.String fixfrm, java.lang.String abcorr, java.lang.String obsrvr, int npoints, double[] trgepc, double[] obspos, double[][] limbpts, int[] plateIDs)
      Compute a set of points on the limb of a specified target body, where the target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.
      static void limbpt​(java.lang.String method, java.lang.String target, double et, java.lang.String fixref, java.lang.String abcorr, java.lang.String corloc, java.lang.String obsrvr, double[] refvec, double rolstp, int ncuts, double schstp, double soltol, int maxn, int[] npts, double[][] points, double[] epochs, double[][] tangts)
      Find limb points on a target body.The limb is the set of points of tangency on the target of rays emanating from the observer.The caller specifies half-planes bounded by the observer-target center vector in which to search for limb points.The surface of the target body may be represented either by a triaxial ellipsoid or by topographic data.
      static void llgridPl02​(int handle, int[] dladsc, double[][] grid, double[][] spoints, int[] plateIDs)
      Given the planetocentric longitude and latitude values of a set of surface points on a specified target body, compute the corresponding rectangular coordinates of those points.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.CAUTION: the argument list of this routine has changed! This routine accepts the input grid values as a 2-D (Nx2) array.The previous version accepted a 1D array.Elements [i][0] [i][1] of `grid' are, respectively, the longitude and latitude of the ith grid point.
      static void lmpool​(java.lang.String[] cvals)
      Load variables contained in a string array into the kernel pool.
      static void ltime​(double etobs, int obs, java.lang.String dir, int targ, double[] ettarg, double[] elapsd)
      Compute the one-way light time between a specified target and observer.
      static double[] m2eul​(double[][] m, int[] axes)
      Convert a rotation matrix and a sequence of axes to a sequence of Euler angles.
      static double[] m2q​(double[][] m)
      Convert a rotation matrix to a SPICE quaternion.
      static double[][] mxm​(double[][] m1, double[][] m2)
      Multiply two 3x3 matrices.
      static double[] mxv​(double[][] m, double[] v)
      Left-multiply a 3-vector by a 3x3 matrix.
      static int namfrm​(java.lang.String name)
      Look up the frame ID code associated with a frame name.
      static void nearpt​(double[] positn, double a, double b, double c, double[] point, double[] alt)
      This routine locates the point on the surface of an ellipsoid that is nearest to a specified position.It also returns the altitude of the position above the ellipsoid.
      static void npedln​(double a, double b, double c, double[] linept, double[] linedr, double[] point, double[] dist)
      Return the nearest point on an ellipsoid to a given line; also return the distance between the ellipsoid and the line.
      static void npelpt​(double[] point, double[] ellipse, double[] pnear, double[] dist)
      Return the nearest point on an ellipseto a given point; also return the distance between the ellipse and the point.
      static void nplnpt​(double[] linept, double[] linedr, double[] point, double[] pnear, double[] dist)
      Return the nearest point on a line to a given point; also return the distance between the two points.
      static double[] nvc2pl​(double[] normal, double constant)
      Convert a normal vector and constant to a plane.
      static double[] nvp2pl​(double[] normal, double[] point)
      Convert a normal vector and point to a plane.
      static int occult​(java.lang.String targ1, java.lang.String shape1, java.lang.String frame1, java.lang.String targ2, java.lang.String shape2, java.lang.String frame2, java.lang.String abcorr, java.lang.String obsrvr, double et)
      Determine the occultation condition (not occulted, partially, etc.) of one target relative to another target as seen by an observer at a given time.The surfaces of the target bodies may be represented by triaxial ellipsoids or by topographic data provided by DSK files.
      static double[] oscelt​(double[] state, double et, double mu)
      Compute osculating elements corresponding to a state.
      static double[] oscltx​(double[] state, double et, double mu)
      Compute extended osculating elements corresponding to a state.
      static void pckcls​(int handle)
      Close a binary PCK file.
      static double[] pckcov​(java.lang.String file, int classID, int size, double[] cover)
      Return a coverage window for a specified reference frame class ID and PCK file.Union this coverage with that contained in an input window.
      static int[] pckfrm​(java.lang.String pck, int size, int[] ids)
      Return an ordered array of unique reference frame class ID codes of all frames associated with segments in a specified binary PCK file.The returned array is the union of this ID set with the set of IDs in the input array `ids'.
      static int pckopn​(java.lang.String fname, java.lang.String ifname, int ncomch)
      Open a new binary PCK file.
      static void pckuof​(int handle)
      Unload a binary PCK from the PCKBSR system.
      static void pckw02​(int handle, int clssid, java.lang.String frame, double first, double last, java.lang.String segid, double intlen, int n, int polydg, double[] cdata, double btime)
      Write a type 2 segment to a binary PCK file.
      static void pcpool​(java.lang.String name, java.lang.String[] cvals)
      Insert a character kernel variable into the kernel pool.
      static void pdpool​(java.lang.String name, double[] dvals)
      Insert a double precision kernel variable into the kernel pool.
      static double[] pgrrec​(java.lang.String body, double longitude, double latitude, double altitude, double re, double f)
      Convert from planetographic coordinates to rectangular coordinates.
      static double pi()
      Deprecated.
      static void pipool​(java.lang.String name, int[] ivals)
      Insert an integer kernel variable into the kernel pool.
      static double[] pjelpl​(double[] elin, double[] plane)
      Project an ellipse orthogonally onto a plane.
      static void pl2nvc​(double[] plane, double[] normal, double[] constant)
      Map a plane array to a normal vector and constant.
      static void pl2nvp​(double[] plane, double[] normal, double[] point)
      Map a plane array to a normal vector and point.
      static void pl2psv​(double[] plane, double[] point, double[] span1, double[] span2)
      Map a plane array to a point and spanning vectors.
      static double pltar​(int nv, double[] vrtces, int np, int[] plates)
      Compute the total area of a collection of triangular plates.
      static double[][] pltexp​(double[][] iverts, double delta)
      Expand a triangular plate by a specified amount.The expanded plate is co-planar with, and has the same orientation as, the original.The centroids of the two plates coincide.
      static void pltnp​(double[] point, double[] v1, double[] v2, double[] v3, double[] pnear, double[] dist)
      Find the nearest point on a triangular plate to a given point.
      static double[] pltnrm​(double[] v1, double[] v2, double[] v3)
      Compute an outward normal vector of a triangular plate.The vector does not necessarily have unit length.
      static double pltvol​(int nv, double[] vrtces, int np, int[] plates)
      Compute the volume of a three-dimensional region bounded by a collection of triangular plates.
      static java.lang.String prompt​(java.lang.String promptStr)
      This function prompts a user for keyboard input.
      static void prop2b​(double gm, double[] pvinit, double dt, double[] pvprop)
      Propagate a state using a two-body model.
      static double[] psv2pl​(double[] point, double[] span1, double[] span2)
      Convert a point and two spanning vectors to a plane.
      static void putcml​(java.lang.String[] argv)
      Store the contents of argv for later access.
      static double[][] pxform​(java.lang.String from, java.lang.String to, double et)
      Return the rotation matrix from one frame to another at a specified epoch.
      static double[][] pxfrm2​(java.lang.String from, java.lang.String to, double etfrom, double etto)
      Return the 3x3 matrix that transforms position vectors from one specified frame at a specified epoch to another specified frame at another specified epoch.
      static double[][] q2m​(double[] q)
      Convert a SPICE quaternion to a matrix.
      static double[] qdq2av​(double[] q, double[] dq)
      Convert a SPICE quaternion and its derivative to angular velocity.
      static double[] qxq​(double[] q1, double[] q2)
      Multiply two SPICE quaternions.
      static double[] radrec​(double range, double ra, double dec)
      Convert from range, right ascension, and declination to rectangular coordinates.
      static double[] rav2xf​(double[][] r, double[] av)
      Convert a rotation matrix and angular velocity vector to a state transformation matrix.
      static void raxisa​(double[][] r, double[] axis, double[] angle)
      Map a rotation matrix to a rotation axis and angle.
      static double[] reccyl​(double[] rectan)
      Convert from rectangular coordinates to cylindrical coordinates.
      static double[] recgeo​(double[] rectan, double Re, double f)
      Convert from rectangular coordinates to geodetic coordinates.
      static double[] reclat​(double[] rectan)
      Convert from rectangular coordinates to latitudinal coordinates.
      static double[] recpgr​(java.lang.String body, double[] rectan, double Re, double f)
      Convert from rectangular coordinates to planetographic coordinates.
      static double[] recrad​(double[] rectan)
      Convert from rectangular coordinates to RA/Dec coordinates.
      static double[] recsph​(double[] rectan)
      Convert from rectangular coordinates to spherical coordinates.
      static void reset()
      Reset SPICE error handling system.
      static double[][] rotate​(double angle, int iaxis)
      Create a matrix that rotates a reference frame by a specified angle about a specified coordinate axis.
      static double[][] rotmat​(double[][] r, double angle, int iaxis)
      Create a matrix that rotates a rotation matrix by a specified angle about a specified coordinate axis.
      static double[] rotvec​(double[] v, double angle, int iaxis)
      Transform a vector to a basis rotated by a specified angle about a specified coordinate axis.
      static double rpd()
      Return the number of radians per degree.
      static java.lang.String scdecd​(int clkid, double sclkdp)
      Convert double precision encoding of spacecraft clock time into a character representation.
      static double sce2c​(int clkid, double et)
      Convert ephemeris seconds past J2000 (ET) to continuous encoded spacecraft clock ("ticks").Non-integral tick values may be returned.
      static java.lang.String sce2s​(int clkid, double et)
      Convert ephemeris seconds past J2000 (ET) to a character string representation of an SCLK value.
      static double scencd​(int clkid, java.lang.String sclkch)
      Encode character representation of spacecraft clock time into a double precision number.
      static java.lang.String scfmt​(int sc, double sclkdp)
      Convert a tick duration to an SCLK string.
      static double scs2e​(int clkid, java.lang.String sclkch)
      Convert a spacecraft clock string to ephemeris seconds past J2000 (ET).
      static double sct2e​(int clkid, double sclkdp)
      Convert encoded spacecraft clock (`ticks') to ephemeris seconds past J2000 (ET).
      static double sctiks​(int clkid, java.lang.String clkstr)
      Convert a spacecraft clock format string to number of "ticks".
      static void sincpt​(java.lang.String method, java.lang.String target, double et, java.lang.String fixref, java.lang.String abcorr, java.lang.String obsrvr, java.lang.String dref, double[] dvec, double[] spoint, double[] trgepc, double[] srfvec, boolean[] found)
      Determine the coordinates of the surface intercept of a ray on a target body at a particular epoch, optionally corrected for planetary (light time) and stellar aberration.Also, return the epoch associated with the surface intercept and the vector from the observer to the surface intercept; this vector is expressed in the frame designated by `fixref'.
      static double spd()
      Deprecated.
      static double[] sphcyl​(double r, double colatitude, double longitude)
      Convert from spherical coordinates to cylindrical coordinates.
      static double[] sphlat​(double r, double colatitude, double longitude)
      Convert from spherical coordinates to latitudinal coordinates.
      static double[] sphrec​(double r, double colatitude, double longitude)
      Convert from spherical coordinates to rectangular coordinates.
      static void spkcls​(int handle)
      Close an SPK file.
      static double[] spkcov​(java.lang.String file, int body, int size, double[] cover)
      Return a coverage window for a specified body and SPK file.Add this coverage to that contained in an input window.
      static void spkcpo​(java.lang.String target, double et, java.lang.String outref, java.lang.String refloc, java.lang.String abcorr, double[] obspos, java.lang.String obsctr, java.lang.String obsref, double[] state, double[] lt)
      Return the state of a specified target relative to an "observer," where the observer has constant position in a specified reference frame.The observer's position is provided by the calling program rather than by loaded SPK files.
      static void spkcpt​(double[] trgpos, java.lang.String trgctr, java.lang.String trgref, double et, java.lang.String outref, java.lang.String refloc, java.lang.String abcorr, java.lang.String obsrvr, double[] state, double[] lt)
      Return the state, relative to a specified observer, of a target having constant position in a specified reference frame.The target's position is provided by the calling program rather than by loaded SPK files.
      static void spkcvo​(java.lang.String target, double et, java.lang.String outref, java.lang.String refloc, java.lang.String abcorr, double[] obssta, double obsepc, java.lang.String obsctr, java.lang.String obsref, double[] state, double[] lt)
      Return the state of a specified target relative to an "observer," where the observer has constant velocity in a specified reference frame.The observer's state is provided by the calling program rather than by loaded SPK files.
      static void spkcvt​(double[] trgsta, double trgepc, java.lang.String trgctr, java.lang.String trgref, double et, java.lang.String outref, java.lang.String refloc, java.lang.String abcorr, java.lang.String obsrvr, double[] state, double[] lt)
      Return the state, relative to a specified observer, of a target having constant velocity in a specified reference frame.The target's state is provided by the calling program rather than by loaded SPK files.
      static void spkezr​(java.lang.String target, double et, java.lang.String ref, java.lang.String abcorr, java.lang.String observer, double[] state, double[] lt)
      Return the state (position and velocity) of a target body relative to an observing body, optionally corrected for light time (planetary aberration) and stellar aberration.
      static int[] spkobj​(java.lang.String file, int size, int[] ids)
      Return an ordered array of unique ID codes of bodies for which a specified SPK file contains data.
      static int spkopn​(java.lang.String fname, java.lang.String ifname, int ncomch)
      Open a new SPK file.
      static void spkpos​(java.lang.String target, double et, java.lang.String ref, java.lang.String abcorr, java.lang.String observer, double[] pos, double[] lt)
      Return the position of a target body relative to an observing body, optionally corrected for light time (planetary aberration) and stellar aberration.
      static void spkuef​(int handle)
      Unload an SPK from the SPKBSR system.
      static void spkw02​(int handle, int body, int center, java.lang.String frame, double first, double last, java.lang.String segid, double intlen, int n, int polydg, double[] cdata, double btime)
      Write a type 2 segment to an SPK file.
      static void spkw03​(int handle, int body, int center, java.lang.String frame, double first, double last, java.lang.String segid, double intlen, int n, int polydg, double[] cdata, double btime)
      Write a type 3 segment to an SPK file.
      static void spkw05​(int handle, int body, int center, java.lang.String frame, double first, double last, java.lang.String segid, double gm, int n, double[] states, double[] epochs)
      Write a type 5 segment to an SPK file.
      static void spkw09​(int handle, int body, int center, java.lang.String frame, double first, double last, java.lang.String segid, int degree, int n, double[] states, double[] epochs)
      Write a type 9 segment to an SPK file.
      static void spkw13​(int handle, int body, int center, java.lang.String frame, double first, double last, java.lang.String segid, int degree, int n, double[] states, double[] epochs)
      Write a type 13 segment to an SPK file.
      static void srfc2s​(int code, int bodyid, java.lang.String[] srfstr, boolean[] isname)
      Translate a surface ID code, together with a body ID code, to the corresponding surface name.If no such name exists, return a string representation of the surface ID code.
      static void srfcss​(int code, java.lang.String bodstr, java.lang.String[] srfstr, boolean[] isname)
      Translate a surface ID code, together with a body string, to the corresponding surface name.If no such surface name exists, return a string representation of the surface ID code.
      static double[][] srfnrm​(java.lang.String method, java.lang.String target, double et, java.lang.String fixref, int npts, double[][] srfpts)
      Map array of surface points on a specified target body to the corresponding unit length outward surface normal vectors.The surface of the target body may be represented by a triaxial ellipsoid or by topographic data provided by DSK files.
      static void srfs2c​(java.lang.String srfstr, java.lang.String bodstr, int[] code, boolean[] found)
      Translate a surface string, together with a body string, to the corresponding surface ID code.The input strings may contain names or integer ID codes.
      static void srfscc​(java.lang.String srfstr, int bodyid, int[] code, boolean[] found)
      Translate a surface string, together with a body ID code, to the corresponding surface ID code.The input surface string may contain a name or an integer ID code.
      static double[] stelab​(double[] pobj, double[] vobs)
      Correct a position vector for reception stellar aberration.
      static double[] stlabx​(double[] pobj, double[] vobs)
      Correct a position vector for transmission stellar aberration.
      static void stpool​(java.lang.String name, int nth, java.lang.String contin, java.lang.String[] component, boolean[] found)
      Retrieve the nth string from the kernel pool variable, where the string may be continued across several components of the kernel pool variable.
      static double str2et​(java.lang.String timeString)
      Convert a string representing an epoch to a double precision value representing the number of TDB seconds past the J2000 epoch corresponding to the input epoch.
      static void subpnt​(java.lang.String method, java.lang.String target, double et, java.lang.String fixref, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, double[] trgepc, double[] srfvec)
      Determine the coordinates of the sub-observer point on a target body at a particular epoch, optionally corrected for planetary (light time) and stellar aberration.Also, return the epoch associated with the sub-observer point and the vector from the observer to the sub-observer point; this vector is expressed in the frame designated by `fixref'.
      static void subptPl02​(int handle, int[] dladsc, java.lang.String method, java.lang.String target, double et, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, double[] alt, int[] plateID)
      Compute the rectangular coordinates of the sub-observer point on a target body at a particular epoch, optionally corrected for light time and stellar aberration.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.Return the sub-observer point's coordinates expressed in the body-fixed frame associated with the target body.Also, return the observer's altitude above the target body.
      static void subslr​(java.lang.String method, java.lang.String target, double et, java.lang.String fixref, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, double[] trgepc, double[] srfvec)
      Determine the coordinates of the sub-solar point on a target body at a particular epoch, optionally corrected for planetary (light time) and stellar aberration.Also, return the epoch associated with the sub-solar point and the vector from the observer to the sub-solar point; this vector is expressed in the frame designated by `fixref'.
      static void subsolPl02​(int handle, int[] dladsc, java.lang.String method, java.lang.String target, double et, java.lang.String abcorr, java.lang.String obsrvr, double[] spoint, double[] alt, int[] plateID)
      Compute the rectangular coordinates of the sub-solar point on a target body at a particular epoch, optionally corrected for light time and stellar aberration.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.Return the sub-solar point's coordinates expressed in the body-fixed frame associated with the target body.Also, return the observer's distance from the sub-solar point.
      static double[] surfnm​(double a, double b, double c, double[] point)
      Compute the outward pointing unit normal vector at a specified point on the surface of an ellipsoid.
      static void surfpt​(double[] positn, double[] u, double a, double b, double c, double[] point, boolean[] found)
      Determine the intersection of a line-of-sight vector with the surface of an ellipsoid.
      static void swpool​(java.lang.String agent, java.lang.String[] names)
      Add a name to the list of agents to notify whenever a member of a list of kernel variables is updated.
      static double[] sxform​(java.lang.String from, java.lang.String to, double et)
      Return the state transformation matrix from one frame to another at a specified epoch.The result is returned as a 1x36 array.
      static int szpool​(java.lang.String name)
      Return the kernel pool size limitations.
      static void termPl02​(int handle, int[] dladsc, java.lang.String trmtyp, java.lang.String source, java.lang.String target, double et, java.lang.String fixfrm, java.lang.String abcorr, java.lang.String obsrvr, int npoints, double[] trgepc, double[] obspos, double[][] trmpts, int[] plateIDs)
      Compute a set of points on the umbral or penumbral terminator of a specified target body, where the target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.
      static void termpt​(java.lang.String method, java.lang.String ilusrc, java.lang.String target, double et, java.lang.String fixref, java.lang.String abcorr, java.lang.String corloc, java.lang.String obsrvr, double[] refvec, double rolstp, int ncuts, double schstp, double soltol, int maxn, int[] npts, double[][] points, double[] epochs, double[][] trmvcs)
      Find terminator points on a target body.The terminator is the set of points of tangency on the target body of planes tangent to both this body and to a light source.The caller specifies half-planes, bounded by the illumination source center-target center vector, in which to search for terminator points.The terminator can be either umbral or penumbral.The umbral terminator is the boundary of the region on the target surface where no light from the source is visible.The penumbral terminator is the boundary of the region on the target surface where none of the light from the source is blocked by the target itself.The surface of the target body may be represented either by a triaxial ellipsoid or by topographic data.
      static java.lang.String timout​(double et, java.lang.String picture)
      This routine converts an input epoch represented in TDB seconds past the TDB epoch of J2000 to a character string formatted to the specifications of a user's format picture.
      static java.lang.String tkvrsn​(java.lang.String item)
      This routine returns Toolkit version information.
      static void tparse​(java.lang.String string, double[] sp2000, java.lang.String[] errmsg)
      Parse a time string; return the result as a double precision count of seconds past J2000 in an unspecified time system.Return an error message if the input string cannot be parsed.
      static void tpictr​(java.lang.String sample, java.lang.String[] pictur, boolean[] ok, java.lang.String[] errmsg)
      Create a time format picture from an example time string.
      static void tsetyr​(int year)
      Set the lower bound of the range used to interpret a two-digit year.
      static double[][] twovec​(double[] axdef, int indexa, double[] plndef, int indexp)
      Create a matrix that transforms vectors to a reference frame defined by two specified vectors.
      static double tyear()
      Return the number of seconds in a tropical year.
      static double[] ucrss​(double[] v1, double[] v2)
      Compute the unitized cross product of two double precision, 3-dimensional vectors.
      static double unitim​(double et, java.lang.String insys, java.lang.String outsys)
      Convert between uniform time systems.
      static void unload​(java.lang.String file)
      Unload a SPICE kernel.
      static void unorm​(double[] v1, double[] vout, double[] vmag)
      Given a 3-vector, return a unitized version of the vector and the norm of the original vector.
      static double[] vcrss​(double[] v1, double[] v2)
      Compute the cross product of two double precision, 3-dimensional vectors.
      static double vdist​(double[] v1, double[] v2)
      Compute the distance between two double precision, 3-dimensional vectors.
      static double[] vhat​(double[] v1)
      Return a unit vector parallel to a given 3-dimensional vector.
      static double vnorm​(double[] v1)
      Compute the magnitude of a double precision, 3-dimensional vector.
      static double[] vperp​(double[] a, double[] b)
      Return the component of a vector perpendicular to a given 3-dimensional vector.
      static double[] vprjp​(double[] vin, double[] plane)
      Return the orthogonal projection of a vector onto a given plane.
      static void vprjpi​(double[] vin, double[] projpl, double[] invpl, double[] vout, boolean[] found)
      Return the pre-image in a given plane of the orthogonal projection of a vector onto a given plane.
      static double[] vproj​(double[] a, double[] b)
      Return the projection of a vector onto a given 3-dimensional vector.
      static double[] vrotv​(double[] v1, double[] axis, double theta)
      Rotate a vector about a given 3-dimensional vector.
      static double vsep​(double[] v1, double[] v2)
      Compute the angular separation between two double precision, 3-dimensional vectors.
      static double[] wncomd​(double left, double right, double[] window)
      Compute the complement with respect to a specified interval of a CSPICE window.
      static double[] wncond​(double left, double right, double[] window)
      Contract each of the intervals of a CSPICE window.
      static double[] wndifd​(double[] a, double[] b)
      Compute the difference of two CSPICE windows.
      static boolean wnelmd​(double point, double[] window)
      Determine whether a point is contained in a specified CSPICE window.
      static double[] wnexpd​(double left, double right, double[] window)
      Expand each of the intervals of a CSPICE window.
      static double[] wnextd​(java.lang.String side, double[] window)
      Extract the left or right endpoints from a CSPICE window.
      static double[] wnfild​(double small, double[] window)
      Fill small gaps between adjacent intervals of a CSPICE window.
      static double[] wnfltd​(double small, double[] window)
      Filter small intervals from a CSPICE window.
      static boolean wnincd​(double left, double right, double[] window)
      Determine whether an interval is included in a CSPICE window.
      static double[] wninsd​(double left, double right, double[] window)
      Insert an interval into a CSPICE window.
      static double[] wnintd​(double[] a, double[] b)
      Compute the intersection of two CSPICE windows.
      static boolean wnreld​(double[] a, java.lang.String op, double[] b)
      Compare two SPICE windows.
      static void wnsumd​(double[] window, double[] meas, double[] avg, double[] stddev, int[] shortest, int[] longest)
      Summarize the contents of a SPICE window.
      static double[] wnunid​(double[] a, double[] b)
      Compute the union of two CSPICE windows.
      static double[] wnvald​(int size, int card, double[] endpoints)
      Validate a CSPICE window.
      static void xf2eul​(double[] xform, int[] axes, double[] angles, boolean[] unique)
      Convert a state transformation matrix and a sequence of axes to a sequence of Euler angles and corresponding rates.
      static void xf2rav​(double[] xform, double[][] r, double[] av)
      Convert a state transformation matrix and a sequence of axes to a sequence of Euler angles and corresponding rates.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • CSPICE

        public CSPICE()
    • Method Detail

      • axisar

        public static double[][] axisar​(double[] axis,
                                        double angle)
                                 throws SpiceErrorException
        Compute a rotation matrix from a rotation axis and angle.
        Parameters:
        axis - double[]
        angle - double double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • b1900

        public static double b1900()
        Return the Julian Date corresponding to Besselian Date 1900.0.
        Returns:
        double
      • b1950

        public static double b1950()
        Return the Julian Date corresponding to Besselian Date 1950.0.
        Returns:
        double
      • badkpv

        public static boolean badkpv​(java.lang.String caller,
                                     java.lang.String name,
                                     java.lang.String comp,
                                     int size,
                                     int divby,
                                     java.lang.String type)
                              throws SpiceErrorException
        Throw an exception if a given kernel variable does not have specified attributes.
        Parameters:
        caller - String
        type - String
        name - String
        divby - int
        comp - String
        size - int
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • bodc2s

        public static java.lang.String bodc2s​(int code)
                                       throws SpiceErrorException
        Translate the SPICE integer code of a body into a common name for that body, or a string representation of the code if no name is associated with the code.
        Parameters:
        code - int
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • bodfnd

        public static boolean bodfnd​(int code,
                                     java.lang.String item)
                              throws SpiceErrorException
        Determine whether values exist for some item for any body in the kernel pool.
        Parameters:
        code - int
        item - String
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • bodvcd

        public static double[] bodvcd​(int body,
                                      java.lang.String item)
                               throws SpiceErrorException
        Return the values of some item for any body in the kernel pool.
        Parameters:
        body - String int
        item - String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • ccifrm

        public static void ccifrm​(int frclss,
                                  int clssid,
                                  int[] frcode,
                                  java.lang.String[] frname,
                                  int[] center,
                                  boolean[] found)
                           throws SpiceErrorException
        Map a frame class and frame class ID to a reference frame ID code, name, and center.
        Parameters:
        frclss - int
        found - boolean[] boolean[]
        clssid - int
        center - int int[]
        frcode - int[]
        frname - String[]
        Throws:
        SpiceErrorException - exception
      • cgv2el

        public static double[] cgv2el​(double[] center,
                                      double[] gv1,
                                      double[] gv2)
                               throws SpiceErrorException
        Create a SPICE ellipse from a center and generating vectors.
        Parameters:
        center - int double[]
        gv2 - double[]
        gv1 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • ckcov

        public static double[] ckcov​(java.lang.String ck,
                                     int idcode,
                                     boolean needav,
                                     java.lang.String level,
                                     double tol,
                                     java.lang.String timsys,
                                     int size,
                                     double[] cover)
                              throws SpiceErrorException
        Return a coverage window for a specified instrument and CK file.Add this coverage to that contained in an input window.
        Parameters:
        ck - String
        cover - double[]
        idcode - int
        size - int
        needav - boolean
        timsys - String
        level - String
        tol - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • ckgp

        public static void ckgp​(int inst,
                                double sclkdp,
                                double tol,
                                java.lang.String ref,
                                double[][] cmat,
                                double[] clkout,
                                boolean[] found)
                         throws SpiceErrorException
        Get instrument pointing for a specified spacecraft clock time.
        Parameters:
        inst - int
        found - boolean[] boolean[]
        sclkdp - double double
        clkout - double[]
        tol - double
        cmat - double[][]
        ref - String String
        Throws:
        SpiceErrorException - exception
      • ckgpav

        public static void ckgpav​(int inst,
                                  double sclkdp,
                                  double tol,
                                  java.lang.String ref,
                                  double[][] cmat,
                                  double[] av,
                                  double[] clkout,
                                  boolean[] found)
                           throws SpiceErrorException
        Get instrument pointing and angular velocity for a specified spacecraft clock time.
        Parameters:
        inst - int
        found - boolean[] boolean[]
        sclkdp - double double
        clkout - double[]
        tol - double
        av - double[]
        ref - String String
        cmat - double[][]
        Throws:
        SpiceErrorException - exception
      • ckmeta

        public static int ckmeta​(int CKID,
                                 java.lang.String meta)
                          throws SpiceErrorException
        Return the SCLK or SPK ID associated with an instrument ID code.
        Parameters:
        CKID - int
        meta - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • ckobj

        public static int[] ckobj​(java.lang.String file,
                                  int size,
                                  int[] ids)
                           throws SpiceErrorException
        Return an ordered array of unique ID codes of instruments for which a specified CK file contains data.
        Parameters:
        file - String
        ids - int[]
        size - int
        Returns:
        int[]
        Throws:
        SpiceErrorException - exception
      • ckopn

        public static int ckopn​(java.lang.String fname,
                                java.lang.String ifname,
                                int ncomch)
                         throws SpiceErrorException
        Open a new CK file.
        Parameters:
        fname - String
        ncomch - int
        ifname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • ckw01

        public static void ckw01​(int handle,
                                 double begtim,
                                 double endtim,
                                 int inst,
                                 java.lang.String ref,
                                 boolean avflag,
                                 java.lang.String segid,
                                 int nrec,
                                 double[] sclkdp,
                                 double[] quats,
                                 double[] avvs)
                          throws SpiceErrorException
        Write a type 1 segment to a CK file.
        Parameters:
        handle - int int
        avvs - double[]
        begtim - double
        quats - double[]
        endtim - double
        sclkdp - double double[]
        inst - int
        nrec - int
        ref - String String
        segid - String String
        avflag - boolean
        Throws:
        SpiceErrorException - exception
      • ckw02

        public static void ckw02​(int handle,
                                 double begtim,
                                 double endtim,
                                 int inst,
                                 java.lang.String ref,
                                 java.lang.String segid,
                                 int nrec,
                                 double[] start,
                                 double[] stop,
                                 double[] quats,
                                 double[] avvs,
                                 double[] rates)
                          throws SpiceErrorException
        Write a type 2 segment to a CK file.
        Parameters:
        handle - int int
        rates - double[]
        begtim - double
        avvs - double[]
        endtim - double
        quats - double[]
        inst - int
        stop - double[]
        ref - String String
        start - double[]
        segid - String String
        nrec - int
        Throws:
        SpiceErrorException - exception
      • ckw03

        public static void ckw03​(int handle,
                                 double begtim,
                                 double endtim,
                                 int inst,
                                 java.lang.String ref,
                                 boolean avflag,
                                 java.lang.String segid,
                                 int nrec,
                                 double[] sclkdp,
                                 double[] quats,
                                 double[] avvs,
                                 int nints,
                                 double[] starts)
                          throws SpiceErrorException
        Write a type 3 segment to a CK file.
        Parameters:
        handle - int int
        starts - double[]
        begtim - double
        nints - int
        endtim - double
        avvs - double[]
        inst - int
        quats - double[]
        ref - String String
        sclkdp - double double[]
        avflag - boolean
        nrec - int
        segid - String String
        Throws:
        SpiceErrorException - exception
      • clight

        public static double clight()
        Return the speed of light.
        Returns:
        double
      • conics

        public static double[] conics​(double[] elts,
                                      double et)
                               throws SpiceErrorException
        Convert conic elements to a state at a given epoch.
        Parameters:
        elts - double[]
        et - double double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • convrt

        public static double convrt​(double x,
                                    java.lang.String in,
                                    java.lang.String out)
                             throws SpiceErrorException
        Convert a measurement from one physical unit to another.
        Parameters:
        x - double
        out - String
        in - String
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • cvpool

        public static boolean cvpool​(java.lang.String agent)
                              throws SpiceErrorException
        Determine whether or not any of the variables that are to be watched and have a specified agent on their distribution list have been updated.
        Parameters:
        agent - String
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • cyllat

        public static double[] cyllat​(double r,
                                      double lon,
                                      double z)
                               throws SpiceErrorException
        Convert from cylindrical coordinates to latitudinal coordinates.
        Parameters:
        r - double
        z - double
        lon - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • cylrec

        public static double[] cylrec​(double r,
                                      double lon,
                                      double z)
                               throws SpiceErrorException
        Convert from cylindrical coordinates to rectangular coordinates.
        Parameters:
        r - double
        z - double
        lon - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • cylsph

        public static double[] cylsph​(double r,
                                      double lon,
                                      double z)
                               throws SpiceErrorException
        Convert from cylindrical coordinates to spherical coordinates.
        Parameters:
        r - double
        z - double
        lon - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dafac

        public static void dafac​(int handle,
                                 java.lang.String[] buffer)
                          throws SpiceErrorException
        Add comments from a buffer to a DAF.
        Parameters:
        handle - int int
        buffer - String[]
        Throws:
        SpiceErrorException - exception
      • dafbbs

        public static void dafbbs​(int handle)
                           throws SpiceErrorException
        Begin a backward search for arrays in a DAF.
        Parameters:
        handle - int int
        Throws:
        SpiceErrorException - exception
      • dafbfs

        public static void dafbfs​(int handle)
                           throws SpiceErrorException
        Begin a forward search for arrays in a DAF.
        Parameters:
        handle - int int
        Throws:
        SpiceErrorException - exception
      • dafcls

        public static void dafcls​(int handle)
                           throws SpiceErrorException
        Close the DAF associated with a given handle.
        Parameters:
        handle - int int
        Throws:
        SpiceErrorException - exception
      • dafcs

        public static void dafcs​(int handle)
                          throws SpiceErrorException
        Select a DAF that already has a search in progress as the one to continue searching.
        Parameters:
        handle - int int
        Throws:
        SpiceErrorException - exception
      • dafec

        public static void dafec​(int handle,
                                 int bufsiz,
                                 int lenout,
                                 int[] n,
                                 java.lang.String[] buffer,
                                 boolean[] done)
                          throws SpiceErrorException
        Extract comments from a DAF into a buffer.
        Parameters:
        handle - int int
        done - boolean[]
        bufsiz - int
        buffer - String[]
        lenout - int
        n - int[]
        Throws:
        SpiceErrorException - exception
      • dafgda

        public static double[] dafgda​(int handle,
                                      int begin,
                                      int end)
                               throws SpiceErrorException
        Return double precision data from the specified address range.
        Parameters:
        handle - int int
        end - int
        begin - int
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dafgn

        public static java.lang.String dafgn()
                                      throws SpiceErrorException
        Return (get) the name for the current array in the current DAF.
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • dafgs

        public static double[] dafgs​(int size)
                              throws SpiceErrorException
        Return (get) the summary for the current array in the current DAF.
        Parameters:
        size - int
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dafopr

        public static int dafopr​(java.lang.String fname)
                          throws SpiceErrorException
        Open a DAF for subsequent read requests.
        Parameters:
        fname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • dafopw

        public static int dafopw​(java.lang.String fname)
                          throws SpiceErrorException
        Open a DAF for writing.
        Parameters:
        fname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • dafrcr

        public static java.lang.String dafrcr​(int handle,
                                              int recno)
                                       throws SpiceErrorException
        Read a DAF character record.
        Parameters:
        handle - int int
        recno - int
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • dafrfr

        public static void dafrfr​(int handle,
                                  int[] nd,
                                  int[] ni,
                                  java.lang.String[] ifname,
                                  int[] fward,
                                  int[] bward,
                                  int[] free)
                           throws SpiceErrorException
        Obtain a file record object from a DAF.
        Parameters:
        handle - int int
        free - int[]
        nd - int[]
        bward - int[]
        ni - int[]
        fward - int[]
        ifname - String[]
        Throws:
        SpiceErrorException - exception
      • dafus

        public static void dafus​(double[] sum,
                                 int nd,
                                 int ni,
                                 double[] dc,
                                 int[] ic)
                          throws SpiceErrorException
        Unpack a DAF summary.
        Parameters:
        sum - double[]
        ic - int[]
        nd - int
        dc - double[]
        ni - int
        Throws:
        SpiceErrorException - exception
      • dascls

        public static void dascls​(int handle)
                           throws SpiceErrorException
        Close the DAS file associated with a given handle.
        Parameters:
        handle - int int
        Throws:
        SpiceErrorException - exception
      • dasac

        public static void dasac​(int handle,
                                 java.lang.String[] buffer)
                          throws SpiceErrorException
        Append buffered comments to a DAS file.
        Parameters:
        handle - int int
        buffer - String[]
        Throws:
        SpiceErrorException - exception
      • dasec

        public static void dasec​(int handle,
                                 int bufsiz,
                                 int lenout,
                                 int[] n,
                                 java.lang.String[] buffer,
                                 boolean[] done)
                          throws SpiceErrorException
        Extract comments from a DAS file into a buffer.
        Parameters:
        handle - int int
        done - boolean[]
        bufsiz - int
        buffer - String[]
        lenout - int
        n - int[]
        Throws:
        SpiceErrorException - exception
      • dashfn

        public static java.lang.String dashfn​(int handle)
                                       throws SpiceErrorException
        Map a DAS file handle to the corresponding file name.
        Parameters:
        handle - int int
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • dasopr

        public static int dasopr​(java.lang.String fname)
                          throws SpiceErrorException
        Open a DAS file for subsequent read requests.
        Parameters:
        fname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • dasopw

        public static int dasopw​(java.lang.String fname)
                          throws SpiceErrorException
        Open a DAS file for write access.
        Parameters:
        fname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • dasrfr

        public static void dasrfr​(int handle,
                                  java.lang.String[] idword,
                                  java.lang.String[] ifname,
                                  int[] nresvr,
                                  int[] nresvc,
                                  int[] ncomr,
                                  int[] ncomc)
                           throws SpiceErrorException
        Read file record paramters from a DAS file.
        Parameters:
        handle - int int
        ncomc - int[]
        idword - String[]
        ncomr - int[]
        ifname - String[]
        nresvc - int[]
        nresvr - int[]
        Throws:
        SpiceErrorException - exception
      • dcyldr

        public static double[][] dcyldr​(double x,
                                        double y,
                                        double z)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the rectangular to cylindrical transformation.
        Parameters:
        x - double
        z - double
        y - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • deltet

        public static double deltet​(double epoch,
                                    java.lang.String eptype)
                             throws SpiceErrorException
        Return the difference between TDB and UTC at a specified epoch.
        Parameters:
        epoch - double
        eptype - String
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • det

        public static double det​(double[][] m)
                          throws SpiceErrorException
        Return the determinant of a 3x3 matrix.
        Parameters:
        m - double[][]
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • dgeodr

        public static double[][] dgeodr​(double x,
                                        double y,
                                        double z,
                                        double re,
                                        double f)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the rectangular to geodetic transformation.
        Parameters:
        x - double
        f - double
        y - double
        re - double
        z - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • dlabbs

        public static void dlabbs​(int handle,
                                  int[] descr,
                                  boolean[] found)
                           throws SpiceErrorException
        Begin a backward search for arrays in a DLA.
        Parameters:
        handle - int int
        found - boolean[] boolean[]
        descr - int[]
        Throws:
        SpiceErrorException - exception
      • dlabfs

        public static void dlabfs​(int handle,
                                  int[] descr,
                                  boolean[] found)
                           throws SpiceErrorException
        Begin a forward search for arrays in a DLA.
        Parameters:
        handle - int int
        found - boolean[] boolean[]
        descr - int[]
        Throws:
        SpiceErrorException - exception
      • dlafns

        public static void dlafns​(int handle,
                                  int[] descr,
                                  int[] nxtdsc,
                                  boolean[] found)
                           throws SpiceErrorException
        Find the next (forward) segment in a DLA.
        Parameters:
        handle - int int
        found - boolean[] boolean[]
        descr - int[]
        nxtdsc - int[]
        Throws:
        SpiceErrorException - exception
      • dlafps

        public static void dlafps​(int handle,
                                  int[] descr,
                                  int[] prvdsc,
                                  boolean[] found)
                           throws SpiceErrorException
        Find the previous (backward) segment in a DLA.
        Parameters:
        handle - int int
        found - boolean[] boolean[]
        descr - int[]
        prvdsc - int[]
        Throws:
        SpiceErrorException - exception
      • dlatdr

        public static double[][] dlatdr​(double x,
                                        double y,
                                        double z)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the rectangular to latitudinal transformation.
        Parameters:
        x - double
        z - double
        y - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • dpgrdr

        public static double[][] dpgrdr​(java.lang.String body,
                                        double x,
                                        double y,
                                        double z,
                                        double re,
                                        double f)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the rectangular to planetographic transformation.
        Parameters:
        body - String String
        f - double
        x - double
        re - double
        y - double
        z - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • dpr

        public static double dpr()
        Return the number of degrees per radian.
        Returns:
        double
      • drdcyl

        public static double[][] drdcyl​(double radius,
                                        double longitude,
                                        double z)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the cylindrical to rectangular transformation.
        Parameters:
        radius - double double
        z - double
        longitude - double double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • drdgeo

        public static double[][] drdgeo​(double longitude,
                                        double latitude,
                                        double altitude,
                                        double re,
                                        double f)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the geodetic to rectangular transformation.
        Parameters:
        longitude - double double
        f - double
        latitude - double double
        re - double
        altitude - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • drdlat

        public static double[][] drdlat​(double radius,
                                        double longitude,
                                        double latitude)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the latitudinal to rectangular transformation.
        Parameters:
        radius - double double
        latitude - double double
        longitude - double double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • drdpgr

        public static double[][] drdpgr​(java.lang.String body,
                                        double longitude,
                                        double latitude,
                                        double altitude,
                                        double re,
                                        double f)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the planetographic to rectangular transformation.
        Parameters:
        body - String String
        f - double
        longitude - double double
        re - double
        latitude - double double
        altitude - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • drdsph

        public static double[][] drdsph​(double radius,
                                        double colatitude,
                                        double longitude)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the spherical to rectangular transformation.
        Parameters:
        radius - double double
        longitude - double double
        colatitude - double double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • dskb02

        public static void dskb02​(int handle,
                                  int[] dladsc,
                                  int[] nv,
                                  int[] np,
                                  int[] nvxtot,
                                  double[][] vtxbds,
                                  double[] voxsiz,
                                  double[] voxori,
                                  int[] vgrext,
                                  int[] cgscal,
                                  int[] vtxnpl,
                                  int[] voxnpt,
                                  int[] voxnpl)
                           throws SpiceErrorException
        Return bookkeeping data from a DSK type 2 segment.
        Parameters:
        handle - int int
        voxnpl - int[]
        dladsc - int[] int[]
        voxnpt - int[]
        nv - int[]
        vtxnpl - int[]
        np - int[]
        cgscal - int[]
        nvxtot - int[]
        vgrext - int[]
        vtxbds - double[][]
        voxori - double[]
        voxsiz - double[]
        Throws:
        SpiceErrorException - exception
      • dskd02

        public static double[] dskd02​(int handle,
                                      int[] dladsc,
                                      int item,
                                      int start,
                                      int room)
                               throws SpiceErrorException
        Fetch double precision data from a type 2 DSK segment.
        Parameters:
        handle - int int
        room - int
        dladsc - int[] int[]
        start - int
        item - int
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dskgd

        public static double[] dskgd​(int handle,
                                     int[] dladsc)
                              throws SpiceErrorException
        Return the DSK descriptor from a DSK segment identified by a DAS handle and DLA descriptor.
        Parameters:
        handle - int int
        dladsc - int[] int[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dskgtl

        public static double dskgtl​(int keywrd)
                             throws SpiceErrorException
        Retrieve the value of a specified DSK tolerance or margin parameter.
        Parameters:
        keywrd - int
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • dski02

        public static int[] dski02​(int handle,
                                   int[] dladsc,
                                   int item,
                                   int start,
                                   int room)
                            throws SpiceErrorException
        Fetch integer data from a type 2 DSK segment.
        Parameters:
        handle - int int
        room - int
        dladsc - int[] int[]
        start - int
        item - int
        Returns:
        int[]
        Throws:
        SpiceErrorException - exception
      • dskmi2

        public static void dskmi2​(int nv,
                                  double[] vrtces,
                                  int np,
                                  int[] plates,
                                  double finscl,
                                  int corscl,
                                  int worksz,
                                  int voxpsz,
                                  int voxlsz,
                                  boolean makvtl,
                                  int spxisz,
                                  double[] spaixd,
                                  int[] spaixi)
                           throws SpiceErrorException
        Make spatial index for a DSK type 2 segment.The index is returned as a pair of arrays, one of type SpiceInt and one of type SpiceDouble.These arrays are suitable for use with the DSK type 2 writer CSPICE.dskw02.
        Parameters:
        nv - int
        spaixi - int[]
        vrtces - double[]
        spaixd - double[]
        np - int
        spxisz - int
        plates - int[]
        makvtl - boolean
        finscl - double
        voxlsz - int
        corscl - int
        voxpsz - int
        worksz - int
        Throws:
        SpiceErrorException - exception
      • dskn02

        public static double[] dskn02​(int handle,
                                      int[] dladsc,
                                      int plid)
                               throws SpiceErrorException
        Compute the unit normal vector for a specified plate from a type 2 DSK segment.
        Parameters:
        handle - int int
        plid - int
        dladsc - int[] int[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dskobj

        public static int[] dskobj​(java.lang.String dsk,
                                   int size,
                                   int[] ids)
                            throws SpiceErrorException
        Find the set of body ID codes of all objects for which topographic data are provided in a specified DSK file.
        Parameters:
        dsk - String
        ids - int[]
        size - int
        Returns:
        int[]
        Throws:
        SpiceErrorException - exception
      • dskopn

        public static int dskopn​(java.lang.String fname,
                                 java.lang.String ifname,
                                 int ncomch)
                          throws SpiceErrorException
        Open a new DSK file for subsequent write operations.
        Parameters:
        fname - String
        ncomch - int
        ifname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • dskp02

        public static int[][] dskp02​(int handle,
                                     int[] dladsc,
                                     int start,
                                     int room)
                              throws SpiceErrorException
        Fetch plates from a type 2 DSK segment.
        Parameters:
        handle - int int
        room - int
        dladsc - int[] int[]
        start - int
        Returns:
        int[][]
        Throws:
        SpiceErrorException - exception
      • dskrb2

        public static void dskrb2​(int nv,
                                  double[] vrtces,
                                  int np,
                                  int[] plates,
                                  int corsys,
                                  double[] corpar,
                                  double[] mncor3,
                                  double[] mxcor3)
                           throws SpiceErrorException
        Derive range bounds on third coordinate for a plate set.Note that the plate and vertex arrays are 1-dimensional.
        Parameters:
        nv - int
        mxcor3 - double[]
        vrtces - double[]
        mncor3 - double[]
        np - int
        corpar - double[]
        plates - int[]
        corsys - int
        Throws:
        SpiceErrorException - exception
      • dskstl

        public static void dskstl​(int keywrd,
                                  double dpval)
                           throws SpiceErrorException
        Set the value of a specified DSK tolerance or margin parameter.
        Parameters:
        keywrd - int
        dpval - double
        Throws:
        SpiceErrorException - exception
      • dsksrf

        public static int[] dsksrf​(java.lang.String dsk,
                                   int bodyid,
                                   int size,
                                   int[] srfids)
                            throws SpiceErrorException
        Find the set of surface ID codes for all surfaces associated with a given body in a specified DSK file.
        Parameters:
        dsk - String
        srfids - int[]
        bodyid - int
        size - int
        Returns:
        int[]
        Throws:
        SpiceErrorException - exception
      • dskv02

        public static double[][] dskv02​(int handle,
                                        int[] dladsc,
                                        int start,
                                        int room)
                                 throws SpiceErrorException
        Fetch vertices from a type 2 DSK segment.
        Parameters:
        handle - int int
        room - int
        dladsc - int[] int[]
        start - int
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • dskw02

        public static void dskw02​(int handle,
                                  int center,
                                  int surfce,
                                  int dclass,
                                  java.lang.String frame,
                                  int corsys,
                                  double[] corpar,
                                  double mncor1,
                                  double mxcor1,
                                  double mncor2,
                                  double mxcor2,
                                  double mncor3,
                                  double mxcor3,
                                  double first,
                                  double last,
                                  int nv,
                                  double[] vrtces,
                                  int np,
                                  int[] plates,
                                  double[] spaixd,
                                  int[] spaixi)
                           throws SpiceErrorException
        Write a type 2 segment to a DSK file.Note that the plate and vertex arrays are 1-dimensional.
        Parameters:
        handle - int int
        spaixi - int[]
        center - int int
        spaixd - double[]
        surfce - int
        plates - int[]
        dclass - int
        np - int
        frame - String String
        vrtces - double[]
        corsys - int
        nv - int
        corpar - double[]
        last - double double
        mncor1 - double
        first - double double
        mxcor1 - double
        mxcor3 - double
        mncor2 - double
        mncor3 - double
        mxcor2 - double
        Throws:
        SpiceErrorException - exception
      • dskx02

        public static void dskx02​(int handle,
                                  int[] dladsc,
                                  double[] vertex,
                                  double[] raydir,
                                  int[] plid,
                                  double[] xpt,
                                  boolean[] found)
                           throws SpiceErrorException
        Determine the plate ID and body-fixed coordinates of the intersection of a specified ray with the surface defined by a type 2 DSK plate model.
        Parameters:
        handle - int int
        found - boolean[] boolean[]
        dladsc - int[] int[]
        xpt - double[] double[]
        vertex - double[] double[]
        plid - int[]
        raydir - double[]
        Throws:
        SpiceErrorException - exception
      • dskxsi

        public static void dskxsi​(boolean pri,
                                  java.lang.String target,
                                  int nsurf,
                                  int[] srflst,
                                  double et,
                                  java.lang.String fixref,
                                  double[] vertex,
                                  double[] raydir,
                                  int maxd,
                                  int maxi,
                                  double[] xpt,
                                  int[] handle,
                                  int[] dladsc,
                                  double[] dskdsc,
                                  double[] dc,
                                  int[] ic,
                                  boolean[] found)
                           throws SpiceErrorException
        Compute a ray-surface intercept using data provided by multiple loaded DSK segments.Return information about the source of the data defining the surface on which the intercept was found: DSK handle, DLA and DSK descriptors, and DSK data type-dependent parameters.
        Parameters:
        pri - boolean
        found - boolean[] boolean[]
        target - String String
        ic - int[]
        nsurf - int
        dc - double[]
        srflst - int[]
        dskdsc - double[]
        et - double double
        dladsc - int[] int[]
        fixref - String String
        handle - int int[]
        vertex - double[] double[]
        xpt - double[] double[]
        raydir - double[]
        maxi - int
        maxd - int
        Throws:
        SpiceErrorException - exception
      • dskxv

        public static void dskxv​(boolean pri,
                                 java.lang.String target,
                                 int nsurf,
                                 int[] srflst,
                                 double et,
                                 java.lang.String fixref,
                                 int nrays,
                                 double[][] vtxarr,
                                 double[][] dirarr,
                                 double[][] xptarr,
                                 boolean[] fndarr)
                          throws SpiceErrorException
        Compute ray-surface intercepts for a set of rays, using data provided by multiple loaded DSK segments.
        Parameters:
        pri - boolean
        fndarr - boolean[]
        target - String String
        nsurf - int
        srflst - int[]
        vtxarr - double[][]
        dirarr - double[][]
        xptarr - double[][]
        et - double double
        nrays - int
        fixref - String String
        Throws:
        SpiceErrorException - exception
      • dskz02

        public static void dskz02​(int handle,
                                  int[] dladsc,
                                  int[] nv,
                                  int[] np)
                           throws SpiceErrorException
        Return plate model size parameters---plate count and vertex count---for a type 2 DSK segment.
        Parameters:
        handle - int int
        np - int[]
        dladsc - int[] int[]
        nv - int[]
        Throws:
        SpiceErrorException - exception
      • dsphdr

        public static double[][] dsphdr​(double x,
                                        double y,
                                        double z)
                                 throws SpiceErrorException
        Return the Jacobian matrix of the rectangular to spherical transformation.
        Parameters:
        x - double
        z - double
        y - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • dtpool

        public static void dtpool​(java.lang.String name,
                                  boolean[] found,
                                  int[] n,
                                  java.lang.String[] type)
                           throws SpiceErrorException
        Return type and dimension attributes of a kernel pool variable.
        Parameters:
        name - String
        type - String[]
        found - boolean[] boolean[]
        n - int[]
        Throws:
        SpiceErrorException - exception
      • dvcrss

        public static double[] dvcrss​(double[] s1,
                                      double[] s2)
                               throws SpiceErrorException
        Return the derivative of the cross product of two vectors.
        Parameters:
        s1 - double[]
        s2 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dvdot

        public static double dvdot​(double[] s1,
                                   double[] s2)
                            throws SpiceErrorException
        Return the derivative of the dot product of two vectors.
        Parameters:
        s1 - double[]
        s2 - double[]
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • dvhat

        public static double[] dvhat​(double[] s1)
                              throws SpiceErrorException
        Return the unit vector defined by a state vector and corresponding derivative.
        Parameters:
        s1 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • dvsep

        public static double dvsep​(double[] s1,
                                   double[] s2)
                            throws SpiceErrorException
        Return the derivative of the angular separation of two vectors.
        Parameters:
        s1 - double[]
        s2 - double[]
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • edlimb

        public static double[] edlimb​(double a,
                                      double b,
                                      double c,
                                      double[] viewpt)
                               throws SpiceErrorException
        Find the limb of a tri-axial ellipsoid as seen from a specified point.
        Parameters:
        a - double
        viewpt - double[]
        b - double
        c - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • el2cgv

        public static void el2cgv​(double[] ellipse,
                                  double[] center,
                                  double[] smajor,
                                  double[] sminor)
                           throws SpiceErrorException
        Create a center and generating vectors from a SPICE ellipse.
        Parameters:
        ellipse - double[]
        sminor - double[]
        center - int double[]
        smajor - double[]
        Throws:
        SpiceErrorException - exception
      • eqstr

        @Deprecated
        public static boolean eqstr​(java.lang.String a,
                                    java.lang.String b)
                             throws SpiceErrorException
        Deprecated.
        Determine whether two strings are equivalent.
        Parameters:
        a - String
        b - String
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • erract

        public static java.lang.String erract​(java.lang.String op,
                                              java.lang.String action)
                                       throws SpiceErrorException
        Set or retrieve the default error action.
        Parameters:
        op - String
        action - String
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • errdev

        public static java.lang.String errdev​(java.lang.String op,
                                              java.lang.String device)
                                       throws SpiceErrorException
        Set or retrieve the default error device.
        Parameters:
        op - String
        device - String
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • et2lst

        public static void et2lst​(double et,
                                  int body,
                                  double lon,
                                  java.lang.String type,
                                  int[] hr,
                                  int[] min,
                                  int[] sec,
                                  java.lang.String[] time,
                                  java.lang.String[] ampm)
                           throws SpiceErrorException
        Convert an input time from ephemeris seconds past J2000 to local solar time at a specified location on a specified body.
        Parameters:
        et - double double
        ampm - String[]
        body - String int
        time - String[]
        lon - double
        sec - int[]
        type - String
        min - int[]
        hr - int[]
        Throws:
        SpiceErrorException - exception
      • et2utc

        public static java.lang.String et2utc​(double et,
                                              java.lang.String format,
                                              int prec)
                                       throws SpiceErrorException
        Convert an input time from ephemeris seconds past J2000 to Calendar, Day-of-Year, or Julian Date format, UTC.
        Parameters:
        et - double double
        prec - int
        format - String
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • etcal

        public static java.lang.String etcal​(double et)
                                      throws SpiceErrorException
        Convert an input time from ephemeris seconds past J2000 to a fixed format calendar TDB string.
        Parameters:
        et - double double
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • eul2m

        public static double[][] eul2m​(double[] angles,
                                       int[] axes)
                                throws SpiceErrorException
        Convert a sequence of Euler angles and axes to a rotation matrix.
        Parameters:
        angles - double[]
        axes - int[]
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • eul2xf

        public static double[] eul2xf​(double[] angles,
                                      int[] axes)
                               throws SpiceErrorException
        Convert a sequence of Euler angles, rates, and axes to a state transformation matrix.
        Parameters:
        angles - double[]
        axes - int[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • frinfo

        public static void frinfo​(int frameID,
                                  int[] centerID,
                                  int[] frclass,
                                  int[] frclassID,
                                  boolean[] found)
                           throws SpiceErrorException
        Look up the frame specification parameters associated with a frame ID code.
        Parameters:
        frameID - int
        found - boolean[]
        centerID - int[]
        frclassID - int[]
        frclass - int[]
        Throws:
        SpiceErrorException - exception
      • frmnam

        public static java.lang.String frmnam​(int code)
                                       throws SpiceErrorException
        Look up the frame name associated with a frame ID code.
        Parameters:
        code - int
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • furnsh

        public static void furnsh​(java.lang.String file)
                           throws SpiceErrorException
        Furnish a program with the kernels and related data needed to carry out the program's computations.
        Parameters:
        file - String
        Throws:
        SpiceErrorException - exception
      • georec

        public static double[] georec​(double longitude,
                                      double latitude,
                                      double altitude,
                                      double re,
                                      double f)
                               throws SpiceErrorException
        Convert from geodetic coordinates to rectangular coordinates.
        Parameters:
        longitude - double double
        f - double
        latitude - double double
        re - double
        altitude - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • getfat

        public static void getfat​(java.lang.String file,
                                  java.lang.String[] arch,
                                  java.lang.String[] type)
                           throws SpiceErrorException
        Determine the file architecture and file type of most SPICE kernel files.
        Parameters:
        file - String
        type - String[]
        arch - String[]
        Throws:
        SpiceErrorException - exception
      • getfov

        public static void getfov​(int instID,
                                  java.lang.String[] shape,
                                  java.lang.String[] ref,
                                  double[] bsight,
                                  int[] size,
                                  double[] bounds)
                           throws SpiceErrorException
        Return the field-of-view (FOV) configuration for a specified instrument.
        Parameters:
        instID - int
        bounds - double[]
        shape - String[]
        size - int[]
        ref - String String[]
        bsight - double[]
        Throws:
        SpiceErrorException - exception
      • gfdist

        public static double[] gfdist​(java.lang.String target,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      java.lang.String relate,
                                      double refval,
                                      double adjust,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF distance search.
        Parameters:
        target - String String
        cnfine - double[]
        abcorr - String String
        nintvls - int
        obsrvr - String String
        step - double
        relate - String
        adjust - double
        refval - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfilum

        public static double[] gfilum​(java.lang.String method,
                                      java.lang.String angtyp,
                                      java.lang.String target,
                                      java.lang.String illmn,
                                      java.lang.String fixref,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      double[] spoint,
                                      java.lang.String relate,
                                      double refval,
                                      double adjust,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF illumination angle search.
        Parameters:
        method - String String
        cnfine - double[]
        angtyp - String
        nintvls - int
        target - String String
        step - double
        illmn - String
        adjust - double
        fixref - String String
        refval - double
        abcorr - String String
        relate - String
        obsrvr - String String
        spoint - double[] double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfocce

        public static double[] gfocce​(java.lang.String occtyp,
                                      java.lang.String front,
                                      java.lang.String fshape,
                                      java.lang.String fframe,
                                      java.lang.String back,
                                      java.lang.String bshape,
                                      java.lang.String bframe,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      int nintvls,
                                      double[] cnfine,
                                      GFSearchUtils utils)
                               throws SpiceErrorException
        Perform a custom GF occultation search using user-specified step and refinement functions.
        Parameters:
        occtyp - String
        utils - GFSearchUtils
        front - String
        cnfine - double[]
        fshape - String
        nintvls - int
        fframe - String
        obsrvr - String String
        back - String
        abcorr - String String
        bshape - String
        bframe - String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • pckcov

        public static double[] pckcov​(java.lang.String file,
                                      int classID,
                                      int size,
                                      double[] cover)
                               throws SpiceErrorException
        Return a coverage window for a specified reference frame class ID and PCK file.Union this coverage with that contained in an input window.
        Parameters:
        file - String
        cover - double[]
        classID - int
        size - int
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • pckfrm

        public static int[] pckfrm​(java.lang.String pck,
                                   int size,
                                   int[] ids)
                            throws SpiceErrorException
        Return an ordered array of unique reference frame class ID codes of all frames associated with segments in a specified binary PCK file.The returned array is the union of this ID set with the set of IDs in the input array `ids'.
        Parameters:
        pck - String
        ids - int[]
        size - int
        Returns:
        int[]
        Throws:
        SpiceErrorException - exception
      • gfoclt

        public static double[] gfoclt​(java.lang.String occtyp,
                                      java.lang.String front,
                                      java.lang.String fshape,
                                      java.lang.String fframe,
                                      java.lang.String back,
                                      java.lang.String bshape,
                                      java.lang.String bframe,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF occultation search.
        Parameters:
        occtyp - String
        cnfine - double[]
        front - String
        nintvls - int
        fshape - String
        step - double
        fframe - String
        obsrvr - String String
        back - String
        abcorr - String String
        bshape - String
        bframe - String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfpa

        public static double[] gfpa​(java.lang.String target,
                                    java.lang.String illum,
                                    java.lang.String abcorr,
                                    java.lang.String obsrvr,
                                    java.lang.String relate,
                                    double refval,
                                    double adjust,
                                    double step,
                                    int nintvls,
                                    double[] cnfine)
                             throws SpiceErrorException
        Perform a GF phase angle search.
        Parameters:
        target - String String
        cnfine - double[]
        illum - String
        nintvls - int
        abcorr - String String
        step - double
        obsrvr - String String
        adjust - double
        relate - String
        refval - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfposc

        public static double[] gfposc​(java.lang.String target,
                                      java.lang.String frame,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      java.lang.String crdsys,
                                      java.lang.String coord,
                                      java.lang.String relate,
                                      double refval,
                                      double adjust,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF position vector coordinate search.
        Parameters:
        target - String String
        cnfine - double[]
        frame - String String
        nintvls - int
        abcorr - String String
        step - double
        obsrvr - String String
        adjust - double
        crdsys - String
        refval - double
        coord - String
        relate - String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfrefn

        public static double gfrefn​(double t1,
                                    double t2,
                                    boolean s1,
                                    boolean s2)
                             throws SpiceErrorException
        Get a refined GF root estimate.
        Parameters:
        t1 - double
        s2 - boolean
        t2 - double
        s1 - boolean
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • gfrepi

        public static void gfrepi​(double[] window,
                                  java.lang.String begmsg,
                                  java.lang.String endmsg)
                           throws SpiceErrorException
        Initialize a GF progress report.
        Parameters:
        window - double[]
        endmsg - String
        begmsg - String
        Throws:
        SpiceErrorException - exception
      • gfrepu

        public static void gfrepu​(double ivbeg,
                                  double ivend,
                                  double time)
                           throws SpiceErrorException
        Update a GF progress report.
        Parameters:
        ivbeg - double
        time - double
        ivend - double
        Throws:
        SpiceErrorException - exception
      • gfrfov

        public static double[] gfrfov​(java.lang.String inst,
                                      double[] raydir,
                                      java.lang.String rframe,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF ray in FOV search.
        Parameters:
        inst - String
        cnfine - double[]
        raydir - double[]
        nintvls - int
        rframe - String
        step - double
        abcorr - String String
        obsrvr - String String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfrr

        public static double[] gfrr​(java.lang.String target,
                                    java.lang.String abcorr,
                                    java.lang.String obsrvr,
                                    java.lang.String relate,
                                    double refval,
                                    double adjust,
                                    double step,
                                    int nintvls,
                                    double[] cnfine)
                             throws SpiceErrorException
        Perform a GF range rate search.
        Parameters:
        target - String String
        cnfine - double[]
        abcorr - String String
        nintvls - int
        obsrvr - String String
        step - double
        relate - String
        adjust - double
        refval - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfsep

        public static double[] gfsep​(java.lang.String targ1,
                                     java.lang.String shape1,
                                     java.lang.String frame1,
                                     java.lang.String targ2,
                                     java.lang.String shape2,
                                     java.lang.String frame2,
                                     java.lang.String abcorr,
                                     java.lang.String obsrvr,
                                     java.lang.String relate,
                                     double refval,
                                     double adjust,
                                     double step,
                                     int nintvls,
                                     double[] cnfine)
                              throws SpiceErrorException
        Perform a GF angular separation coordinate search.
        Parameters:
        targ1 - String
        cnfine - double[]
        shape1 - String
        nintvls - int
        frame1 - String
        step - double
        targ2 - String
        adjust - double
        shape2 - String
        refval - double
        frame2 - String
        relate - String
        abcorr - String String
        obsrvr - String String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfsntc

        public static double[] gfsntc​(java.lang.String target,
                                      java.lang.String fixref,
                                      java.lang.String method,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      java.lang.String dref,
                                      double[] dvec,
                                      java.lang.String crdsys,
                                      java.lang.String coord,
                                      java.lang.String relate,
                                      double refval,
                                      double adjust,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF surface intercept coordinate search.
        Parameters:
        target - String String
        cnfine - double[]
        fixref - String String
        nintvls - int
        method - String String
        step - double
        abcorr - String String
        adjust - double
        obsrvr - String String
        refval - double
        dref - String
        relate - String
        dvec - double[]
        coord - String
        crdsys - String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfstep

        public static double gfstep​(double et)
                             throws SpiceErrorException
        Get the current GF step size.
        Parameters:
        et - double double
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • gfsubc

        public static double[] gfsubc​(java.lang.String target,
                                      java.lang.String fixref,
                                      java.lang.String method,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      java.lang.String crdsys,
                                      java.lang.String coord,
                                      java.lang.String relate,
                                      double refval,
                                      double adjust,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF sub-observer point coordinate search.
        Parameters:
        target - String String
        cnfine - double[]
        fixref - String String
        nintvls - int
        method - String String
        step - double
        abcorr - String String
        adjust - double
        obsrvr - String String
        refval - double
        crdsys - String
        relate - String
        coord - String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gftfov

        public static double[] gftfov​(java.lang.String inst,
                                      java.lang.String target,
                                      java.lang.String tshape,
                                      java.lang.String tframe,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      double step,
                                      int nintvls,
                                      double[] cnfine)
                               throws SpiceErrorException
        Perform a GF target in FOV search.
        Parameters:
        inst - String
        cnfine - double[]
        target - String String
        nintvls - int
        tshape - String
        step - double
        tframe - String
        obsrvr - String String
        abcorr - String String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gfuds

        public static double[] gfuds​(GFScalarQuantity quant,
                                     java.lang.String relate,
                                     double refval,
                                     double adjust,
                                     double step,
                                     int nintvls,
                                     double[] cnfine)
                              throws SpiceErrorException
        Perform a GF user-defined scalar quantity search.
        Parameters:
        quant - GFScalarQuantity
        cnfine - double[]
        relate - String
        nintvls - int
        refval - double
        step - double
        adjust - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • gnpool

        public static java.lang.String[] gnpool​(java.lang.String template,
                                                int start,
                                                int room)
                                         throws SpiceErrorException
        Retrieve the names of kernel variables matching a specified template.
        Parameters:
        template - String
        room - int
        start - int
        Returns:
        String[]
        Throws:
        SpiceErrorException - exception
      • inedpl

        public static void inedpl​(double a,
                                  double b,
                                  double c,
                                  double[] plane,
                                  double[] ellipse,
                                  boolean[] found)
                           throws SpiceErrorException
        Find the intersection of a plane and a triaxial ellipsoid.
        Parameters:
        a - double
        found - boolean[] boolean[]
        b - double
        ellipse - double[]
        c - double
        plane - double[] double[]
        Throws:
        SpiceErrorException - exception
      • inelpl

        public static void inelpl​(double[] ellipse,
                                  double[] plane,
                                  int[] nxpts,
                                  double[] xpt1,
                                  double[] xpt2)
                           throws SpiceErrorException
        Find the intersection of an ellipse and a plane.
        Parameters:
        ellipse - double[]
        plane - double[] double[]
        nxpts - int[] int[]
        xpt1 - double[]
        xpt2 - double[]
        Throws:
        SpiceErrorException - exception
      • illumf

        public static void illumf​(java.lang.String method,
                                  java.lang.String target,
                                  java.lang.String ilusrc,
                                  double et,
                                  java.lang.String fixref,
                                  java.lang.String abcorr,
                                  java.lang.String obsrvr,
                                  double[] spoint,
                                  double[] trgepc,
                                  double[] srfvec,
                                  double[] angles,
                                  boolean[] visibl,
                                  boolean[] lit)
                           throws SpiceErrorException
        Compute the illumination angles---phase, incidence, and emission---at a specified point on a target body.Return logical flags indicating whether the surface point is visible from the observer's position and whether the surface point is illuminated.The target body's surface is represented using topographic data provided by DSK files, or by a reference ellipsoid.The illumination source is a specified ephemeris object.
        Parameters:
        method - String String
        lit - boolean[]
        target - String String
        visibl - boolean[]
        ilusrc - String
        et - double double
        srfvec - double[] double[]
        fixref - String String
        trgepc - double[] double[]
        abcorr - String String
        angles - double[]
        spoint - double[] double[]
        obsrvr - String String
        Throws:
        SpiceErrorException - exception
      • illumPl02

        public static void illumPl02​(int handle,
                                     int[] dladsc,
                                     java.lang.String target,
                                     double et,
                                     java.lang.String abcorr,
                                     java.lang.String obsrvr,
                                     double[] spoint,
                                     double[] trgepc,
                                     double[] srfvec,
                                     double[] angles)
                              throws SpiceErrorException
        Compute the illumination angles---phase, solar incidence, and emission---at a specified point on a target body at a particular epoch, optionally corrected for light time and stellar aberration.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.
        Parameters:
        handle - int int
        angles - double[]
        dladsc - int[] int[]
        srfvec - double[] double[]
        target - String String
        trgepc - double[] double[]
        et - double double
        spoint - double[] double[]
        abcorr - String String
        obsrvr - String String
        Throws:
        SpiceErrorException - exception
      • ilumin

        public static void ilumin​(java.lang.String method,
                                  java.lang.String target,
                                  double et,
                                  java.lang.String fixref,
                                  java.lang.String abcorr,
                                  java.lang.String obsrvr,
                                  double[] spoint,
                                  double[] trgepc,
                                  double[] srfvec,
                                  double[] angles)
                           throws SpiceErrorException
        Find the illumination angles at a specified surface point of a target body.
        Parameters:
        method - String String
        angles - double[]
        target - String String
        srfvec - double[] double[]
        et - double double
        trgepc - double[]
        fixref - String
        spoint - double[]
        abcorr - String
        obsrvr - String
        Throws:
        SpiceErrorException - exception
      • inrypl

        public static void inrypl​(double[] vertex,
                                  double[] dir,
                                  double[] plane,
                                  int[] nxpts,
                                  double[] xpt)
                           throws SpiceErrorException
        Find the intersection of a ray and a plane.
        Parameters:
        vertex - double[]
        xpt - double[]
        dir - double[]
        nxpts - int[]
        plane - double[]
        Throws:
        SpiceErrorException - exception
      • invert

        public static double[][] invert​(double[][] m)
                                 throws SpiceErrorException
        Return the inverse of a nonsingular 3x3 matrix.
        Parameters:
        m - double[][]
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • isrot

        public static boolean isrot​(double[][] m,
                                    double ntol,
                                    double dtol)
                             throws SpiceErrorException
        Indicate whether a given matrix is a rotation matrix.
        Parameters:
        m - double[][]
        dtol - double
        ntol - double
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • j1900

        public static double j1900()
        Return the Julian Date of 1899 DEC 31 12:00:00 (1900 JAN 0.5).
        Returns:
        double
      • j1950

        public static double j1950()
        Return the Julian Date of 1950 JAN 01 00:00:00 (1950 JAN 1.0).
        Returns:
        double
      • j2000

        public static double j2000()
        Return the Julian Date of 2000 JAN 01 12:00:00 (2000 JAN 1.5).
        Returns:
        double
      • j2100

        public static double j2100()
        Return the Julian Date of 2100 JAN 01 12:00:00 (2100 JAN 1.5).
        Returns:
        double
      • jyear

        public static double jyear()
        Return the number of seconds in a Julian year.
        Returns:
        double
      • kclear

        public static void kclear()
        Clear the keeper system and kernel pool.
      • kdata

        public static void kdata​(int which,
                                 java.lang.String kind,
                                 java.lang.String[] file,
                                 java.lang.String[] filtyp,
                                 java.lang.String[] source,
                                 int[] handle,
                                 boolean[] found)
                          throws SpiceErrorException
        Return data for a kernel of specified type and index loaded in the keeper system.
        Parameters:
        which - int
        found - boolean[]
        kind - String
        handle - int int[]
        file - String[]
        source - String[]
        filtyp - String[]
        Throws:
        SpiceErrorException - exception
      • kinfo

        public static void kinfo​(java.lang.String file,
                                 java.lang.String[] filtyp,
                                 java.lang.String[] source,
                                 int[] handle,
                                 boolean[] found)
                          throws SpiceErrorException
        Return data for a kernel, specified by name, that is loaded in the keeper system.
        Parameters:
        file - String
        found - boolean[]
        filtyp - String[]
        handle - int int[]
        source - String[]
        Throws:
        SpiceErrorException - exception
      • ktotal

        public static int ktotal​(java.lang.String kind)
                          throws SpiceErrorException
        Return the count of kernels of a specified type loaded in the keeper system.
        Parameters:
        kind - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • latcyl

        public static double[] latcyl​(double radius,
                                      double longitude,
                                      double latitude)
                               throws SpiceErrorException
        Convert from latitudinal coordinates to cylindrical coordinates.
        Parameters:
        radius - double double
        latitude - double double
        longitude - double double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • latrec

        public static double[] latrec​(double radius,
                                      double longitude,
                                      double latitude)
                               throws SpiceErrorException
        Convert from latitudinal coordinates to rectangular coordinates.
        Parameters:
        radius - double double
        latitude - double double
        longitude - double double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • latsph

        public static double[] latsph​(double radius,
                                      double longitude,
                                      double latitude)
                               throws SpiceErrorException
        Convert from latitudinal coordinates to spherical coordinates.
        Parameters:
        radius - double
        latitude - double
        longitude - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • latsrf

        public static double[][] latsrf​(java.lang.String method,
                                        java.lang.String target,
                                        double et,
                                        java.lang.String fixref,
                                        int npts,
                                        double[][] lonlat)
                                 throws SpiceErrorException
        Map array of planetocentric longitude/latitude coordinate pairs to surface points on a specified target body.The surface of the target body may be represented by a triaxial ellipsoid or by topographic data provided by DSK files.
        Parameters:
        method - String
        lonlat - double[][]
        target - String
        npts - int[] int
        et - double
        fixref - String
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • ldpool

        public static void ldpool​(java.lang.String filename)
                           throws SpiceErrorException
        Load a text kernel into the kernel pool.
        Parameters:
        filename - String
        Throws:
        SpiceErrorException - exception
      • limbpt

        public static void limbpt​(java.lang.String method,
                                  java.lang.String target,
                                  double et,
                                  java.lang.String fixref,
                                  java.lang.String abcorr,
                                  java.lang.String corloc,
                                  java.lang.String obsrvr,
                                  double[] refvec,
                                  double rolstp,
                                  int ncuts,
                                  double schstp,
                                  double soltol,
                                  int maxn,
                                  int[] npts,
                                  double[][] points,
                                  double[] epochs,
                                  double[][] tangts)
                           throws SpiceErrorException
        Find limb points on a target body.The limb is the set of points of tangency on the target of rays emanating from the observer.The caller specifies half-planes bounded by the observer-target center vector in which to search for limb points.The surface of the target body may be represented either by a triaxial ellipsoid or by topographic data.
        Parameters:
        method - String
        tangts - double[][]
        target - String
        epochs - double[]
        et - double
        points - double[][]
        fixref - String
        npts - int[]
        abcorr - String
        maxn - int
        corloc - String
        soltol - double
        obsrvr - String
        schstp - double
        refvec - double[]
        ncuts - int
        rolstp - double
        Throws:
        SpiceErrorException - exception
      • limbPl02

        public static void limbPl02​(int handle,
                                    int[] dladsc,
                                    java.lang.String target,
                                    double et,
                                    java.lang.String fixfrm,
                                    java.lang.String abcorr,
                                    java.lang.String obsrvr,
                                    int npoints,
                                    double[] trgepc,
                                    double[] obspos,
                                    double[][] limbpts,
                                    int[] plateIDs)
                             throws SpiceErrorException
        Compute a set of points on the limb of a specified target body, where the target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.
        Parameters:
        handle - int
        plateIDs - int[]
        dladsc - int[]
        limbpts - double[][]
        target - String
        obspos - double[]
        et - double
        trgepc - double[]
        fixfrm - String
        npoints - int
        abcorr - String
        obsrvr - String
        Throws:
        SpiceErrorException - exception
      • llgridPl02

        public static void llgridPl02​(int handle,
                                      int[] dladsc,
                                      double[][] grid,
                                      double[][] spoints,
                                      int[] plateIDs)
                               throws SpiceErrorException
        Given the planetocentric longitude and latitude values of a set of surface points on a specified target body, compute the corresponding rectangular coordinates of those points.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.CAUTION: the argument list of this routine has changed! This routine accepts the input grid values as a 2-D (Nx2) array.The previous version accepted a 1D array.Elements [i][0] [i][1] of `grid' are, respectively, the longitude and latitude of the ith grid point.
        Parameters:
        handle - int
        plateIDs - int[]
        dladsc - int[]
        spoints - double[]
        grid - double[][]
        Throws:
        SpiceErrorException - exception
      • lmpool

        public static void lmpool​(java.lang.String[] cvals)
                           throws SpiceErrorException
        Load variables contained in a string array into the kernel pool.
        Parameters:
        cvals - String[]
        Throws:
        SpiceErrorException - exception
      • ltime

        public static void ltime​(double etobs,
                                 int obs,
                                 java.lang.String dir,
                                 int targ,
                                 double[] ettarg,
                                 double[] elapsd)
                          throws SpiceErrorException
        Compute the one-way light time between a specified target and observer.
        Parameters:
        ettarg - double[]
        elapsd - double[]
        obs - int
        etobs - double
        dir - double[]
        targ - int
        Throws:
        SpiceErrorException - exception
      • m2eul

        public static double[] m2eul​(double[][] m,
                                     int[] axes)
                              throws SpiceErrorException
        Convert a rotation matrix and a sequence of axes to a sequence of Euler angles.
        Parameters:
        m - double[][]
        axes - int[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • m2q

        public static double[] m2q​(double[][] m)
                            throws SpiceErrorException
        Convert a rotation matrix to a SPICE quaternion.
        Parameters:
        m - double[][]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • mxm

        public static double[][] mxm​(double[][] m1,
                                     double[][] m2)
                              throws SpiceErrorException
        Multiply two 3x3 matrices.
        Parameters:
        m1 - double[][]
        m2 - double[][]
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • mxv

        public static double[] mxv​(double[][] m,
                                   double[] v)
                            throws SpiceErrorException
        Left-multiply a 3-vector by a 3x3 matrix.
        Parameters:
        m - double[][]
        v - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • namfrm

        public static int namfrm​(java.lang.String name)
                          throws SpiceErrorException
        Look up the frame ID code associated with a frame name.
        Parameters:
        name - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • npedln

        public static void npedln​(double a,
                                  double b,
                                  double c,
                                  double[] linept,
                                  double[] linedr,
                                  double[] point,
                                  double[] dist)
                           throws SpiceErrorException
        Return the nearest point on an ellipsoid to a given line; also return the distance between the ellipsoid and the line.
        Parameters:
        a - double
        dist - double[]
        b - double
        point - double[]
        c - double
        linedr - double[]
        linept - double[]
        Throws:
        SpiceErrorException - exception
      • npelpt

        public static void npelpt​(double[] point,
                                  double[] ellipse,
                                  double[] pnear,
                                  double[] dist)
                           throws SpiceErrorException
        Return the nearest point on an ellipseto a given point; also return the distance between the ellipse and the point.
        Parameters:
        point - double[]
        dist - double[]
        ellipse - double[]
        pnear - double[]
        Throws:
        SpiceErrorException - exception
      • nplnpt

        public static void nplnpt​(double[] linept,
                                  double[] linedr,
                                  double[] point,
                                  double[] pnear,
                                  double[] dist)
                           throws SpiceErrorException
        Return the nearest point on a line to a given point; also return the distance between the two points.
        Parameters:
        linept - double[]
        dist - double[]
        linedr - double[]
        pnear - double[]
        point - double[]
        Throws:
        SpiceErrorException - exception
      • nvc2pl

        public static double[] nvc2pl​(double[] normal,
                                      double constant)
                               throws SpiceErrorException
        Convert a normal vector and constant to a plane.
        Parameters:
        normal - double[]
        constant - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • nvp2pl

        public static double[] nvp2pl​(double[] normal,
                                      double[] point)
                               throws SpiceErrorException
        Convert a normal vector and point to a plane.
        Parameters:
        normal - double[]
        point - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • nearpt

        public static void nearpt​(double[] positn,
                                  double a,
                                  double b,
                                  double c,
                                  double[] point,
                                  double[] alt)
                           throws SpiceErrorException
        This routine locates the point on the surface of an ellipsoid that is nearest to a specified position.It also returns the altitude of the position above the ellipsoid.
        Parameters:
        positn - double[]
        alt - double[]
        a - double
        point - double[]
        b - double
        c - double
        Throws:
        SpiceErrorException - exception
      • occult

        public static int occult​(java.lang.String targ1,
                                 java.lang.String shape1,
                                 java.lang.String frame1,
                                 java.lang.String targ2,
                                 java.lang.String shape2,
                                 java.lang.String frame2,
                                 java.lang.String abcorr,
                                 java.lang.String obsrvr,
                                 double et)
                          throws SpiceErrorException
        Determine the occultation condition (not occulted, partially, etc.) of one target relative to another target as seen by an observer at a given time.The surfaces of the target bodies may be represented by triaxial ellipsoids or by topographic data provided by DSK files.
        Parameters:
        targ1 - String
        et - double
        shape1 - String
        obsrvr - String
        frame1 - String
        abcorr - String
        targ2 - String
        frame2 - String
        shape2 - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • oscelt

        public static double[] oscelt​(double[] state,
                                      double et,
                                      double mu)
                               throws SpiceErrorException
        Compute osculating elements corresponding to a state.
        Parameters:
        state - double[] double[]
        mu - double
        et - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • oscltx

        public static double[] oscltx​(double[] state,
                                      double et,
                                      double mu)
                               throws SpiceErrorException
        Compute extended osculating elements corresponding to a state.
        Parameters:
        state - double[] double[]
        mu - double
        et - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • pckopn

        public static int pckopn​(java.lang.String fname,
                                 java.lang.String ifname,
                                 int ncomch)
                          throws SpiceErrorException
        Open a new binary PCK file.
        Parameters:
        fname - String
        ncomch - int
        ifname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • pckw02

        public static void pckw02​(int handle,
                                  int clssid,
                                  java.lang.String frame,
                                  double first,
                                  double last,
                                  java.lang.String segid,
                                  double intlen,
                                  int n,
                                  int polydg,
                                  double[] cdata,
                                  double btime)
                           throws SpiceErrorException
        Write a type 2 segment to a binary PCK file.
        Parameters:
        handle - int
        btime - double
        clssid - int
        cdata - double[]
        frame - String String
        polydg - int
        first - double double
        n - int
        last - double double
        intlen - double
        segid - String String
        Throws:
        SpiceErrorException - exception
      • pcpool

        public static void pcpool​(java.lang.String name,
                                  java.lang.String[] cvals)
                           throws SpiceErrorException
        Insert a character kernel variable into the kernel pool.
        Parameters:
        name - String
        cvals - String[]
        Throws:
        SpiceErrorException - exception
      • pdpool

        public static void pdpool​(java.lang.String name,
                                  double[] dvals)
                           throws SpiceErrorException
        Insert a double precision kernel variable into the kernel pool.
        Parameters:
        name - String
        dvals - double[]
        Throws:
        SpiceErrorException - exception
      • pgrrec

        public static double[] pgrrec​(java.lang.String body,
                                      double longitude,
                                      double latitude,
                                      double altitude,
                                      double re,
                                      double f)
                               throws SpiceErrorException
        Convert from planetographic coordinates to rectangular coordinates.
        Parameters:
        body - String String
        f - double
        longitude - double
        re - double
        latitude - double
        altitude - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • pi

        @Deprecated
        public static double pi()
        Deprecated.
        Return the value of pi.
        Returns:
        double
      • pipool

        public static void pipool​(java.lang.String name,
                                  int[] ivals)
                           throws SpiceErrorException
        Insert an integer kernel variable into the kernel pool.
        Parameters:
        name - String
        ivals - int[]
        Throws:
        SpiceErrorException - exception
      • pjelpl

        public static double[] pjelpl​(double[] elin,
                                      double[] plane)
                               throws SpiceErrorException
        Project an ellipse orthogonally onto a plane.
        Parameters:
        elin - double[]
        plane - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • pl2nvc

        public static void pl2nvc​(double[] plane,
                                  double[] normal,
                                  double[] constant)
                           throws SpiceErrorException
        Map a plane array to a normal vector and constant.
        Parameters:
        plane - double[]
        constant - double[]
        normal - double[]
        Throws:
        SpiceErrorException - exception
      • pl2nvp

        public static void pl2nvp​(double[] plane,
                                  double[] normal,
                                  double[] point)
                           throws SpiceErrorException
        Map a plane array to a normal vector and point.
        Parameters:
        plane - double[]
        point - double[]
        normal - double[]
        Throws:
        SpiceErrorException - exception
      • pl2psv

        public static void pl2psv​(double[] plane,
                                  double[] point,
                                  double[] span1,
                                  double[] span2)
                           throws SpiceErrorException
        Map a plane array to a point and spanning vectors.
        Parameters:
        plane - double[]
        span2 - double[]
        point - double[]
        span1 - double[]
        Throws:
        SpiceErrorException - exception
      • pltar

        public static double pltar​(int nv,
                                   double[] vrtces,
                                   int np,
                                   int[] plates)
                            throws SpiceErrorException
        Compute the total area of a collection of triangular plates.
        Parameters:
        nv - int
        plates - int[]
        vrtces - double[]
        np - int
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • pltexp

        public static double[][] pltexp​(double[][] iverts,
                                        double delta)
                                 throws SpiceErrorException
        Expand a triangular plate by a specified amount.The expanded plate is co-planar with, and has the same orientation as, the original.The centroids of the two plates coincide.
        Parameters:
        iverts - double[][]
        delta - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • pltnp

        public static void pltnp​(double[] point,
                                 double[] v1,
                                 double[] v2,
                                 double[] v3,
                                 double[] pnear,
                                 double[] dist)
                          throws SpiceErrorException
        Find the nearest point on a triangular plate to a given point.
        Parameters:
        point - double[]
        dist - double[]
        v1 - double[]
        pnear - double[]
        v2 - double[]
        v3 - double[]
        Throws:
        SpiceErrorException - exception
      • pltnrm

        public static double[] pltnrm​(double[] v1,
                                      double[] v2,
                                      double[] v3)
                               throws SpiceErrorException
        Compute an outward normal vector of a triangular plate.The vector does not necessarily have unit length.
        Parameters:
        v1 - double[]
        v3 - double[]
        v2 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • pltvol

        public static double pltvol​(int nv,
                                    double[] vrtces,
                                    int np,
                                    int[] plates)
                             throws SpiceErrorException
        Compute the volume of a three-dimensional region bounded by a collection of triangular plates.
        Parameters:
        nv - int
        plates - int[]
        vrtces - double[]
        np - int
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • psv2pl

        public static double[] psv2pl​(double[] point,
                                      double[] span1,
                                      double[] span2)
                               throws SpiceErrorException
        Convert a point and two spanning vectors to a plane.
        Parameters:
        point - double[]
        span2 - double[]
        span1 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • putcml

        public static void putcml​(java.lang.String[] argv)
                           throws SpiceErrorException
        Store the contents of argv for later access.
        Parameters:
        argv - String[]
        Throws:
        SpiceErrorException - exception
      • prompt

        public static java.lang.String prompt​(java.lang.String promptStr)
                                       throws SpiceErrorException
        This function prompts a user for keyboard input.
        Parameters:
        promptStr - String
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • prop2b

        public static void prop2b​(double gm,
                                  double[] pvinit,
                                  double dt,
                                  double[] pvprop)
                           throws SpiceErrorException
        Propagate a state using a two-body model.
        Parameters:
        gm - double
        pvprop - double[]
        pvinit - double[]
        dt - double
        Throws:
        SpiceErrorException - exception
      • pxform

        public static double[][] pxform​(java.lang.String from,
                                        java.lang.String to,
                                        double et)
                                 throws SpiceErrorException
        Return the rotation matrix from one frame to another at a specified epoch.
        Parameters:
        from - String
        et - double
        to - String
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • pxfrm2

        public static double[][] pxfrm2​(java.lang.String from,
                                        java.lang.String to,
                                        double etfrom,
                                        double etto)
                                 throws SpiceErrorException
        Return the 3x3 matrix that transforms position vectors from one specified frame at a specified epoch to another specified frame at another specified epoch.
        Parameters:
        from - String
        etfrom - double
        to - String
        etto - double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • q2m

        public static double[][] q2m​(double[] q)
                              throws SpiceErrorException
        Convert a SPICE quaternion to a matrix.
        Parameters:
        q - double[]
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • qdq2av

        public static double[] qdq2av​(double[] q,
                                      double[] dq)
                               throws SpiceException
        Convert a SPICE quaternion and its derivative to angular velocity.
        Parameters:
        q - double[]
        dq - double[]
        Returns:
        double[]
        Throws:
        SpiceException - exception
      • qxq

        public static double[] qxq​(double[] q1,
                                   double[] q2)
                            throws SpiceException
        Multiply two SPICE quaternions.
        Parameters:
        q1 - double[]
        q2 - double[]
        Returns:
        double[]
        Throws:
        SpiceException - exception
      • radrec

        public static double[] radrec​(double range,
                                      double ra,
                                      double dec)
                               throws SpiceErrorException
        Convert from range, right ascension, and declination to rectangular coordinates.
        Parameters:
        range - double
        dec - double
        ra - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • rav2xf

        public static double[] rav2xf​(double[][] r,
                                      double[] av)
                               throws SpiceErrorException
        Convert a rotation matrix and angular velocity vector to a state transformation matrix.
        Parameters:
        r - double[][]
        av - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • raxisa

        public static void raxisa​(double[][] r,
                                  double[] axis,
                                  double[] angle)
                           throws SpiceErrorException
        Map a rotation matrix to a rotation axis and angle.
        Parameters:
        r - double[][]
        angle - double double[]
        axis - double[]
        Throws:
        SpiceErrorException - exception
      • reccyl

        public static double[] reccyl​(double[] rectan)
                               throws SpiceErrorException
        Convert from rectangular coordinates to cylindrical coordinates.
        Parameters:
        rectan - double[] double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • recgeo

        public static double[] recgeo​(double[] rectan,
                                      double Re,
                                      double f)
                               throws SpiceErrorException
        Convert from rectangular coordinates to geodetic coordinates.
        Parameters:
        rectan - double[] double[]
        f - double
        Re - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • reclat

        public static double[] reclat​(double[] rectan)
                               throws SpiceErrorException
        Convert from rectangular coordinates to latitudinal coordinates.
        Parameters:
        rectan - double[] double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • recpgr

        public static double[] recpgr​(java.lang.String body,
                                      double[] rectan,
                                      double Re,
                                      double f)
                               throws SpiceErrorException
        Convert from rectangular coordinates to planetographic coordinates.
        Parameters:
        body - String
        f - double
        rectan - double[]
        Re - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • recrad

        public static double[] recrad​(double[] rectan)
                               throws SpiceErrorException
        Convert from rectangular coordinates to RA/Dec coordinates.
        Parameters:
        rectan - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • recsph

        public static double[] recsph​(double[] rectan)
                               throws SpiceErrorException
        Convert from rectangular coordinates to spherical coordinates.
        Parameters:
        rectan - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • reset

        public static void reset()
        Reset SPICE error handling system.
      • rotate

        public static double[][] rotate​(double angle,
                                        int iaxis)
                                 throws SpiceErrorException
        Create a matrix that rotates a reference frame by a specified angle about a specified coordinate axis.
        Parameters:
        angle - double double
        iaxis - int int
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • rotmat

        public static double[][] rotmat​(double[][] r,
                                        double angle,
                                        int iaxis)
                                 throws SpiceErrorException
        Create a matrix that rotates a rotation matrix by a specified angle about a specified coordinate axis.
        Parameters:
        r - double[][]
        iaxis - int int
        angle - double double
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • rotvec

        public static double[] rotvec​(double[] v,
                                      double angle,
                                      int iaxis)
                               throws SpiceErrorException
        Transform a vector to a basis rotated by a specified angle about a specified coordinate axis.
        Parameters:
        v - double[]
        iaxis - int
        angle - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • rpd

        public static double rpd()
        Return the number of radians per degree.
        Returns:
        double
      • scdecd

        public static java.lang.String scdecd​(int clkid,
                                              double sclkdp)
                                       throws SpiceErrorException
        Convert double precision encoding of spacecraft clock time into a character representation.
        Parameters:
        clkid - int int
        sclkdp - double double
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • sce2c

        public static double sce2c​(int clkid,
                                   double et)
                            throws SpiceErrorException
        Convert ephemeris seconds past J2000 (ET) to continuous encoded spacecraft clock ("ticks").Non-integral tick values may be returned.
        Parameters:
        clkid - int int
        et - double
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • sce2s

        public static java.lang.String sce2s​(int clkid,
                                             double et)
                                      throws SpiceErrorException
        Convert ephemeris seconds past J2000 (ET) to a character string representation of an SCLK value.
        Parameters:
        clkid - int
        et - double
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • scencd

        public static double scencd​(int clkid,
                                    java.lang.String sclkch)
                             throws SpiceErrorException
        Encode character representation of spacecraft clock time into a double precision number.
        Parameters:
        clkid - int
        sclkch - String
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • scfmt

        public static java.lang.String scfmt​(int sc,
                                             double sclkdp)
                                      throws SpiceErrorException
        Convert a tick duration to an SCLK string.
        Parameters:
        sc - int
        sclkdp - double
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • scs2e

        public static double scs2e​(int clkid,
                                   java.lang.String sclkch)
                            throws SpiceErrorException
        Convert a spacecraft clock string to ephemeris seconds past J2000 (ET).
        Parameters:
        clkid - int
        sclkch - String
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • sct2e

        public static double sct2e​(int clkid,
                                   double sclkdp)
                            throws SpiceErrorException
        Convert encoded spacecraft clock (`ticks') to ephemeris seconds past J2000 (ET).
        Parameters:
        clkid - int
        sclkdp - double double
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • sctiks

        public static double sctiks​(int clkid,
                                    java.lang.String clkstr)
                             throws SpiceErrorException
        Convert a spacecraft clock format string to number of "ticks".
        Parameters:
        clkid - int
        clkstr - String
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • sincpt

        public static void sincpt​(java.lang.String method,
                                  java.lang.String target,
                                  double et,
                                  java.lang.String fixref,
                                  java.lang.String abcorr,
                                  java.lang.String obsrvr,
                                  java.lang.String dref,
                                  double[] dvec,
                                  double[] spoint,
                                  double[] trgepc,
                                  double[] srfvec,
                                  boolean[] found)
                           throws SpiceErrorException
        Determine the coordinates of the surface intercept of a ray on a target body at a particular epoch, optionally corrected for planetary (light time) and stellar aberration.Also, return the epoch associated with the surface intercept and the vector from the observer to the surface intercept; this vector is expressed in the frame designated by `fixref'.
        Parameters:
        method - String
        found - boolean[]
        target - String
        srfvec - double[] double[]
        et - double
        trgepc - double[]
        fixref - String
        spoint - double[]
        abcorr - String
        dvec - double[]
        obsrvr - String
        dref - String
        Throws:
        SpiceErrorException - exception
      • spd

        @Deprecated
        public static double spd()
        Deprecated.
        Return the number of seconds in a Julian day.
        Returns:
        double
      • sphcyl

        public static double[] sphcyl​(double r,
                                      double colatitude,
                                      double longitude)
                               throws SpiceErrorException
        Convert from spherical coordinates to cylindrical coordinates.
        Parameters:
        r - double
        longitude - double
        colatitude - double double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • sphlat

        public static double[] sphlat​(double r,
                                      double colatitude,
                                      double longitude)
                               throws SpiceErrorException
        Convert from spherical coordinates to latitudinal coordinates.
        Parameters:
        r - double
        longitude - double
        colatitude - double double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • sphrec

        public static double[] sphrec​(double r,
                                      double colatitude,
                                      double longitude)
                               throws SpiceErrorException
        Convert from spherical coordinates to rectangular coordinates.
        Parameters:
        r - double
        longitude - double
        colatitude - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • spkcov

        public static double[] spkcov​(java.lang.String file,
                                      int body,
                                      int size,
                                      double[] cover)
                               throws SpiceErrorException
        Return a coverage window for a specified body and SPK file.Add this coverage to that contained in an input window.
        Parameters:
        file - String
        cover - double[]
        body - String
        size - int
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • spkcpo

        public static void spkcpo​(java.lang.String target,
                                  double et,
                                  java.lang.String outref,
                                  java.lang.String refloc,
                                  java.lang.String abcorr,
                                  double[] obspos,
                                  java.lang.String obsctr,
                                  java.lang.String obsref,
                                  double[] state,
                                  double[] lt)
                           throws SpiceErrorException
        Return the state of a specified target relative to an "observer," where the observer has constant position in a specified reference frame.The observer's position is provided by the calling program rather than by loaded SPK files.
        Parameters:
        target - String
        lt - double[] double[]
        et - double
        state - double[] double[]
        outref - String String
        obsref - String
        refloc - String String
        obsctr - String
        abcorr - String
        obspos - double[]
        Throws:
        SpiceErrorException - exception
      • spkcpt

        public static void spkcpt​(double[] trgpos,
                                  java.lang.String trgctr,
                                  java.lang.String trgref,
                                  double et,
                                  java.lang.String outref,
                                  java.lang.String refloc,
                                  java.lang.String abcorr,
                                  java.lang.String obsrvr,
                                  double[] state,
                                  double[] lt)
                           throws SpiceErrorException
        Return the state, relative to a specified observer, of a target having constant position in a specified reference frame.The target's position is provided by the calling program rather than by loaded SPK files.
        Parameters:
        trgpos - double[]
        lt - double[] double[]
        trgctr - String String
        state - double[] double[]
        trgref - String String
        obsrvr - String
        et - double
        abcorr - String
        outref - String String
        refloc - String String
        Throws:
        SpiceErrorException - exception
      • spkcvo

        public static void spkcvo​(java.lang.String target,
                                  double et,
                                  java.lang.String outref,
                                  java.lang.String refloc,
                                  java.lang.String abcorr,
                                  double[] obssta,
                                  double obsepc,
                                  java.lang.String obsctr,
                                  java.lang.String obsref,
                                  double[] state,
                                  double[] lt)
                           throws SpiceErrorException
        Return the state of a specified target relative to an "observer," where the observer has constant velocity in a specified reference frame.The observer's state is provided by the calling program rather than by loaded SPK files.
        Parameters:
        target - String
        lt - double[] double[]
        et - double
        state - double[] double[]
        outref - String String
        obsref - String
        refloc - String String
        obsctr - String
        abcorr - String
        obsepc - double
        obssta - double[]
        Throws:
        SpiceErrorException - exception
      • spkcvt

        public static void spkcvt​(double[] trgsta,
                                  double trgepc,
                                  java.lang.String trgctr,
                                  java.lang.String trgref,
                                  double et,
                                  java.lang.String outref,
                                  java.lang.String refloc,
                                  java.lang.String abcorr,
                                  java.lang.String obsrvr,
                                  double[] state,
                                  double[] lt)
                           throws SpiceErrorException
        Return the state, relative to a specified observer, of a target having constant velocity in a specified reference frame.The target's state is provided by the calling program rather than by loaded SPK files.
        Parameters:
        trgsta - double[]
        lt - double[]
        trgepc - double[]
        state - double[]
        trgctr - String
        obsrvr - String
        trgref - String
        abcorr - String
        et - double
        refloc - String
        outref - String
        Throws:
        SpiceErrorException - exception
      • spkezr

        public static void spkezr​(java.lang.String target,
                                  double et,
                                  java.lang.String ref,
                                  java.lang.String abcorr,
                                  java.lang.String observer,
                                  double[] state,
                                  double[] lt)
                           throws SpiceErrorException
        Return the state (position and velocity) of a target body relative to an observing body, optionally corrected for light time (planetary aberration) and stellar aberration.
        Parameters:
        target - String
        lt - double[]
        et - double
        state - double[]
        ref - String
        observer - String
        abcorr - String
        Throws:
        SpiceErrorException - exception
      • spkobj

        public static int[] spkobj​(java.lang.String file,
                                   int size,
                                   int[] ids)
                            throws SpiceErrorException
        Return an ordered array of unique ID codes of bodies for which a specified SPK file contains data.
        Parameters:
        file - String
        ids - int[]
        size - int
        Returns:
        int[]
        Throws:
        SpiceErrorException - exception
      • spkopn

        public static int spkopn​(java.lang.String fname,
                                 java.lang.String ifname,
                                 int ncomch)
                          throws SpiceErrorException
        Open a new SPK file.
        Parameters:
        fname - String
        ncomch - int
        ifname - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • spkpos

        public static void spkpos​(java.lang.String target,
                                  double et,
                                  java.lang.String ref,
                                  java.lang.String abcorr,
                                  java.lang.String observer,
                                  double[] pos,
                                  double[] lt)
                           throws SpiceErrorException
        Return the position of a target body relative to an observing body, optionally corrected for light time (planetary aberration) and stellar aberration.
        Parameters:
        target - String
        lt - double[]
        et - double
        pos - double[]
        ref - String
        observer - String
        abcorr - String
        Throws:
        SpiceErrorException - exception
      • spkw02

        public static void spkw02​(int handle,
                                  int body,
                                  int center,
                                  java.lang.String frame,
                                  double first,
                                  double last,
                                  java.lang.String segid,
                                  double intlen,
                                  int n,
                                  int polydg,
                                  double[] cdata,
                                  double btime)
                           throws SpiceErrorException
        Write a type 2 segment to an SPK file.
        Parameters:
        handle - int
        btime - double
        body - String
        cdata - double[]
        center - int int
        polydg - int
        frame - String String
        n - int
        first - double double
        intlen - double
        last - double double
        segid - String String
        Throws:
        SpiceErrorException - exception
      • spkw03

        public static void spkw03​(int handle,
                                  int body,
                                  int center,
                                  java.lang.String frame,
                                  double first,
                                  double last,
                                  java.lang.String segid,
                                  double intlen,
                                  int n,
                                  int polydg,
                                  double[] cdata,
                                  double btime)
                           throws SpiceErrorException
        Write a type 3 segment to an SPK file.
        Parameters:
        handle - int
        btime - double
        body - String
        cdata - double[]
        center - int int
        polydg - int
        frame - String String
        n - int
        first - double double
        intlen - double
        last - double double
        segid - String String
        Throws:
        SpiceErrorException - exception
      • spkw05

        public static void spkw05​(int handle,
                                  int body,
                                  int center,
                                  java.lang.String frame,
                                  double first,
                                  double last,
                                  java.lang.String segid,
                                  double gm,
                                  int n,
                                  double[] states,
                                  double[] epochs)
                           throws SpiceErrorException
        Write a type 5 segment to an SPK file.
        Parameters:
        handle - int
        epochs - double[]
        body - String
        states - double[]
        center - int int
        n - int
        frame - String String
        gm - double
        first - double double
        segid - String String
        last - double double
        Throws:
        SpiceErrorException - exception
      • spkw09

        public static void spkw09​(int handle,
                                  int body,
                                  int center,
                                  java.lang.String frame,
                                  double first,
                                  double last,
                                  java.lang.String segid,
                                  int degree,
                                  int n,
                                  double[] states,
                                  double[] epochs)
                           throws SpiceErrorException
        Write a type 9 segment to an SPK file.
        Parameters:
        handle - int
        epochs - double[]
        body - String
        states - double[]
        center - int
        n - int
        frame - String
        degree - int
        first - double
        segid - String
        last - double
        Throws:
        SpiceErrorException - exception
      • spkw13

        public static void spkw13​(int handle,
                                  int body,
                                  int center,
                                  java.lang.String frame,
                                  double first,
                                  double last,
                                  java.lang.String segid,
                                  int degree,
                                  int n,
                                  double[] states,
                                  double[] epochs)
                           throws SpiceErrorException
        Write a type 13 segment to an SPK file.
        Parameters:
        handle - int
        epochs - double[]
        body - String
        states - double[]
        center - int
        n - int
        frame - String
        degree - int
        first - double
        segid - String
        last - double
        Throws:
        SpiceErrorException - exception
      • srfc2s

        public static void srfc2s​(int code,
                                  int bodyid,
                                  java.lang.String[] srfstr,
                                  boolean[] isname)
                           throws SpiceErrorException
        Translate a surface ID code, together with a body ID code, to the corresponding surface name.If no such name exists, return a string representation of the surface ID code.
        Parameters:
        code - int
        isname - boolean[]
        bodyid - String
        srfstr - String[]
        Throws:
        SpiceErrorException - exception
      • srfcss

        public static void srfcss​(int code,
                                  java.lang.String bodstr,
                                  java.lang.String[] srfstr,
                                  boolean[] isname)
                           throws SpiceErrorException
        Translate a surface ID code, together with a body string, to the corresponding surface name.If no such surface name exists, return a string representation of the surface ID code.
        Parameters:
        code - int
        isname - boolean[]
        bodstr - String
        srfstr - String[]
        Throws:
        SpiceErrorException - exception
      • srfnrm

        public static double[][] srfnrm​(java.lang.String method,
                                        java.lang.String target,
                                        double et,
                                        java.lang.String fixref,
                                        int npts,
                                        double[][] srfpts)
                                 throws SpiceErrorException
        Map array of surface points on a specified target body to the corresponding unit length outward surface normal vectors.The surface of the target body may be represented by a triaxial ellipsoid or by topographic data provided by DSK files.
        Parameters:
        method - String
        srfpts - double[][]
        target - String
        npts - int[]
        et - double
        fixref - String
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • srfs2c

        public static void srfs2c​(java.lang.String srfstr,
                                  java.lang.String bodstr,
                                  int[] code,
                                  boolean[] found)
                           throws SpiceErrorException
        Translate a surface string, together with a body string, to the corresponding surface ID code.The input strings may contain names or integer ID codes.
        Parameters:
        srfstr - String
        found - boolean[]
        bodstr - String
        code - int[]
        Throws:
        SpiceErrorException - exception
      • srfscc

        public static void srfscc​(java.lang.String srfstr,
                                  int bodyid,
                                  int[] code,
                                  boolean[] found)
                           throws SpiceErrorException
        Translate a surface string, together with a body ID code, to the corresponding surface ID code.The input surface string may contain a name or an integer ID code.
        Parameters:
        srfstr - String
        found - boolean[]
        bodyid - String
        code - int[]
        Throws:
        SpiceErrorException - exception
      • stelab

        public static double[] stelab​(double[] pobj,
                                      double[] vobs)
                               throws SpiceErrorException
        Correct a position vector for reception stellar aberration.
        Parameters:
        pobj - double[]
        vobs - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • stlabx

        public static double[] stlabx​(double[] pobj,
                                      double[] vobs)
                               throws SpiceErrorException
        Correct a position vector for transmission stellar aberration.
        Parameters:
        pobj - double[]
        vobs - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • stpool

        public static void stpool​(java.lang.String name,
                                  int nth,
                                  java.lang.String contin,
                                  java.lang.String[] component,
                                  boolean[] found)
                           throws SpiceErrorException,
                                  KernelVarNotFoundException
        Retrieve the nth string from the kernel pool variable, where the string may be continued across several components of the kernel pool variable.
        Parameters:
        name - String
        found - boolean[]
        nth - int
        component - String[]
        contin - String
        Throws:
        SpiceErrorException - exception
        KernelVarNotFoundException - exception
      • str2et

        public static double str2et​(java.lang.String timeString)
                             throws SpiceErrorException
        Convert a string representing an epoch to a double precision value representing the number of TDB seconds past the J2000 epoch corresponding to the input epoch.
        Parameters:
        timeString - String
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • subpnt

        public static void subpnt​(java.lang.String method,
                                  java.lang.String target,
                                  double et,
                                  java.lang.String fixref,
                                  java.lang.String abcorr,
                                  java.lang.String obsrvr,
                                  double[] spoint,
                                  double[] trgepc,
                                  double[] srfvec)
                           throws SpiceErrorException
        Determine the coordinates of the sub-observer point on a target body at a particular epoch, optionally corrected for planetary (light time) and stellar aberration.Also, return the epoch associated with the sub-observer point and the vector from the observer to the sub-observer point; this vector is expressed in the frame designated by `fixref'.
        Parameters:
        method - String
        srfvec - double[]
        target - String
        trgepc - double[]
        et - double
        spoint - double[]
        fixref - String
        obsrvr - String
        abcorr - String
        Throws:
        SpiceErrorException - exception
      • subptPl02

        public static void subptPl02​(int handle,
                                     int[] dladsc,
                                     java.lang.String method,
                                     java.lang.String target,
                                     double et,
                                     java.lang.String abcorr,
                                     java.lang.String obsrvr,
                                     double[] spoint,
                                     double[] alt,
                                     int[] plateID)
                              throws SpiceErrorException
        Compute the rectangular coordinates of the sub-observer point on a target body at a particular epoch, optionally corrected for light time and stellar aberration.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.Return the sub-observer point's coordinates expressed in the body-fixed frame associated with the target body.Also, return the observer's altitude above the target body.
        Parameters:
        handle - int
        plateID - int[]
        dladsc - int[]
        alt - double[]
        method - String
        spoint - double[]
        target - String
        obsrvr - String
        et - double
        abcorr - String
        Throws:
        SpiceErrorException - exception
      • subslr

        public static void subslr​(java.lang.String method,
                                  java.lang.String target,
                                  double et,
                                  java.lang.String fixref,
                                  java.lang.String abcorr,
                                  java.lang.String obsrvr,
                                  double[] spoint,
                                  double[] trgepc,
                                  double[] srfvec)
                           throws SpiceErrorException
        Determine the coordinates of the sub-solar point on a target body at a particular epoch, optionally corrected for planetary (light time) and stellar aberration.Also, return the epoch associated with the sub-solar point and the vector from the observer to the sub-solar point; this vector is expressed in the frame designated by `fixref'.
        Parameters:
        method - String
        srfvec - double[]
        target - String
        trgepc - double[]
        et - double
        spoint - double[]
        fixref - String
        obsrvr - String
        abcorr - String
        Throws:
        SpiceErrorException - exception
      • subsolPl02

        public static void subsolPl02​(int handle,
                                      int[] dladsc,
                                      java.lang.String method,
                                      java.lang.String target,
                                      double et,
                                      java.lang.String abcorr,
                                      java.lang.String obsrvr,
                                      double[] spoint,
                                      double[] alt,
                                      int[] plateID)
                               throws SpiceErrorException
        Compute the rectangular coordinates of the sub-solar point on a target body at a particular epoch, optionally corrected for light time and stellar aberration.The target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.Return the sub-solar point's coordinates expressed in the body-fixed frame associated with the target body.Also, return the observer's distance from the sub-solar point.
        Parameters:
        handle - int
        plateID - int[]
        dladsc - int[]
        alt - double[]
        method - String
        spoint - double[]
        target - String
        obsrvr - String
        et - double
        abcorr - String
        Throws:
        SpiceErrorException - exception
      • surfnm

        public static double[] surfnm​(double a,
                                      double b,
                                      double c,
                                      double[] point)
                               throws SpiceErrorException
        Compute the outward pointing unit normal vector at a specified point on the surface of an ellipsoid.
        Parameters:
        a - double
        point - double[]
        b - double
        c - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • surfpt

        public static void surfpt​(double[] positn,
                                  double[] u,
                                  double a,
                                  double b,
                                  double c,
                                  double[] point,
                                  boolean[] found)
                           throws SpiceErrorException
        Determine the intersection of a line-of-sight vector with the surface of an ellipsoid.
        Parameters:
        positn - double[]
        found - boolean[]
        u - double[]
        point - double[]
        a - double
        c - double
        b - double
        Throws:
        SpiceErrorException - exception
      • swpool

        public static void swpool​(java.lang.String agent,
                                  java.lang.String[] names)
                           throws SpiceErrorException
        Add a name to the list of agents to notify whenever a member of a list of kernel variables is updated.
        Parameters:
        agent - String
        names - String[]
        Throws:
        SpiceErrorException - exception
      • sxform

        public static double[] sxform​(java.lang.String from,
                                      java.lang.String to,
                                      double et)
                               throws SpiceErrorException
        Return the state transformation matrix from one frame to another at a specified epoch.The result is returned as a 1x36 array.
        Parameters:
        from - String
        et - double
        to - String
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • szpool

        public static int szpool​(java.lang.String name)
                          throws SpiceErrorException
        Return the kernel pool size limitations.
        Parameters:
        name - String
        Returns:
        int
        Throws:
        SpiceErrorException - exception
      • termpt

        public static void termpt​(java.lang.String method,
                                  java.lang.String ilusrc,
                                  java.lang.String target,
                                  double et,
                                  java.lang.String fixref,
                                  java.lang.String abcorr,
                                  java.lang.String corloc,
                                  java.lang.String obsrvr,
                                  double[] refvec,
                                  double rolstp,
                                  int ncuts,
                                  double schstp,
                                  double soltol,
                                  int maxn,
                                  int[] npts,
                                  double[][] points,
                                  double[] epochs,
                                  double[][] trmvcs)
                           throws SpiceErrorException
        Find terminator points on a target body.The terminator is the set of points of tangency on the target body of planes tangent to both this body and to a light source.The caller specifies half-planes, bounded by the illumination source center-target center vector, in which to search for terminator points.The terminator can be either umbral or penumbral.The umbral terminator is the boundary of the region on the target surface where no light from the source is visible.The penumbral terminator is the boundary of the region on the target surface where none of the light from the source is blocked by the target itself.The surface of the target body may be represented either by a triaxial ellipsoid or by topographic data.
        Parameters:
        method - String
        trmvcs - double[][]
        ilusrc - String
        epochs - double[]
        target - String
        points - double[][]
        et - double
        npts - int[]
        fixref - String
        maxn - int
        abcorr - String
        soltol - double
        corloc - String
        schstp - double
        obsrvr - String
        ncuts - int
        refvec - double[]
        rolstp - double
        Throws:
        SpiceErrorException - exception
      • timout

        public static java.lang.String timout​(double et,
                                              java.lang.String picture)
                                       throws SpiceErrorException
        This routine converts an input epoch represented in TDB seconds past the TDB epoch of J2000 to a character string formatted to the specifications of a user's format picture.
        Parameters:
        et - double
        picture - String
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • tkvrsn

        public static java.lang.String tkvrsn​(java.lang.String item)
                                       throws SpiceErrorException
        This routine returns Toolkit version information.
        Parameters:
        item - String
        Returns:
        String
        Throws:
        SpiceErrorException - exception
      • tparse

        public static void tparse​(java.lang.String string,
                                  double[] sp2000,
                                  java.lang.String[] errmsg)
                           throws SpiceErrorException
        Parse a time string; return the result as a double precision count of seconds past J2000 in an unspecified time system.Return an error message if the input string cannot be parsed.
        Parameters:
        string - String
        errmsg - String[]
        sp2000 - double[]
        Throws:
        SpiceErrorException - exception
      • tpictr

        public static void tpictr​(java.lang.String sample,
                                  java.lang.String[] pictur,
                                  boolean[] ok,
                                  java.lang.String[] errmsg)
                           throws SpiceErrorException
        Create a time format picture from an example time string.
        Parameters:
        sample - String
        errmsg - String[]
        pictur - String[]
        ok - boolean[]
        Throws:
        SpiceErrorException - exception
      • tsetyr

        public static void tsetyr​(int year)
                           throws SpiceErrorException
        Set the lower bound of the range used to interpret a two-digit year.
        Parameters:
        year - int
        Throws:
        SpiceErrorException - exception
      • twovec

        public static double[][] twovec​(double[] axdef,
                                        int indexa,
                                        double[] plndef,
                                        int indexp)
                                 throws SpiceErrorException
        Create a matrix that transforms vectors to a reference frame defined by two specified vectors.
        Parameters:
        axdef - double[]
        indexp - int
        indexa - int
        plndef - double[]
        Returns:
        double[][]
        Throws:
        SpiceErrorException - exception
      • tyear

        public static double tyear()
        Return the number of seconds in a tropical year.
        Returns:
        double
      • ucrss

        public static double[] ucrss​(double[] v1,
                                     double[] v2)
                              throws SpiceErrorException
        Compute the unitized cross product of two double precision, 3-dimensional vectors.
        Parameters:
        v1 - double[]
        v2 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • unitim

        public static double unitim​(double et,
                                    java.lang.String insys,
                                    java.lang.String outsys)
                             throws SpiceErrorException
        Convert between uniform time systems.
        Parameters:
        et - double
        outsys - String
        insys - String
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • unorm

        public static void unorm​(double[] v1,
                                 double[] vout,
                                 double[] vmag)
                          throws SpiceErrorException
        Given a 3-vector, return a unitized version of the vector and the norm of the original vector.
        Parameters:
        v1 - double[]
        vmag - double[]
        vout - double[]
        Throws:
        SpiceErrorException - exception
      • vcrss

        public static double[] vcrss​(double[] v1,
                                     double[] v2)
                              throws SpiceErrorException
        Compute the cross product of two double precision, 3-dimensional vectors.
        Parameters:
        v1 - double[]
        v2 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • vdist

        public static double vdist​(double[] v1,
                                   double[] v2)
                            throws SpiceErrorException
        Compute the distance between two double precision, 3-dimensional vectors.
        Parameters:
        v1 - double[]
        v2 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • vhat

        public static double[] vhat​(double[] v1)
                             throws SpiceErrorException
        Return a unit vector parallel to a given 3-dimensional vector.
        Parameters:
        v1 - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • vnorm

        public static double vnorm​(double[] v1)
                            throws SpiceErrorException
        Compute the magnitude of a double precision, 3-dimensional vector.
        Parameters:
        v1 - double[]
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • vperp

        public static double[] vperp​(double[] a,
                                     double[] b)
                              throws SpiceErrorException
        Return the component of a vector perpendicular to a given 3-dimensional vector.
        Parameters:
        a - double[]
        b - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • vproj

        public static double[] vproj​(double[] a,
                                     double[] b)
                              throws SpiceErrorException
        Return the projection of a vector onto a given 3-dimensional vector.
        Parameters:
        a - double[]
        b - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • vprjp

        public static double[] vprjp​(double[] vin,
                                     double[] plane)
                              throws SpiceErrorException
        Return the orthogonal projection of a vector onto a given plane.
        Parameters:
        vin - double[]
        plane - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • vprjpi

        public static void vprjpi​(double[] vin,
                                  double[] projpl,
                                  double[] invpl,
                                  double[] vout,
                                  boolean[] found)
                           throws SpiceErrorException
        Return the pre-image in a given plane of the orthogonal projection of a vector onto a given plane.
        Parameters:
        vin - double[]
        found - boolean[]
        projpl - double[]
        vout - double[]
        invpl - double[]
        Throws:
        SpiceErrorException - exception
      • vrotv

        public static double[] vrotv​(double[] v1,
                                     double[] axis,
                                     double theta)
                              throws SpiceErrorException
        Rotate a vector about a given 3-dimensional vector.
        Parameters:
        v1 - double[]
        theta - double
        axis - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • vsep

        public static double vsep​(double[] v1,
                                  double[] v2)
                           throws SpiceErrorException
        Compute the angular separation between two double precision, 3-dimensional vectors.
        Parameters:
        v1 - double[]
        v2 - double[]
        Returns:
        double
        Throws:
        SpiceErrorException - exception
      • wncomd

        public static double[] wncomd​(double left,
                                      double right,
                                      double[] window)
                               throws SpiceErrorException
        Compute the complement with respect to a specified interval of a CSPICE window.
        Parameters:
        left - double
        window - double[]
        right - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wncond

        public static double[] wncond​(double left,
                                      double right,
                                      double[] window)
                               throws SpiceErrorException
        Contract each of the intervals of a CSPICE window.
        Parameters:
        left - double
        window - double[]
        right - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wndifd

        public static double[] wndifd​(double[] a,
                                      double[] b)
                               throws SpiceErrorException
        Compute the difference of two CSPICE windows.
        Parameters:
        a - double[]
        b - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnelmd

        public static boolean wnelmd​(double point,
                                     double[] window)
                              throws SpiceErrorException
        Determine whether a point is contained in a specified CSPICE window.
        Parameters:
        point - double
        window - double[]
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • wnexpd

        public static double[] wnexpd​(double left,
                                      double right,
                                      double[] window)
                               throws SpiceErrorException
        Expand each of the intervals of a CSPICE window.
        Parameters:
        left - double
        window - double[]
        right - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnextd

        public static double[] wnextd​(java.lang.String side,
                                      double[] window)
                               throws SpiceErrorException
        Extract the left or right endpoints from a CSPICE window.
        Parameters:
        side - String
        window - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnfild

        public static double[] wnfild​(double small,
                                      double[] window)
                               throws SpiceErrorException
        Fill small gaps between adjacent intervals of a CSPICE window.
        Parameters:
        small - double
        window - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnfltd

        public static double[] wnfltd​(double small,
                                      double[] window)
                               throws SpiceErrorException
        Filter small intervals from a CSPICE window.
        Parameters:
        small - double
        window - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnincd

        public static boolean wnincd​(double left,
                                     double right,
                                     double[] window)
                              throws SpiceErrorException
        Determine whether an interval is included in a CSPICE window.
        Parameters:
        left - double
        window - double[]
        right - double
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • wninsd

        public static double[] wninsd​(double left,
                                      double right,
                                      double[] window)
                               throws SpiceErrorException
        Insert an interval into a CSPICE window.
        Parameters:
        left - double
        window - double[]
        right - double
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnintd

        public static double[] wnintd​(double[] a,
                                      double[] b)
                               throws SpiceErrorException
        Compute the intersection of two CSPICE windows.
        Parameters:
        a - double[]
        b - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnreld

        public static boolean wnreld​(double[] a,
                                     java.lang.String op,
                                     double[] b)
                              throws SpiceErrorException
        Compare two SPICE windows.
        Parameters:
        a - double[]
        b - double[]
        op - String
        Returns:
        boolean
        Throws:
        SpiceErrorException - exception
      • wnsumd

        public static void wnsumd​(double[] window,
                                  double[] meas,
                                  double[] avg,
                                  double[] stddev,
                                  int[] shortest,
                                  int[] longest)
                           throws SpiceErrorException
        Summarize the contents of a SPICE window.
        Parameters:
        window - double[]
        longest - int[]
        meas - double[]
        shortest - int[]
        avg - double[]
        stddev - double[]
        Throws:
        SpiceErrorException - exception
      • wnunid

        public static double[] wnunid​(double[] a,
                                      double[] b)
                               throws SpiceErrorException
        Compute the union of two CSPICE windows.
        Parameters:
        a - double[]
        b - double[]
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • wnvald

        public static double[] wnvald​(int size,
                                      int card,
                                      double[] endpoints)
                               throws SpiceErrorException
        Validate a CSPICE window.
        Parameters:
        size - int
        endpoints - double[]
        card - int
        Returns:
        double[]
        Throws:
        SpiceErrorException - exception
      • xf2eul

        public static void xf2eul​(double[] xform,
                                  int[] axes,
                                  double[] angles,
                                  boolean[] unique)
                           throws SpiceErrorException
        Convert a state transformation matrix and a sequence of axes to a sequence of Euler angles and corresponding rates.
        Parameters:
        xform - double[]
        unique - boolean[]
        axes - int[]
        angles - double[]
        Throws:
        SpiceErrorException - exception
      • xf2rav

        public static void xf2rav​(double[] xform,
                                  double[][] r,
                                  double[] av)
                           throws SpiceErrorException
        Convert a state transformation matrix and a sequence of axes to a sequence of Euler angles and corresponding rates.
        Parameters:
        xform - double[]
        av - double[]
        r - double[][]
        Throws:
        SpiceErrorException - exception
      • termPl02

        public static void termPl02​(int handle,
                                    int[] dladsc,
                                    java.lang.String trmtyp,
                                    java.lang.String source,
                                    java.lang.String target,
                                    double et,
                                    java.lang.String fixfrm,
                                    java.lang.String abcorr,
                                    java.lang.String obsrvr,
                                    int npoints,
                                    double[] trgepc,
                                    double[] obspos,
                                    double[][] trmpts,
                                    int[] plateIDs)
                             throws SpiceErrorException
        Compute a set of points on the umbral or penumbral terminator of a specified target body, where the target body's surface is represented by a triangular plate model contained in a type 2 DSK segment.
        Parameters:
        handle - int
        plateIDs - int[]
        dladsc - int[]
        trmpts - double[][]
        trmtyp - String
        obspos - double[]
        source - String
        trgepc - double[]
        target - String
        npoints - int
        et - double
        obsrvr - String
        fixfrm - String
        abcorr - String
        Throws:
        SpiceErrorException - exception