Isis 3 Programmer Reference
|
This class defines a body-fixed surface point. More...
#include <SurfacePoint.h>
Public Types | |
enum | CoordinateType { Latitudinal, Rectangular } |
Defines the coordinate typ, units, and coordinate index for some of the output methods. More... | |
enum | CoordUnits { Degrees, Kilometers, Meters, Radians } |
enum | CoordIndex { One =0, Two =1, Three =2 } |
Public Member Functions | |
SurfacePoint () | |
Constructs an empty SurfacePoint object. More... | |
SurfacePoint (const SurfacePoint &other) | |
Constructs a new SurfacePoint object from an existing SurfacePoint. More... | |
SurfacePoint (const Latitude &lat, const Longitude &lon, const Distance &radius) | |
Constructs a SurfacePoint object with a spherical point only. More... | |
SurfacePoint (const Latitude &lat, const Longitude &lon, const Distance &radius, const Angle &latSigma, const Angle &lonSigma, const Distance &radiusSigma) | |
Constructs a SurfacePoint object with a spherical point and its sigmas. More... | |
SurfacePoint (const Latitude &lat, const Longitude &lon, const Distance &radius, const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > &covar) | |
SurfacePoint (const Displacement &x, const Displacement &y, const Displacement &z) | |
Constructs a SurfacePoint object with a rectangular point only. More... | |
SurfacePoint (const Displacement &x, const Displacement &y, const Displacement &z, const Distance &xSigma, const Distance &ySigma, const Distance &zSigma) | |
Constructs a SurfacePoint object with a rectangular point and sigmas. More... | |
SurfacePoint (const Displacement &x, const Displacement &y, const Displacement &z, const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > &covar) | |
~SurfacePoint () | |
Destroys a SurfacePoint object/. More... | |
void | SetRectangular (const Displacement &x, const Displacement &y, const Displacement &z, const Distance &xSigma=Distance(), const Distance &ySigma=Distance(), const Distance &zSigma=Distance()) |
Set surface point in rectangular body-fixed coordinates wtih optional sigmas. More... | |
void | SetRectangular (const Displacement x, const Displacement y, const Displacement z, const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > &covar) |
void | SetRectangularCoordinates (const Displacement &x, const Displacement &y, const Displacement &z) |
Set surface point in rectangular coordinates. More... | |
void | SetRectangularSigmas (const Distance &xSigma, const Distance &ySigma, const Distance &zSigma) |
Set surface point and sigmas in rectangular coordinates and convert to planetocentric. More... | |
void | SetRectangularMatrix (const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > &covar, SurfacePoint::CoordUnits units=SurfacePoint::Meters) |
Set rectangular covariance matrix and store in units of km**2. More... | |
void | SetSpherical (const Latitude &lat, const Longitude &lon, const Distance &radius, const Angle &latSigma=Angle(), const Angle &lonSigma=Angle(), const Distance &radiusSigma=Distance()) |
Set surface point and covariance matrix in planetocentric coordinates and convert to rectangular (Latitude, Longitude in degrees, Radius in meters; matrix in radians and radians**2) More... | |
void | SetSpherical (const Latitude &lat, const Longitude &lon, const Distance &radius, const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > &covar) |
void | SetSphericalCoordinates (const Latitude &lat, const Longitude &lon, const Distance &radius) |
Update spherical coordinates (lat/lon/radius) More... | |
void | SetSphericalMatrix (const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > &covar, SurfacePoint::CoordUnits units=SurfacePoint::Meters) |
Set spherical covariance matrix. More... | |
void | SetSphericalSigmas (const Angle &latSigma, const Angle &lonSigma, const Distance &radiusSigma) |
Set the spherical sigmas into the spherical variance/covariance matrix in diagonal units of radians^2, radians^2, km^2. More... | |
void | SetSphericalSigmasDistance (const Distance &latSigma, const Distance &lonSigma, const Distance &radiusSigma) |
Set the spherical sigmas (in Distance units) into the spherical variance/covariance matrix. More... | |
void | ResetLocalRadius (const Distance &radius) |
This method resets the local radius of a SurfacePoint. More... | |
bool | Valid () const |
void | SetMatrix (CoordinateType type, const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > &covar) |
Set the covariance matrix. More... | |
std::vector< double > | Partial (CoordinateType type, CoordIndex index) |
Compute partial derivative of conversion from body-fixed coordinates to the specified. More... | |
double | GetCoord (CoordinateType type, CoordIndex index, CoordUnits units) |
This method returns a coordinate of a SurfacePoint. More... | |
double | GetSigma (CoordinateType type, CoordIndex index, CoordUnits units) |
This method returns a sigma of a SurfacePoint coordinate. More... | |
Distance | GetSigmaDistance (CoordinateType type, CoordIndex index) |
This method returns a sigma of a SurfacePoint coordinate as a Distance. More... | |
double | GetWeight (CoordinateType type, CoordIndex index) |
This method returns the weight of a SurfacePoint coordinate Note: At this time a units argument is not included. More... | |
Displacement | GetX () const |
Displacement | GetY () const |
Displacement | GetZ () const |
Distance | GetXSigma () const |
Distance | GetYSigma () const |
Distance | GetZSigma () const |
double | GetXWeight () const |
Return X weight for bundle adjustment Units are 1/(kilometers)^2. More... | |
double | GetYWeight () const |
Return Y weight for bundle adjustment Units are 1/(kilometers)^2. More... | |
double | GetZWeight () const |
Return Z weight for bundle adjustment Units are 1/(kilometers)^2. More... | |
boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > | GetRectangularMatrix (SurfacePoint::CoordUnits units=SurfacePoint::Meters) const |
Latitude | GetLatitude () const |
Return the body-fixed latitude for the surface point. More... | |
Longitude | GetLongitude () const |
Return the body-fixed longitude for the surface point. More... | |
Distance | GetLocalRadius () const |
Return the radius of the surface point. More... | |
Angle | GetLatSigma () const |
Distance | GetLatSigmaDistance () const |
Return the latitude sigma as a Distance. More... | |
double | GetLatWeight () const |
Return latitude weight for bundle adjustment Units are 1/(radians)^2. More... | |
Angle | GetLonSigma () const |
Distance | GetLonSigmaDistance () const |
Return the longitude sigma in meters. More... | |
double | GetLonWeight () const |
Return longitude weight for bundle adjustment Units are 1/(radians)^2. More... | |
Distance | GetLocalRadiusSigma () const |
double | GetLocalRadiusWeight () const |
Return radius weight for bundle adjustment Units are 1/(kilometers)^2. More... | |
boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > | GetSphericalMatrix (SurfacePoint::CoordUnits units=SurfacePoint::Meters) const |
double | DisplacementToDouble (Displacement disp, CoordUnits units) |
This method returns a double version of a Displacement in the specified units. More... | |
double | DistanceToDouble (Distance dist, CoordUnits units) |
This method returns a double version of a Distance in the specified units. More... | |
double | MetersToLatitude (double latLength) |
This method returns an angular measure of a distance in the direction of and relative to the latitude of the SurfacePoint. More... | |
double | MetersToLongitude (double lonLength) |
This method returns an angular measure in radians of a distance in the direction of and relative to the longitude of the SurfacePoint. More... | |
double | LatitudeToMeters (double latitude) const |
This method returns a Displacement of an Angle relative to the current SurfacePoint latitude. More... | |
double | LongitudeToMeters (double longitude) const |
This method returns a length in meters version of a delta longitude angle in radians relative to the current SurfacePoint longitude. More... | |
double | LatToDouble (Latitude lat, CoordUnits units) |
This method returns a double version of a Latitude in the specified units. More... | |
double | LonToDouble (Longitude lon, CoordUnits units) |
This method returns a double version of a Longitude in the specified units. More... | |
Distance | GetDistanceToPoint (const SurfacePoint &other) const |
Computes and returns the distance between two surface points. More... | |
Distance | GetDistanceToPoint (const SurfacePoint &other, const Distance &sphereRadius) const |
Computes and returns the distance between two surface points, assuming both points are on a sphere with the given radius. More... | |
std::vector< double > | LatitudinalDerivative (CoordIndex index) |
Compute partial derivative of the conversion of the latitudinal coordinates to body-fixed rectangular coordinates with respect to the indicated coordinate. More... | |
std::vector< double > | RectangularDerivative (CoordIndex index) |
Compute partial derivative of the body-fixed rectangular coordinates with respect to the indicated coordinate. More... | |
void | ToNaifArray (double naifOutput[3]) const |
A naif array is a c-style array of size 3. More... | |
void | FromNaifArray (const double naifValues[3]) |
A naif array is a c-style array of size 3. More... | |
bool | operator== (const SurfacePoint &other) const |
SurfacePoint & | operator= (const SurfacePoint &other) |
Static Public Member Functions | |
static CoordinateType | stringToCoordinateType (QString type) |
This method converts the given string value to a SurfacePoint::CoordinateType enumeration. More... | |
static QString | coordinateTypeToString (CoordinateType type) |
Converts the given SurfacePoint::CoordinateType enumeration to a string. More... | |
Private Member Functions | |
void | ComputeLocalRadius () |
Compute the local radius of the surface point. More... | |
void | InitCovariance () |
Initialize the variance/covariance matrices. More... | |
void | InitPoint () |
Initialize a surface point. More... | |
void | SetRectangularPoint (const Displacement &x, const Displacement &y, const Displacement &z) |
This is a private method to set a surface point in rectangular, body-fixed coordinates. More... | |
void | SetSphericalPoint (const Latitude &lat, const Longitude &lon, const Distance &radius) |
This is a private method to set a surface point in spherical (lat/lon/radius), body-fixed coordinates. More... | |
void | FreeAllocatedMemory () |
Private Attributes | |
Distance | p_localRadius |
Displacement * | p_x |
Displacement * | p_y |
Displacement * | p_z |
boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > * | p_rectCovar |
3x3 upper triangular covariance matrix rectangular coordinates More... | |
boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > * | p_sphereCovar |
3x3 upper triangular covariance matrix ocentric coordinates More... | |
This class defines a body-fixed surface point.
This class is a container for body-fixed surface points. It provides methods to set and present the coordinates of surface points in various usable units to support projection of image points to the ground and bundle adjustment.
Definition at line 132 of file SurfacePoint.h.
Defines the coordinate typ, units, and coordinate index for some of the output methods.
Enumerator | |
---|---|
Latitudinal | Planetocentric latitudinal (lat/lon/rad) coordinates. |
Rectangular | Body-fixed rectangular x/y/z coordinates. |
Definition at line 139 of file SurfacePoint.h.
Isis::SurfacePoint::SurfacePoint | ( | ) |
Constructs an empty SurfacePoint object.
Definition at line 26 of file SurfacePoint.cpp.
Isis::SurfacePoint::SurfacePoint | ( | const SurfacePoint & | other | ) |
Constructs a new SurfacePoint object from an existing SurfacePoint.
Definition at line 35 of file SurfacePoint.cpp.
References p_rectCovar, and p_sphereCovar.
Isis::SurfacePoint::SurfacePoint | ( | const Latitude & | lat, |
const Longitude & | lon, | ||
const Distance & | radius | ||
) |
Constructs a SurfacePoint object with a spherical point only.
lat | The latitude of the surface point |
lon | The longitude of the surface point |
radius | The radius of the surface point |
Definition at line 82 of file SurfacePoint.cpp.
Isis::SurfacePoint::SurfacePoint | ( | const Latitude & | lat, |
const Longitude & | lon, | ||
const Distance & | radius, | ||
const Angle & | latSigma, | ||
const Angle & | lonSigma, | ||
const Distance & | radiusSigma | ||
) |
Constructs a SurfacePoint object with a spherical point and its sigmas.
lat | The latitude of the surface point |
lon | The longitude of the surface point |
radius | The radius of the surface point The sigmas indicate the accuracy of the point. For instance, a latitude sigma of 5 degrees would indicate that the latitiude value could have an error or + or - 5 degrees. |
sigmaLat | The sigma of the latitude |
sigmaLon | The sigma of the longitude |
sigmaRadius | The sigma of the local radius |
Definition at line 105 of file SurfacePoint.cpp.
Isis::SurfacePoint::SurfacePoint | ( | const Displacement & | x, |
const Displacement & | y, | ||
const Displacement & | z | ||
) |
Constructs a SurfacePoint object with a rectangular point only.
x | The x coordinate of the surface point |
y | The y coordinate of the surface point |
z | The z coordinate of the surface point |
Definition at line 134 of file SurfacePoint.cpp.
Isis::SurfacePoint::SurfacePoint | ( | const Displacement & | x, |
const Displacement & | y, | ||
const Displacement & | z, | ||
const Distance & | xSigma, | ||
const Distance & | ySigma, | ||
const Distance & | zSigma | ||
) |
Constructs a SurfacePoint object with a rectangular point and sigmas.
x | The x coordinate of the surface point |
y | The y coordinate of the surface point |
z | The z coordinate of the surface point The sigmas indicate the accuracy of the point. For instance, a sigmaX=100 m, would indicate that the x coordinate was accurate to within 100 meters. |
xSigma | The x coordinate of the surface point |
ySigma | The y coordinate of the surface point |
zSigma | The z coordinate of the surface point |
Definition at line 156 of file SurfacePoint.cpp.
Isis::SurfacePoint::~SurfacePoint | ( | ) |
Destroys a SurfacePoint object/.
Definition at line 186 of file SurfacePoint.cpp.
|
private |
Compute the local radius of the surface point.
Definition at line 1709 of file SurfacePoint.cpp.
|
static |
Converts the given SurfacePoint::CoordinateType enumeration to a string.
This method is used to print the type of control point coordinates used in the bundle adjustment.
type | The Coordinate Type enumeration to be converted. |
Isis::Exception::Programmer | "Unknown SurfacePoint CoordinateType enum." |
Definition at line 1389 of file SurfacePoint.cpp.
References Isis::toString().
Referenced by Isis::BundleSolutionInfo::outputHeader().
double Isis::SurfacePoint::DisplacementToDouble | ( | Displacement | disp, |
CoordUnits | units | ||
) |
This method returns a double version of a Displacement in the specified units.
disp | The displacement to convert to a double |
units | The units in which to return the displacement (see CoordinateUnits in .h file) |
Definition at line 1160 of file SurfacePoint.cpp.
References Isis::Displacement::kilometers(), and Isis::Displacement::meters().
double Isis::SurfacePoint::DistanceToDouble | ( | Distance | dist, |
CoordUnits | units | ||
) |
This method returns a double version of a Distance in the specified units.
dist | The distance to convert to a double |
units | The units in which to return the distance (see CoordinateUnits in .h file) |
Definition at line 1188 of file SurfacePoint.cpp.
References Isis::Distance::kilometers(), and Isis::Distance::meters().
void Isis::SurfacePoint::FromNaifArray | ( | const double | naifValues[3] | ) |
A naif array is a c-style array of size 3.
The element types are double... keep in mind a SpiceDouble is a double. The values' units are kilometers because that is the unit naif works in. The first element is X, the second Y, and the third Z. This loads the naif array into the surface point.
naifValues | The naif array to use as rectangular coordinates |
Definition at line 891 of file SurfacePoint.cpp.
Referenced by Isis::TriangularPlate::intercept(), Isis::DemShape::intersectSurface(), Isis::EquatorialCylindricalShape::intersectSurface(), Isis::PlaneShape::intersectSurface(), Isis::BulletShapeModel::makeSurfacePoint(), Isis::TriangularPlate::point(), and Isis::EmbreeShapeModel::updateIntersection().
double Isis::SurfacePoint::GetCoord | ( | CoordinateType | type, |
CoordIndex | index, | ||
CoordUnits | units | ||
) |
This method returns a coordinate of a SurfacePoint.
type | The coordinate type to return (see CoordinateType in .h file) |
index | The coordinate index to return (1 <= index <= 3) |
units | The units in which to return the coordinate value (see CoordinateUnits in .h file) |
Definition at line 962 of file SurfacePoint.cpp.
References Isis::toString().
Referenced by Isis::BundleControlPoint::formatBundleOutputSummaryString().
Distance Isis::SurfacePoint::GetDistanceToPoint | ( | const SurfacePoint & | other | ) | const |
Computes and returns the distance between two surface points.
The average of the local radii will be used.
Definition at line 1880 of file SurfacePoint.cpp.
References GetLocalRadius().
Referenced by Isis::ControlNetFilter::CubeDistanceFilter(), Isis::FindTool::distancePerPixel(), Isis::QnetCubeDistanceFilter::filter(), Isis::QnetPointDistanceFilter::filter(), Isis::SpatialPlotTool::getSpatialStatistics(), and Isis::ControlNetFilter::PointDistanceFilter().
Distance Isis::SurfacePoint::GetDistanceToPoint | ( | const SurfacePoint & | other, |
const Distance & | sphereRadius | ||
) | const |
Computes and returns the distance between two surface points, assuming both points are on a sphere with the given radius.
This uses the haversine formula to compute the distance. Using a spherical model gives errors typically <1%
Definition at line 1897 of file SurfacePoint.cpp.
References GetLatitude(), GetLongitude(), and Isis::Angle::radians().
Latitude Isis::SurfacePoint::GetLatitude | ( | ) | const |
Return the body-fixed latitude for the surface point.
Definition at line 1665 of file SurfacePoint.cpp.
Referenced by Isis::ControlPointEditWidget::createTemporaryGroundMeasure(), Isis::QnetTool::drawGroundMeasures(), Isis::ControlNetTool::drawGroundMeasures(), Isis::CameraGroundMap::EllipsoidPartial(), Isis::QnetSetAprioriDialog::fillAverageAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillCurrentAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillReferenceAprioriLineEdits(), Isis::QnetPointRangeFilter::filter(), Isis::QnetTool::findPointLocation(), Isis::BundleControlPoint::formatBundleLatitudinalOutputDetailString(), Isis::BundleControlPoint::formatBundleRectangularOutputDetailString(), GetDistanceToPoint(), Isis::Sensor::GetLatitude(), Isis::Camera::GetLocalNormal(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::CameraGroundMap::PointPartial(), Isis::UniversalGroundMap::SetGround(), Isis::VimsGroundMap::SetGround(), Isis::PushFrameCameraGroundMap::SetGround(), Isis::ControlPointEditWidget::setShapesForPoint(), Isis::BundleAdjust::solveCholesky(), Isis::CSMCamera::subSpacecraftPoint(), Isis::ControlNetVersioner::toPvl(), Isis::BundleControlPoint::updateAdjustedSurfacePointLatitudinally(), Isis::SunShadowTool::updateRow(), Isis::ControlPointEditWidget::updateSurfacePointInfo(), and Isis::QnetTool::updateSurfacePointInfo().
Distance Isis::SurfacePoint::GetLatSigmaDistance | ( | ) | const |
Return the latitude sigma as a Distance.
Definition at line 1747 of file SurfacePoint.cpp.
Referenced by Isis::QnetSetAprioriDialog::fillSigmaLineEdits(), Isis::ControlNetVersioner::toPvl(), Isis::QnetTool::updateSurfacePointInfo(), and Isis::ControlNetVersioner::writeFirstPoint().
double Isis::SurfacePoint::GetLatWeight | ( | ) | const |
Return latitude weight for bundle adjustment Units are 1/(radians)^2.
Definition at line 1832 of file SurfacePoint.cpp.
Distance Isis::SurfacePoint::GetLocalRadius | ( | ) | const |
Return the radius of the surface point.
Definition at line 1732 of file SurfacePoint.cpp.
Referenced by Isis::QnetSetAprioriDialog::fillAverageAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillCurrentAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillReferenceAprioriLineEdits(), Isis::QnetPointDistanceFilter::filter(), Isis::BundleControlPoint::formatBundleLatitudinalOutputDetailString(), Isis::BundleControlPoint::formatBundleRectangularOutputDetailString(), GetDistanceToPoint(), Isis::BundleAdjust::init(), Isis::Sensor::LocalRadius(), Isis::ControlNetFilter::PointDistanceFilter(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::CameraGroundMap::PointPartial(), Isis::EmbreeShapeModel::pointToRay(), Isis::ControlNetVersioner::toPvl(), Isis::BundleControlPoint::updateAdjustedSurfacePointLatitudinally(), Isis::ControlPointEditWidget::updateSurfacePointInfo(), and Isis::QnetTool::updateSurfacePointInfo().
double Isis::SurfacePoint::GetLocalRadiusWeight | ( | ) | const |
Return radius weight for bundle adjustment Units are 1/(kilometers)^2.
Definition at line 1864 of file SurfacePoint.cpp.
Longitude Isis::SurfacePoint::GetLongitude | ( | ) | const |
Return the body-fixed longitude for the surface point.
Definition at line 1685 of file SurfacePoint.cpp.
References Isis::PI.
Referenced by Isis::ControlPointEditWidget::createTemporaryGroundMeasure(), Isis::QnetTool::drawGroundMeasures(), Isis::ControlNetTool::drawGroundMeasures(), Isis::CameraGroundMap::EllipsoidPartial(), Isis::QnetSetAprioriDialog::fillAverageAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillCurrentAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillReferenceAprioriLineEdits(), Isis::QnetPointRangeFilter::filter(), Isis::QnetTool::findPointLocation(), Isis::BundleControlPoint::formatBundleLatitudinalOutputDetailString(), Isis::BundleControlPoint::formatBundleRectangularOutputDetailString(), GetDistanceToPoint(), Isis::Camera::GetLocalNormal(), Isis::Sensor::GetLongitude(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::CameraGroundMap::PointPartial(), Isis::UniversalGroundMap::SetGround(), Isis::VimsGroundMap::SetGround(), Isis::PushFrameCameraGroundMap::SetGround(), Isis::ControlPointEditWidget::setShapesForPoint(), Isis::BundleAdjust::solveCholesky(), Isis::CSMCamera::subSpacecraftPoint(), Isis::ControlNetVersioner::toPvl(), Isis::BundleControlPoint::updateAdjustedSurfacePointLatitudinally(), Isis::SunShadowTool::updateRow(), Isis::ControlPointEditWidget::updateSurfacePointInfo(), and Isis::QnetTool::updateSurfacePointInfo().
Distance Isis::SurfacePoint::GetLonSigmaDistance | ( | ) | const |
Return the longitude sigma in meters.
Definition at line 1763 of file SurfacePoint.cpp.
Referenced by Isis::QnetSetAprioriDialog::fillSigmaLineEdits(), Isis::ControlNetVersioner::toPvl(), Isis::QnetTool::updateSurfacePointInfo(), and Isis::ControlNetVersioner::writeFirstPoint().
double Isis::SurfacePoint::GetLonWeight | ( | ) | const |
Return longitude weight for bundle adjustment Units are 1/(radians)^2.
Definition at line 1848 of file SurfacePoint.cpp.
double Isis::SurfacePoint::GetSigma | ( | CoordinateType | type, |
CoordIndex | index, | ||
CoordUnits | units | ||
) |
This method returns a sigma of a SurfacePoint coordinate.
type | The coordinate type to return (see CoordinateType in .h file) |
index | The coordinate index to return (1 <= index <= 3) |
units | The units in which to return the coordinate value (see CoordinateUnits in .h file) |
Definition at line 1029 of file SurfacePoint.cpp.
References Isis::toString().
Distance Isis::SurfacePoint::GetSigmaDistance | ( | CoordinateType | type, |
CoordIndex | index | ||
) |
This method returns a sigma of a SurfacePoint coordinate as a Distance.
type | The coordinate type to return (see CoordinateType in .h file) |
index | The coordinate index to return (1 <= index <= 3) |
Definition at line 1094 of file SurfacePoint.cpp.
References Isis::toString().
Referenced by Isis::BundleControlPoint::formatAdjustedSigmaString(), and Isis::BundleControlPoint::setWeights().
double Isis::SurfacePoint::GetWeight | ( | CoordinateType | type, |
CoordIndex | index | ||
) |
This method returns the weight of a SurfacePoint coordinate Note: At this time a units argument is not included.
If BundleAdjust is modified to allow different distance or displacement units other than kilometers, the units argument can be added similar to the GetCoord and GetSigma methods. Angle weights are in 1/rad^2 and distance and displacements are in 1/km^2
type | The coordinate type to return (see CoordinateType in .h file) |
index | The coordinate index to return (1 <= index <= 3) |
Definition at line 1491 of file SurfacePoint.cpp.
References Isis::toString().
Referenced by Isis::BundleControlPoint::setWeights().
double Isis::SurfacePoint::GetXWeight | ( | ) | const |
Return X weight for bundle adjustment Units are 1/(kilometers)^2.
Definition at line 1553 of file SurfacePoint.cpp.
double Isis::SurfacePoint::GetYWeight | ( | ) | const |
Return Y weight for bundle adjustment Units are 1/(kilometers)^2.
Definition at line 1571 of file SurfacePoint.cpp.
double Isis::SurfacePoint::GetZWeight | ( | ) | const |
Return Z weight for bundle adjustment Units are 1/(kilometers)^2.
Definition at line 1589 of file SurfacePoint.cpp.
|
private |
Initialize the variance/covariance matrices.
Definition at line 195 of file SurfacePoint.cpp.
|
private |
Initialize a surface point.
Definition at line 205 of file SurfacePoint.cpp.
double Isis::SurfacePoint::LatitudeToMeters | ( | double | relativeLat | ) | const |
This method returns a Displacement of an Angle relative to the current SurfacePoint latitude.
It should only be used to convert relative latitudes near the SurfacePoint latitude. Typical usage would be to convert latitude sigmas and point corrections for the SurfacePoint.
latRadians | The latitude in Angle units to convert to Displacement units |
Definition at line 1310 of file SurfacePoint.cpp.
References Isis::IsSpecial(), and Isis::Null.
Referenced by Isis::BundleControlPoint::formatBundleLatitudinalOutputDetailString().
std::vector< double > Isis::SurfacePoint::LatitudinalDerivative | ( | CoordIndex | index | ) |
Compute partial derivative of the conversion of the latitudinal coordinates to body-fixed rectangular coordinates with respect to the indicated coordinate.
index | Coordinate index |
Definition at line 798 of file SurfacePoint.cpp.
Referenced by Isis::CsmBundleObservation::computePoint3DPartials().
double Isis::SurfacePoint::LatToDouble | ( | Latitude | lat, |
CoordUnits | units | ||
) |
This method returns a double version of a Latitude in the specified units.
lat | The latitude to convert to a double |
units | The units in which to return the latitude (see CoordinateUnits in .h file) |
Definition at line 1216 of file SurfacePoint.cpp.
double Isis::SurfacePoint::LongitudeToMeters | ( | double | deltaLonRadians | ) | const |
This method returns a length in meters version of a delta longitude angle in radians relative to the current SurfacePoint longitude.
It should only be used to convert delta longitudes relative to the SurfacePoint longitude.
Typical usage would be to convert longitude sigmas and point corrections for the SurfacePoint.
lonRadians | The delta longitude in radians to convert to meters |
Definition at line 1336 of file SurfacePoint.cpp.
References Isis::IsSpecial(), and Isis::Null.
Referenced by Isis::BundleControlPoint::formatBundleLatitudinalOutputDetailString().
double Isis::SurfacePoint::LonToDouble | ( | Longitude | lon, |
CoordUnits | units | ||
) |
This method returns a double version of a Longitude in the specified units.
lon | The longitude to convert to a double |
units | The units in which to return the longitude (see CoordinateUnits in .h file) |
Definition at line 1415 of file SurfacePoint.cpp.
double Isis::SurfacePoint::MetersToLatitude | ( | double | latLength | ) |
This method returns an angular measure of a distance in the direction of and relative to the latitude of the SurfacePoint.
It should only be used to convert lengths relative to the SurfacePoint and in the direction of latitude. Typical usage would be to convert latitude sigmas and point corrections for the SurfacePoint.
latLength | The latitude in meters to convert to radian units |
Definition at line 1248 of file SurfacePoint.cpp.
References Isis::IsSpecial(), and Isis::Null.
Referenced by Isis::BundleControlPoint::setSigmaWeightFromGlobals().
double Isis::SurfacePoint::MetersToLongitude | ( | double | deltaLonMeters | ) |
This method returns an angular measure in radians of a distance in the direction of and relative to the longitude of the SurfacePoint.
It should only be used to
convert lengths relative to the SurfacePoint and in the direction of longitude. Typical usage is to convert longitude sigmas and point corrections for the SurfacePoint.
lonLength | The delta longitude distance in meters to convert to radians |
Definition at line 1276 of file SurfacePoint.cpp.
References Isis::IsSpecial(), Isis::Null, and Isis::PI.
Referenced by Isis::BundleControlPoint::setSigmaWeightFromGlobals().
std::vector< double > Isis::SurfacePoint::Partial | ( | CoordinateType | type, |
CoordIndex | index | ||
) |
Compute partial derivative of conversion from body-fixed coordinates to the specified.
Compute partial derivative of the conversion of the body-fixed surface point coordinate to the specified coordinate type.
covar | variance/covariance matrix |
Definition at line 773 of file SurfacePoint.cpp.
References Isis::toString().
Referenced by Isis::IsisBundleObservation::computePoint3DPartials().
std::vector< double > Isis::SurfacePoint::RectangularDerivative | ( | CoordIndex | index | ) |
Compute partial derivative of the body-fixed rectangular coordinates with respect to the indicated coordinate.
index | Coordinate index |
Definition at line 840 of file SurfacePoint.cpp.
void Isis::SurfacePoint::ResetLocalRadius | ( | const Distance & | radius | ) |
This method resets the local radius of a SurfacePoint.
radius | The new local radius value to set |
Definition at line 914 of file SurfacePoint.cpp.
References Isis::Distance::isValid(), and Isis::Distance::kilometers().
Referenced by Isis::BundleAdjust::solveCholesky().
void Isis::SurfacePoint::SetMatrix | ( | CoordinateType | type, |
const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > & | covar | ||
) |
Set the covariance matrix.
Set covariance matrix in km.
covar | variance/covariance matrix |
Definition at line 749 of file SurfacePoint.cpp.
References Isis::toString().
Referenced by Isis::BundleAdjust::errorPropagation(), and Isis::BundleAdjust::formPointNormals().
void Isis::SurfacePoint::SetRectangular | ( | const Displacement & | x, |
const Displacement & | y, | ||
const Displacement & | z, | ||
const Distance & | xSigma = Distance() , |
||
const Distance & | ySigma = Distance() , |
||
const Distance & | zSigma = Distance() |
||
) |
Set surface point in rectangular body-fixed coordinates wtih optional sigmas.
x | x value of body-fixed coordinate of surface point |
y | y value of body-fixed coordinate of surface point |
z | z value of body-fixed coordinate of surface point |
xSigma | x sigma of body-fixed coordinate of surface point |
ySigma | y sigma of body-fixed coordinate of surface point |
zSigma | z sigma of body-fixed coordinate of surface point |
Definition at line 283 of file SurfacePoint.cpp.
References Isis::Distance::isValid().
Referenced by Isis::ControlPoint::ComputeApriori(), Isis::ControlPointV0001::ControlPointV0001(), and Isis::QnetSetAprioriDialog::fillAverageAprioriLineEdits().
void Isis::SurfacePoint::SetRectangularCoordinates | ( | const Displacement & | x, |
const Displacement & | y, | ||
const Displacement & | z | ||
) |
Set surface point in rectangular coordinates.
x | x value of body-fixed coordinate of surface point |
y | y value of body-fixed coordinate of surface point |
z | z value of body-fixed coordinate of surface point |
Definition at line 327 of file SurfacePoint.cpp.
Referenced by Isis::BundleControlPoint::updateAdjustedSurfacePointRectangularly().
void Isis::SurfacePoint::SetRectangularMatrix | ( | const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > & | covar, |
SurfacePoint::CoordUnits | units = SurfacePoint::Meters |
||
) |
Set rectangular covariance matrix and store in units of km**2.
covar | Rectangular variance/covariance matrix |
units | Units of matrix are units**2 |
Definition at line 376 of file SurfacePoint.cpp.
Referenced by Isis::ControlNetVersioner::createPoint().
|
private |
This is a private method to set a surface point in rectangular, body-fixed coordinates.
This method isolates the procedure for setting a rectangular point in one place.
x | x value of body-fixed coordinate of surface point |
y | y value of body-fixed coordinate of surface point |
z | z value of body-fixed coordinate of surface point |
Definition at line 225 of file SurfacePoint.cpp.
References Isis::Displacement::isValid().
void Isis::SurfacePoint::SetRectangularSigmas | ( | const Distance & | xSigma, |
const Distance & | ySigma, | ||
const Distance & | zSigma | ||
) |
Set surface point and sigmas in rectangular coordinates and convert to planetocentric.
Set the rectangular sigmas into the rectangular variance/covariance matrix with diagonal element units of km^2, km^2, and km^2.
xSigma | x sigma of body-fixed coordinate of surface point |
ySigma | y sigma of body-fixed coordinate of surface point |
zSigma | z sigma of body-fixed coordinate of surface point |
Definition at line 350 of file SurfacePoint.cpp.
References Isis::Distance::isValid(), and Isis::Distance::meters().
void Isis::SurfacePoint::SetSpherical | ( | const Latitude & | lat, |
const Longitude & | lon, | ||
const Distance & | radius, | ||
const Angle & | latSigma = Angle() , |
||
const Angle & | lonSigma = Angle() , |
||
const Distance & | radiusSigma = Distance() |
||
) |
Set surface point and covariance matrix in planetocentric coordinates and convert to rectangular (Latitude, Longitude in degrees, Radius in meters; matrix in radians and radians**2)
Set surface point in spherical body-fixed coordinates (lat/lon/radius) wtih optional sigmas.
lat | Body-fixed latitude of surface point |
lon | Body-fixed longitude of surface point |
radius | Local radius of surface point |
latSigma | Latitude sigma of of spherical coordinate of surface point |
lonSigma | Longitude sigma of of spherical coordinate of surface point |
radiusSigma | Local radius sigma of of spherical coordinate of surface point |
Definition at line 518 of file SurfacePoint.cpp.
References Isis::Angle::isValid(), and Isis::Distance::isValid().
Referenced by Isis::ControlNetFilter::PointDistanceFilter(), and Isis::ControlNetFilter::PointLatLonFilter().
void Isis::SurfacePoint::SetSphericalCoordinates | ( | const Latitude & | lat, |
const Longitude & | lon, | ||
const Distance & | radius | ||
) |
Update spherical coordinates (lat/lon/radius)
lat | |
lon | |
radius |
Definition at line 553 of file SurfacePoint.cpp.
Referenced by Isis::BundleControlPoint::updateAdjustedSurfacePointLatitudinally().
void Isis::SurfacePoint::SetSphericalMatrix | ( | const boost::numeric::ublas::symmetric_matrix< double, boost::numeric::ublas::upper > & | covar, |
SurfacePoint::CoordUnits | units = SurfacePoint::Meters |
||
) |
Set spherical covariance matrix.
covar | Spherical variance/covariance matrix (radians**2 for lat and lon) |
Definition at line 637 of file SurfacePoint.cpp.
|
private |
This is a private method to set a surface point in spherical (lat/lon/radius), body-fixed coordinates.
This method isolates the procedure for setting a spherical point in one place.
lat | Body-fixed latitude of surface point |
lon | Body-fixed longitude of surface point |
radius | Local radius of surface point |
Definition at line 480 of file SurfacePoint.cpp.
References Isis::Angle::isValid(), Isis::Distance::isValid(), Isis::Distance::kilometers(), and Isis::Angle::radians().
void Isis::SurfacePoint::SetSphericalSigmas | ( | const Angle & | latSigma, |
const Angle & | lonSigma, | ||
const Distance & | radiusSigma | ||
) |
Set the spherical sigmas into the spherical variance/covariance matrix in diagonal units of radians^2, radians^2, km^2.
latSigma | Latitude sigma of body-fixed coordinate of surface point |
lonSigma | Longitude sigma of body-fixed coordinate of surface point |
radiusSigma | Radius sigma of body-fixed coordinate of surface point |
Definition at line 573 of file SurfacePoint.cpp.
References Isis::Angle::isValid(), Isis::Distance::isValid(), Isis::Distance::meters(), and Isis::Angle::radians().
void Isis::SurfacePoint::SetSphericalSigmasDistance | ( | const Distance & | latSigma, |
const Distance & | lonSigma, | ||
const Distance & | radiusSigma | ||
) |
Set the spherical sigmas (in Distance units) into the spherical variance/covariance matrix.
latSigma | Latitude sigma of body-fixed coordinate of surface point as a Distance |
lonSigma | Longitude sigma of body-fixed coordinate of surface point as a Distance |
radiusSigma | Radius sigma of body-fixed coordinate of surface point in meters |
Definition at line 617 of file SurfacePoint.cpp.
References Isis::Distance::meters().
Referenced by Isis::ControlPointV0001::ControlPointV0001(), and Isis::QnetSetAprioriDialog::setApriori().
|
static |
This method converts the given string value to a SurfacePoint::CoordinateType enumeration.
Currently (March 31, 2017) accepted inputs are listed below.
This method is case insensitive.
type | The coordinate type name to be converted |
Definition at line 1363 of file SurfacePoint.cpp.
Referenced by Isis::BundleSettings::XmlHandler::startElement().
void Isis::SurfacePoint::ToNaifArray | ( | double | naifOutput[3] | ) | const |
A naif array is a c-style array of size 3.
The element types are double... keep in mind a SpiceDouble is a double. The values' units are kilometers because that is the unit naif works in. The first element is X, the second Y, and the third Z.
naifOutput | The naif array to populate with the surface point's XYZ position. |
Definition at line 870 of file SurfacePoint.cpp.
Referenced by Isis::DemShape::calculateLocalNormal(), Isis::BulletShapeModel::ellipsoidNormal(), Isis::EmbreeShapeModel::ellipsoidNormal(), Isis::NaifDskShape::ellipsoidNormal(), Isis::TriangularPlate::hasPoint(), Isis::EmbreeShapeModel::intersectSurface(), Isis::EmbreeShapeModel::isVisibleFrom(), Isis::TriangularPlate::point(), Isis::EmbreeShapeModel::pointToRay(), Isis::BulletShapeModel::pointToVector(), and Isis::RadarGroundMap::SetGround().
|
private |
3x3 upper triangular covariance matrix rectangular coordinates
Definition at line 312 of file SurfacePoint.h.
Referenced by SurfacePoint().
|
private |
3x3 upper triangular covariance matrix ocentric coordinates
Definition at line 315 of file SurfacePoint.h.
Referenced by SurfacePoint().