- java.lang.Object
-
- spice.basic.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.
-
-
-
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
- Stringtype
- Stringname
- Stringdivby
- intcomp
- Stringsize
- int- Returns:
- boolean
- Throws:
SpiceErrorException
- exception
-
bodc2n
public static java.lang.String bodc2n(int code) throws SpiceErrorException, NameNotFoundException
Translate the SPICE integer code of a body into a common name for that body.- Parameters:
code
- int- Returns:
- String
- Throws:
SpiceErrorException
- exceptionNameNotFoundException
- 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
- intitem
- String- Returns:
- boolean
- Throws:
SpiceErrorException
- exception
-
bodn2c
public static int bodn2c(java.lang.String name) throws SpiceErrorException, IDCodeNotFoundException
Translate the name of a body into the SPICE integer ID code for that body.- Parameters:
name
- String- Returns:
- int
- Throws:
SpiceErrorException
- exceptionIDCodeNotFoundException
- exception
-
bods2c
public static int bods2c(java.lang.String name) throws SpiceErrorException, IDCodeNotFoundException
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.- Parameters:
name
- String- Returns:
- int
- Throws:
SpiceErrorException
- exceptionIDCodeNotFoundException
- 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 intitem
- 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
- intfound
- boolean[] boolean[]clssid
- intcenter
- 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
-
ckcls
public static void ckcls(int handle) throws SpiceErrorException
Close a CK file.- Parameters:
handle
- int int- 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
- Stringcover
- double[]idcode
- intsize
- intneedav
- booleantimsys
- Stringlevel
- Stringtol
- 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
- intfound
- boolean[] boolean[]sclkdp
- double doubleclkout
- double[]tol
- doublecmat
- 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
- intfound
- boolean[] boolean[]sclkdp
- double doubleclkout
- double[]tol
- doubleav
- double[]ref
- String Stringcmat
- double[][]- Throws:
SpiceErrorException
- exception
-
ckupf
public static void ckupf(int handle) throws SpiceErrorException
Unload a CK from the CKBSR system.- Parameters:
handle
- int int- 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
- intmeta
- 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
- Stringids
- 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
- Stringncomch
- intifname
- 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 intavvs
- double[]begtim
- doublequats
- double[]endtim
- doublesclkdp
- double double[]inst
- intnrec
- intref
- String Stringsegid
- String Stringavflag
- 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 intrates
- double[]begtim
- doubleavvs
- double[]endtim
- doublequats
- double[]inst
- intstop
- double[]ref
- String Stringstart
- double[]segid
- String Stringnrec
- 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 intstarts
- double[]begtim
- doublenints
- intendtim
- doubleavvs
- double[]inst
- intquats
- double[]ref
- String Stringsclkdp
- double double[]avflag
- booleannrec
- intsegid
- String String- Throws:
SpiceErrorException
- exception
-
clight
public static double clight()
Return the speed of light.- Returns:
- double
-
clpool
public static void clpool() throws SpiceErrorException
Clear the kernel pool.- Throws:
SpiceErrorException
- exception
-
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
- doubleout
- Stringin
- 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
- doublez
- doublelon
- 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
- doublez
- doublelon
- 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
- doublez
- doublelon
- 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 intbuffer
- 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
-
dafdc
public static void dafdc(int handle) throws SpiceErrorException
Delete comments from a DAF.- 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 intdone
- boolean[]bufsiz
- intbuffer
- String[]lenout
- intn
- int[]- Throws:
SpiceErrorException
- exception
-
daffna
public static boolean daffna() throws SpiceErrorException
Find the next (forward) array in the current DAF.- Returns:
- boolean
- Throws:
SpiceErrorException
- exception
-
daffpa
public static boolean daffpa() throws SpiceErrorException
Find the previous (backward) array in the current DAF.- Returns:
- boolean
- 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 intend
- intbegin
- 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
-
dafgsr
public static double[] dafgsr(int handle, int recno, int begin, int end) throws SpiceErrorException, DAFRecordNotFoundException
Return the specified summary record.- Parameters:
handle
- int intend
- intrecno
- intbegin
- int- Returns:
- double[]
- Throws:
SpiceErrorException
- exceptionDAFRecordNotFoundException
- 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 intrecno
- 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 intfree
- 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
- intdc
- 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 intbuffer
- String[]- Throws:
SpiceErrorException
- exception
-
dasdc
public static void dasdc(int handle) throws SpiceErrorException
Delete comments from a DAS file.- Parameters:
handle
- int int- 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 intdone
- boolean[]bufsiz
- intbuffer
- String[]lenout
- intn
- 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 intncomc
- 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
- doublez
- doubley
- 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
- doubleeptype
- 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
- doublef
- doubley
- doublere
- doublez
- 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 intfound
- 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 intfound
- 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 intfound
- 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 intfound
- 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
- doublez
- doubley
- 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 Stringf
- doublex
- doublere
- doubley
- doublez
- 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 doublez
- doublelongitude
- 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 doublef
- doublelatitude
- double doublere
- doublealtitude
- 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 doublelatitude
- double doublelongitude
- 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 Stringf
- doublelongitude
- double doublere
- doublelatitude
- double doublealtitude
- 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 doublelongitude
- double doublecolatitude
- 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 intvoxnpl
- 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 introom
- intdladsc
- int[] int[]start
- intitem
- 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 intdladsc
- 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 introom
- intdladsc
- int[] int[]start
- intitem
- 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
- intspaixi
- int[]vrtces
- double[]spaixd
- double[]np
- intspxisz
- intplates
- int[]makvtl
- booleanfinscl
- doublevoxlsz
- intcorscl
- intvoxpsz
- intworksz
- 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 intplid
- intdladsc
- 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
- Stringids
- 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
- Stringncomch
- intifname
- 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 introom
- intdladsc
- 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
- intmxcor3
- double[]vrtces
- double[]mncor3
- double[]np
- intcorpar
- 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
- intdpval
- 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
- Stringsrfids
- int[]bodyid
- intsize
- 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 introom
- intdladsc
- 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 intspaixi
- int[]center
- int intspaixd
- double[]surfce
- intplates
- int[]dclass
- intnp
- intframe
- String Stringvrtces
- double[]corsys
- intnv
- intcorpar
- double[]last
- double doublemncor1
- doublefirst
- double doublemxcor1
- doublemxcor3
- doublemncor2
- doublemncor3
- doublemxcor2
- 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 intfound
- 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
- booleanfound
- boolean[] boolean[]target
- String Stringic
- int[]nsurf
- intdc
- double[]srflst
- int[]dskdsc
- double[]et
- double doubledladsc
- int[] int[]fixref
- String Stringhandle
- int int[]vertex
- double[] double[]xpt
- double[] double[]raydir
- double[]maxi
- intmaxd
- 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
- booleanfndarr
- boolean[]target
- String Stringnsurf
- intsrflst
- int[]vtxarr
- double[][]dirarr
- double[][]xptarr
- double[][]et
- double doublenrays
- intfixref
- 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 intnp
- 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
- doublez
- doubley
- 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
- Stringtype
- 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
-
dvpool
public static void dvpool(java.lang.String name) throws SpiceErrorException
Delete a kernel pool variable.- Parameters:
name
- String- 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
- doubleviewpt
- double[]b
- doublec
- 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
- Stringb
- 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
- Stringaction
- 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
- Stringdevice
- 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 doubleampm
- String[]body
- String inttime
- String[]lon
- doublesec
- int[]type
- Stringmin
- 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 doubleprec
- intformat
- 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
- intfound
- 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
-
gcpool
public static java.lang.String[] gcpool(java.lang.String name, int start, int room) throws SpiceErrorException, KernelVarNotFoundException
Return the character value of a kernel variable from the kernel pool.- Parameters:
name
- Stringroom
- intstart
- int- Returns:
- String[]
- Throws:
SpiceErrorException
- exceptionKernelVarNotFoundException
- exception
-
gdpool
public static double[] gdpool(java.lang.String name, int start, int room) throws SpiceErrorException, KernelVarNotFoundException
Return the double precision value of a kernel variable from the kernel pool.- Parameters:
name
- Stringroom
- intstart
- int- Returns:
- double[]
- Throws:
SpiceErrorException
- exceptionKernelVarNotFoundException
- 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 doublef
- doublelatitude
- double doublere
- doublealtitude
- 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
- Stringtype
- 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
- intbounds
- double[]shape
- String[]size
- int[]ref
- String String[]bsight
- double[]- Throws:
SpiceErrorException
- exception
-
gfbail
public static boolean gfbail() throws SpiceErrorException
Indicate whether an interrupt was detected.- Returns:
- boolean
- Throws:
SpiceErrorException
- exception
-
gfclrh
public static void gfclrh() throws SpiceErrorException
Clear interrupt status.- 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 Stringcnfine
- double[]abcorr
- String Stringnintvls
- intobsrvr
- String Stringstep
- doublerelate
- Stringadjust
- doublerefval
- 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 Stringcnfine
- double[]angtyp
- Stringnintvls
- inttarget
- String Stringstep
- doubleillmn
- Stringadjust
- doublefixref
- String Stringrefval
- doubleabcorr
- String Stringrelate
- Stringobsrvr
- String Stringspoint
- 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
- Stringutils
- GFSearchUtilsfront
- Stringcnfine
- double[]fshape
- Stringnintvls
- intfframe
- Stringobsrvr
- String Stringback
- Stringabcorr
- String Stringbshape
- Stringbframe
- 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
- Stringcover
- double[]classID
- intsize
- 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
- Stringids
- 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
- Stringcnfine
- double[]front
- Stringnintvls
- intfshape
- Stringstep
- doublefframe
- Stringobsrvr
- String Stringback
- Stringabcorr
- String Stringbshape
- Stringbframe
- 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 Stringcnfine
- double[]illum
- Stringnintvls
- intabcorr
- String Stringstep
- doubleobsrvr
- String Stringadjust
- doublerelate
- Stringrefval
- 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 Stringcnfine
- double[]frame
- String Stringnintvls
- intabcorr
- String Stringstep
- doubleobsrvr
- String Stringadjust
- doublecrdsys
- Stringrefval
- doublecoord
- Stringrelate
- 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
- doubles2
- booleant2
- doubles1
- boolean- Returns:
- double
- Throws:
SpiceErrorException
- exception
-
gfrepf
public static void gfrepf() throws SpiceErrorException
Finalize a GF progress report.- 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
- Stringbegmsg
- String- Throws:
SpiceErrorException
- exception
-
gfrepu
public static void gfrepu(double ivbeg, double ivend, double time) throws SpiceErrorException
Update a GF progress report.- Parameters:
ivbeg
- doubletime
- doubleivend
- 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
- Stringcnfine
- double[]raydir
- double[]nintvls
- intrframe
- Stringstep
- doubleabcorr
- String Stringobsrvr
- 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 Stringcnfine
- double[]abcorr
- String Stringnintvls
- intobsrvr
- String Stringstep
- doublerelate
- Stringadjust
- doublerefval
- 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
- Stringcnfine
- double[]shape1
- Stringnintvls
- intframe1
- Stringstep
- doubletarg2
- Stringadjust
- doubleshape2
- Stringrefval
- doubleframe2
- Stringrelate
- Stringabcorr
- String Stringobsrvr
- 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 Stringcnfine
- double[]fixref
- String Stringnintvls
- intmethod
- String Stringstep
- doubleabcorr
- String Stringadjust
- doubleobsrvr
- String Stringrefval
- doubledref
- Stringrelate
- Stringdvec
- double[]coord
- Stringcrdsys
- String- Returns:
- double[]
- Throws:
SpiceErrorException
- exception
-
gfsstp
public static void gfsstp(double step) throws SpiceErrorException
Set the GF step size.- Parameters:
step
- 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
-
gfstol
public static void gfstol(double tol) throws SpiceErrorException
Set the GF tolerance.- Parameters:
tol
- 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 Stringcnfine
- double[]fixref
- String Stringnintvls
- intmethod
- String Stringstep
- doubleabcorr
- String Stringadjust
- doubleobsrvr
- String Stringrefval
- doublecrdsys
- Stringrelate
- Stringcoord
- 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
- Stringcnfine
- double[]target
- String Stringnintvls
- inttshape
- Stringstep
- doubletframe
- Stringobsrvr
- String Stringabcorr
- 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
- GFScalarQuantitycnfine
- double[]relate
- Stringnintvls
- intrefval
- doublestep
- doubleadjust
- double- Returns:
- double[]
- Throws:
SpiceErrorException
- exception
-
gipool
public static int[] gipool(java.lang.String name, int start, int room) throws SpiceErrorException, KernelVarNotFoundException
Return the integer value of a kernel variable from the kernel pool.- Parameters:
name
- Stringroom
- intstart
- int- Returns:
- int[]
- Throws:
SpiceErrorException
- exceptionKernelVarNotFoundException
- 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
- Stringroom
- intstart
- 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
- doublefound
- boolean[] boolean[]b
- doubleellipse
- double[]c
- doubleplane
- 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 Stringlit
- boolean[]target
- String Stringvisibl
- boolean[]ilusrc
- Stringet
- double doublesrfvec
- double[] double[]fixref
- String Stringtrgepc
- double[] double[]abcorr
- String Stringangles
- 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 intangles
- double[]dladsc
- int[] int[]srfvec
- double[] double[]target
- String Stringtrgepc
- double[] double[]et
- double doublespoint
- double[] double[]abcorr
- String Stringobsrvr
- 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 Stringangles
- double[]target
- String Stringsrfvec
- double[] double[]et
- double doubletrgepc
- double[]fixref
- Stringspoint
- double[]abcorr
- Stringobsrvr
- 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
- doublentol
- 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
- intfound
- boolean[]kind
- Stringhandle
- 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
- Stringfound
- 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 doublelatitude
- double doublelongitude
- 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 doublelatitude
- double doublelongitude
- 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
- doublelatitude
- doublelongitude
- 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
- Stringlonlat
- double[][]target
- Stringnpts
- int[] intet
- doublefixref
- 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
- Stringtangts
- double[][]target
- Stringepochs
- double[]et
- doublepoints
- double[][]fixref
- Stringnpts
- int[]abcorr
- Stringmaxn
- intcorloc
- Stringsoltol
- doubleobsrvr
- Stringschstp
- doublerefvec
- double[]ncuts
- introlstp
- 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
- intplateIDs
- int[]dladsc
- int[]limbpts
- double[][]target
- Stringobspos
- double[]et
- doubletrgepc
- double[]fixfrm
- Stringnpoints
- intabcorr
- Stringobsrvr
- 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
- intplateIDs
- 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
- intetobs
- doubledir
- 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
- doubledist
- double[]b
- doublepoint
- double[]c
- doublelinedr
- 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
- doublepoint
- double[]b
- doublec
- 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
- Stringet
- doubleshape1
- Stringobsrvr
- Stringframe1
- Stringabcorr
- Stringtarg2
- Stringframe2
- Stringshape2
- 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
- doubleet
- 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
- doubleet
- double- Returns:
- double[]
- Throws:
SpiceErrorException
- exception
-
pckcls
public static void pckcls(int handle) throws SpiceErrorException
Close a binary PCK file.- Parameters:
handle
- int- 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
- Stringncomch
- intifname
- String- Returns:
- int
- Throws:
SpiceErrorException
- exception
-
pckuof
public static void pckuof(int handle) throws SpiceErrorException
Unload a binary PCK from the PCKBSR system.- Parameters:
handle
- 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
- intbtime
- doubleclssid
- intcdata
- double[]frame
- String Stringpolydg
- intfirst
- double doublen
- intlast
- double doubleintlen
- doublesegid
- 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
- Stringcvals
- 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
- Stringdvals
- 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 Stringf
- doublelongitude
- doublere
- doublelatitude
- doublealtitude
- 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
- Stringivals
- 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
- intplates
- 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
- intplates
- 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
- doublepvprop
- 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
- Stringet
- doubleto
- 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
- Stringetfrom
- doubleto
- Stringetto
- 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
- doubledec
- doublera
- 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
- doubleRe
- 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
- Stringf
- doublerectan
- 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 doubleiaxis
- 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 intangle
- 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
- intangle
- 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 intsclkdp
- 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 intet
- 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
- intet
- 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
- intsclkch
- 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
- intsclkdp
- 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
- intsclkch
- 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
- intsclkdp
- 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
- intclkstr
- 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
- Stringfound
- boolean[]target
- Stringsrfvec
- double[] double[]et
- doubletrgepc
- double[]fixref
- Stringspoint
- double[]abcorr
- Stringdvec
- double[]obsrvr
- Stringdref
- 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
- doublelongitude
- doublecolatitude
- 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
- doublelongitude
- doublecolatitude
- 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
- doublelongitude
- doublecolatitude
- double- Returns:
- double[]
- Throws:
SpiceErrorException
- exception
-
spkcls
public static void spkcls(int handle) throws SpiceErrorException
Close an SPK file.- Parameters:
handle
- int- 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
- Stringcover
- double[]body
- Stringsize
- 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
- Stringlt
- double[] double[]et
- doublestate
- double[] double[]outref
- String Stringobsref
- Stringrefloc
- String Stringobsctr
- Stringabcorr
- Stringobspos
- 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 Stringstate
- double[] double[]trgref
- String Stringobsrvr
- Stringet
- doubleabcorr
- Stringoutref
- String Stringrefloc
- 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
- Stringlt
- double[] double[]et
- doublestate
- double[] double[]outref
- String Stringobsref
- Stringrefloc
- String Stringobsctr
- Stringabcorr
- Stringobsepc
- doubleobssta
- 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
- Stringobsrvr
- Stringtrgref
- Stringabcorr
- Stringet
- doublerefloc
- Stringoutref
- 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
- Stringlt
- double[]et
- doublestate
- double[]ref
- Stringobserver
- Stringabcorr
- 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
- Stringids
- 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
- Stringncomch
- intifname
- 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
- Stringlt
- double[]et
- doublepos
- double[]ref
- Stringobserver
- Stringabcorr
- String- Throws:
SpiceErrorException
- exception
-
spkuef
public static void spkuef(int handle) throws SpiceErrorException
Unload an SPK from the SPKBSR system.- Parameters:
handle
- int- 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
- intbtime
- doublebody
- Stringcdata
- double[]center
- int intpolydg
- intframe
- String Stringn
- intfirst
- double doubleintlen
- doublelast
- double doublesegid
- 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
- intbtime
- doublebody
- Stringcdata
- double[]center
- int intpolydg
- intframe
- String Stringn
- intfirst
- double doubleintlen
- doublelast
- double doublesegid
- 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
- intepochs
- double[]body
- Stringstates
- double[]center
- int intn
- intframe
- String Stringgm
- doublefirst
- double doublesegid
- String Stringlast
- 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
- intepochs
- double[]body
- Stringstates
- double[]center
- intn
- intframe
- Stringdegree
- intfirst
- doublesegid
- Stringlast
- 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
- intepochs
- double[]body
- Stringstates
- double[]center
- intn
- intframe
- Stringdegree
- intfirst
- doublesegid
- Stringlast
- 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
- intisname
- boolean[]bodyid
- Stringsrfstr
- 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
- intisname
- boolean[]bodstr
- Stringsrfstr
- 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
- Stringsrfpts
- double[][]target
- Stringnpts
- int[]et
- doublefixref
- 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
- Stringfound
- boolean[]bodstr
- Stringcode
- 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
- Stringfound
- boolean[]bodyid
- Stringcode
- 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
- Stringfound
- boolean[]nth
- intcomponent
- String[]contin
- String- Throws:
SpiceErrorException
- exceptionKernelVarNotFoundException
- 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
- Stringsrfvec
- double[]target
- Stringtrgepc
- double[]et
- doublespoint
- double[]fixref
- Stringobsrvr
- Stringabcorr
- 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
- intplateID
- int[]dladsc
- int[]alt
- double[]method
- Stringspoint
- double[]target
- Stringobsrvr
- Stringet
- doubleabcorr
- 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
- Stringsrfvec
- double[]target
- Stringtrgepc
- double[]et
- doublespoint
- double[]fixref
- Stringobsrvr
- Stringabcorr
- 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
- intplateID
- int[]dladsc
- int[]alt
- double[]method
- Stringspoint
- double[]target
- Stringobsrvr
- Stringet
- doubleabcorr
- 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
- doublepoint
- double[]b
- doublec
- 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
- doublec
- doubleb
- 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
- Stringnames
- 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
- Stringet
- doubleto
- 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
- Stringtrmvcs
- double[][]ilusrc
- Stringepochs
- double[]target
- Stringpoints
- double[][]et
- doublenpts
- int[]fixref
- Stringmaxn
- intabcorr
- Stringsoltol
- doublecorloc
- Stringschstp
- doubleobsrvr
- Stringncuts
- intrefvec
- 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
- doublepicture
- 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
- Stringerrmsg
- 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
- Stringerrmsg
- 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
- intindexa
- intplndef
- 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
- doubleoutsys
- Stringinsys
- String- Returns:
- double
- Throws:
SpiceErrorException
- exception
-
unload
public static void unload(java.lang.String file) throws SpiceErrorException
Unload a SPICE kernel.- Parameters:
file
- String- 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
- doubleaxis
- 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
- doublewindow
- 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
- doublewindow
- 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
- doublewindow
- 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
- doublewindow
- 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
- Stringwindow
- 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
- doublewindow
- 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
- doublewindow
- 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
- doublewindow
- 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
- doublewindow
- 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
- intendpoints
- 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
- intplateIDs
- int[]dladsc
- int[]trmpts
- double[][]trmtyp
- Stringobspos
- double[]source
- Stringtrgepc
- double[]target
- Stringnpoints
- intet
- doubleobsrvr
- Stringfixfrm
- Stringabcorr
- String- Throws:
SpiceErrorException
- exception
-
-