Changes between Version 4 and Version 5 of TOManual/tasks2


Ignore:
Timestamp:
Apr 16, 2021 1:40:44 PM (3 years ago)
Author:
stevenj
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TOManual/tasks2

    v4 v5  
    33                   with minor updates in October 2020 (SJ)
    44
     5'''Helpful links'''
     6
     7* The current RA night report is: [http://nossy/noss/RA/NightReport/]
     8* Previous TO night reports are at: [http://nossy/noss/TO/dateselect.php]
     9* The public night report reader is: [https://het.as.utexas.edu/HET/hetweb/vlrweb/RR/reader.php]
     10* Amy's time accounting summary page is: [https://het.as.utexas.edu/HET/hetweb/apps/nightdata/index.php]
     11
     12[[br]]
     13
     14
    515'''Duties'''
    616
    7         Although time accounting is a responsibility shared between the RA and the TO it ultimately falls to the RA to make sure that the accounts are correct since it is the RA who must respond to any problems encountered in a PI’s time accounting.  The best way to keep problems minimized to communicate during the night about when certain actions occur (such as the end of stacking or when idle time begins), to double check your report for strange accounting values (such as large overheads or huge PR time lost values) AND to check the time accounting page at the end of the night: 
    8 https://het.as.utexas.edu/HET/hetweb/apps/nightdata/index.php
     17Although time accounting is a responsibility shared between the RA and the TO it ultimately falls to the RA to make sure that the accounts are correct since it is the RA who must respond to any problems encountered in a PI's time accounting.  The best way to keep problems minimized to **communicate during the night** about when certain actions occur (such as the end of stacking or when idle time begins), to double check your report for strange accounting values (such as large overheads or huge PR time lost values) AND to check the time accounting page at the end of the night:  [[https://het.as.utexas.edu/HET/hetweb/apps/nightdata/index.php]]
    918
     19[[br]]
    1020
    1121'''Time Accounting Basics'''
    1222
    13 The beginning of the night accounting is defined as beginning at the first science exposure or 18 degree evening twilight, which ever comes first.  Thus if the TO is doing mirror alignment before 18 degree twilight then the alignment time is not counted against any science time.  If the telescope is idle from the beginning of the night, the TO should use the 18 degree twilight time as the time for the “Start Idle”.
    14 The end of the night accounting is defined as 18 degree morning twilight or the last science target, which ever comes last. 
    15 The priority for the night (set by the Supervisors) is set in the TO report.  This priority will set what type of work would start at the beginning of the night.  Thus an engineering priority would mean that by default engineering begins at 18 degree twilight.  This can be over-ridden by entering “Start Science” if we did a science target just before starting the engineering time.
    16 Time lost due to weather comes from the TO marking a start of Idle time OR the RA marks a science target as lost due to weather.
    17 Time lost due to PR are any entry in the PR section of the TO report (even if it does not have a PR number) as long as it follows the proper formatting.  Any equipment failure reported in the Accounting of the RA report must have a corresponding entry in the TO report’s PR section and should probably have a PR filed to the PR system.  PR time lost is only accumulated during official science, engineering or instrument commissioning time.  Thus a PR reported in the TO report before science operations begins or during idle time is not counted in the Time Accounting but is important for the Day Staff so they know to go fix/monitor it.
     23The beginning of the night accounting is defined as beginning at the first science exposure or 18 degree evening twilight, which ever comes first.  Thus if the TO is doing mirror alignment before 18 degree twilight then the alignment time is not counted against any science time.  If the telescope is idle from the beginning of the night, the RA should use the 18 degree twilight time as the time for the first "Idle" activity entry in the NR.
     24Time lost due to weather comes from the RA making an Idle activity entry and sometimes also changing a science/engineering target's acceptance status to "W" which is rejected due to weather.
     25
     26Time lost due to PR are any entry in the PR section of the TO report (even if it does not have a PR number) as long as it follows the proper formatting.  Any observations rejected for equipment failure ("E") in the RA report must have a corresponding entry in the TO report’s PR section and should probably have a PR filed to the Bugzilla system.  PR time lost is only accumulated during official science, engineering or instrument commissioning time.  Thus a PR reported in the TO report before science operations begins or during idle time is not counted in the Time Accounting sense, but is important for the Day Staff so they know to go fix/monitor it.
     27
    1828All actions should begin and end in the same minute to properly account for the overhead.  Thus target 1 ends at 10:20 and target 2 begins at 10:20 and Stacking might end at 10:20 and the next target should begin at 10:20.
    19 Not Used time is the catch-all for mistakes made in time accounting (there will be some) and those minutes during science which are not charged to anyone.  Example:  the clouds are rolling in so the RA and TO go out to decide what azimuth has the best chance of success, OR the seeing gets worse so the RA has to change his choice of targets.  Those few minutes should not be charged to any PI and we eat them in the Not Used category.
    2029
     30[[br]]
    2131
    2232
    2333'''Idling and Splitting Science and Engineering Time'''
    2434
    25         Idle time is really a misnomer; we don’t sit around idle watching the “Beverly Hillbillies” when conditions don’t allow normal science operations.  If the priority for the night is science but the clouds are too thick to allow science operations then you are idle.  There are some engineering tests that can be conducted under nearly any open dome conditions.  Normally we save these tests for idle conditions. This does not mean we should account this time as engineering since we would be doing science if we could, we can’t so we account the time as idle.   If you do these engineering tests, mark them as done in the queue, report the results to the appropriate person and watch the weather in case we can start back on the priority for the night. 
    26         If you find that the next few science targets have a low priority and there is a higher priority engineering test waiting in the queue then consider stopping science to begin engineering.  Tell the TO to account the time as engineering since you could have been doing the priority for the night (assuming it is science). 
    27         Under conditions where a night is completely lost due to a problem and bad weather has rolled in the time should be accounted according to what occurred first.  If bad weather rolls in and then you discover the tracker is broken the night was lost due to weather (assuming that the weather is bad all night).   If the next night the weather is also bad and the tracker is still broken then the entire night (18 degree to 18 degree) should be accounted as lost to a PR and you never enter “Idle due to weather”.
     35Idle time is really a misnomer; we don’t sit around idle watching the “Beverly Hillbillies” when conditions don’t allow normal science operations.  If the priority for the night is science but the clouds are too thick to allow science operations then you are idle.  There are some engineering tests that can be conducted under nearly any open dome conditions.  Normally we save these tests for idle conditions. This does not mean we should account this time as engineering since we would be doing science if we could, we can’t so we account the time as idle.   If you do these engineering tests, mark them as done in the queue, report the results to the appropriate person and watch the weather in case we can start back on the priority for the night. 
    2836
     37If you find that the next few science targets have a low priority and there is a higher priority engineering test waiting in the queue then consider stopping science to begin engineering.  In that case, make an entry in the RA NR to account the time as engineering since you could have been doing the priority for the night (assuming it is science). 
     38
     39Under conditions where a night is completely lost due to a problem and bad weather has rolled in the time should be accounted according to what occurred first.  If bad weather rolls in and then you discover the tracker is broken the night was lost due to weather (assuming that the weather is bad all night).   If the next night the weather is also bad and the tracker is still broken then the entire night (18 degree to 18 degree) should be accounted as lost to a PR and you never enter “Idle due to weather”.
     40
     41[[br]]
    2942
    3043
    3144'''Clear Weather- Normal Operations'''
    3245
    33         Shutter Open time is charged from htopx while overhead is charged from the night report.   It is important that the night report program number be correct in order to have the right program charged.   It is important that the htopx program number be correct (ie 3 digits in the program number, UT03-2-XXX) in order to have the right program charged.    The night report code should be an “A”.    Targets should be observed with at least 0.1 arcsecond better seeing than the image quality observing constraint and 0.1 magnitude better sky brightness than the sky brightness observing constraint.   Targets should be observed with the following priority
     46Shutter Open time is charged from htopx (using "Done") while overhead is charged from the RA night report (calculated from start to expstart).   It is important that the night report program number be correct in order to have the right program charged.   It is important that the htopx program number be correct (i.e., 3 digits in the program number, UT03-2-XXX) in order to have the right program charged.    The night report code should be an “A”.    Targets should be observed within about 0.1 arcsecond seeing of the image quality observing constraint and within about 0.1 mag/arcsec2 of the sky surface brightness brightness observing constraint.   Targets should be observed with the following priority
    34471.      Targets on the priority list
    35482.      New priority zero targets or newly activated synoptic targets.
    … …  
    3851Note this means that a dark time target with P3 might beat a P1 bright time object IF the bright time object is not on the priority list for some reason (synoptic, setting at beginning of the night, requires exceptionally good seeing).
    3952
    40 
     53[[br]]
    4154
    4255'''Poor Weather Operations, Priority < 4'''
    4356
    44         When the observing conditions are worse than the requested observing conditions for a target it should not be observed except under unusual conditions (the target may never again be available in the period or no other targets are available).  Should this happen then the RA should choose a target that has the greatest chance of being successfully completed:
     57When the observing conditions are worse than the requested observing conditions for a target it should not be observed except under unusual conditions (the target may never again be available in the period or no other targets are available).  Should this happen then the RA should choose a target that has the greatest chance of being successfully completed:
    45581.      Targets with the closest observing constraints to the current conditions.
    46592.      The target with the shortest exposure times
    47 Multiple exposures should be taken to bring the signal to noise up to roughly the desired level.   Since the first exposure will have the largest overhead this visit should be marked as rejected due to weather (“W”) in the night report.   This will have the result of reducing the overhead charged down to 0-2 minutes.   When the RA believes that enough spectra have been acquired the target should be incremented a single visit.  Thus a five minute visit request could be done with 5 five minute visits but the PI would only be charged for a single five minute visit.   Only a single entry in the nigh report should be marked as acceptable and this entry should have a minimized overhead.
    48 When targets are observed during variable conditions or degrading conditions it will be up to the RA whether the visit should be charged or not. If the observation appears to be a success but the conditions degraded to worse than the requested observing constraints then the RA should note this in the notes section of the night report and mark the target as done in the htopx file and mark is at “B” for borderline in the night report.  The borderline marker will appear as acceptable to the night report reader but gives the RA a reminder that if the PI rejects the spectrum there is no reason to investigate further.  Should the PI reject a spectrum then the RA will need to:
    49 1.       Edited the htopx file and subtract off the appropriate number of done visits. NOTE:  Look at the night report and try to determine then correct number of visits to remove, i.e. it may be less than 1.    Htopx keeps a log of all operations done through the code so you can scan back through it and look for the appropriate data entry.
    50 2.      The RA must edit the night report and change the “B” to the appropriate rejection code (most likely “W” for weather).
    51 3.      Contact the PI (cc the other RAs) and let them know what changes have been made
     60Multiple additional exposures may be taken to bring the signal to noise up to roughly the desired level.   Since the first exposure will have the largest overhead this visit should be marked as rejected due to weather (“W”) in the night report.   This will have the result of reducing the overhead charged down to 0-2 minutes.   When the RA believes that enough spectra have been acquired the target should be incremented (in htopx) for a single visit.  Thus a five minute visit request could be done with 5 five minute visits but the PI would be charged for only a single five minute visit.   Only a single entry in the nigh report should be marked with acceptance "A" and this entry should have a small overhead.
     61
     62When targets are observed during variable conditions or degrading conditions it will be up to the RA whether the visit should be charged or not. If the observation appears to be a success but the conditions degraded to worse than the requested observing constraints then the RA should note this in the notes section of the night report, increment the target in htopx, and use acceptance code “B” for borderline in the night report.  The borderline marker will appear as acceptable to the night report reader but gives the RA a reminder that if the PI rejects the spectrum there is no reason to investigate further.  Should the PI reject a spectrum then the RA will need to:
     631.       Edit the target in htopx with the "Restore" button to remove the appropriate number of done visits. NOTE:  Look at the night report and try to determine then correct number of visits to remove, i.e. it may be less than 1.    Htopx keeps a log of all operations done through the code so you can scan back through it and look for the appropriate data entry.
     642.      Edit the night report and change the “B” to the appropriate rejection code (most likely “P” which is Rejected by PI for weather).
     653.      Contact the PI (cc the other RAs using the astronomer email account) and let them know what changes have been made
    5266       
     67[[br]]
     68
     69'''
     70Options to exhaust before going idle for poor seeing'''
     71
     721. check htopx for any (including P4) targets with loose constraints on IQ
     732. observe HPF telluric standard star (even if not requested that night)
     743. observe LRS2B/R standard stars (even if not requested that night)
     754. observe VIRUS standard stars (even if not requested that night)
     76
     77[[br]]
     78
    5379
    5480'''
    5581Science Operations in an Empty Queue and Priority = 4'''
    5682
    57         The purpose of priority 4 targets is to offer the RA objects that can be observed in poor weather conditions OR when the queue would otherwise have no targets.  For targets of priority 4 the PI is not charged any overhead and the CCD shutter open time is only 50% of the requested visit.    To do this the RA simply marks the acceptance type to “4” and increment the number of visits done by 1.   If multiple visits are taken to get the S/N up to near the requested level the RA can reject the first few spectra as “W” and accept the best as “4”.  All of the accounting is done automatically within the software if the acceptance for the night report is set to “4” and the priority in the Phase II is 4.
    58         If a hole develops in the weather filtered queue and no engineering or science targets are available then rather than keep the telescope idle some rather extreme actions are required.  Targets may be re-observed from inactive programs, ie. targets that have already been observed and marked as done or targets that are on hold for any reason.  The observation should be marked as “I” which stands for Idle.   The PI is not charged for the overhead.   If the program had been placed on hold because it was out of time then the target should be marked as “Done” without incrementing the number done.  This will keep you from observing it again but keeps the PI from being charged for the time.  If the target was on hold because it was waiting for a specific date then just leave the Phase II entry unchanged but explain the situation to the PI in an e-mail.
     83The purpose of priority 4 targets is to offer the RA objects that can be observed in poor weather conditions OR when the queue would otherwise have no targets.  For targets of priority 4 the PI is not charged any overhead and the CCD shutter open time is charged at only 50% of the requested visit.    To do this the RA simply marks the acceptance type to “4” and increment the number of visits done by 1.   If multiple visits are taken to get the S/N up to near the requested level the RA can reject the first few spectra as “W” and accept the best as “4”.  All of the accounting is done automatically within the software if the acceptance for the night report is set to “4” and the priority in the Phase II is 4.
    5984
     85If a hole develops in the weather filtered queue and no engineering or science targets are available then rather than keep the telescope idle some rather extreme actions are required.  Targets may be re-observed from inactive programs, i.e., targets that have already been observed and marked as done or targets that are on hold for any reason.  The observation should be marked as “I” which stands for Idle.   The PI is not charged for the overhead.   If the program had been placed on hold because it was out of time then the target should be marked as “Done” without incrementing the number done.  This will keep you from observing it again but keeps the PI from being charged for the time.  If the target was on hold because it was waiting for a specific date then just leave the Phase II entry unchanged but explain the situation to the PI in an e-mail.
     86
     87[[br]]
    6088
    6189'''