 |
Isis 3 Programmer Reference
|
|
Isis 3 Programmer Reference
|
Class for computing sensor ground coordinates. More...
#include <Sensor.h>
Public Member Functions | |
| Sensor (Cube &cube) | |
| Constructs a Sensor object and loads SPICE kernels using information from the label object. More... | |
| virtual | ~Sensor () |
| Destroys the Sensor. More... | |
| void | setTime (const iTime &time) |
| By setting the time you essential set the position of the spacecraft and body as indicated in the class Spice. More... | |
| bool | SetLookDirection (const double v[3]) |
| Sets the look direction of the spacecraft. More... | |
| bool | SetRightAscensionDeclination (const double ra, const double dec) |
| Given the ra/dec compute the look direction. More... | |
| bool | SetUniversalGround (const double latitude, const double longitude, bool backCheck=true) |
| This is the opposite routine for SetLookDirection. More... | |
| bool | SetUniversalGround (const double latitude, const double longitude, const double radius, bool backCheck=true) |
| This overloaded method has the opposite function as SetLookDirection. More... | |
| bool | SetGround (const SurfacePoint &surfacePt, bool backCheck=true) |
| This overloaded method has the opposite function as SetLookDirection. More... | |
| bool | HasSurfaceIntersection () const |
| Returns if the last call to either SetLookDirection or SetUniversalGround had a valid intersection with the target. More... | |
| void | Coordinate (double p[3]) const |
| Returns the x,y,z of the surface intersection in BodyFixed km. More... | |
| double | UniversalLatitude () const |
| Returns the planetocentric latitude, in degrees, at the surface intersection point in the body fixed coordinate system. More... | |
| Latitude | GetLatitude () const |
| Returns a planetocentric latitude object at the surface intersection point in body fixed. More... | |
| double | UniversalLongitude () const |
| Returns the positive east, 0-360 domain longitude, in degrees, at the surface intersection point in the body fixed coordinate system. More... | |
| Longitude | GetLongitude () const |
| Returns a positive east, 0-360 domain longitude object at the surface intersection point in the body fixed coordinate system. More... | |
| SurfacePoint | GetSurfacePoint () const |
| Returns the surface point (most efficient accessor). More... | |
| Distance | LocalRadius () const |
| Returns the local radius at the intersection point. More... | |
| Distance | LocalRadius (Latitude lat, Longitude lon) |
| Returns the local radius at the intersection point. More... | |
| Distance | LocalRadius (double lat, double lon) |
| Returns the local radius at the intersection point. More... | |
| double | PhaseAngle () const |
| Returns the phase angle in degrees. More... | |
| double | EmissionAngle () const |
| Returns the emission angle in degrees. More... | |
| double | IncidenceAngle () const |
| Returns the incidence angle in degrees. More... | |
| void | LookDirection (double v[3]) const |
| Returns the look direction in the camera coordinate system. More... | |
| std::vector< double > | lookDirectionJ2000 () const |
| Returns the look direction in the camera coordinate system. More... | |
| std::vector< double > | lookDirectionBodyFixed () const |
| Returns the look direction in the body fixed coordinate system. More... | |
| double | RightAscension () |
| Returns the right ascension angle (sky longitude). More... | |
| double | Declination () |
| Returns the declination angle (sky latitude). More... | |
| void | SpacecraftSurfaceVector (double scSurfaceVector[3]) const |
| Sets the vector between the spacecraft and surface point in body-fixed. More... | |
| double | SlantDistance () const |
| Return the distance between the spacecraft and surface point in kmv. More... | |
| double | LocalSolarTime () |
| Return the local solar time in hours. More... | |
| double | SolarDistance () const |
| Returns the distance between the sun and surface point in AU. More... | |
| double | SpacecraftAltitude () |
| Returns the distance from the spacecraft to the subspacecraft point in km. More... | |
| virtual double | resolution () |
| Virtual method that returns the pixel resolution of the sensor in meters/pix. More... | |
| void | IgnoreElevationModel (bool ignore) |
| This allows you to ignore the cube elevation model and use the ellipse. More... | |
| virtual QList< QPointF > | PixelIfovOffsets () |
| This method is implemented in Camera which defaults to the (pixel pitch * summing mode ) / 2. More... | |
| virtual QString | instrumentNameLong () const =0 |
| virtual QString | instrumentNameShort () const =0 |
| virtual QString | spacecraftNameLong () const =0 |
| virtual QString | spacecraftNameShort () const =0 |
| void | instrumentPosition (double p[3]) const |
| Returns the spacecraft position in body-fixed frame km units. More... | |
| SpicePosition * | instrumentPosition () const |
| Accessor method for the instrument position. More... | |
| void | instrumentBodyFixedPosition (double p[3]) const |
| Returns the spacecraft position in body-fixed frame km units. More... | |
| void | sunPosition (double p[3]) const |
| Fills the input vector with sun position information, in either body-fixed or J2000 reference frame and km units. More... | |
| SpicePosition * | sunPosition () const |
| Accessor method for the sun position. More... | |
| double | targetCenterDistance () const |
| Calculates and returns the distance from the spacecraft to the target center. More... | |
| Longitude | solarLongitude () |
| Returns the solar longitude. More... | |
| void | instrumentBodyFixedVelocity (double v[3]) const |
| Returns the spacecraft velocity in body-fixed frame km/sec units. More... | |
| iTime | time () const |
| Returns the ephemeris time in seconds which was used to obtain the spacecraft and sun positions. More... | |
| void | radii (Distance r[3]) const |
| Returns the radii of the body in km. More... | |
| void | createCache (iTime startTime, iTime endTime, const int size, double tol) |
| This method creates an internal cache of spacecraft and sun positions over a specified time range. More... | |
| iTime | cacheStartTime () const |
| Accessor method for the cache start time. More... | |
| iTime | cacheEndTime () const |
| Accessor method for the cache end time. More... | |
| void | subSpacecraftPoint (double &lat, double &lon) |
| Returns the sub-spacecraft latitude/longitude in universal coordinates (0-360 positive east, ocentric) More... | |
| void | subSolarPoint (double &lat, double &lon) |
| Returns the sub-solar latitude/longitude in universal coordinates (0-360 positive east, ocentric) More... | |
| Target * | target () const |
| Returns a pointer to the target object. More... | |
| QString | targetName () const |
| Returns the QString name of the target. More... | |
| iTime | getClockTime (QString clockValue, int sclkCode=-1, bool clockTicks=false) |
| This converts the spacecraft clock ticks value (clockValue) to an iTime. More... | |
| SpiceDouble | getDouble (const QString &key, int index=0) |
| This returns a value from the NAIF text pool. More... | |
| SpiceInt | getInteger (const QString &key, int index=0) |
| This returns a value from the NAIF text pool. More... | |
| QString | getString (const QString &key, int index=0) |
| This returns a value from the NAIF text pool. More... | |
| SpiceRotation * | bodyRotation () const |
| Accessor method for the body rotation. More... | |
| SpiceRotation * | instrumentRotation () const |
| Accessor method for the instrument rotation. More... | |
| bool | hasKernels (Pvl &lab) |
| Returns true if the kernel group has kernel files. More... | |
| bool | isTimeSet () |
| Returns true if time has been initialized. More... | |
| SpiceInt | naifBodyCode () const |
| This returns the NAIF body code of the target indicated in the labels. More... | |
| SpiceInt | naifSpkCode () const |
| This returns the NAIF SPK code to use when reading from SPK kernels. More... | |
| SpiceInt | naifCkCode () const |
| This returns the NAIF CK code to use when reading from CK kernels. More... | |
| SpiceInt | naifIkCode () const |
| This returns the NAIF IK code to use when reading from instrument kernels. More... | |
| SpiceInt | naifSclkCode () const |
| This returns the NAIF SCLK code to use when reading from instrument kernels. More... | |
| SpiceInt | naifBodyFrameCode () const |
| This returns the NAIF body frame code. More... | |
| PvlObject | getStoredNaifKeywords () const |
| This returns the PvlObject that stores all of the requested Naif data and can be a replacement for furnishing text kernels. More... | |
Protected Types | |
| enum | SpiceValueType { SpiceDoubleType, SpiceStringType, SpiceIntType, SpiceByteCodeType } |
| NAIF value primitive type. More... | |
Protected Member Functions | |
| QVariant | readValue (QString key, SpiceValueType type, int index=0) |
| This should be used for reading ALL text naif kernel values. More... | |
| void | storeResult (QString name, SpiceValueType type, QVariant value) |
| QVariant | getStoredResult (QString name, SpiceValueType type) |
| void | storeValue (QString key, int index, SpiceValueType type, QVariant value) |
| QVariant | readStoredValue (QString key, SpiceValueType type, int index) |
Protected Attributes | |
| SpiceDouble | m_uB [3] |
| This contains the sun position (u) in the bodyfixed reference frame (B). More... | |
| SpiceDouble | m_BJ [3][3] |
| This contains the transformation matrix from J2000 (J) to Body fixed (B). More... | |
Private Member Functions | |
| void | CommonInitialize (const std::string &demCube) |
| void | computeRaDec () |
| Computes the ra/dec from the look direction. More... | |
| bool | SetGroundLocal (bool backCheck) |
| Computes look vector. More... | |
Private Attributes | |
| SpiceDouble | m_lookB [3] |
| Look direction in body fixed. More... | |
| bool | m_newLookB |
| flag to indicate we need to recompute ra/dec More... | |
| SpiceDouble | m_ra |
| Right ascension (sky longitude) More... | |
| SpiceDouble | m_dec |
| Decliation (sky latitude) More... | |
Class for computing sensor ground coordinates.
The sensor class allows for the computation of parameters related to orbiting instruments. In particular, a time and look direction can be set and from those the ground coordinate (latitude/longitude) along with phase, incidence, and emission angles can be computed. Likewise, a ground point can be set and look direction can be computed. This class is derived from the Spice class.
An important capability of this class is the ability to use a surface model other than an ellipsoid when intersecting the look direction of the sensor with the planetary body. This allows for the generation of othrorectified products. The file containing the surface model is a cube and is obtained from the labels in the follow form:
2003-05-16 Stuart Sides - Modified schema from astrogeology... isis.astrogeology...
2003-05-30 Jeff Anderson - Updated unitTest and truth to account for precision due to optimization
2003-10-16 Jeff Anderson - Added LoadEulerMounting() and LoadFrameMounting() methods
2003-11-26 Jeff Anderson - Modified FrameMounting() methods to allow for fixed frames or time dependent frames
2004-01-14 Jeff Anderson - Remove an unused constructor
2004-01-20 Jeff Anderson - Added an option to the SetUniversalGround() method to eliminate checks for points on the backside of the target
2004-02-18 Jeff Anderson - Fixed a problem with the FrameMounting() methods as the frame kernel is unloaded if a cache is created.
2004-02-23 Jeff Anderson - Fixed two bugs in the handling of DEMs. Used universal lat/lon when appropriate and the radius needed to be converted to km when read from the DEM file.
2005-02-15 Elizabeth Ribelin - Modified file to support Doxygen documentation
2005-02-24 Jeff Anderson - Added SlantDistance() method and made the constructor ignore the ElevationModel keyword if it is null
2005-02-25 Jeff Anderson - Added LocalSolarTime() method
2005-06-09 Elizabeth Ribelin - Added LoadEulerMounting() method that accepts a matrix as a parameter
2005-08-24 Jeff Anderson - Make sure LocalSolarTime always return positive hours
2005-09-20 Jeff Anderson - Added tests for trying to intersect the sky
2006-03-31 Elizabeth Miller - Added SpacecraftAltitude() and SolarDistance() methods
2006-09-07 Debbie A. Cook - Changed back-of-planet test to use emission angle instead of length of vector to surface point
2006-10-11 Jeff Anderson - Modified reading radius from DEM using bilinear interpolation
2006-10-12 Jeff Anderson - Modified the SetLookDirection() method to use the DEM (if available) when computing a ground point
2007-05-18 Jeff Anderson - Modify SpacecraftAltitude() method to use DEM
2007-06-11 Debbie A. Cook - Added alternative method that includes radius
2007-08-24 Debbie A. Cook - Replaced references to m_sB since it was removed from Spice
2007-11-27 Debbie A. Cook - Added overloaded method SetUniversalGround(lat, lon, radius)
2008-05-21 Steven Lambright - CubeManager is now used to speed up DEM Cube I/O
2008-06-18 Debbie A. Cook - Made DemRadius radius public instead of private and added method HasElevationModel()
2008-08-06 Stuart Sides - Modified SetLookDirection() to better handle oblique views. In the past it would oscillate and run out of iterations.
2009-02-06 Debbie A. Cook - Changed the tolerance from 1e-6 to 1e-12 for dist**2 (mm)
2009-02-06 Debbie A. Cook - Changed the tolerance back to 1e-6 (mm)
2009-02-15 Debbie A. Cook - Added virtual Resolution() method
2009-06-30 Steven Lambright - Added IgnoreElevationModel() and fixed DemRadius()
2009-07-09 Debbie A. Cook - Corrected documentation on Resolution() method
2009-09-23 Tracie Sucharski - Convert negative longitudes returned by reclat in SetLookDirection().
2010-09-15 Janet Barrett - Modified the SetLookDirection() method to use a new algorithm for finding the intersection of a ray with the DEM. This was required to take care of problems that were encountered at the poles of global DEM files. The algorithm that is being used was taken from "Intersection between spacecraft viewing vectors and digital elevation models" by N.A. Teanby.
2010-11-09 Eric Hyer - moved some private members to protected section for Camera
2010-12-07 Steven Lambright - Added LocalRadius(lat,lon) and removed a sqrt from SetLookDirection()
2011-01-26 Steven Lambright - The LocalRadius methods now return Distance objects and added a LocalRadius() method that uses the Latitude and Longitude classes.
2011-02-08 Jeannie Walldren - Added method parameter documentation.
2011-02-09 Steven Lambright & Debbie Cook - Refactored heavily to use Latitude, Longitude, SurfacePoint, and iTime where applicable. Optimized SetLookDirection. These changes were meant primarily for readability and reducing error-proneness of the code.
2011-03-28 Janet Barrett - Fixed the SetLookDirection routine so that it checks to make sure that the projection of the DEM is in an Equatorial cylindrical projection before using the new ray tracing routine. The check for this was moved when other code was added. This was causing a problem with footprintinit.
2011-05-03 Jeannie Walldren - Added Isis Disclaimer to files.
2011-05-25 Janet Barrett and Steven Lambright - Moved the ownership of the DEM projection to the DEM cube which is owned by CubeManager.
2011-08-22 Steven Lambright - The DEM cube now uses a UniqueIOCachingAlgorithm(5). This will probably behave better in all cases. Fixes #364
2011-08-16 Jeff Anderson - Fixed a problem with an infinite loop in the ray tracing algorithm. The problem was first exposed when trying to intersect the Vesta DEM on the limb.
2011-12-20 Tracie Sucharski - Added SpacecraftSurfaceVector method which returns the vector between the spacecraft and the surface point in body-fixed.
2012-05-04 Steven Lambright - Re-enabled a safety check in the DemRadius() method which was needed due to Projection not uniformly handling Null inputs. Fixes #807.
2012-07-06 Debbie A. Cook - Updated Spice members to be more compliant with Isis coding standards. References #972.
2012-09-06 Steven Lambright and Stuart Sides - Changed the constructors to take Cube instead of Pvl to prevent redundant parsing. This should eventually be refactored into a CubeLabel or similar object so that an actual cube isn't required in the future, but for now this enables the control net GUI to create a camera from a cube with no dimensions in the label.
2012-10-10 Debbie A. Cook - Moved the functionality related to the shape model into new classes: ShapeModel, EllipsoidShape, DemShape, and EquatorialCylindricalShape. Also modified to use new Target class.
References #775 and #1114
2012-10-25 Jeannie Backer - Changed resolution() method to lower camel case. References #1181.
2012-03-04 Tracie Sucharski - Added new method, PixelIfovOffsets, which will return the ifov offsets from the center of the pixel in mm. This is a virtual method and if not implemented in the specific instrument camera, this class will throw an error. References #1604.
2015-08-11 Ian Humphrey and Makayla Shepherd - Added pure virtual methods to return the long and short spacecraft and instrument names.
2015-10-01 Jeannie Backer - Made improvements to documentation and brought code closer to ISIS coding standards. References #1438
2017-03-23 Kris Becker - Added support for occlusion checks. Modified SetLocalGround(bool backCheck) to make a callback to the ShapeModel::isOccludedFrom() to test for point visability.
|
protectedinherited |
| Isis::Sensor::Sensor | ( | Cube & | cube | ) |
Constructs a Sensor object and loads SPICE kernels using information from the label object.
The constructor expects an Instrument and Kernels group to be in the labels (see Spice documentation).
Definition at line 61 of file Sensor.cpp.
|
virtual |
Destroys the Sensor.
Definition at line 66 of file Sensor.cpp.
|
inherited |
Accessor method for the body rotation.
Definition at line 1478 of file Spice.cpp.
Referenced by computeRaDec(), EmissionAngle(), Isis::RadarGroundMap::GetdXYdPosition(), Isis::RadarGroundMap::GetXY(), Isis::Camera::LocalPhotometricAngles(), lookDirectionJ2000(), PhaseAngle(), Isis::RadarGroundMap::SetFocalPlane(), Isis::RadarGroundMap::SetGround(), SetGround(), SetGroundLocal(), SetLookDirection(), SetUniversalGround(), and SlantDistance().
|
inherited |
|
inherited |
|
private |
Computes the ra/dec from the look direction.
Protected method which computes the ra/dec of the current look direction.
Definition at line 596 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Isis::SpiceRotation::J2000Vector(), m_dec, m_lookB, m_newLookB, m_ra, and Isis::PI.
Referenced by Declination(), and RightAscension().
| void Isis::Sensor::Coordinate | ( | double | p[3] | ) | const |
Returns the x,y,z of the surface intersection in BodyFixed km.
| p[] | The coordinate of the surface intersection. |
Definition at line 211 of file Sensor.cpp.
References Isis::Displacement::kilometers(), Isis::Target::shape(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
Referenced by Isis::ControlPoint::ComputeApriori(), Isis::Camera::ComputeAzimuth(), Isis::Camera::DetectorResolution(), EmissionAngle(), Isis::QnetSetAprioriDialog::fillAverageAprioriLineEdits(), Isis::VimsGroundMap::Init(), Isis::Camera::LocalPhotometricAngles(), Isis::Camera::OffNadirAngle(), PhaseAngle(), SetGround(), SetGroundLocal(), SetLookDirection(), SetUniversalGround(), SlantDistance(), and Isis::AdvancedTrackTool::updateRow().
|
inherited |
This method creates an internal cache of spacecraft and sun positions over a specified time range.
The SPICE kernels are then immediately unloaded. This allows multiple instances of the Spice object to be created as the NAIF toolkit can clash if multiple sets of SPICE kernels are loaded. Note that the cache size is specified as an argument. Therefore, times requested via setTime() which are not directly loaded in the cache will be interpolated. If the instrument position is not cached and cacheSize is greater than 3, the tolerance is passed to the SpicePosition Memcache2HermiteCache() method.
Note: Before this method is called, the private variables m_cacheSize, m_startTime and m_endTime must be set. This is done in the Camera classes using the methods SetCacheSize() and SetStartEndEphemerisTime().
| startTime | Starting ephemeris time to cache |
| endTime | Ending ephemeris time to cache |
| size | Size of the cache. |
| tol | Tolerance. |
| Isis::IException::Programmer | - "Argument cacheSize must be greater than zero" |
| Isis::IException::Programmer | - "Argument startTime must be less than or equal to endTime" |
| Isis::IException::User | - "This instrument does not support time padding" |
Definition at line 574 of file Spice.cpp.
References _FILEINFO_, Isis::iTime::Et(), and Isis::FileName::expanded().
Referenced by Isis::CrismCamera::CrismCamera(), and Isis::Camera::LoadCache().
| double Isis::Sensor::Declination | ( | ) |
Returns the declination angle (sky latitude).
Definition at line 587 of file Sensor.cpp.
References computeRaDec(), m_dec, and m_newLookB.
Referenced by Isis::Camera::CelestialNorthClockAngle(), Isis::VimsSkyMap::Init(), Isis::Camera::RaDecRange(), Isis::Camera::RaDecResolution(), Isis::Camera::RawFocalPlanetoImage(), and Isis::AdvancedTrackTool::updateRow().
| double Isis::Sensor::EmissionAngle | ( | ) | const |
Returns the emission angle in degrees.
Definition at line 339 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Coordinate(), Isis::ShapeModel::emissionAngle(), Isis::Spice::instrumentPosition(), Isis::Target::shape(), and Isis::Spice::target().
Referenced by Isis::CameraStatistics::addStats(), Isis::ImagePolygon::FixPolePoly(), Isis::InterestOperator::InterestByMeasure(), Isis::Camera::ObliqueDetectorResolution(), Isis::Camera::OffNadirAngle(), Isis::ImagePolygon::SetImage(), and Isis::AdvancedTrackTool::updateRow().
|
inherited |
This converts the spacecraft clock ticks value (clockValue) to an iTime.
If the clock ticks value is provided directly, rather than the spacecraft clock string, set clockTicks=true.
Use this when possible because naif calls (such as scs2e_c) cannot be called when not using naif.
Definition at line 977 of file Spice.cpp.
References Isis::toString().
Referenced by Isis::Chandrayaan1M3Camera::Chandrayaan1M3Camera(), Isis::CTXCamera::CTXCamera(), Isis::DawnFcCamera::DawnFcCamera(), Isis::HayabusaAmicaCamera::HayabusaAmicaCamera(), Isis::HayabusaNirsCamera::HayabusaNirsCamera(), Isis::HiriseCamera::HiriseCamera(), Isis::Hyb2OncCamera::Hyb2OncCamera(), Isis::VimsSkyMap::Init(), Isis::VimsGroundMap::Init(), Isis::JunoCamera::JunoCamera(), Isis::KaguyaTcCamera::KaguyaTcCamera(), Isis::LroNarrowAngleCamera::LroNarrowAngleCamera(), Isis::LroWideAngleCamera::LroWideAngleCamera(), Isis::MarciCamera::MarciCamera(), Isis::MdisCamera::MdisCamera(), Isis::MocNarrowAngleCamera::MocNarrowAngleCamera(), Isis::MocWideAngleCamera::MocWideAngleCamera(), Isis::NewHorizonsLeisaCamera::NewHorizonsLeisaCamera(), Isis::NewHorizonsLorriCamera::NewHorizonsLorriCamera(), Isis::NewHorizonsMvicFrameCamera::NewHorizonsMvicFrameCamera(), Isis::NewHorizonsMvicTdiCamera::NewHorizonsMvicTdiCamera(), Isis::OsirisRexOcamsCamera::OsirisRexOcamsCamera(), Isis::RosettaVirtisCamera::readHouseKeeping(), Isis::DawnVirCamera::readHouseKeeping(), Isis::RosettaVirtisCamera::readSCET(), Isis::RosettaOsirisCamera::RosettaOsirisCamera(), Isis::ThemisIrCamera::ThemisIrCamera(), Isis::ThemisVisCamera::ThemisVisCamera(), Isis::VikingCamera::VikingCamera(), and Isis::VimsCamera::VimsCamera().
|
inherited |
This returns a value from the NAIF text pool.
It is a static convience method
| key | Name of NAIF keyword to obtain from the pool |
| index | If the keyword is an array, the element to obtain. Defaults to 0 |
| Isis::iException::Io | - "Can not find key in instrument kernels." |
Definition at line 963 of file Spice.cpp.
Referenced by Isis::LroWideAngleCameraFocalPlaneMap::addFilter(), Isis::LroWideAngleCameraDistortionMap::addFilter(), Isis::ApolloMetricCamera::ApolloMetricCamera(), Isis::ApolloPanoramicCamera::ApolloPanoramicCamera(), Isis::Chandrayaan1M3Camera::Chandrayaan1M3Camera(), Isis::MdisCamera::computeFocalLength(), Isis::CrismCamera::CrismCamera(), Isis::CTXCamera::CTXCamera(), Isis::DawnFcCamera::DawnFcCamera(), Isis::DawnVirCamera::DawnVirCamera(), Isis::HayabusaAmicaCamera::HayabusaAmicaCamera(), Isis::HayabusaNirsCamera::HayabusaNirsCamera(), Isis::HiresCamera::HiresCamera(), Isis::HrscCamera::HrscCamera(), Isis::Hyb2OncCamera::Hyb2OncCamera(), Isis::CameraFocalPlaneMap::Init(), Isis::RosettaOsirisCamera::initDistortion(), Isis::IssNACamera::IssNACamera(), Isis::IssWACamera::IssWACamera(), Isis::JunoCamera::JunoCamera(), Isis::KaguyaMiCamera::KaguyaMiCamera(), Isis::KaguyaTcCamera::KaguyaTcCamera(), Isis::KaguyaTcCameraDistortionMap::KaguyaTcCameraDistortionMap(), Isis::LroNarrowAngleCamera::LroNarrowAngleCamera(), Isis::LroWideAngleCamera::LroWideAngleCamera(), Isis::LwirCamera::LwirCamera(), Isis::MarciCamera::MarciCamera(), Isis::MarciDistortionMap::MarciDistortionMap(), Isis::Mariner10Camera::Mariner10Camera(), Isis::MdisCamera::MdisCamera(), Isis::MsiCamera::MsiCamera(), Isis::NewHorizonsLorriCamera::NewHorizonsLorriCamera(), Isis::NewHorizonsMvicFrameCamera::NewHorizonsMvicFrameCamera(), Isis::NewHorizonsMvicTdiCamera::NewHorizonsMvicTdiCamera(), Isis::NirCamera::NirCamera(), Isis::OsirisRexOcamsCamera::OsirisRexOcamsCamera(), Isis::RosettaOsirisCamera::RosettaOsirisCamera(), Isis::RosettaVirtisCamera::RosettaVirtisCamera(), Isis::KaguyaMiCameraDistortionMap::SetDistortion(), Isis::TaylorCameraDistortionMap::SetDistortion(), Isis::LroNarrowAngleDistortionMap::SetDistortion(), Isis::Camera::SetFocalLength(), Isis::Camera::SetPixelPitch(), Isis::SsiCamera::SsiCamera(), Isis::TgoCassisCamera::TgoCassisCamera(), Isis::TgoCassisDistortionMap::TgoCassisDistortionMap(), and Isis::UvvisCamera::UvvisCamera().
|
inherited |
This returns a value from the NAIF text pool.
It is a static convience
| key | Name of NAIF keyword to obtain from the pool |
| index | If the keyword is an array, the element to obtain. Defaults to 0 |
| Isis::iException::Io | - "Can not find key in instrument kernels |
Definition at line 949 of file Spice.cpp.
Referenced by Isis::RosettaVirtisCamera::getPointingTable(), Isis::DawnVirCamera::getPointingTable(), Isis::LroWideAngleCamera::GetVector(), Isis::IssNACamera::IssNACamera(), Isis::IssWACamera::IssWACamera(), and Isis::LroWideAngleCamera::LroWideAngleCamera().
| Latitude Isis::Sensor::GetLatitude | ( | ) | const |
Returns a planetocentric latitude object at the surface intersection point in body fixed.
Definition at line 236 of file Sensor.cpp.
References Isis::SurfacePoint::GetLatitude(), Isis::Target::shape(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
Referenced by Isis::StereoTool::calculateElevation(), and UniversalLatitude().
| Longitude Isis::Sensor::GetLongitude | ( | ) | const |
Returns a positive east, 0-360 domain longitude object at the surface intersection point in the body fixed coordinate system.
Definition at line 260 of file Sensor.cpp.
References Isis::SurfacePoint::GetLongitude(), Isis::Target::shape(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
Referenced by Isis::StereoTool::calculateElevation(), and UniversalLongitude().
|
inherited |
|
inherited |
This returns a value from the NAIF text pool.
It is a static convience method
| key | Name of NAIF keyword to obtain from the pool |
| index | If the keyword is an array, the element to obtain. Defaults to 0 |
| Isis::IException::Io | - "Can not find key in instrument kernels." |
Definition at line 1185 of file Spice.cpp.
Referenced by Isis::LightTimeCorrectionState::checkAberrationCorrection(), Isis::LightTimeCorrectionState::checkLightTimeToSurfaceCorrect(), Isis::LightTimeCorrectionState::checkObserverTargetSwap(), Isis::MdisCamera::computeFocalLength(), Isis::MdisCamera::MdisCamera(), and Isis::NewHorizonsLorriCamera::NewHorizonsLorriCamera().
| SurfacePoint Isis::Sensor::GetSurfacePoint | ( | ) | const |
Returns the surface point (most efficient accessor).
Definition at line 270 of file Sensor.cpp.
References Isis::Target::shape(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
Referenced by Isis::ControlPoint::ComputeResiduals(), Isis::QnetSetAprioriDialog::fillReferenceAprioriLineEdits(), Isis::QnetPointDistanceFilter::filter(), Isis::Camera::GetLocalNormal(), Isis::Camera::LocalPhotometricAngles(), and Isis::SunShadowTool::recalculateShadowHeight().
|
inherited |
Returns true if the kernel group has kernel files.
| lab | Label containing Instrument and Kernels groups. |
Definition at line 1393 of file Spice.cpp.
References Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), and Isis::PvlKeyword::size().
| bool Isis::Sensor::HasSurfaceIntersection | ( | ) | const |
Returns if the last call to either SetLookDirection or SetUniversalGround had a valid intersection with the target.
If so then other methods such as Coordinate, UniversalLatitude, UniversalLongitude, etc can be used with confidence.
Definition at line 201 of file Sensor.cpp.
References Isis::ShapeModel::hasIntersection(), Isis::Target::shape(), and Isis::Spice::target().
Referenced by Isis::CameraStatistics::addStats(), Isis::Camera::ComputeAzimuth(), Isis::Camera::DetectorResolution(), Isis::Chip::Load(), Isis::Camera::ObliqueDetectorResolution(), Isis::VimsGroundMap::SetGround(), and Isis::Camera::SetImageSkyMapProjection().
| void Isis::Sensor::IgnoreElevationModel | ( | bool | ignore | ) |
This allows you to ignore the cube elevation model and use the ellipse.
| ignore | Indicates whether the elevation model is ignored. |
Definition at line 75 of file Sensor.cpp.
References Isis::Target::restoreShape(), Isis::Target::setShapeEllipsoid(), and Isis::Spice::target().
Referenced by Isis::StereoTool::calculateElevation(), Isis::ImagePolygon::Create(), and Isis::ImagePolygon::initCube().
| double Isis::Sensor::IncidenceAngle | ( | ) | const |
Returns the incidence angle in degrees.
This does not use the surface model.
Definition at line 350 of file Sensor.cpp.
References Isis::ShapeModel::incidenceAngle(), Isis::Spice::m_uB, Isis::Target::shape(), and Isis::Spice::target().
Referenced by Isis::CameraStatistics::addStats(), Isis::ImagePolygon::FixPolePoly(), Isis::InterestOperator::InterestByMeasure(), Isis::SunShadowTool::recalculateShadowHeight(), Isis::ImagePolygon::SetImage(), and Isis::AdvancedTrackTool::updateRow().
|
inherited |
Returns the spacecraft position in body-fixed frame km units.
| p[] | Spacecraft position |
| Isis::iException::Programmer | - "You must call SetTime first" |
Definition at line 760 of file Spice.cpp.
References _FILEINFO_.
|
inherited |
Returns the spacecraft velocity in body-fixed frame km/sec units.
| v[] | Spacecraft velocity |
Definition at line 778 of file Spice.cpp.
References _FILEINFO_.
|
inherited |
Returns the spacecraft position in body-fixed frame km units.
| p[] | Spacecraft position |
| Isis::iException::Programmer | - "You must call SetTime first" |
Definition at line 747 of file Spice.cpp.
Referenced by Isis::RadarGroundMap::GetdXYdPosition(), Isis::RadarGroundMap::GetXY(), Isis::RadarGroundMap::SetFocalPlane(), Isis::RadarGroundMap::SetGround(), and Isis::AdvancedTrackTool::updateRow().
|
inherited |
Accessor method for the instrument position.
Definition at line 1467 of file Spice.cpp.
Referenced by Isis::Camera::DetectorResolution(), EmissionAngle(), Isis::Camera::LocalPhotometricAngles(), Isis::LoHighCamera::LoHighCamera(), Isis::LoMediumCamera::LoMediumCamera(), Isis::Mariner10Camera::Mariner10Camera(), Isis::Camera::OffNadirAngle(), PhaseAngle(), SetGround(), SetGroundLocal(), SetLookDirection(), SetUniversalGround(), SlantDistance(), and SpacecraftAltitude().
|
inherited |
Accessor method for the instrument rotation.
Definition at line 1489 of file Spice.cpp.
Referenced by Isis::DawnVirCamera::DawnVirCamera(), Isis::HiriseCamera::HiriseCamera(), Isis::HrscCamera::HrscCamera(), Isis::IssNACamera::IssNACamera(), Isis::IssWACamera::IssWACamera(), Isis::JunoCamera::JunoCamera(), LookDirection(), Isis::LroWideAngleCamera::LroWideAngleCamera(), Isis::Mariner10Camera::Mariner10Camera(), Isis::MocNarrowAngleCamera::MocNarrowAngleCamera(), Isis::MocWideAngleCamera::MocWideAngleCamera(), Isis::RosettaVirtisCamera::readSCET(), Isis::RosettaVirtisCamera::RosettaVirtisCamera(), Isis::RadarGroundMap::SetFocalPlane(), SetLookDirection(), SetRightAscensionDeclination(), and Isis::TgoCassisCamera::TgoCassisCamera().
|
inherited |
Returns true if time has been initialized.
Definition at line 1444 of file Spice.cpp.
Referenced by Isis::CameraDetectorMap::SetParent().
| Distance Isis::Sensor::LocalRadius | ( | ) | const |
Returns the local radius at the intersection point.
This is either the radius on the ellipsoid, the radius from the surface model passed into the constructor, or the radius set with SetUniversalGround.
Definition at line 282 of file Sensor.cpp.
References Isis::SurfacePoint::GetLocalRadius(), Isis::Target::shape(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
Referenced by Isis::CameraStatistics::addStats(), Isis::StereoTool::calculateElevation(), Isis::Camera::ComputeAzimuth(), Isis::FindTool::distancePerPixel(), Isis::QnetCubeDistanceFilter::filter(), Isis::Camera::GetLocalNormal(), Isis::Camera::GroundRangeResolution(), Isis::ControlNetFilter::PointDistanceFilter(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::Camera::RawFocalPlanetoImage(), Isis::Camera::ringRangeResolution(), Isis::ProjectionFactory::RingsCreateForCube(), Isis::PushFrameCameraGroundMap::SetGround(), Isis::LineScanCameraGroundMap::SetGround(), Isis::VimsGroundMap::SetGround(), Isis::RadarGroundMap::SetGround(), Isis::Camera::SetGround(), Isis::Camera::SetImageMapProjection(), SpacecraftAltitude(), Isis::TrackTool::updateLabels(), and Isis::AdvancedTrackTool::updateRow().
Returns the local radius at the intersection point.
This is either the radius on the ellipsoid, the radius from the surface model passed into the constructor, or the radius set with SetUniversalGround.
| lat | |
| lon |
Definition at line 300 of file Sensor.cpp.
References Isis::Target::shape(), and Isis::Spice::target().
| Distance Isis::Sensor::LocalRadius | ( | double | lat, |
| double | lon | ||
| ) |
Returns the local radius at the intersection point.
This is either the radius on the ellipsoid, the radius from the surface model passed into the constructor, or the radius set with SetUniversalGround.
| lat | |
| lon |
Definition at line 316 of file Sensor.cpp.
References Isis::Angle::Degrees, Isis::Target::shape(), and Isis::Spice::target().
| double Isis::Sensor::LocalSolarTime | ( | ) |
Return the local solar time in hours.
Definition at line 671 of file Sensor.cpp.
References Isis::Spice::subSolarPoint(), and UniversalLongitude().
Referenced by Isis::CameraStatistics::addStats(), and Isis::AdvancedTrackTool::updateRow().
| void Isis::Sensor::LookDirection | ( | double | v[3] | ) | const |
Returns the look direction in the camera coordinate system.
| v[] | The look vector. |
Definition at line 538 of file Sensor.cpp.
References Isis::Spice::instrumentRotation(), lookDirectionJ2000(), and Isis::SpiceRotation::ReferenceVector().
Referenced by Isis::PixelFOV::instantaneousFov().
| vector< double > Isis::Sensor::lookDirectionBodyFixed | ( | ) | const |
Returns the look direction in the body fixed coordinate system.
Definition at line 550 of file Sensor.cpp.
References m_lookB.
Referenced by lookDirectionJ2000(), and SetGroundLocal().
| vector< double > Isis::Sensor::lookDirectionJ2000 | ( | ) | const |
Returns the look direction in the camera coordinate system.
Definition at line 564 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Isis::SpiceRotation::J2000Vector(), and lookDirectionBodyFixed().
Referenced by LookDirection().
|
inherited |
This returns the NAIF body code of the target indicated in the labels.
Definition at line 866 of file Spice.cpp.
Referenced by Isis::Camera::SpkCenterId().
|
inherited |
|
inherited |
|
inherited |
This returns the NAIF IK code to use when reading from instrument kernels.
Definition at line 893 of file Spice.cpp.
Referenced by Isis::ApolloMetricCamera::ApolloMetricCamera(), Isis::ApolloPanoramicCamera::ApolloPanoramicCamera(), Isis::Chandrayaan1M3Camera::Chandrayaan1M3Camera(), Isis::CrismCamera::CrismCamera(), Isis::CTXCamera::CTXCamera(), Isis::DawnFcCamera::DawnFcCamera(), Isis::DawnVirCamera::DawnVirCamera(), Isis::HayabusaAmicaCamera::HayabusaAmicaCamera(), Isis::HayabusaNirsCamera::HayabusaNirsCamera(), Isis::HiresCamera::HiresCamera(), Isis::HiriseCamera::HiriseCamera(), Isis::HrscCamera::HrscCamera(), Isis::Hyb2OncCamera::Hyb2OncCamera(), Isis::IssNACamera::IssNACamera(), Isis::IssWACamera::IssWACamera(), Isis::JunoCamera::JunoCamera(), Isis::KaguyaMiCamera::KaguyaMiCamera(), Isis::KaguyaTcCamera::KaguyaTcCamera(), Isis::LoHighCamera::LoHighCamera(), Isis::LoMediumCamera::LoMediumCamera(), Isis::LroNarrowAngleCamera::LroNarrowAngleCamera(), Isis::LroWideAngleCamera::LroWideAngleCamera(), Isis::LwirCamera::LwirCamera(), Isis::MarciCamera::MarciCamera(), Isis::Mariner10Camera::Mariner10Camera(), Isis::MdisCamera::MdisCamera(), Isis::MiniRF::MiniRF(), Isis::MocNarrowAngleCamera::MocNarrowAngleCamera(), Isis::MocWideAngleCamera::MocWideAngleCamera(), Isis::MsiCamera::MsiCamera(), Isis::NewHorizonsLeisaCamera::NewHorizonsLeisaCamera(), Isis::NewHorizonsLorriCamera::NewHorizonsLorriCamera(), Isis::NewHorizonsMvicFrameCamera::NewHorizonsMvicFrameCamera(), Isis::NewHorizonsMvicTdiCamera::NewHorizonsMvicTdiCamera(), Isis::NirCamera::NirCamera(), Isis::OsirisRexOcamsCamera::OsirisRexOcamsCamera(), Isis::RosettaOsirisCamera::RosettaOsirisCamera(), Isis::RosettaVirtisCamera::RosettaVirtisCamera(), Isis::Camera::SetFocalLength(), Isis::Camera::SetPixelPitch(), Isis::SsiCamera::SsiCamera(), Isis::TgoCassisCamera::TgoCassisCamera(), Isis::ThemisIrCamera::ThemisIrCamera(), Isis::ThemisVisCamera::ThemisVisCamera(), Isis::UvvisCamera::UvvisCamera(), Isis::VikingCamera::VikingCamera(), Isis::VimsCamera::VimsCamera(), and Isis::VoyagerCamera::VoyagerCamera().
|
inherited |
This returns the NAIF SCLK code to use when reading from instrument kernels.
Definition at line 903 of file Spice.cpp.
Referenced by Isis::CrismCamera::CrismCamera().
|
inherited |
This returns the NAIF SPK code to use when reading from SPK kernels.
Definition at line 875 of file Spice.cpp.
Referenced by Isis::RosettaVirtisCamera::readHouseKeeping(), Isis::DawnVirCamera::readHouseKeeping(), Isis::RosettaVirtisCamera::readSCET(), and Isis::Camera::SpkTargetId().
| double Isis::Sensor::PhaseAngle | ( | ) | const |
Returns the phase angle in degrees.
This does not use the surface model.
Definition at line 327 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Coordinate(), Isis::Spice::instrumentPosition(), Isis::Spice::m_uB, Isis::ShapeModel::phaseAngle(), Isis::Target::shape(), and Isis::Spice::target().
Referenced by Isis::CameraStatistics::addStats(), and Isis::AdvancedTrackTool::updateRow().
|
virtual |
This method is implemented in Camera which defaults to the (pixel pitch * summing mode ) / 2.
If the instrument has a non-square ifov, it must implement this method to return offsets from the center of the pixel.
Reimplemented in Isis::Camera, Isis::VimsCamera, and Isis::HayabusaNirsCamera.
Definition at line 96 of file Sensor.cpp.
References _FILEINFO_, and Isis::IException::Programmer.
|
inherited |
Returns the radii of the body in km.
The radii are obtained from the appropriate SPICE kernel for the body specified by TargetName in the Instrument group of the labels.
| r[] | Radii of the target in kilometers |
Definition at line 855 of file Spice.cpp.
Referenced by Isis::Camera::BasicMapping(), Isis::Camera::GroundRange(), Isis::VimsGroundMap::Init(), Isis::ControlPointEditWidget::openReferenceRadius(), Isis::QnetTool::openReferenceRadius(), Isis::SunShadowTool::recalculateShadowHeight(), Isis::RadarGroundMap::SetFocalPlane(), and Isis::AdvancedTrackTool::updateRow().
|
protectedinherited |
This should be used for reading ALL text naif kernel values.
This will read it from Naif if we're using naif/not attached kernels. If we have attached kernels and a NaifKeywords label object we will grab it from there instead. This allows us to not furnish kernels after spiceinit.
| key | The naif keyword,value name |
| type | The naif value's primitive type |
| index | The index into the naif keyword array to read |
Definition at line 1017 of file Spice.cpp.
References _FILEINFO_.
Referenced by Isis::IdealCamera::IdealCamera().
|
inlinevirtual |
Virtual method that returns the pixel resolution of the sensor in meters/pix.
Reimplemented from Isis::Spice.
Reimplemented in Isis::Camera.
| double Isis::Sensor::RightAscension | ( | ) |
Returns the right ascension angle (sky longitude).
Definition at line 576 of file Sensor.cpp.
References computeRaDec(), m_newLookB, and m_ra.
Referenced by Isis::Camera::CelestialNorthClockAngle(), Isis::VimsSkyMap::Init(), Isis::Camera::RaDecRange(), Isis::Camera::RaDecResolution(), Isis::Camera::RawFocalPlanetoImage(), and Isis::AdvancedTrackTool::updateRow().
| bool Isis::Sensor::SetGround | ( | const SurfacePoint & | surfacePt, |
| bool | backCheck = true |
||
| ) |
This overloaded method has the opposite function as SetLookDirection.
Instead of computing a point on the target, a point is set and the look direction is computed. Other methods such as lat/lon, phase, incidence, etc. can be used if this method returns a true.
| backCheck | If true this method will check the lat/lon point to see if it falls on the backside of the target (or beyond the horizon). If false this test will not occur. Defaults to true. |
Definition at line 458 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Isis::ShapeModel::clearSurfacePoint(), Coordinate(), Isis::Spice::instrumentPosition(), SetGroundLocal(), Isis::Target::shape(), and Isis::Spice::target().
|
private |
Computes look vector.
This method handles the common functions for the overloaded SetUniversalGround methods.
Instead of computing a point on the target, a point is set (lat,lon,radius) and the look direction is computed.
| backCheck | If true this method will check the lat/lon point to see if it falls on the backside of the target (or beyond the horizon). If false this test will not occur. Defaults to true. |
Definition at line 490 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Isis::ShapeModel::clearSurfacePoint(), Coordinate(), Isis::ShapeModel::hasIntersection(), Isis::Spice::instrumentPosition(), Isis::ShapeModel::isVisibleFrom(), Isis::Displacement::kilometers(), lookDirectionBodyFixed(), m_lookB, m_newLookB, Isis::SpiceRotation::ReferenceVector(), Isis::ShapeModel::setHasIntersection(), Isis::Target::shape(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
Referenced by SetGround(), and SetUniversalGround().
| bool Isis::Sensor::SetLookDirection | ( | const double | v[3] | ) |
Sets the look direction of the spacecraft.
This routine will then attempt to intersect the look direction with the target. If successful you can utilize the methods which return the lat/lon, phase, incidence, etc. This routine returns false if the look direction does not intersect the target.
| v[] | A look vector in camera coordinates. For example, (0,0,1) is usually the look direction out of the boresight of a camera. |
2009-09-23 Tracie Sucharski - Convert negative longitudes returned my reclat.
2010-09-15 Janet Barrett - Modified this method to use a new algorithm for finding the intersection of a ray with the DEM. This was required to take care of problems that were encountered at the poles of global DEM files. The algorithm that is being used was taken from "Intersection between spacecraft viewing vectors and digital elevation models" by N.A. Teanby. This algorithm only works on Equatorial Cylindrical projections. Other projections still use the previous algorithm.
2010-10-26 Janet Barrett - The tolerance value of 1E-5 was too small and was causing a divide by zero error when the current and last intersections were virtually the same. The tolerance was changed to 3E-8 * a (where a is the equatorial radius of the planet we are dealing with).
2011-01-24 Janet Barrett - Got rid of extra loop that wasn't needed for the new ray tracing algorithm.
Definition at line 156 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Coordinate(), Isis::Spice::instrumentPosition(), Isis::Spice::instrumentRotation(), Isis::SpiceRotation::J2000Vector(), m_lookB, m_newLookB, Isis::SpiceRotation::ReferenceVector(), Isis::ShapeModel::setHasIntersection(), Isis::Target::shape(), and Isis::Spice::target().
Referenced by Isis::PixelFOV::instantaneousFov(), Isis::CameraSkyMap::SetFocalPlane(), Isis::VimsSkyMap::SetFocalPlane(), Isis::VimsGroundMap::SetFocalPlane(), and SetRightAscensionDeclination().
| bool Isis::Sensor::SetRightAscensionDeclination | ( | const double | ra, |
| const double | dec | ||
| ) |
Given the ra/dec compute the look direction.
| ra | Right ascension in degrees (sky longitude). |
| dec | Declination in degrees (sky latitude). |
Definition at line 619 of file Sensor.cpp.
References Isis::Spice::instrumentRotation(), Isis::PI, Isis::SpiceRotation::ReferenceVector(), and SetLookDirection().
| void Isis::Sensor::setTime | ( | const iTime & | time | ) |
By setting the time you essential set the position of the spacecraft and body as indicated in the class Spice.
However, after this is invoked there will be no intersection point until SetLookDirection or SetUniversalGround is invoked. (Read NAIF documentation for a detailed description of ephemeris time.)
| time | Ephemeris time. |
Definition at line 112 of file Sensor.cpp.
References Isis::ShapeModel::clearSurfacePoint(), Isis::Spice::setTime(), Isis::Target::shape(), Isis::Spice::target(), and Isis::Spice::time().
Referenced by Isis::ApolloMetricCamera::ApolloMetricCamera(), Isis::ApolloPanoramicCamera::ApolloPanoramicCamera(), Isis::CrismCamera::CrismCamera(), Isis::DawnFcCamera::DawnFcCamera(), Isis::DawnVirCamera::DawnVirCamera(), Isis::HayabusaAmicaCamera::HayabusaAmicaCamera(), Isis::HayabusaNirsCamera::HayabusaNirsCamera(), Isis::HiresCamera::HiresCamera(), Isis::Hyb2OncCamera::Hyb2OncCamera(), Isis::IdealCamera::IdealCamera(), Isis::VimsSkyMap::Init(), Isis::VimsGroundMap::Init(), Isis::IssNACamera::IssNACamera(), Isis::IssWACamera::IssWACamera(), Isis::JunoCamera::JunoCamera(), Isis::KaguyaMiCamera::KaguyaMiCamera(), Isis::KaguyaTcCamera::KaguyaTcCamera(), Isis::Camera::LoadCache(), Isis::LoHighCamera::LoHighCamera(), Isis::LoMediumCamera::LoMediumCamera(), Isis::LroNarrowAngleCamera::LroNarrowAngleCamera(), Isis::LwirCamera::LwirCamera(), Isis::Mariner10Camera::Mariner10Camera(), Isis::MdisCamera::MdisCamera(), Isis::MsiCamera::MsiCamera(), Isis::NewHorizonsLorriCamera::NewHorizonsLorriCamera(), Isis::NirCamera::NirCamera(), Isis::OsirisRexOcamsCamera::OsirisRexOcamsCamera(), Isis::RosettaOsirisCamera::RosettaOsirisCamera(), Isis::RosettaVirtisCamera::RosettaVirtisCamera(), Isis::NewHorizonsMvicFrameCamera::SetBand(), Isis::ThemisVisCamera::SetBand(), Isis::VimsSkyMap::SetFocalPlane(), Isis::VimsGroundMap::SetFocalPlane(), Isis::PushFrameCameraDetectorMap::SetFramelet(), Isis::CameraDetectorMap::SetParent(), Isis::LineScanCameraDetectorMap::SetParent(), Isis::VariableLineScanCameraDetectorMap::SetParent(), Isis::RadarPulseMap::SetParent(), Isis::SsiCamera::SsiCamera(), Isis::TgoCassisCamera::TgoCassisCamera(), Isis::UvvisCamera::UvvisCamera(), Isis::VikingCamera::VikingCamera(), and Isis::VoyagerCamera::VoyagerCamera().
| bool Isis::Sensor::SetUniversalGround | ( | const double | latitude, |
| const double | longitude, | ||
| bool | backCheck = true |
||
| ) |
This is the opposite routine for SetLookDirection.
Instead of computing a point on the target, a point is set and the look direction is computed. Other methods such as lat/lon, phase, incidence, etc. can be used if this method returns a true.
| latitude | Planetocentric latitude. |
| longitude | Positive east longitude. |
| backCheck | If true this method will check the lat/lon point to see if it falls on the backside of the target (or beyond the horizon). If false this test will not occur. Defaults to true. |
Definition at line 374 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Isis::ShapeModel::clearSurfacePoint(), Coordinate(), Isis::Angle::Degrees, Isis::Spice::instrumentPosition(), SetGroundLocal(), Isis::Target::shape(), and Isis::Spice::target().
| bool Isis::Sensor::SetUniversalGround | ( | const double | latitude, |
| const double | longitude, | ||
| const double | radius, | ||
| bool | backCheck = true |
||
| ) |
This overloaded method has the opposite function as SetLookDirection.
Instead of computing a point on the target, a point is set and the look direction is computed. Other methods such as lat/lon, phase, incidence, etc. can be used if this method returns a true.
| latitude | Planetocentric latitude in degrees. |
| longitude | Positive east longitude in degrees. |
| radius | Radius in meters. |
| backCheck | If true this method will check the lat/lon point to see if it falls on the backside of the target (or beyond the horizon). If false this test will not occur. Defaults to true. |
Definition at line 416 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Isis::ShapeModel::clearSurfacePoint(), Coordinate(), Isis::Angle::Degrees, Isis::Spice::instrumentPosition(), Isis::Distance::Meters, SetGroundLocal(), Isis::Target::shape(), and Isis::Spice::target().
| double Isis::Sensor::SlantDistance | ( | ) | const |
Return the distance between the spacecraft and surface point in kmv.
Definition at line 648 of file Sensor.cpp.
References Isis::Spice::bodyRotation(), Coordinate(), Isis::Spice::instrumentPosition(), Isis::Displacement::kilometers(), Isis::SpiceRotation::ReferenceVector(), Isis::Target::shape(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
Referenced by Isis::PushFrameCameraGroundMap::FindSpacecraftDistance(), and Isis::AdvancedTrackTool::updateRow().
| double Isis::Sensor::SolarDistance | ( | ) | const |
Returns the distance between the sun and surface point in AU.
Definition at line 688 of file Sensor.cpp.
References Isis::Displacement::kilometers(), Isis::Target::shape(), Isis::Spice::sunPosition(), Isis::ShapeModel::surfaceIntersection(), and Isis::Spice::target().
|
inherited |
Returns the solar longitude.
Definition at line 1376 of file Spice.cpp.
Referenced by Isis::AdvancedTrackTool::updateRow().
| double Isis::Sensor::SpacecraftAltitude | ( | ) |
Returns the distance from the spacecraft to the subspacecraft point in km.
It uses the ellipsoid, not the shape model.
Definition at line 712 of file Sensor.cpp.
References Isis::Spice::instrumentPosition(), Isis::Distance::kilometers(), LocalRadius(), Isis::PI, and Isis::Spice::subSpacecraftPoint().
Referenced by Isis::CrismCamera::CrismCamera(), and Isis::Camera::LoadCache().
| void Isis::Sensor::SpacecraftSurfaceVector | ( | double | scSurfaceVector[3] | ) | const |
Sets the vector between the spacecraft and surface point in body-fixed.
| scSurfaceVector | The direction vector from the observer to the surface intersection. |
Definition at line 636 of file Sensor.cpp.
References m_lookB.
|
inherited |
Returns the sub-solar latitude/longitude in universal coordinates (0-360 positive east, ocentric)
| lat | Sub-solar latitude |
| lon | Sub-solar longitude |
| Isis::IException::Programmer | - "You must call SetTime first." |
Definition at line 1251 of file Spice.cpp.
References _FILEINFO_, and Isis::PI.
Referenced by LocalSolarTime(), and Isis::Camera::SunAzimuth().
|
inherited |
Returns the sub-spacecraft latitude/longitude in universal coordinates (0-360 positive east, ocentric)
| lat | Sub-spacecraft latitude |
| lon | Sub-spacecraft longitude |
| Isis::IException::Programmer | - "You must call SetTime first." |
Definition at line 1202 of file Spice.cpp.
References _FILEINFO_, and Isis::PI.
Referenced by Isis::Camera::GroundRangeResolution(), SpacecraftAltitude(), and Isis::Camera::SpacecraftAzimuth().
|
inherited |
Fills the input vector with sun position information, in either body-fixed or J2000 reference frame and km units.
| p[] | Sun position |
Definition at line 827 of file Spice.cpp.
References _FILEINFO_.
Referenced by Isis::SunShadowTool::recalculateShadowHeight().
|
inherited |
Accessor method for the sun position.
Definition at line 1456 of file Spice.cpp.
Referenced by SolarDistance().
|
inherited |
Returns a pointer to the target object.
Definition at line 1290 of file Spice.cpp.
Referenced by Isis::Camera::BasicMapping(), Isis::Camera::basicRingMapping(), Coordinate(), EmissionAngle(), Isis::FeatureNomenclatureTool::findMissingNomenclature(), GetLatitude(), Isis::Camera::GetLocalNormal(), GetLongitude(), GetSurfacePoint(), Isis::UniversalGroundMap::GroundRange(), Isis::Camera::GroundRangeResolution(), HasSurfaceIntersection(), IgnoreElevationModel(), Isis::ImportImagesWorkOrder::importConfirmedImages(), IncidenceAngle(), Isis::Camera::LoadCache(), LocalRadius(), Isis::Camera::NorthAzimuth(), PhaseAngle(), Isis::Camera::RawFocalPlanetoImage(), Isis::VimsGroundMap::SetGround(), SetGround(), Isis::Camera::SetGround(), SetGroundLocal(), Isis::Camera::SetImage(), SetLookDirection(), Isis::Camera::SetRightAscensionDeclination(), setTime(), SetUniversalGround(), Isis::Camera::SetUniversalGround(), SlantDistance(), SolarDistance(), Isis::TrackTool::updateLabels(), and Isis::AdvancedTrackTool::updateRow().
|
inherited |
|
inherited |
Returns the QString name of the target.
Definition at line 1300 of file Spice.cpp.
References Isis::Target::name().
|
inherited |
Returns the ephemeris time in seconds which was used to obtain the spacecraft and sun positions.
| IException::Programmer | "Unable to retrieve the time Spice::setTime must be called first." |
Definition at line 809 of file Spice.cpp.
References _FILEINFO_.
Referenced by Isis::RadarSlantRangeMap::ComputeA(), Isis::HiresCamera::HiresCamera(), Isis::KaguyaTcCamera::KaguyaTcCamera(), Isis::LoHighCamera::LoHighCamera(), Isis::LoMediumCamera::LoMediumCamera(), Isis::LwirCamera::LwirCamera(), Isis::NewHorizonsMvicFrameCamera::SetBand(), Isis::LineScanCameraDetectorMap::SetDetector(), Isis::VariableLineScanCameraDetectorMap::SetDetector(), Isis::RadarPulseMap::SetDetector(), Isis::RadarSlantRangeMap::SetFocalPlane(), Isis::CameraDetectorMap::SetParent(), setTime(), Isis::RadarSlantRangeMap::SetUndistortedFocalPlane(), Isis::Hyb2OncCamera::ShutterOpenCloseTimes(), Isis::JunoCamera::ShutterOpenCloseTimes(), Isis::MsiCamera::ShutterOpenCloseTimes(), Isis::OsirisRexOcamsCamera::ShutterOpenCloseTimes(), Isis::HayabusaAmicaCamera::ShutterOpenCloseTimes(), Isis::FramingCamera::ShutterOpenCloseTimes(), Isis::DawnFcCamera::ShutterOpenCloseTimes(), Isis::NewHorizonsLorriCamera::ShutterOpenCloseTimes(), Isis::RosettaOsirisCamera::ShutterOpenCloseTimes(), Isis::HayabusaNirsCamera::ShutterOpenCloseTimes(), Isis::NewHorizonsMvicFrameCamera::ShutterOpenCloseTimes(), Isis::ApolloMetricCamera::ShutterOpenCloseTimes(), Isis::Mariner10Camera::ShutterOpenCloseTimes(), Isis::SsiCamera::ShutterOpenCloseTimes(), Isis::VoyagerCamera::ShutterOpenCloseTimes(), Isis::LoHighCamera::ShutterOpenCloseTimes(), Isis::LwirCamera::ShutterOpenCloseTimes(), Isis::HiresCamera::ShutterOpenCloseTimes(), Isis::VikingCamera::ShutterOpenCloseTimes(), Isis::IssNACamera::ShutterOpenCloseTimes(), Isis::IssWACamera::ShutterOpenCloseTimes(), Isis::NirCamera::ShutterOpenCloseTimes(), Isis::LoMediumCamera::ShutterOpenCloseTimes(), Isis::TgoCassisCamera::ShutterOpenCloseTimes(), Isis::UvvisCamera::ShutterOpenCloseTimes(), Isis::MdisCamera::ShutterOpenCloseTimes(), Isis::Camera::StartEndEphemerisTimes(), Isis::AdvancedTrackTool::updateRow(), and Isis::UvvisCamera::UvvisCamera().
| double Isis::Sensor::UniversalLatitude | ( | ) | const |
Returns the planetocentric latitude, in degrees, at the surface intersection point in the body fixed coordinate system.
Definition at line 225 of file Sensor.cpp.
References Isis::Angle::degrees(), and GetLatitude().
Referenced by Isis::QnetTool::addMeasure(), Isis::CameraStatistics::addStats(), Isis::ProjectionFactory::CreateForCube(), Isis::ControlPointEditWidget::createTemporaryGroundMeasure(), Isis::QnetCubeDistanceFilter::filter(), Isis::InterestOperator::FindCnetRef(), Isis::QnetTool::findPointLocation(), Isis::SmtkMatcher::getLatLon(), Isis::Camera::GroundRangeResolution(), Isis::PixelFOV::instantaneousFov(), Isis::Cube::latLonRange(), Isis::Chip::Load(), Isis::Camera::NorthAzimuth(), Isis::ControlNetFilter::PointDistanceFilter(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::Camera::RawFocalPlanetoImage(), Isis::Camera::SetRightAscensionDeclination(), Isis::ControlPointEditWidget::setShapesForPoint(), Isis::UniversalGroundMap::UniversalLatitude(), Isis::TrackTool::updateLabels(), and Isis::AdvancedTrackTool::updateRow().
| double Isis::Sensor::UniversalLongitude | ( | ) | const |
Returns the positive east, 0-360 domain longitude, in degrees, at the surface intersection point in the body fixed coordinate system.
Definition at line 248 of file Sensor.cpp.
References Isis::Angle::degrees(), and GetLongitude().
Referenced by Isis::QnetTool::addMeasure(), Isis::CameraStatistics::addStats(), Isis::ProjectionFactory::CreateForCube(), Isis::ControlPointEditWidget::createTemporaryGroundMeasure(), Isis::QnetCubeDistanceFilter::filter(), Isis::InterestOperator::FindCnetRef(), Isis::QnetTool::findPointLocation(), Isis::SmtkMatcher::getLatLon(), Isis::Camera::GroundRangeResolution(), Isis::PixelFOV::instantaneousFov(), Isis::Cube::latLonRange(), Isis::Chip::Load(), LocalSolarTime(), Isis::ControlNetFilter::PointDistanceFilter(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::Camera::RawFocalPlanetoImage(), Isis::Camera::ringRangeResolution(), Isis::ProjectionFactory::RingsCreateForCube(), Isis::Camera::SetRightAscensionDeclination(), Isis::ControlPointEditWidget::setShapesForPoint(), Isis::UniversalGroundMap::UniversalLongitude(), Isis::TrackTool::updateLabels(), and Isis::AdvancedTrackTool::updateRow().
|
protectedinherited |
This contains the transformation matrix from J2000 (J) to Body fixed (B).
Recall that the transpose of this matrix JB will convert from body-fixed to J2000. It is left in protected space so that conversions between double and SpiceDouble do not have to occur in inheriting classes.
|
private |
Decliation (sky latitude)
Definition at line 261 of file Sensor.h.
Referenced by computeRaDec(), and Declination().
|
private |
Look direction in body fixed.
Definition at line 257 of file Sensor.h.
Referenced by computeRaDec(), lookDirectionBodyFixed(), SetGroundLocal(), SetLookDirection(), and SpacecraftSurfaceVector().
|
private |
flag to indicate we need to recompute ra/dec
Definition at line 259 of file Sensor.h.
Referenced by computeRaDec(), Declination(), RightAscension(), SetGroundLocal(), and SetLookDirection().
|
private |
Right ascension (sky longitude)
Definition at line 260 of file Sensor.h.
Referenced by computeRaDec(), and RightAscension().
|
protectedinherited |
This contains the sun position (u) in the bodyfixed reference frame (B).
It is left protected so that conversions between double and SpiceDouble do not have to occur in inheriting classes. Units are km
Definition at line 377 of file Spice.h.
Referenced by IncidenceAngle(), Isis::Camera::LocalPhotometricAngles(), and PhaseAngle().