TwiceAsNice  2019-02-18
Macros | Functions
licsPcam2Se.cc File Reference

Convert Pcam picture to a preset of the HWS SE's. More...

#include "config.h"
#include <fstream>
#include <LicsPcamSnapshot.h>
Include dependency graph for licsPcam2Se.cc:

Macros

#define DR2D   57.2957795130823208767981548141
 180 divided by pi More...
 

Functions

void usage (char *argv0)
 emit a usage notice on stdout. More...
 
static void run (const Lics::LicsIIFSide &sdx, Laos::LaosSeAOType &ao, const std::string catfil, const double mang, const double pang, const double ra, const double dec, bool batch)
 Retrieve a Pcam picture, analyse the star locations, convert to SE coordinates and move the SE's. More...
 
int main (int argc, char *argv[])
 Retrieve a Pcam picture, analyse the star locations, convert to SE coordinates and move the SE's. More...
 

Detailed Description

Convert Pcam picture to a preset of the HWS SE's.


Macro Definition Documentation

◆ DR2D

#define DR2D   57.2957795130823208767981548141

180 divided by pi

Function Documentation

◆ main()

int main ( int  argc,
char *  argv[] 
)

Retrieve a Pcam picture, analyse the star locations, convert to SE coordinates and move the SE's.


For the short use (only with -s) the steps are:

  • get a single picture of the patrol camera on one side. Which side is configured by the command line option.
  • Run sex(1) on that image. Eliminate stars that are outside the 1 arcmin radius (because the patrol camera has a slightly larger FOV). Order the output by star brightness (priority) according to the sex(1) pseudo-magnitude. Return these as a SeqPoint with units of pixels.
  • Map this list to SE coordinates (with Kalyan's matrix, depending on side) which again is a SeqPoint
  • construct an association with SE arms (1-8) with the associated Starcat library function, and call licsSEPreset.py to move the SE arms.

For the long use (including the two trailing angles and th starcat name)

  • get a single picture of the patrol camera on one side. Which side is configured by the command line option.
  • Show it in a ds9 image, upright as in the patrol camera, with the prediced star catalog stars shown as yellow squares (not precessed to the equinox, but proper motions applied).
Parameters
argcThe count of the command line arguments.
argvThe vector of blank-separated strings onthe command line. Usage: licsPcam2Se -s {sx|dx} licsPcam2Se -s {sx|dx} -H motang/deg -p parang/deg ra/deg dec/deg starcat.cat So there is only a single, mandatory switch that selects one of the two LBT arms.
Since
2017-08-18

◆ run()

static void run ( const Lics::LicsIIFSide sdx,
Laos::LaosSeAOType ao,
const std::string  catfil,
const double  mang,
const double  pang,
const double  ra,
const double  dec,
bool  batch 
)
static

Retrieve a Pcam picture, analyse the star locations, convert to SE coordinates and move the SE's.


For the short use option (only -s used) The steps are:

  • get a single picture of the patrol camera on one side. Which side is configured by the command line option.
  • Run sex(1) on that image. Eliminate stars that are outside the 1 arcmin radius (because the patrol camera has a slightly larger FOV). Order the output by star brightness (priority) according to the sex(1) pseudo-magnitude. Return these as a SeqPoint with units of pixels.
  • Map this list to SE coordinates (with Kalyan's matrix, depending on side) which again is a SeqPoint
  • construct an association with SE arms (1-8) with the associated Starcat library function, and call licsSEPreset.py to move the SE arms.
    Parameters
    aospecifies either the Patrol Camera or the SE on the HWS as the image target.
    sdxspecifies SX or DX patrol camera and SE
    catfilthe name of a star catalog file. May be empty if this is a run to map the Pcam picture to SE .
    mangDerotator (K-mirror) nominal anlge [rad]
    pangparallactic angle [rad]
    raright ascension [deg]
    decdeclination [deg]
    batchFlag to trigger batch-type (non-GUI) service

◆ usage()

void usage ( char *  argv0)

emit a usage notice on stdout.


Parameters
argv0The string which is the first component of argv, namely the command name
Since
2017-08-18