DawnVirCamera.cpp

 
/* SPDX-License-Identifier: CC0-1.0 */
 
#include "DawnVirCamera.h"
 
#include <cctype>
#include <iostream>
#include <iomanip>
#include <sstream>
#include <algorithm>
 
#include <QRegExp>
#include <QString>
 
#include <tnt/tnt_array2d_utils.h>
 
#include "Camera.h"
#include "CameraFocalPlaneMap.h"
#include "IException.h"
#include "IString.h"
#include "iTime.h"
#include "Kernels.h"
#include "LineScanCameraDetectorMap.h"
#include "LineScanCameraGroundMap.h"
#include "LineScanCameraSkyMap.h"
#include "NaifStatus.h"
#include "NumericalApproximation.h"
 
// #define DUMP_INFO 1
 
using namespace std;
namespace Isis {
    // constructors
  DawnVirCamera::DawnVirCamera(Cube &cube) : LineScanCamera(cube) {
 
    m_instrumentNameLong = "Visual and Infrared Spectrometer";
    m_instrumentNameShort = "VIR";
    m_spacecraftNameLong = "Dawn";
    m_spacecraftNameShort = "Dawn";
 
 //     cout << "Testing DawnVirCamera...\n";
 
    Pvl &lab = *cube.label();
    PvlGroup &archive = lab.findGroup("Archive", Isis::Pvl::Traverse);
    int procLevel = archive["ProcessingLevelId"];
    m_is1BCalibrated = (procLevel > 2) ? true : false;
 
    // Get the start time from labels
    PvlGroup &inst = lab.findGroup("Instrument", Isis::Pvl::Traverse);
    QString channelId = inst["ChannelId"];
 
    QString instMode = inst["InstrumentModeId"];
    m_slitMode = instMode[14].toLatin1();   // "F" for full slit, Q for quarter slit
 
    // Check for presence of articulation kernel
    bool hasArtCK = hasArticulationKernel(lab);
 
    // Set proper end frame
    int virFrame(0);
    if (channelId == "VIS") {
      // Frame DAWN_VIR_VIS : DAWN_VIR_VIS_ZERO
      virFrame = (hasArtCK) ? -203211 : -203221;
    }
    else { // (channelId == "IR)
      // Frame DAWN_VIR_IR : DAWN_VIR_IR_ZERO
      virFrame = (hasArtCK) ? -203213 : -203223;
    }
 
    instrumentRotation()->SetFrame(virFrame);
 
    // We do not want to downsize the cache
    instrumentRotation()->MinimizeCache(SpiceRotation::No);
 
    // Set up the camera info from ik/iak kernels
    SetFocalLength();
    SetPixelPitch();
 
    // Get other info from labels
    PvlKeyword &frameParam = inst["FrameParameter"];
    m_exposureTime = toDouble(frameParam[0]);
    m_summing  = toDouble(frameParam[1]);
    m_scanRate = toDouble(frameParam[2]);
 
    // Setup detector map
    //  Get the line scan rates/times
    readHouseKeeping(lab.fileName(), m_scanRate);
    new VariableLineScanCameraDetectorMap(this, m_lineRates);
    DetectorMap()->SetDetectorSampleSumming(m_summing);
 
    // Setup focal plane map
    new CameraFocalPlaneMap(this, naifIkCode());
 
    //  Retrieve boresight location from instrument kernel (IK) (addendum?)
    QString ikernKey = "INS" + toString(naifIkCode()) + "_BORESIGHT_SAMPLE";
    double sampleBoreSight = getDouble(ikernKey);
 
    ikernKey = "INS" + toString(naifIkCode()) + "_BORESIGHT_LINE";
    double lineBoreSight = getDouble(ikernKey);
 
    FocalPlaneMap()->SetDetectorOrigin(sampleBoreSight, lineBoreSight);
 
    // Setup distortion map
    new CameraDistortionMap(this);
 
    // Setup the ground and sky map
    new LineScanCameraGroundMap(this);
    new LineScanCameraSkyMap(this);
 
    // Set initial start time always (label start time is inaccurate)
    setTime(iTime(startTime()));    // Isis3nightly
//      SetEphemerisTime(startTime());  // Isis3.2.1
 
    //  Now check to determine if we have a cache already.  If we have a cache
    //  table, we are beyond spiceinit and have already computed the proper
    //  point table from the housekeeping data or articulation kernel.
    if (!instrumentRotation()->IsCached() && !hasArtCK) {
 
      // Create new table here prior to creating normal caches
      Table quats = getPointingTable(channelId, virFrame);
 
      // Create all system tables - all kernels closed after this
      LoadCache();
      instrumentRotation()->LoadCache(quats);
    }
    else {
      LoadCache();
    }
 
#if defined(DUMP_INFO)
    Table cache = instrumentRotation()->Cache("Loaded");
    cout << "Total Records: " << cache.Records() << "\n";
 
    for (int i = 0 ; i < cache.Records() ; i++) {
      TableRecord rec = cache[i];
      string separator("");
      for (int f = 0 ; f < rec.Fields() ; f++) {
        cout << separator << (double) rec[f];
        separator = ", ";
      }
      cout << "\n";
    }
#endif
  }
 
  DawnVirCamera::~DawnVirCamera() {
  }
 
  int DawnVirCamera::CkFrameId() const {
    return (-203000);
  }
 
 
  int DawnVirCamera::CkReferenceId() const {
    return (1);
  }
 
 
  int DawnVirCamera::SpkReferenceId() const {
    return (1);
  }
 
 
  QString DawnVirCamera::scrub(const QString &text) const {
    QString ostr;
    for (int i = 0 ; i < text.size() ; i++) {
      if ((text[i] > ' ') &&  (text[i] <= 'z')) ostr += text[i];
    }
    return (ostr);
  }
 
 
  int DawnVirCamera::pixelSumming() const {
    return (m_summing);
  }
 
 
  double DawnVirCamera::exposureTime() const {
    return (m_exposureTime);
  }
 
 
  double DawnVirCamera::scanLineTime() const {
    return (m_scanRate);
  }
 
 
  double DawnVirCamera::lineStartTime(const double midExpTime) const {
    return (midExpTime-(exposureTime()/2.0));
  }
 
 
  double DawnVirCamera::lineEndTime(const double midExpTime) const {
    return (midExpTime+(exposureTime()/2.0));
  }
 
 
  double DawnVirCamera::startTime() const {
    return (lineStartTime(m_mirrorData[0].m_scanLineEt));
  }
 
 
  double DawnVirCamera::endTime() const {
   return (lineEndTime(m_mirrorData[hkLineCount()-1].m_scanLineEt));
  }
 
 
  int DawnVirCamera::hkLineCount() const {
    return (m_mirrorData.size());
  }
 
 
  void DawnVirCamera::readHouseKeeping(const QString &filename,
                                       double lineRate) {
   //  Open the ISIS table object
   Table hktable("VIRHouseKeeping", filename);
 
   m_lineRates.clear();
   int lineno(1);
   NumericalApproximation angFit;
   for (int i = 0; i < hktable.Records(); i++) {
     TableRecord &trec = hktable[i];
     QString scet = scrub(trec["ScetTimeClock"]);
     QString shutterMode = scrub(trec["ShutterStatus"]);
 
     // Compute the optical mirror angle
     double mirrorSin = trec["MirrorSin"];
     double mirrorCos = trec["MirrorCos"];
     double scanElecDeg = atan(mirrorSin/mirrorCos) * dpr_c();
     double optAng = ((scanElecDeg - 3.7996979) * 0.25/0.257812);
     optAng /= 1000.0;
 
 
     ScanMirrorInfo smInfo;
     double lineMidTime;
     //  scs2e_c(naifSpkCode(), scet.c_str(), &lineMidTime);
     lineMidTime = getClockTime(scet, naifSpkCode()).Et();
     bool isDark = shutterMode.toLower() == "closed";
 
     // Add fit data for all open angles
     if ( ! isDark ) {  angFit.AddData(lineno, optAng);   }
 
#if defined(DUMP_INFO)
      cout << "Line(" << ((isDark) ? "C): " : "O): ") << i
           << ", OptAng(D): " << setprecision(12) << optAng * dpr_c()
           << ", MidExpTime(ET): " <<  lineMidTime
           << "\n";
#endif
 
      // Store line,
      smInfo.m_lineNum = lineno;
      smInfo.m_scanLineEt = lineMidTime;
      smInfo.m_mirrorSin = mirrorSin;
      smInfo.m_mirrorCos = mirrorCos;
      smInfo.m_opticalAngle = optAng;
      smInfo.m_isDarkCurrent = isDark;
 
      if ((!m_is1BCalibrated) || (!(m_is1BCalibrated && isDark))) {
        m_lineRates.push_back(LineRateChange(lineno,
                                             lineStartTime(lineMidTime),
                                             exposureTime()));
        m_mirrorData.push_back(smInfo);
        lineno++;
      }
    }
 
    // Adjust the last time
    LineRateChange  lastR = m_lineRates.back();
 
    // Normally the line rate changes would store the line scan rate instead of exposure time.
    // Storing the exposure time instead allows for better time calculations within a line.
    // In order for the VariableLineScanCameraDetectorMap to work correctly with this change,
    // every line in the cube must have a LineRateChange object.  This is because determining
    // the start time for one line based on another line requires the line scan rate.  Having
    // a LineRateChange for every line means never needing to calculate the start time for a line
    // because the start time is stored in that line's LineRateChange.  So, the detector map only
    // calculates times within a given line.
    // See VariableLineScanCameraDetectorMap::exposureDuration() for a description of the
    // difference between exposure time and line scan rate.
 
    m_lineRates.back() = LineRateChange(lastR.GetStartLine(),
                                        lastR.GetStartEt(),
                                        exposureTime());
 
    //  Run through replacing all closed optical angles with fitted data.
    //  These are mostly first/last lines so must set proper extrapolation
    //  option.
    for (unsigned int a = 0 ; a < m_mirrorData.size() ; a++) {
      if (m_mirrorData[a].m_isDarkCurrent) {
        m_mirrorData[a].m_opticalAngle = angFit.Evaluate(a+1,
                                      NumericalApproximation::NearestEndpoint);
      }
    }
 
    //  Gut check on housekeeping contents and cube lines
    if ((int) m_lineRates.size() != Lines()) {
      ostringstream mess;
      mess << "Number housekeeping lines determined (" << m_lineRates.size()
           << ") is not equal to image lines(" << Lines() << ")";
      throw IException(IException::Programmer, mess.str(), _FILEINFO_);
    }
  }
 
 
  Table DawnVirCamera::getPointingTable(const QString &virChannel,
                                        const int zeroFrame)  {
 
    // Create Spice Pointing table
    TableField q0("J2000Q0", TableField::Double);
    TableField q1("J2000Q1", TableField::Double);
    TableField q2("J2000Q2", TableField::Double);
    TableField q3("J2000Q3", TableField::Double);
    TableField av1("AV1", TableField::Double);
    TableField av2("AV2", TableField::Double);
    TableField av3("AV3", TableField::Double);
    TableField t("ET", TableField::Double);
 
    TableRecord record;
    record += q0;
    record += q1;
    record += q2;
    record += q3;
    record += av1;
    record += av2;
    record += av3;
    record += t;
 
    // Get pointing table
    Table quats("SpiceRotation", record);
    int nfields = record.Fields();
 
    QString virId = "DAWN_VIR_" + virChannel;
    QString virZero = virId + "_ZERO";
 
    // Allocate output arrays
    int nvals = nfields - 1;
    int nlines = m_lineRates.size();
 
    SpiceDouble eulang[6] = { 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 };
    SpiceDouble xform[6][6], xform2[6][6];
    SpiceDouble m[3][3];
    SpiceDouble q_av[7], *av(&q_av[4]);
 
    for (int i = 0 ; i < nlines ; i++) {
      int index = min(i, nlines-1);
      double etTime = m_mirrorData[index].m_scanLineEt;  // mid exposure ET
      double optAng = m_mirrorData[index].m_opticalAngle;
      try {
        // J2000 -> DAWN_VIR_{channel}_ZERO
        SMatrix state = getStateRotation("J2000", virZero, etTime);
 
        // Set rotation of optical scan mirror (in radians)
        eulang[1] = -optAng;
        eul2xf_c(eulang, 1, 2, 3, xform);
        mxmg_c(xform, &state[0][0], 6, 6, 6, xform2);
 
        // Transform to output format
        xf2rav_c(xform2, m, av);  // Transfers AV to output q_av via pointer
        m2q_c(m, q_av);          // Transfers quaternion
 
        //  Now populate the table record with the line pointing
        for (int k = 0 ; k < nvals ; k++) {
          record[k] = q_av[k];
        }
 
        // Add time to record; record to table
        record[nvals] = etTime;
        quats += record;
      }
      catch (IException &ie) {
        ostringstream mess;
        mess << "Failed to get point state for line " << i+1;
        throw IException(ie, IException::User, mess.str(), _FILEINFO_);
      }
    }
 
    // Add some necessary keywords
    quats.Label() += PvlKeyword("CkTableStartTime", toString(startTime()));
    quats.Label() += PvlKeyword("CkTableEndTime", toString(endTime()));
    quats.Label() += PvlKeyword("CkTableOriginalSize", toString(quats.Records()));
 
    // Create the time dependant frames keyword
    int virZeroId = getInteger("FRAME_" + virZero);
    PvlKeyword tdf("TimeDependentFrames", toString(virZeroId)); // DAWN_VIR_{ID}_ZERO
    tdf.addValue("-203200");  // DAWN_VIR
    tdf.addValue("-203000");  // DAWN_SPACECRAFT
    tdf.addValue("1");        // J2000
    quats.Label() += tdf;
 
    //  Create constant rotation frames
    PvlKeyword cf("ConstantFrames", toString(virZeroId));
    cf.addValue(toString(virZeroId));
    quats.Label() += cf;
 
    SpiceDouble identity[3][3];
    ident_c(identity);
 
    //  Store DAWN_VIR_{ID}_ZERO -> DAWN_VIR_{ID}_ZERO identity rotation
    PvlKeyword crot("ConstantRotation");
    for (int i = 0 ; i < 3 ; i++) {
      for (int j = 0 ; j < 3 ; j++) {
        crot.addValue(toString(identity[i][j]));
      }
    }
 
    quats.Label() += crot;
 
    return (quats);
  }
 
 
  DawnVirCamera::SMatrix DawnVirCamera::getStateRotation(const QString &frame1,
                                                         const QString &frame2,
                                                         const double &etTime)
                                                         const {
    SMatrix state(6,6);
    NaifStatus::CheckErrors();
    try {
      // Get pointing w/AVs
      sxform_c(frame1.toLatin1().data(), frame2.toLatin1().data(), etTime,
               (SpiceDouble (*)[6]) state[0]);
      NaifStatus::CheckErrors();
    }
    catch (IException &) {
      try {
        SMatrix rot(3,3);
        pxform_c(frame1.toLatin1().data(), frame2.toLatin1().data(), etTime,
                 (SpiceDouble (*)[3]) rot[0]);
        NaifStatus::CheckErrors();
        SpiceDouble av[3] = {0.0, 0.0, 0.0 };
        rav2xf_c((SpiceDouble (*)[3]) rot[0], av,
                 (SpiceDouble (*)[6]) state[0]);
      }
      catch (IException &ie2) {
        ostringstream mess;
        mess << "Could not get state rotation for Frame1 (" << frame1
             << ") to Frame2 (" <<  frame2 <<  ") at time " << etTime;
        throw IException(ie2, IException::User, mess.str(), _FILEINFO_);
      }
    }
    return (state);
  }
 
 
  bool DawnVirCamera::hasArticulationKernel(Pvl &label) const {
    Kernels kerns(label);
    QStringList cks = kerns.getKernelList("CK");
    QRegExp virCk("*dawn_vir_?????????_?.bc");
    virCk.setPatternSyntax(QRegExp::Wildcard);
    for (int i = 0 ; i < cks.size() ; i++) {
      if ( virCk.exactMatch(cks[i]) ) return (true);
    }
    return (false);
  }
 
}
 
extern "C" Isis::Camera *DawnVirCameraPlugin(Isis::Cube &cube) {
  return new Isis::DawnVirCamera(cube);
}