|
JNISpice version 2.0.0 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectspice.basic.Vector6
spice.basic.StateVector
spice.basic.StateRecord
public class StateRecord
Class StateRecord represents the states (positions and velocities) of ephemeris objects relative to other objects; state records carry along with them one-way light time between target and observer.
The numerical results shown for these examples may differ across platforms. The results depend on the SPICE kernels used as input, the compiler and supporting libraries, and the machine specific arithmetic implementation.
1) Find the apparent state of the Moon as seen from the Earth, expressed in the J2000 reference frame, at the observation epoch 2009 JUL 09 00:00:00 TDB. Use light time and stellar aberration corrections.
Use the meta-kernel shown below to load the required SPICE kernels.
KPL/MK This meta-kernel is intended to support operation of SPICE example programs. The kernels shown here should not be assumed to contain adequate or correct versions of data required by SPICE-based user applications. In order for an application to use this meta-kernel, the kernels referenced here must be present in the user's current working directory. The names and contents of the kernels referenced by this meta-kernel are as follows: File name Contents --------- -------- de421.bsp Planetary ephemeris pck00008.tpc Planet orientation and radii naif0009.tls Leapseconds \begindata KERNELS_TO_LOAD = ( '/kernels/gen/lsk/naif0009.tls' '/kernels/gen/spk/de421.bsp' '/kernels/gen/pck/pck00008.tpc' )
Example code begins here.
import spice.basic.*; class StateRecordEx1 { // // Load the JNISpice shared object library // at initialization time. // static { System.loadLibrary( "JNISpice" ); } public static void main ( String[] args ) { try { // // Load kernels. // KernelDatabase.load ( "standard.tm" ); // // Create input objects required to specify the // StateRecord. // String timstr = "2009 JUL 09 00:00:00 TDB"; Body target = new Body ( "Moon" ); TDBTime et = new TDBTime ( timstr ); ReferenceFrame ref = new ReferenceFrame( "J2000" ); AberrationCorrection abcorr = new AberrationCorrection( "LT+S" ); Body observer = new Body ( 399 ); // // Create a StateRecord and display it. // StateRecord s = new StateRecord ( target, et, ref, abcorr, observer ); System.out.println ( s ); } catch ( SpiceException exc ) { exc.printStackTrace(); } } }
When run on a PC/Linux/java 1.6.0_14/gcc platform, the output from this program was:
State vector = X: 2.283960670189394e+05 (km) Y: -3.088436590471006e+05 (km) Z: -1.308849289940148e+05 (km) VX: 7.946652340856368e-01 (km/s) VY: 4.715096134721694e-01 (km/s) VZ: 3.015826664840431e-01 (km/s) Distance = 4.058078779436026e+05 (km) Speed = 9.719908716570748e-01 (km/s) One way light time = 1.353629376305400e+00 (s)
Added constructors corresponding to CSPICE methods CSPICE.spkcpo CSPICE.spkcpt CSPICE.spkcvo CSPICE.spkcvt
Constructor Summary | |
---|---|
StateRecord(Body target,
Time t,
ReferenceFrame ref,
AberrationCorrection abcorr,
Body observer)
Construct aberration-corrected StateRecord from ephemeris data. |
|
StateRecord(Body target,
Time t,
ReferenceFrame outref,
java.lang.String refloc,
AberrationCorrection abcorr,
Vector3 obspos,
Body obsctr,
ReferenceFrame obsref)
Construct aberration-corrected StateRecord from ephemeris data and an observer position vector. |
|
StateRecord(Body target,
Time t,
ReferenceFrame outref,
java.lang.String refloc,
AberrationCorrection abcorr,
Vector6 obssta,
Time obsepc,
Body obsctr,
ReferenceFrame obsref)
Construct aberration-corrected StateRecord from ephemeris data and an observer state vector. |
|
StateRecord(StateRecord sr)
Copy constructor. |
|
StateRecord(Vector3 trgpos,
Body trgctr,
ReferenceFrame trgref,
Time t,
ReferenceFrame outref,
java.lang.String refloc,
AberrationCorrection abcorr,
Body obsrvr)
Construct aberration-corrected StateRecord from ephemeris data and a target position vector. |
|
StateRecord(Vector6 trgsta,
Time trgepc,
Body trgctr,
ReferenceFrame trgref,
Time t,
ReferenceFrame outref,
java.lang.String refloc,
AberrationCorrection abcorr,
Body obsrvr)
Construct aberration-corrected StateRecord from ephemeris data and a target state vector. |
Method Summary | |
---|---|
TDBDuration |
getLightTime()
Get one way light time between target and observer. |
StateVector |
getStateVector()
Get the state vector. |
java.lang.String |
toString()
Create a String representation of this StateRecord. |
Methods inherited from class spice.basic.StateVector |
---|
correctStelab, correctStelabXmit, getPosition, getVelocity |
Methods inherited from class spice.basic.Vector6 |
---|
add, assign, dcross, ddot, dhat, dist, dot, dsep, getElt, getVector3, isZero, lcom, negate, norm, scale, sub, toArray |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public StateRecord(StateRecord sr) throws SpiceException
This constructor creates a deep copy.
SpiceException
public StateRecord(Body target, Time t, ReferenceFrame ref, AberrationCorrection abcorr, Body observer) throws SpiceException
SpiceException
public StateRecord(Body target, Time t, ReferenceFrame outref, java.lang.String refloc, AberrationCorrection abcorr, Vector3 obspos, Body obsctr, ReferenceFrame obsref) throws SpiceException
SpiceException
public StateRecord(Body target, Time t, ReferenceFrame outref, java.lang.String refloc, AberrationCorrection abcorr, Vector6 obssta, Time obsepc, Body obsctr, ReferenceFrame obsref) throws SpiceException
SpiceException
public StateRecord(Vector3 trgpos, Body trgctr, ReferenceFrame trgref, Time t, ReferenceFrame outref, java.lang.String refloc, AberrationCorrection abcorr, Body obsrvr) throws SpiceException
SpiceException
public StateRecord(Vector6 trgsta, Time trgepc, Body trgctr, ReferenceFrame trgref, Time t, ReferenceFrame outref, java.lang.String refloc, AberrationCorrection abcorr, Body obsrvr) throws SpiceException
SpiceException
Method Detail |
---|
public java.lang.String toString()
toString
in class StateVector
public StateVector getStateVector() throws SpiceException
SpiceException
public TDBDuration getLightTime()
|
JNISpice version 2.0.0 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |