Isis 3 Programmer Reference
CSMCamera.h
1 #ifndef CSMCamera_h
2 #define CSMCamera_h
3 
9 /* SPDX-License-Identifier: CC0-1.0 */
10 
11 #include "Camera.h"
12 #include "iTime.h"
13 #include "Target.h"
14 
15 #include <vector>
16 
17 #include <QList>
18 #include <QPointF>
19 #include <QStringList>
20 
21 #include "csm/csm.h"
22 #include "csm/RasterGM.h"
23 
24 namespace Isis {
25  class CSMCamera : public Camera {
26 
27  public:
28  // constructors
29  CSMCamera(Cube &cube);
30 // CSMCamera(Cube &cube, QString pluginName, QString modelName, QString stateString);
31 
33  ~CSMCamera() {};
34 
40  virtual CameraType GetCameraType() const {
41  return Csm;
42  }
43 
50  virtual int CkFrameId() const { return (-1); }
51 
58  virtual int CkReferenceId() const { return (-1); }
59 
66  virtual int SpkCenterId() const { return -1; }
67 
74  virtual int SpkReferenceId() const { return (-1); }
75 
77 
78  virtual bool SetImage(const double sample, const double line);
79 
80  virtual bool SetGround(Latitude latitude, Longitude longitude);
81  virtual bool SetGround(const SurfacePoint &surfacePt);
82  virtual bool SetUniversalGround(const double latitude, const double longitude);
83  virtual bool SetUniversalGround(const double latitude, const double longitude, double radius);
84 
85  virtual void setTime(const iTime &time);
86 
87  virtual double LineResolution();
88  virtual double SampleResolution();
89  virtual double DetectorResolution();
90  virtual double ObliqueLineResolution();
91  virtual double ObliqueSampleResolution();
92  virtual double ObliqueDetectorResolution();
93 
94  virtual double parentLine() const;
95  virtual double parentSample() const;
96 
97  virtual void subSpacecraftPoint(double &lat, double &lon);
98  virtual void subSpacecraftPoint(double &lat, double &lon, double line, double sample);
99  virtual void subSolarPoint(double &lat, double &lon);
100 
101  virtual double PhaseAngle() const;
102  virtual double EmissionAngle() const;
103  virtual double IncidenceAngle() const;
104 
105  virtual SpicePosition *sunPosition() const;
106  virtual SpicePosition *instrumentPosition() const;
107  virtual SpiceRotation *bodyRotation() const;
108  virtual SpiceRotation *instrumentRotation() const;
109 
110  virtual void instrumentBodyFixedPosition(double p[3]) const;
111  virtual void sunPosition(double p[3]) const;
112  virtual double SolarDistance() const;
113 
114  virtual double SlantDistance() const;
115  virtual double targetCenterDistance() const;
116 
117  virtual double RightAscension();
118  virtual double Declination();
119 
120  std::vector<int> getParameterIndices(csm::param::Set paramSet) const;
121  std::vector<int> getParameterIndices(csm::param::Type paramType) const;
122  std::vector<int> getParameterIndices(QStringList paramList) const;
123  void applyParameterCorrection(int index, double correction);
124  double getParameterCovariance(int index1, int index2);
125  QString getParameterName(int index);
126  QString getParameterUnits(int index);
127  double getParameterValue(int index);
128 
129  std::vector<double> getSensorPartials(int index, SurfacePoint groundPoint);
130  virtual std::vector<double> GroundPartials(SurfacePoint groundPoint);
131  virtual std::vector<double> GroundPartials();
132 
133  QString getModelState() const;
134 
135  protected:
136  void setTarget(Pvl label);
137 
138  std::vector<double> sensorPositionBodyFixed() const;
139  std::vector<double> sensorPositionBodyFixed(double line, double sample) const;
140 
141  virtual void computeSolarLongitude(iTime et);
142 
143  private:
144  void init(Cube &cube, QString pluginName, QString modelName, QString stateString);
145 
146  csm::RasterGM *m_model;
148 
149  void isisToCsmPixel(double line, double sample, csm::ImageCoord &csmPixel) const;
150  void csmToIsisPixel(csm::ImageCoord csmPixel, double &line, double &sample) const;
151  csm::EcefCoord isisToCsmGround(const SurfacePoint &groundPt) const;
152  SurfacePoint csmToIsisGround(const csm::EcefCoord &groundPt) const;
153 
154  virtual std::vector<double> ImagePartials(SurfacePoint groundPoint);
155  virtual std::vector<double> ImagePartials();
156  };
157 };
158 #endif
Isis::CSMCamera::computeSolarLongitude
virtual void computeSolarLongitude(iTime et)
Computes the solar longitude for the given ephemeris time.
Definition: CSMCamera.cpp:1098
Isis::CSMCamera::targetCenterDistance
virtual double targetCenterDistance() const
Calculates and returns the distance from the spacecraft to the target center at the currently set tim...
Definition: CSMCamera.cpp:820
Isis::CSMCamera::PixelIfovOffsets
virtual QList< QPointF > PixelIfovOffsets()
Returns the pixel ifov offsets from center of pixel.
Definition: CSMCamera.cpp:1011
Isis::CSMCamera::sunPosition
virtual SpicePosition * sunPosition() const
Get the SpicePosition object that contains the state information for the sun in J2000.
Definition: CSMCamera.cpp:1039
Isis::Spice::time
iTime time() const
Returns the ephemeris time in seconds which was used to obtain the spacecraft and sun positions.
Definition: Spice.cpp:884
Isis::SpicePosition
Obtain SPICE position information for a body.
Definition: SpicePosition.h:173
Isis::CSMCamera::SpkCenterId
virtual int SpkCenterId() const
SPK Center ID - 6 (Saturn)
Definition: CSMCamera.h:66
Isis::CSMCamera::ObliqueDetectorResolution
virtual double ObliqueDetectorResolution()
Compute the oblique detector resolution in meters per pixel for the current set point.
Definition: CSMCamera.cpp:424
Isis::CSMCamera::csmToIsisGround
SurfacePoint csmToIsisGround(const csm::EcefCoord &groundPt) const
Convert a CSM ground point into an ISIS ground point.
Definition: CSMCamera.cpp:737
Isis::CSMCamera::getParameterCovariance
double getParameterCovariance(int index1, int index2)
Get the covariance between two parameters.
Definition: CSMCamera.cpp:913
Isis::CSMCamera::IncidenceAngle
virtual double IncidenceAngle() const
Compute the incidence angle at the currently set ground point.
Definition: CSMCamera.cpp:778
Isis::CSMCamera::csmToIsisPixel
void csmToIsisPixel(csm::ImageCoord csmPixel, double &line, double &sample) const
Convert a CSM pixel coordinate to an ISIS pixel coordinate.
Definition: CSMCamera.cpp:704
QList< QPointF >
Isis::Latitude
This class is designed to encapsulate the concept of a Latitude.
Definition: Latitude.h:51
Isis::CSMCamera::m_refTime
iTime m_refTime
CSM sensor model.
Definition: CSMCamera.h:147
Isis::iTime
Parse and return pieces of a time string.
Definition: iTime.h:65
Isis::CSMCamera::ImagePartials
virtual std::vector< double > ImagePartials()
Compute the partial derivatives of the ground point with respect to the line and sample at the curren...
Definition: CSMCamera.cpp:552
Isis::CSMCamera::instrumentRotation
virtual SpiceRotation * instrumentRotation() const
Get the SpiceRotation object the contains the orientation of the sensor relative to J2000.
Definition: CSMCamera.cpp:1084
Isis::CSMCamera::ObliqueSampleResolution
virtual double ObliqueSampleResolution()
Compute the oblique sample resolution in meters per pixel for the current set point.
Definition: CSMCamera.cpp:409
Isis::CSMCamera::SetImage
virtual bool SetImage(const double sample, const double line)
Set the image sample and line for the Camera Model and then compute the corresponding image time,...
Definition: CSMCamera.cpp:123
Isis::CSMCamera::applyParameterCorrection
void applyParameterCorrection(int index, double correction)
Adjust the value of a parameter.
Definition: CSMCamera.cpp:901
Isis::CSMCamera::SolarDistance
virtual double SolarDistance() const
Computes the distance to the sun from the currently set ground point.
Definition: CSMCamera.cpp:1111
Isis::CSMCamera::EmissionAngle
virtual double EmissionAngle() const
Compute the emission angle at the currently set ground point.
Definition: CSMCamera.cpp:768
Isis::CSMCamera::subSpacecraftPoint
virtual void subSpacecraftPoint(double &lat, double &lon)
Get the latitude and longitude of the sub-spacecraft point at the currently set time.
Definition: CSMCamera.cpp:510
Isis::CSMCamera::SlantDistance
virtual double SlantDistance() const
Compute the slant distance from the sensor to the ground point at the currently set time.
Definition: CSMCamera.cpp:798
Isis::Pvl
Container for cube-like labels.
Definition: Pvl.h:119
Isis::CSMCamera::GroundPartials
virtual std::vector< double > GroundPartials()
Compute the partial derivatives of the sample, line with respect to the x, y, z coordinates of the gr...
Definition: CSMCamera.cpp:622
Isis::CSMCamera::PhaseAngle
virtual double PhaseAngle() const
Compute the phase angle at the currently set ground point.
Definition: CSMCamera.cpp:749
Isis::Camera
Definition: Camera.h:236
Isis::CSMCamera::bodyRotation
virtual SpiceRotation * bodyRotation() const
Get the SpiceRotation object the contains the orientation of the target body relative to J2000.
Definition: CSMCamera.cpp:1069
QStringList
Isis::CSMCamera::LineResolution
virtual double LineResolution()
Compute the line resolution in meters per pixel for the current set point.
Definition: CSMCamera.cpp:337
Isis::CSMCamera::init
void init(Cube &cube, QString pluginName, QString modelName, QString stateString)
Init method which performs most of the setup for the CSM Camera Model inside ISIS.
Definition: CSMCamera.cpp:75
Isis::CSMCamera::getParameterValue
double getParameterValue(int index)
Get the value of a parameter.
Definition: CSMCamera.cpp:947
Isis::CSMCamera::ObliqueLineResolution
virtual double ObliqueLineResolution()
Compute the oblique line resolution in meters per pixel for the current set point.
Definition: CSMCamera.cpp:394
Isis::Longitude
This class is designed to encapsulate the concept of a Longitude.
Definition: Longitude.h:40
Isis::CSMCamera::parentLine
virtual double parentLine() const
Returns the currently set parent line for the camera model.
Definition: CSMCamera.cpp:437
Isis::CSMCamera::setTime
virtual void setTime(const iTime &time)
Set the time and update the sensor position and orientation.
Definition: CSMCamera.cpp:982
Isis::CSMCamera::setTarget
void setTarget(Pvl label)
Set the Target object for the camera model.
Definition: CSMCamera.cpp:657
Isis::CSMCamera::DetectorResolution
virtual double DetectorResolution()
Compute the detector resolution in meters per pixel for the current set point.
Definition: CSMCamera.cpp:371
Isis::CSMCamera::CkReferenceId
virtual int CkReferenceId() const
CK Reference ID - J2000.
Definition: CSMCamera.h:58
Isis::Camera::CameraType
CameraType
This enum defines the types of cameras supported in this class.
Definition: Camera.h:357
Isis::CSMCamera::SetGround
virtual bool SetGround(Latitude latitude, Longitude longitude)
Set the latitude and longitude for the Camera Model and then compute the corresponding image time,...
Definition: CSMCamera.cpp:228
Isis::CSMCamera::~CSMCamera
~CSMCamera()
Destroys the CSMCamera object.
Definition: CSMCamera.h:33
Isis::CSMCamera::subSolarPoint
virtual void subSolarPoint(double &lat, double &lon)
Returns the sub-solar latitude/longitude in universal coordinates (0-360 positive east,...
Definition: CSMCamera.cpp:998
Isis::CSMCamera::SpkReferenceId
virtual int SpkReferenceId() const
SPK Reference ID - J2000.
Definition: CSMCamera.h:74
Isis::CSMCamera::GetCameraType
virtual CameraType GetCameraType() const
The CSM camera needs a bogus type for now.
Definition: CSMCamera.h:40
Isis::CSMCamera::SetUniversalGround
virtual bool SetUniversalGround(const double latitude, const double longitude)
Set the latitude and longitude for the Camera Model and then compute the corresponding image time,...
Definition: CSMCamera.cpp:193
Isis::CSMCamera::CkFrameId
virtual int CkFrameId() const
CK frame ID - - Instrument Code from spacit run on CK.
Definition: CSMCamera.h:50
Isis::CSMCamera::parentSample
virtual double parentSample() const
Returns the currently set parent sample for the camera model.
Definition: CSMCamera.cpp:449
Isis::Cube
IO Handler for Isis Cubes.
Definition: Cube.h:167
Isis::CSMCamera::Declination
virtual double Declination()
Computes the Declination of the currently set image coordinate.
Definition: CSMCamera.cpp:1139
Isis::Camera::Csm
@ Csm
Community Sensor Model Camera.
Definition: Camera.h:364
Isis::CSMCamera::getModelState
QString getModelState() const
Get the CSM Model state string to re-create the CSM Model.
Definition: CSMCamera.cpp:969
Isis::CSMCamera::getParameterIndices
std::vector< int > getParameterIndices(csm::param::Set paramSet) const
Get the indices of the parameters that belong to a set.
Definition: CSMCamera.cpp:836
Isis::CSMCamera::CSMCamera
CSMCamera(Cube &cube)
Constructor for an ISIS Camera model that uses a Community Sensor Model (CSM) for the principal trans...
Definition: CSMCamera.cpp:56
Isis::CSMCamera::getParameterUnits
QString getParameterUnits(int index)
Get the units of the parameter at a particular index.
Definition: CSMCamera.cpp:959
Isis::CSMCamera::sensorPositionBodyFixed
std::vector< double > sensorPositionBodyFixed() const
Get the position of the sensor in the body fixed coordinate system at the currently set time.
Definition: CSMCamera.cpp:475
Isis::CSMCamera::getParameterName
QString getParameterName(int index)
Get the name of the parameter.
Definition: CSMCamera.cpp:935
Isis::CSMCamera::isisToCsmGround
csm::EcefCoord isisToCsmGround(const SurfacePoint &groundPt) const
Convert an ISIS ground point into a CSM ground point.
Definition: CSMCamera.cpp:720
Isis::CSMCamera::instrumentBodyFixedPosition
virtual void instrumentBodyFixedPosition(double p[3]) const
Get the position of the sensor in the body fixed coordinate system at the currently set time.
Definition: CSMCamera.cpp:461
Isis::CSMCamera::instrumentPosition
virtual SpicePosition * instrumentPosition() const
Get the SpicePosition object the contains the state information for the sensor in J2000.
Definition: CSMCamera.cpp:1054
Isis::CSMCamera
Definition: CSMCamera.h:25
Isis::CSMCamera::SampleResolution
virtual double SampleResolution()
Compute the sample resolution in meters per pixel for the current set point.
Definition: CSMCamera.cpp:354
Isis::CSMCamera::RightAscension
virtual double RightAscension()
Computes the Right Ascension of the currently set image coordinate.
Definition: CSMCamera.cpp:1125
Isis::SurfacePoint
This class defines a body-fixed surface point.
Definition: SurfacePoint.h:132
Isis
This is free and unencumbered software released into the public domain.
Definition: Apollo.h:16
Isis::CSMCamera::isisToCsmPixel
void isisToCsmPixel(double line, double sample, csm::ImageCoord &csmPixel) const
The reference time that all model image times are relative to.
Definition: CSMCamera.cpp:689
Isis::SpiceRotation
Obtain SPICE rotation information for a body.
Definition: SpiceRotation.h:209