MOP Commands and Procedures


NxN (PTcalibration.tcl)


Take an NxN pattern of images
[Ngrid]:    The size of the grid
                Default value: "5"
[filter]:   The filter in which to take the grid
                Default value: "g"
[expTime]:  The exposure time on each pointing
                Default value: "10"
[telTest]:  I don't know what this does
                Default value: "0"
-readout:   Set for separate images at each pointing
-informGUI: Inform the GUI
-help:      Print summary of command-line options and abort

OBJTYPE (PTutils.tcl)


Returns the observation type, as is standard in fits files
-help: Print summary of command-line options and abort

OBSTYPE (PTutils.tcl)


Returns the observation type, as is standard in fits files
-help: Print summary of command-line options and abort

PTCameraTemperatures (PTutils.tcl)


get the cryotiger temp for the PT camera
-setCameraData: Set the cameraData global variable
-help:          Print summary of command-line options and abort

abortSlew (PTcontrol.tcl)


abort a slew:
        cancels auto slew if in progress
        cancels slew enabled if motion not begin
        cancels automatic motions and commands

-help: Print summary of command-line options and abort

addLogLine (logGUI.tcl)


Add a line to the log GUI

<newline>: line to add
-noTemp:   do not write to the temp file
-help:     Print summary of command-line options and abort

addStripeToMOPDB (PTutils.tcl)


Add of stripe to the list of stripes which are a high priority
<stripe>:    The stripe number
<minLabbda>: The minimum lambda of the stripe to be covered
<maxLabbda>: The maximum lambda of the stripe to be covered
[mjd]:       MJD of stripe (0 for today)
                 Default value: "0"
-help:       Print summary of command-line options and abort

addTargetToList (PTtarget.tcl)


Interactively add a target to the PT target list in memory

-help: Print summary of command-line options and abort

alarmGUI (alarmGUI.tcl)


Run the MOP Alarm

[geometry]: window geometry
                Default value: "+150+150"
-help:      Print summary of command-line options and abort

alarmIfNoStarInField (alarmGUI.tcl)


start the alarm if no stars are in the field
[exposureNumber]: The exposure number of the image in which to look
                      Default value: "[getExposureNumber]"
-mjd:             The mjd
                      Default value: "[mjd4Gang]"
-help:            Print summary of command-line options and abort

alarmYell (alarmGUI.tcl)


Beep if the alarm isn't hushed
-help: Print summary of command-line options and abort

appendObservedSecondaryPatches (PTtarget.tcl)


Add the list of observed secondary patches to a list, intended for adding to the invisible targets list.
<inList>:                  The list on which to append the good field names
[observedPatchesFileName]: The par file with the observed secondary patches
                               Default value: "~/ptlog/observedSecondaryPatches.par"
-help:                     Print summary of command-line options and abort

autoFocus (PTcalibration.tcl)


focus the PT automatically. This will fail if the current focus position is very far off
-maximumRepeats: The maximum number of focus frames to take
                     Default value: "6"
-informGUI:      inform the GUI when finished
-verbose:        Print additional information
-help:           Print summary of command-line options and abort

autoPoint (PTcalibration.tcl)


find an FK5 star in an image and center on it (UNTESTED)
[exposureNumber]:        The exposure number of the focus image (0 for one just taken)
                             Default value: "0"
[targetName]:            The name of the star to center on (default for last exposure)
                             Default value: "default"
-peakLevel:              the level of peaks to find (in sky sigma)
                             Default value: "1000"
-maximumCentralDistance: minimum distance from center to consider in focus
                             Default value: "512"
-minimumCounts:          The minimum count level for a useful star
                             Default value: "4000"
-minimumSigma:           The minimum psf sigma for a useful star
                             Default value: "0.8"
-force:                  Fix the pointing on the image even if the target is not of an FK5 star
-verbose:                Print additional information
-help:                   Print summary of command-line options and abort

autoTwilight (PTtwilight.tcl)


take a set of automated twilights in a signlge filter
[filter]:          The name of the filter in which to take twilights
                       Default value: "u"
[neededExposures]: The number of exposures needed
                       Default value: "5"
[initialTime]:     The initial exposure time (0 for default)
                       Default value: "0"
[maximumAttempts]: The maximum attempts
                       Default value: "60"
-fake:             fake the autotwilight
-skipSlew:         do not slew to the twilight target
-mjd:              starting MJD of the fake
                       Default value: "51823.02"
-informGUI:        inform the GUI when finished
-help:             Print summary of command-line options and abort

biasSection (PTutils.tcl)


return the bias section of an image for a given amplifier and program. Note that the sections are returned in a format traditional to IRAF (beginning with 1, not 0)
[program]:   The program name
                 Default value: "pt_stare"
[amplifier]: The amplifier
                 Default value: "1"
-mjd:        The MJD of the observation (-1=today)
                 Default value: "0"
-help:       Print summary of command-line options and abort

binDisplay (PTutils.tcl)


Set the display binning, useful for getting the entire image on the screen.
[binning]: The desired binning
               Default value: "2"
-help:     Print summary of command-line options and abort

cameraGUI (cameraGUI.tcl)


Run the GUI controls for the camera and filter wheel box

[geometry]: window geometry
                Default value: "+100+100"
-help:      Print summary of command-line options and abort

canTakeTwilight (PTtarget.tcl)


Returns true if the model indicates a twilight flat is possible
[filter]: The filter to consider
              Default value: ""
-help:    Print summary of command-line options and abort

centerRowForWCS (PTutils.tcl)


return the center row of the data section of the image for a given program
[program]: The program name
               Default value: "pt_stare"
-mjd:      The MJD of the observation (-1=today)
               Default value: "0"
-help:     Print summary of command-line options and abort

centerThis (PTcontrol.tcl)


Point the telescope at the object currently at the provided x, y coordinates
[x]:       x position on image
               Default value: "1064"
[y]:       y position on image
               Default value: "1045"
[xcenter]: x position of center
               Default value: "1064"
[ycenter]: y position of center
               Default value: "1045"
-help:     Print summary of command-line options and abort

checkFocus (PTutils.tcl)


Examine an image to see if there is a star in the field
[exposureNumber]:         The exposure number of the image in which to look
                              Default value: "[getExposureNumber]"
-mjd:                     The mjd
                              Default value: "[mjd4Gang]"
-peakLevel:               the level of peaks to find (in sky sigma)
                              Default value: "100"
-subregionSize:           the size of the central subregion in which to look
                              Default value: "512"
-minimumCounts:           The minimum count level for a useful star
                              Default value: "500"
-minimumSigma:            The minimum psf sigma for a true star
                              Default value: "0.7"
-minimumInFocusAxisRatio: Minimum axis ratio for an in focus star
                              Default value: "0.8"
-maximumInFocusAxisRatio: Maximum axis ratio for an in focus star
                              Default value: "1.3"
-okayAxisRatio:           Maximum axis ratio for good star
                              Default value: "1.8"
-maximumStarsToMeasure:   The maximum number of stars to measure to get an axis ratio
                              Default value: "11"
-verbose:                 Print additional information
                              Default value: "1"
-help:                    Print summary of command-line options and abort

checkForStarInField (PTutils.tcl)


Examine an image to see if there is a star in the field
[exposureNumber]:       The exposure number of the image in which to look
                            Default value: "[getExposureNumber]"
-mjd:                   The mjd
                            Default value: "[mjd4Gang]"
-peakLevel:             the level of peaks to find (in sky sigma)
                            Default value: "100"
-subregionSize:         the size of the central subregion in which to look
                            Default value: "512"
-minimumCounts:         The minimum count level for a useful star
                            Default value: "500"
-minimumSigma:          The minimum psf sigma for a true star
                            Default value: "0.7"
-okayAxisRatio:         Maximum axis ratio for good star
                            Default value: "1.3"
-maximumStarsToMeasure: The maximum number of stars to measure to get an axis ratio
                            Default value: "11"
-verbose:               Print additional information
                            Default value: "0"
-help:                  Print summary of command-line options and abort

checkMdReport (PTutils.tcl)


Check the mdReport file to ensure that all fits files have mdReport entries, and vice versa
-help: Print summary of command-line options and abort

checkPhotometry (PTcalibration.tcl)


create a photometry checking frame
[number]:  the number of exposures on the frame
               Default value: "5"
[expTime]: exposure time for each exposure
               Default value: "10"
-help:     Print summary of command-line options and abort

checkTargetGUIparms (targetGUI.tcl)


Check the targetGUIparms global variable to make sure user modified variables have legal values UNTESTED

[paramCheckList]: List of elements to check.
                      Default value: "minAirmass maxAirmass minEta maxEta minLambda maxLambda numberOfDomes numberOfBias"
-help:            Print summary of command-line options and abort

cleanCCD (PTinitialization.tcl)


clear the CCD. This is accomplished in the following steps:
1. read the CCD forward preCleanLines lines, unbinned. The purporse 
   of this read is to remove charge in saturated pixels from the chip. 
   This only seems to be necessary if the chip has been saturated. 
2. erase the chip my manipulating the voltages on the CCD.
3. read the chip backwards, binned. This removes charge from the charge trap, 
   and significantly improves its column.
4. read the chip forward, optionally binned. 

-preCleanLines:   the lines to read forward before 
                  backward read. Should be set to 3072 or highter if the 
                  chip is saturated, 0 otherwise.
                      Default value: "0"
-backwardBinning: the binning for the readout
                      Default value: "16"
-backwardLines:   the number of lines to read backward
                      Default value: "2048"
-forwardBinning:  the binning for the readout. If this is set 
                  to greater than 1, hot pixels will be dribbled across the 
                  chip in the following exposure
                      Default value: "1"
-forwardLines:    the number of lines to read forward. Should 
                  be at least as large as backwardLines to 
                  get all the charge off the chip
                      Default value: "3072"
-time:            time this command
-noErase:         do not erase the chip using manipulation of the CCD voltages
-help:            Print summary of command-line options and abort

clearLog (logGUI.tcl)


Clear the GUI log

-help: Print summary of command-line options and abort

closeDome (PTcontrol.tcl)


close dome

-help: Print summary of command-line options and abort

completionMJD (PTtarget.tcl)


Procedure to calculate the MJD at the end of an exposure sequence
<targetList>: A list of targets in the exposure sequence
-mjd:         Modified julian date for the beginning of the sequence (now if 0.0)
                  Default value: "0.0"
-last:        The last element of the list to be included
               in the sequence (all if <0)
                  Default value: "-1"
-help:        Print summary of command-line options and abort

copyAstrologsToAstrologDirectory (PTutils.tcl)


copy the astrologs in /data/mt/MJD's to the /data/mt/astrolog directory
-verbose: Write lots of info to the screen
-help:    Print summary of command-line options and abort

copyParFiles (PTutils.tcl)


copy the .par files into the /data/mt/MJD directory
[mjd]: The mjd to copy to (0- most recent data directory)
           Default value: "0"
-help: Print summary of command-line options and abort

createLogLine (PTobserving.tcl)


Prepare a line for the logfile
<exposureTime>: The exposure time to be placed in the log
<filter>:       The filter to be placed in the log
-verbose:       Be verbose
-help:          Print summary of command-line options and abort

dataSection (PTutils.tcl)


return the bias section of an image for a given amplifier and program. Note that the sections are returned in a format traditional to IRAF (beginning with 1, not 0)
[program]:   The program name
                 Default value: "pt_stare"
[amplifier]: The amplifier
                 Default value: "1"
-mjd:        The MJD of the observation (-1=today)
                 Default value: "0"
-help:       Print summary of command-line options and abort

deleteSequenceFromMOPDB (PTutils.tcl)


Remove a secondary sequence from MOPDB
<sequence>: The number of the sequence to delete
-help:      Print summary of command-line options and abort

dfmCoords (baseDFMcode.tcl)


query the DFM computer for its coordinates

-print:     print some of the coordinates
-informGUI: inform the GUI
-help:      Print summary of command-line options and abort

dfmSlew (baseDFMcode.tcl)


Begin a slew
-wait: wait for the telescope or dome to arrive before returning
-help: Print summary of command-line options and abort

dfmStat (baseDFMcode.tcl)


query the DFM computer for its status

-print:     print some of the status
-informGUI: inform the GUI
-help:      Print summary of command-line options and abort

dfmTrackOn (baseDFMcode.tcl)


Turn on the telescope tracking
[raRate]:     The RA tracking rate
                  Default value: "15.0"
[decRate]:    The RA tracking rate
                  Default value: "0.0"
[auxRaRate]:  The RA tracking rate
                  Default value: "0.0"
[auxDecRate]: The RA tracking rate
                  Default value: "0.0"
-quiet:       Do not report an error if command fails
-help:        Print summary of command-line options and abort

dismissAlarmGUI (alarmGUI.tcl)


Nicely destroy the alarm window
-help: Print summary of command-line options and abort

dispEpoch (PTcontrol.tcl)


Set the display epoch of the telescope.

<equinox>: The desired display epoch
-help:     Print summary of command-line options and abort

distanceFromMoon (PTutils.tcl)


determine the distance from a target or set of coordinates to the moon
[timeStamp]:   time for determination
                   Default value: "now"
[RA]:          The RA to consider (in decimal degrees or H:M:S)
                   Default value: "0"
[dec]:         The Declination to consider (in decimal degrees or D:M:S)
                   Default value: "0"
-targetName:   The target fow which to find the distance
                   Default value: "none"
-deleteTstamp: delete the tstamp when done with it
-verbose:      print extra information
-help:         Print summary of command-line options and abort

doBias (PTcalibration.tcl)


Take a set of bias images
[number]:   the number of bias frames to take
                Default value: "1"
-informGUI: inform the GUI when finished
-help:      Print summary of command-line options and abort

doDome (PTcalibration.tcl)


Take a set of dome flats
[number]:   the number of dome flats to take
                Default value: "1"
-informGUI: inform the GUI when finished
-nolamp:    do not turn on and off the lamp
-help:      Print summary of command-line options and abort

doFocus (PTcalibration.tcl)


create a focus frame
[startValue]: the initial focus value
                  Default value: "1710.0"
[expTime]:    the exposure time for the focus frame
                  Default value: "10"
-filter:      the filter to focus in
                  Default value: "r"
-examine:     examine the resulting frame are return the best focus value
-verbose:     Print additional information
-informGUI:   inform the GUI when finished
-help:        Print summary of command-line options and abort

doOffset (PTcontrol.tcl)


Offset the pointing of the telescope.

<rasec>:  RA offset in arcseconds
<decsec>: Dec. offset in arcseconds
-help:    Print summary of command-line options and abort

doTargetList (PTobserving.tcl)


Take data on a list of targets.
 The list may be aborted by creating the file "stopnow" 
 in the current directory.
<listOfTargets>: The list of targets to observe
-help:           Print summary of command-line options and abort

doTwilight (PTcalibration.tcl)


Take a twilight flat
[filter]:       the filter in which to take the flat
                    Default value: "g"
[exposureTime]: the exposure time of the flat
                    Default value: "2.0"
-skipOffset:    skip offset at end of exposure?
-informGUI:     inform the GUI when finished
-fake:          only pretend to take a twilight, and use a model to update variables
-model:         the model to use for the fake
                    Default value: "default"
-mjd:           the mjd of observation, for the fake
                    Default value: "0"
-help:          Print summary of command-line options and abort

estimateTwilightCounts (PTtwilight.tcl)


extimate the counts obtained in a twilight observation
[filter]:       the filter for the observation
                    Default value: "1"
[startTime]:    the starting time of the observation
                    Default value: "1.0"
[exposureTime]: the exposure time of the observation
                    Default value: "1.0"
[filterModel]:  the model for the twilight
                    Default value: ""
-help:          Print summary of command-line options and abort

estimateTwilightExposureTime (PTtwilight.tcl)


extimate the required exposure time for a twilight observation
[startTime]:   startTime of the observation
                   Default value: "0.0"
[filter]:      the filter for the observation
                   Default value: "u"
[targetLevel]: the target level for the observation
                   Default value: "25000"
[filterModel]: the model for the twilight
                   Default value: ""
-help:         Print summary of command-line options and abort

fakeDoDome (PTcalibration.tcl)


Take a set of dome flats
[number]:   the number of dome flats to take
                Default value: "1"
-informGUI: inform the GUI when finished
-nolamp:    do not turn on and off the lamp
-help:      Print summary of command-line options and abort

fakePickedNight (PTutils.tcl)


fake a night using the autopicker
<mjd>:                    the mjd of the start of observations
[numberOfTargets]:        The number of targets to fake observations of
                              Default value: "40"
[listLength]:             The number of stars in the list
                              Default value: "6"
-invisibleTargetFileName: The file from which invisible targets are to be loaded
                              Default value: "/home/observer/ptlog/invisibleTargets.dat"
-outFileName:             What file to write to
                              Default value: "none"
-verbose:                 print extra information
-help:                    Print summary of command-line options and abort

fflamp (PTcontrol.tcl)


Turn on or off the flat field lamp.

<onoff>: The desired state of the fflamp (on or off)
-help:   Print summary of command-line options and abort

findFocus (PTcalibration.tcl)


find the PT focus
<exposureNumber>:        The exposure number of the focus image
-peakLevel:              the level of peaks to find (in sky sigma)
                             Default value: "25"
-maximumCentralDistance: maximum distance from center to consider in focus
                             Default value: "512"
-saturationCounts:       The count level which saturates the chip
                             Default value: "40000"
-minimumCounts:          The minimum count level for a useful star
                             Default value: "400"
-minimumSigma:           The minimum psf sigma for a useful star
                             Default value: "0.6"
-tolerance:              Minimum difference from exected position for star 
                                         in sequence
                             Default value: "2"
-countMatch:             Allowed difference in count levels
                             Default value: "0.50"
-verbose:                Print additional information
-help:                   Print summary of command-line options and abort

findPointing (PTcalibration.tcl)


find the coordinates of the star in a pointing image (UNTESTED)
<exposureNumber>:        The exposure number of the focus image
-peakLevel:              the level of peaks to find (in sky sigma)
                             Default value: "1000"
-maximumCentralDistance: maximum distance from center to consider
                             Default value: "512"
-minimumCounts:          The minimum count level for a useful star
                             Default value: "4000"
-minimumSigma:           The minimum psf sigma for a true star
                             Default value: "0.8"
-verbose:                Print additional information
-help:                   Print summary of command-line options and abort

findTwilightPosition (PTtwilight.tcl)


determine the RA and Dec of the optimal position for twilight flats
-verbose: print extra information
-rise:    position for sunrise (default from clock)
-set:     position for sunset (default from clock)
-help:    Print summary of command-line options and abort

fixPointingFromGUI (targetGUI.tcl)


Load the PT standard targets from the MTSTDS_DIR directory
-help: Print summary of command-line options and abort

fixToDecimal (PTutils.tcl)


remove leading zero from numeric string, to ensure tcl interprets it as decimal. Sign is preserved, even in the case of -0
<number>: the string to fix
-help:    Print summary of command-line options and abort

focusPT (PTcontrol.tcl)


Set the focus on the PT. To ensure that the focus mechanism moves in from 
the same direction each time, focusPT first sends the focus 10 units past 
the designated position, and then moves it to its final destination.

MOP must have a TCS connection to change the PT focus.

<newFocus>: The focus position desired, in encoder units
-help:      Print summary of command-line options and abort

fwbSetFilterSlot (baseFWBcode.tcl)


Send to filter wheel to a given position
[filter]: The slot number to which to send the filter
              Default value: "0"
-verbose: Provide extra information
-long:    wait the maximum amount of time for the filter
-wait:    wait for the fwb to finish moving
-help:    Print summary of command-line options and abort

fwbStartExposure (baseFWBcode.tcl)


Begin an exposure
-help: Print summary of command-line options and abort

gainFromPar (PTutils.tcl)


read the gain from the opECalib.par file
[amplifier]: The amplifier
                 Default value: "1"
-program:    The program name
                 Default value: "pt_stare"
-mjd:        The MJD of the observation (-1=today)
                 Default value: "0"
-help:       Print summary of command-line options and abort

getExposureMean (PTutils.tcl)


Get the mean of the center of an image.
-exposureNumber:  The exposure number (0 for most recent)
                      Default value: "0"
-mjd:             The MJD of the observation (0 for tonight)
                      Default value: "0"
-subImageHeight:  The height of the subimage to average
                      Default value: "128"
-subImageWidth:   The width of the subimage to average
                      Default value: "128"
-ccdCenterHeight: The y coordinate of the center of the ccd
                      Default value: "1045"
-ccdCenterWidth:  The x coordinate of the center of the ccd
                      Default value: "1045"
-help:            Print summary of command-line options and abort

getLST (PTutils.tcl)


get the local siderial time from the telescope.

-help: Print summary of command-line options and abort

getListMaximum (PTutils.tcl)


find the maximum in a list (this is much faster than listMax)
<inputList>: The list to find the maximum of
-verbose:    Write lots of info to the screen
-help:       Print summary of command-line options and abort

getMJDOnDiskList (PTutils.tcl)


get a list of MJD's on disk
-verbose: Write lots of info to the screen
-help:    Print summary of command-line options and abort

getMopHelp (PTutils.tcl)


Build an html file from help strings
[fileName]: the file name
                Default value: "mopHelp.html"
-help:      Print summary of command-line options and abort

getObservedAirmassesFromReport (PTtarget.tcl)


Use the mdReport file to restore the list of observed targets,
 such as after exiting mop.
[MJD]:      MJD to load from report (0 for today)
                Default value: "0"
-informGUI: update GUI records as well
-help:      Print summary of command-line options and abort

halfSecExposure (PTcontrol.tcl)


Take a half second exposure.

-help: Print summary of command-line options and abort

initializeCCD (PTinitialization.tcl)


Initialize the CCD.
-cleanCCD:        clean the CCD (see online help for cleanCCD)
-preCleanLines:   the lines to read forward before backward read
                      Default value: "4096"
-backwardBinning: the binning for the readout
                      Default value: "16"
-backwardLines:   the number of lines to read backward
                      Default value: "2048"
-forwardBinning:  the binning for the readout
                      Default value: "16"
-forwardLines:    the number of lines to read forward
                      Default value: "2048"
-time:            time the exposure
-informGUI:       send the GUI log the log lines
-help:            Print summary of command-line options and abort

initializeTelescope (PTinitialization.tcl)



initialize the telescope (TCS):
        set time and date on TCS based on site time
        turn on tracking (only works when the switch in the dome
                          is properly set for tracking)
        check the coordinates

-help: Print summary of command-line options and abort

isMorning (PTtwilight.tcl)


determine whether a given stamp is in the morning
[timeStamp]:          time for determination
                          Default value: "now"
[timeZoneDifference]: The number of hours difference between the local time zone and GMT
                          Default value: "-7"
-deleteTstamp:        delete the tstamp when done with it
-verbose:             print extra information
-help:                Print summary of command-line options and abort

legalDMS (PTutils.tcl)


Returns true if value is a legal value
[value]: The test value
             Default value: ""
-help:   Print summary of command-line options and abort

legalDeclinationDecimalDegrees (PTutils.tcl)


Returns true if value is a legal value
[value]: The test value
             Default value: "0"
-help:   Print summary of command-line options and abort

legalDouble (PTutils.tcl)


Returns true if value is a legal value
[value]: The test value
             Default value: ""
-help:   Print summary of command-line options and abort

legalHMS (PTutils.tcl)


Returns true if value is a legal value
[value]: The test value
             Default value: ""
-help:   Print summary of command-line options and abort

legalInt (PTutils.tcl)


Returns true if value is a legal value
[value]: The test value
             Default value: ""
-help:   Print summary of command-line options and abort

legalRADecimalDegrees (PTutils.tcl)


Returns true if value is a legal value
[value]: The test value
             Default value: "0"
-help:   Print summary of command-line options and abort

legalRADecimalHours (PTutils.tcl)


Returns true if value is a legal value
[value]: The test value
             Default value: "0"
-help:   Print summary of command-line options and abort

listProcsInFile (PTutils.tcl)


Return a tcl list of the procs in a file
<fileName>: the source file name
-help:      Print summary of command-line options and abort

listTargets (PTtarget.tcl)


Procedure to provide a formated list of target parameters.
The argument is the list of target names desired. If all
targets are desired, the global variable $targetList can be used
as the argument
The output is formatted as follows:
       Column      Information
       1           time for which airmass and hour angle are correct
       2           object name
       3           current (or projected) airmass
       4           Hour angle (in hours:minues)
       5           object right ascention
       6           object Declintation, in degrees
       7           magnitude of brightest target in field
       8           number of standards in field
       9           the color of the reddest standard 
       10          the color of the bluest standard
       11          the "flavor" of the target

<targetList>:    A list of targets for which information is needed
-projectAirmass: project future values of airmass?
-quiet:          do not print the list, but return is as a list
-moon:           include the distance to the moon
-mjd:            Modified julian date for hour angle and airmass (now if 0.0)
                     Default value: "0.0"
-help:           Print summary of command-line options and abort

listTargetsWithAirmass (PTtarget.tcl)


Return a table of objects in the desired range of airmass,
  with the desired flavors
<minAirmass>:    The minimum desired airmass
<maxAirmass>:    The maximum desired airmass
[wantedFlavors]: The desired target flavors (enclosed in curly braces)
                     Default value: ""
-help:           Print summary of command-line options and abort

loadCoords (PTcontrol.tcl)


load coordinates into the DFM computer.

<ra>:        Right Ascention (or Hour Angle, if -ha set)
<dec>:       Declination
[epoch]:     epoch
                 Default value: "2000.0"
-decdegrees: Provied coordinates in decimal degrees
-ha:         Hour angle is provided, rather than RA
-help:       Print summary of command-line options and abort

loadImage (PTutils.tcl)


load an image into a region, bringing it from the pool if necessary
[exposureNumber]:   The exposure number (0=most recent)
                        Default value: "0"
[region]:           The region in which to load the image. create creates a new image.
                        Default value: "create"
-mjd:               the MJD, (0=now)
                        Default value: "0"
-wait:              the maximum time to wait for the file to be written, if necessary
                        Default value: "10"
-completeImageSize: the file size of a completed image
                        Default value: "8815680"
-debias:            do a quick and dirty debias and gain correction
-help:              Print summary of command-line options and abort

loadLog (logGUI.tcl)


Load the GUI log from a file

[filename]: the file to save it to
                Default value: "default"
-help:      Print summary of command-line options and abort

loadSecondaryFromMOPDB (PTtarget.tcl)


Load secondary information from the database
<STRING>: The name of the patch
-help:    Print summary of command-line options and abort

loadSecondaryPriorities (PTtarget.tcl)


load priorities from mopdb, and set the new targets based on the database if they are not already loaded
-help: Print summary of command-line options and abort

loadStandards (PTtarget.tcl)


Load the PT standard targets from the MTSTDS_DIR directory
-replace:   remove targets currently in memory
-readMOPDB: read priorities from MOPDB
-help:      Print summary of command-line options and abort

loadTargets (PTtarget.tcl)


Load PT targets from a target list (see also loadStandards)
[filename]: the name of the file from which to load the data
                Default value: "~/ptlog/targetList.txt"
-replace:   remove targets currently in memory
-help:      Print summary of command-line options and abort

logGUI (logGUI.tcl)


Run the MOP log GUI

[geometry]: window geometry
                Default value: "+150+150"
-help:      Print summary of command-line options and abort

makeDecimalDegrees (PTutils.tcl)


Convert a string to decimal degrees. If the argument is already an integer or floating point, assume it is already in decimal degrees, otherwise assume it is in Deg:Min:Sec or Hour:Min:Sec (if -hour set) form
<angle>:       The angle to consider
-hours:        If set, convert from H:M:S rather than D:M:S if conversion is necessary. IF angle IS A FLOAT OR INTEGER, IT IS STILL ASSUMED TO BE A DECIMAL DEGREE
-deleteTstamp: delete the tstamp when done with it
-verbose:      print extra information
-help:         Print summary of command-line options and abort

mergeLogAndReport (PTutils.tcl)


copy an mdReport files, using quility indocators in the manual logfile to set the quality in the new report file.
[mjd]:              mjd of the night in question (0=now)
                        Default value: "0"
[inputReportFile]:  The input report file
                        Default value: "/astrolog/${mjd}/mdReport-${mjd}.par"
[outputReportFile]: The output report file
                        Default value: "/data/mt/${mjd}/mdReport-${mjd}.par"
[manualLogfile]:    The output report file, defaults to /data/mt/mjd/manualLogfile.txt
                        Default value: "/data/mt/${mjd}/manualLogfile.txt"
-help:              Print summary of command-line options and abort

modelTwilight (PTtwilight.tcl)


Get model of twilight from a set of observations
-endTimeList:        A list of ending times of exposures
                         Default value: ""
-exposureTimeList:   A list of corresponding exposure times
                         Default value: ""
-filterList:         A list of corresponding filters
                         Default value: ""
-levelList:          A list of count levels
                         Default value: ""
-dataFileName:       File to load the data from
                         Default value: ""
-filtersToModel:     The filters to model
                         Default value: "u g"
-reverseFilterOrder: The reverse order in which filters are taken
                         Default value: "u g"
-filterZeroPoints:   The zero points of the SDSS filters
                         Default value: "-18.7 -20.5"
-skyColors:          The sky colors (SDSS system), m(filter)-m(0)
                         Default value: "0.0 -5.0"
-help:               Print summary of command-line options and abort

multiFakePickedNight (PTutils.tcl)


fake a night using the autopicker
[mjd]:                    a list of mjd's of the starts of observations
                              Default value: "51549.057 51579.061 51608.097 51637.109 51667.134 51696.134 51726.134 51755.134 51784.109 51813.097 51843.061 51872.05"
[numberOfTargets]:        The number of targets to fake observations of
                              Default value: "60"
[listLength]:             The number of stars in the list
                              Default value: "6"
-invisibleTargetFileName: The file from which invisible targets are to be loaded
                              Default value: "/home/observer/ptlog/invisibleTargets.dat"
-outFileName:             A list of files to write to
                              Default value: "jan feb mar apr may jun jul aug sep oct nov dec"
-verbose:                 print extra information
-help:                    Print summary of command-line options and abort

nextObject (PTobserving.tcl)


Tell the telescope where to point next
<rahr>:    R. A. hours
<ramin>:   R. A. minutes
<rasec>:   R. A. seconds
<decdeg>:  Dec. degrees
<decmin>:  Dec. minutes
<decsec>:  Dec. seconds
[equinox]: Equinox
               Default value: "2000.0"
-help:     Print summary of command-line options and abort

nextTarget (PTtarget.tcl)


Set up to observe the next target, and possibly do it
<objectName>:               the object to observe
-interactive:               prompt to slew and take the sequence?
-doit:                      observe without prompting
-adjustFocus:               If the doit flag is set, automatically adjust focus when doing it
-fakeit:                    spend some time not observing
-informGUI:                 inform the GUI when finished
-automaticSubarray:         automatically change the subarray size (UNTESTED)
-priCenteringRandomization: size of randomization box (in arc minutes) (UNTESTED)
                                Default value: "0.0"
-help:                      Print summary of command-line options and abort

offsetDisplay (PTutils.tcl)


Set the display offset.
[offset]: The desired offset
              Default value: "0"
-help:    Print summary of command-line options and abort

openDome (PTcontrol.tcl)


open dome

-help: Print summary of command-line options and abort

parkTelescope (PTinitialization.tcl)


park the telescope:
        unslave the dome
        disable tracking
        slew to zenith

-help: Print summary of command-line options and abort

pickTarget (PTtarget.tcl)


Evaluate a list of targets, and return the best field to add to observing list
-mjd:                      MJD for which to pick target
                               Default value: "0.0"
-availableList:            Targets from which to pick
                               Default value: ""
-plannedFields:            List with field names already planned for observation
                               Default value: ""
-colorDiff:                minimum color difference for r/b pair
                               Default value: "0.6"
-highAirmass:              minimum airmass to be high airmass end red/blue pair
                               Default value: "1.7"
-maximumPrimaryAirmass:    maximum airmass to observe a primary patch
                               Default value: "2.1"
-maximumSecondaryAirmass:  maximum airmass to observe a secondary patch
                               Default value: "1.6"
-lowAirmass:               maximum airmass to be low airmass end red/blue pair
                               Default value: "1.2"
-minAirmassDifference:     minimum difference in airmass to be a completed pair
                               Default value: "0.5"
-timeBlockLength:          Maximum length of independently reducable set of observations (currently unused)
                               Default value: "2:0:0.0"
-totalPriInBlock:          Minimum total number of primaries in block
                               Default value: "6"
-redPriInBlock:            Minumum red primaries in block
                               Default value: "1"
-bluePriInBlock:           Minimum blue primaries in block
                               Default value: "1"
-colorRedPri:              Color of bluest primary to consider red
                               Default value: "1.0"
-colorBluePri:             Color of reddest primary to consider blue
                               Default value: "0.2"
-rbPairsInBlock:           Number of red/blue pair observations per block
                               Default value: "1"
-redPoints:                Point value of (needed) red primary
                               Default value: "100"
-bluePoints:               Point value of (needed) blue primary
                               Default value: "100"
-priPoints:                Point value of (needed) primary
                               Default value: "100"
-extraPriPoints:           Point value of additional (unneeded) primaries in field
                               Default value: "5"
-secPoints:                Point value of secondary field
                               Default value: "30"
-transitBonusPoints:       Point value bonus for transiting field
                               Default value: "0"
-highAirmassPenaltyPoints: Point value penalty for high airmass field
                               Default value: "-35"
-duplicationPenaltyPoints: Point value penalty for duplicating a field in a block
                               Default value: "-5000"
-nighltyDupPenaltyPoints:  Point value penalty for duplicating a field in a night
                               Default value: "-400"
-rbPoints:                 Point value of (needed) rb pair
                               Default value: "100"
-rbCompletePoints:         Point value for last chance completion of any rb pair
                               Default value: "5000"
-nearMoonPenaltyPoints:    Point value penalty for being too near the moon
                               Default value: "-1000"
-timeTolerance:            a time tolerance value
                               Default value: "0:30:0.0"
-longestExposureTime:      the time to do the longest target
                               Default value: "0:17:0.0"
-maximumContribution:      the maximum number of primarys a single primary field may contribute to the required number per plock
                               Default value: "4"
-airmassRangePoints:       Points assesed for attaining a range of airmasses
                               Default value: "400"
-minHA:                    minimum observable hour angle (h:m:s)
                               Default value: "-4:15:0.0"
-maxHA:                    maximum observable hour angle (h:m:s)
                               Default value: "4:15:0.0"
-minDec:                   minimum observable declination (d:m:s)
                               Default value: "-20:0:0.0"
-maxDec:                   maximum observable declination (d:m:s)
                               Default value: "90:0:0.0"
-minMoonDistance:          minimum distance from moon to be considered near moon (degrees)
                               Default value: "25.0"
-randomPoints:             randomize the choice of identically scored fields (1 for not randomization)
                               Default value: "5"
-debug:                    print debugging info
-help:                     Print summary of command-line options and abort

pointToDomeScreen (PTcalibration.tcl)


Slew the telescope to point at the dome screen
[ha]:  The Hour Angle of the dome screen
           Default value: "3:42:00.00"
[dec]: The declination of the dome screen
           Default value: "13:04:25.00"
-help: Print summary of command-line options and abort

pointToTwilight (PTcalibration.tcl)


Slew the telescope to point at the appropriate twilight position
-help: Print summary of command-line options and abort

ptConnect (PTinitialization.tcl)



Open connection to the telescope (TCS) and filter wheel box.

-help: Print summary of command-line options and abort

ptDisconnect (PTinitialization.tcl)


Close connection to the telescope (TCS) and filter wheel box..

-help: Print summary of command-line options and abort

querryDFMcomputer (baseDFMcode.tcl)


query the DFM computer for its coordinates

-help: Print summary of command-line options and abort

quickDisplay (PTutils.tcl)


display an image with an SAO display
[exposureNumber]:   The exposure number (0=most recent)
                        Default value: "0"
[region]:           The region in which to load the image. create creates a new image.
                        Default value: "create"
-mjd:               the MJD, (0=now)
                        Default value: "0"
-delete:            delete the region after displaying it
-wait:              the maximum time to wait for the file to be written, if necessary
                        Default value: "10"
-completeImageSize: the file size of a completed image
                        Default value: "8815680"
-debias:            do a quick and dirty debias
-help:              Print summary of command-line options and abort

readNoiseFromPar (PTutils.tcl)


read the readNoise from the opECalib.par file
[amplifier]: The amplifier
                 Default value: "1"
-program:    The program name
                 Default value: "pt_stare"
-mjd:        The MJD of the observation (-1=today)
                 Default value: "0"
-help:       Print summary of command-line options and abort

reviseExposures (PTobserving.tcl)


Revise the filters and exposure times. Note that it does not change the target 
values, only the values used next for takeSequence.
<filters>:  the list of filters
<expTimes>: the corresponding exposure times
-help:      Print summary of command-line options and abort

saturationFromPar (PTutils.tcl)


read the saturation from the opECalib.par file
[amplifier]: The amplifier
                 Default value: "1"
-program:    The program name
                 Default value: "pt_stare"
-mjd:        The MJD of the observation (-1=today)
                 Default value: "0"
-help:       Print summary of command-line options and abort

saveLog (logGUI.tcl)


Save the GUI log to a file

[filename]: the file to save it to
                Default value: "default"
-append:    append log to the end of the file
-backup:    make a backup
-help:      Print summary of command-line options and abort

saveTargets (PTtarget.tcl)


Save the target list in a file
[filename]: the name of the file to which to save the data
                Default value: "~/ptlog/targetList.txt"
[flavors]:  the flavors to save
                Default value: "FK5 Pri Fund Sec Man"
-help:      Print summary of command-line options and abort

saveTargetsToXephem (PTutils.tcl)


Save the target list in a file
[filename]:      the name of the file to which to save the data
                     Default value: "~/ptlog/targetList.edb"
[invisibleFile]: file with list of targets to exclude
                     Default value: "~/ptlog/invisibleTargets.dat"
[flavors]:       the flavors to save
                     Default value: "FK5 Pri Fund Sec Man"
-help:           Print summary of command-line options and abort

selectFilter (PTcontrol.tcl)


Command the filter wheel box to move to a specified filter
[filterName]: The filter to which to move (of u, g, r, i, and z)
                  Default value: "u"
-help:        Print summary of command-line options and abort

setAutoFocus (PTutils.tcl)


Turn on or off the autofocus (if no switches are used, autofocus is turned on)
-on:   Turn on the autofocus
-off:  Turn off the autofocus
-help: Print summary of command-line options and abort

setDFMDataFromReply (baseDFMcode.tcl)


query the DFM computer for its coordinates

<reply>: the string returned by the DFM computer
-help:   Print summary of command-line options and abort

setSectionSize (PTcontrol.tcl)


Set the number of data rows (in the center) to read from the PT camera

[sectionSize]: number of data lines desired (2048, 1024, 512, 256, 128, or 64)
                   Default value: "2048"
-informGUI:    ensure agreement with GUI
-help:         Print summary of command-line options and abort

setTarget (PTcontrol.tcl)


Set targetData interactively

-help: Print summary of command-line options and abort

setTimeAndDate (baseDFMcode.tcl)


set the time on the DFM computer

-help: Print summary of command-line options and abort

shutdownGUI (mopGUI.tcl)


shut down the GUI, trying to nicely clean up semaphores
-help: Print summary of command-line options and abort

slaveDome (PTcontrol.tcl)


turn on dome tracking

-help: Print summary of command-line options and abort

snap (PTcontrol.tcl)


Open the camera shutter for a specified length of time.

<exposureTime>: The desired exposure time
-help:          Print summary of command-line options and abort

startTimer (targetGUI.tcl)


Schedule the timer for updates
-help: Print summary of command-line options and abort

startupGUI (mopGUI.tcl)


Run the mop GUI in a slave process.
It has the unintuitive result of loading the standards, as in
loadStandards, turning off the flat field lamp, and setting the
seciton size to 2048.
-help: Print summary of command-line options and abort

stopTimer (targetGUI.tcl)


Stop updating the timer
-help: Print summary of command-line options and abort

suggestTwilightExposureTime (PTtarget.tcl)


Suggest a twilight exposure time based on the model
[filter]:   The filter to consider
                Default value: ""
[now]:      The MJD right now
                Default value: "[MJDNow]"
-informGUI: inform the GUI
-help:      Print summary of command-line options and abort

suggestTwilightFilter (PTtarget.tcl)


Suggest a filter for a twilight flat
-informGUI: inform the GUI
-help:      Print summary of command-line options and abort

takeSequence (PTobserving.tcl)


take a sequence of images 
        Use info in targetData to set filters and exposure in filters.

-checkForStars:           Check for stars in the last image.
-adjustFocus:             Adjust the focus after the sequence, if necessary.
-focusAdjustmentStepSize: The number of focus steps to move if out of focus
                              Default value: "1.0"
-maximumAllowedFocus:     Maximum allowed automatic focus
                              Default value: "1800"
-minimumAllowedFocus:     Minimum allowed automatic focus
                              Default value: "1600"
-informGUI:               send the GUI log the log lines
-informDB:                update the mopdb
-clear:                   clear frame before taking images
-dark:                    take darks, don't open shutter
-init:                    initialize the DA and camera
-help:                    Print summary of command-line options and abort

targetGUI (targetGUI.tcl)


Run the GUI controls for target selection

[geometry]: window geometry
                Default value: "+200+200"
-help:      Print summary of command-line options and abort

telescopeGUI (telescopeGUI.tcl)


Run the GUI controls for the telescope

[geometry]: window geometry
                Default value: "+100+100"
-help:      Print summary of command-line options and abort

telescopeSlewHADec (PTcontrol.tcl)


Slew the telescope to a specified Hour angle and Declination
<ha>:  The Hour Angle to slew to
<dec>: The declination to slew to
-help: Print summary of command-line options and abort

toggleAutoFocus (targetGUI.tcl)


toggle autoFocus
-help: Print summary of command-line options and abort

unslaveDome (PTcontrol.tcl)


turn of dome tracking

-help: Print summary of command-line options and abort

updateMOPDBFromMdReport (PTutils.tcl)


Update mopdb from the mdReport file.
[reportFileList]: List of report files to update the DB from
                      Default value: "[glob mdReport*.par]"
-verbose:         Provide extra information
-help:            Print summary of command-line options and abort

updateTimer (targetGUI.tcl)


update the time in the timer
-help: Print summary of command-line options and abort

updateTwilightModel (PTtarget.tcl)


Update the twilight model
[endTime]:      The ending time of the exposure, in MJD
                    Default value: ""
[filter]:       The filter of the exposure
                    Default value: ""
[exposureTime]: The exposure time
                    Default value: ""
[level]:        The level obtained
                    Default value: ""
-help:          Print summary of command-line options and abort

vputs (PTutils.tcl)


send information to the screen if verbose has a value
<message>:  The message to print
[level]:    The minimum level for printing
                Default value: "1"
[variable]: The variable holding the verbosity
                Default value: "verbose"
-help:      Print summary of command-line options and abort

withAirmass (PTtarget.tcl)


Return a list of objects in the desired range of airmass,
 with the desired flavors
<minAirmass>:    The minimum desired airmass
<maxAirmass>:    The maximum desired airmass
[wantedFlavors]: The desired target flavors (enclosed in curly braces)
                     Default value: ""
[theseTargets]:  A list of targets from which to select
                     Default value: "all"
[mjd]:           The mjd for which the airmasses apply (0.0 if now)
                     Default value: "0.0"
-help:           Print summary of command-line options and abort

writeMOPTape (PTutils.tcl)


write PT data to tape
[mjdList]: The list of MJD's with data to write
               Default value: "0"
-all:      Write all MJD's on disk, not just the most recent 2
-test:     For debugging only, do not actually write tape
-verbose:  Write lots of info to the screen
-help:     Print summary of command-line options and abort

zpoint (PTinitialization.tcl)


Set the current position of the telescope.

<RAstring>:   R. A. of current pointing
<DeclString>: Decl. of current pointing
[equinox]:    Equinox of provided coordinates
                  Default value: "2000.0"
-help:        Print summary of command-line options and abort

zpointTarget (PTinitialization.tcl)


reset the pointing of the telescope, such that the
 current pointing is centered on the provided target
<targetName>:   The name of the target at which the telescope is pointing
[maximumShift]: The maximum arcseconds to shift the pointing of the telescope
                    Default value: "50000.0"
-help:          Print summary of command-line options and abort