Syntax
Document.PinPointSolve ( [RA, Dec, [XPixScale, YPixScale] )
Parameters
double RA - [optional] specifies the initial RA for the PinPoint solution, in decimal hours
double Dec - [optional] specifies the initial declination for the PinPoint solution, in decimal degrees
double XPixScale - [optional] arc-seconds per pixel, along the X-axis, for the image
double YPixScale - [optional] arc-seconds per pixel, along the Y-axis, for the image
Returns
Nothing
Remarks
Uses PinPoint (full version only) to solve the image, determining the right ascension, declination, position angle and exact scale of the image. This method begins the solution and immediately returns control to the calling program. The caller then uses the PinPointStatus property to determine whether PinPoint is still running, has solved the image, or has failed to solve the image. Once a solution is complete, the CenterRA, CenterDec, PositionAngle and ImageScale properties may be used to read the image parameters determined by PinPoint.
All parameters of this method are optional. The normal way to use the method is to supply no parameters. In this case, MaxIm DL will examine the image header to determine the starting right ascension, declination, and image scale to use. If the header lacks a right ascension and declination, or if you wish to override the values in the header, you must supply both a right ascension and declination as the starting point for the PinPoint search. Likewise, to override the header's pixel scale, provide both the XPixScale and YPixScale parameters.
All PinPoint settings not specified in the parameters of this method are acquired from the PinPoint Astrometry dialog. This includes selection of the reference catalog, brightness thresholds, and so on. For this reason, it is a good idea to use the dialog to solve an image taken with the same camera and optical configuration and a similar exposure time, before attempting to use the scripting interface.
All four parameters must either be passed to this method, or available in the FITS header, in order for the solution to proceed. If any of the four are missing then the first call to PinPointStatus will generate an exception.
PinPointSolve throws an exception if only PinPoint LE is installed.