Home

Project Tracker Operations Manual

1. SBs failed 0 of 0 0 of 0 0 of 0 0 of 0 0 of 0 2008 03 07 15 43 18 2008 03 07 15 43 18 Spectral line survey in high z molecular absorption systems Timed Out ALMA Project Doe Date 2009 12 01 Status Draft we Observatory Operations Support Page 14 of 30 er Software Operations Manual Due to the amount of information displayed the results list panel can be collapsed to free some space Arrow button at the right top of the window The root element of the navigation tree is the ObsProject itself and it is selected Below that element we find the Programs Node Observing Program element Inside the Programs Node there are the Obs Unit Set Nodes 325 43 SFI PKSI amp 30 211 SFI PKS1413 135 SFI in the example above And inside each ObsUnitSet there 1s a list of the SchedBlock child nodes The panel on the right shows a detailed summary of each selected item in the navigation tree If another element in the tree is selected the summary panel updates its contents to show information about the new selected item Refresh Sched Block 1325 43 B6 1 a Spectral line survey in high z molecular b ti i Name 1325 43 B6 1 State Phase2Submitted absorption systems na i Sched Block id uid X58 X13a X100 Status entity id uid X302 X323 X3 Observing Program Seconds observed 0 of 0 Progress Be Ses Tae Mode Single Field Interferometry Standard
2. PartiallyObserved StateEngine ObsUnitSet SCO OUS PartiallyObserved gt FullyObserved StateEngine ObsUnitSet OSF OUS Processed gt FullyObserved StateEngine ObsUnitSet SCO OUS FullyObserved gt Processed StateEngine ObsUnitSet SCO Processed eee Verified Manual verification of the DbsProject revealed problems CSVReady ALMA Project Dee Date 2009 12 01 Status Draft Page 27 of 30 gt Observatory Operations Support Su Software Operations Manual A 3 ObsUnitSet Life cycle The life cycle of an ObsUnitSet is shown in the following figure SB Phase2Submitted gt Deleted _ CSVReady Deleted StateEngine SchedBlock sco Phase Submitted SB Broken gt Phase2Submitted StateEngine SchedBlock SCO OP Phase2Submitted gt Ready OP Repaired gt PartialyObserved StateEngine ObsProject SCO OSF SB Phase2Submitted gt Ready bubbleup When ArcA changes repaired SB s to Ready StateEngine SchedBlock SCO Phase2Submitted gt SB Broken StateEngine SchedBlock OSF j Broken Ready Broken SB was made FullyObserved but other OUS children are PartiallyObserved SB Ready gt Running StateEngine SchedBlock SCO OSF StateEngine SchedBlock OSF SB Processed gt Ready PartiallyObserved StateEngine SchedBlock SCO a SB Running gt Broken SB PartiallyObserved gt Broken f StateEngine SchedBlock OSF Project changed to
3. ArcA DSOA SCO AnyState OUS Phase2Submitted gt PartiallyObserved ArcA changed repaired SB s to Ready StateEngine ObsUnitSet SCO OUS Phase2Submitted to Brokwn StateEngine ObsUnitSet OSF OUS Broken gt Phase2Submitted This transition bubbled up when SBs resubmitted by Pl using OT StateEngine ObsPrep ObsUnitSet Pl SCO OUS PartiallyObserved gt Broken StateEngine ObsUnitSet OSF Broken z OUSBroken gt FullyObserved and more Ready OUS StateEngine ObsUnitSet SCO OUSBroken gt FullyObserved and no more Ready OUS StateEngine ObsUnitSet SCO OUS Processed gt Broken StateEngine ObsUnitSet SCO OUS ObservingTimedOut gt Processed ObservingTimedOut StateEngine ObsUnitSet SCO No more observing should be performed trickle down to OUS s ObOps ArcA DSOA SCO AnyState OUS Processed gt Verified StateEngine ObsUnitSet SCO Phase1Submitted ObOps DSOA PHT SCO Approved Phase2Submitted PartiallyObserved U FullyObserved O S Rejection rejected ObOps DSOA PHT PCH SCO Proposal Rejected ObOps DSOA PHT PCH SCO SBs submitted ObsPrep Pl SCO ObOps ArcA SCO Manual verification of the ObsProject completes without errors ObOps Scheduling ArcA AoD SCO OSF Ready OUS Ready gt PartiallyObserved StateEngine ObsUnitSet OSF OUS Processed gt
4. ObservingTimedOut StateEngine ObsProject SCO ObservingTimedOut SB Running gt FullyObserved StateEngine ObsUnitSet SchedBlock OSF QAA decides to try Broken SB is Terminated Process an incomplete OUS All remaining SB s ObOps StateEngine QAA SchedBlock SCO are FullyObserved StateEngine SchedBlock SCO FullyObserved QAA decides that the OUS cannot be processe ObOps QAA SCO Pipeline problem detected Pipeline QAA SCO Pipeline completed reduction of OUS Need to Trickle Down to SB s and Bubble Up to ObsProject Pipeline StateEngine QAA ObsUnitSet SchedBlock SCO Pipeline problem solved ObOps QAA SCO PipelineError Child OUS changed to FullyObserved StateEngine ObsUnitSet SchedBlock SCO Pipeline problem detected Trickle down to SB s ObOps StateEngine QAA ObsUnitSet SCO Processed Geet SB Processed gt Broken StateEngine SchedBlock SCO SEE Piitan as Werte StateEngine SchedBlock SCO O Verified Note that most state transitions are derived all manual state transitions are related to pipeline processing and data Quality Assurance None of these state changes can be performed or tracked using the Project Tracker Doc ALMA Project Date 2009 12 01 a Status Draft Observatory Operations Support Page u Software Operations Manual ALMA A 4 Sched Block lifecycle 28 of 30 The life cycle of a Sc
5. SchedBlocks Progress Name spata ECDFS FullyObserved And Project state detailed screen would be Project Name Code 2010 1 00055 N PI name Email Creation date 2010 02 11 14 07 45 Priority 0 Id uid X22 X29 X5d Project status State Status Entity Id uid X22 X29 X61 Ready time For more detailed information about state changes please refer to the Project ObsUnit set and Sched Block life cycle documentation ALMA Project Dee Date 2009 12 01 Status Draft Page 20 of 30 7 User section for Principal Investigators PI Principal Investigators can track progress of their observing project and constituent schedule blocks A PI will normally search by project but can also search by schedule block most likely when the PI has more than one active project 7 1 Tracking Principle investigators are only allowed to track their own projects and schedule blocks They will use the project tracker mostly as a monitoring tool for their projects and schedule blocks especially in the case of problems broken SBs for example 7 2 Allowed state changes All done in the Observing Tool ALMA Project Doc Date 2009 12 01 Status Draft Page 21 of 30 8 User section for Astronomers on Duty AoD 8 1 Tracking An Astronomer on Duty AoD can track all projects and schedule blocks In practice an AoD will mostly track SBs planned for or executed during his shift 8 2 Allowed state chan
6. mode 1325 43 B6 1 5 1325 43 B6 2 Expected exec time 0 0 Maximum exec time 1325 43 B3 1 Expected Exec count 1 Delay 1325 43 B3 2 Sched Block details lt 1325 43 B7 1 1325 43 B9 1 Exec Status List PKS1830 211 SFI State Ready Time Start Time End Time Last update time Time of Creation Array Name ExecBlock id PKS1830 211 B6 1 2009 11 01 2009 11 01 p 2009 11 06 PKS1830 211 B6 2 FullyObser N A 09 20 36 09 30 36 M 09 10 36 123455 PKS1830 211 B3 1 PKS1830 211 B3 2 PKS1830 211 B7 1 PKS1830 211 B9 1 PKS1413 135 SFI PKS1413 135 B6 1 PKS1413 135 B6 2 1 2 gt PI fi 20 22 At any time the Refresh button on top of the ObsProject navigation tree will update the information displayed in case it has been modified by a third party during the working session with the Project Tracker 5 1 1 Changing ObsProject states Project Tracker can change the Project state according to its life cycle if the user is authorized to do it In Project summary window the Project status panel shows the current status in a drop down list together with the other possible target states If a new state is selected a button labeled Change State appears When clicked a confirmation window will pop up and if accepted the state change will be carried out The state change trickles down the corresponding state changes for its child elements see lifecycle documentation ALMA Project Doc Date 2009 1
7. the user according to their position in the sky A equatorial coordinate search can be done in two different ways Square search ALMA Project Doc Date 2009 12 01 m Status Draft i p Observatory Operations Support Pace 11 of 30 Software Operations Manual ee j ALMA Square Free RA DEC Radius The Square search coordinates returns the SchedBlock within a virtual box in the sky delimited by a central point Declination and Right Ascension coordinates and a Radius in degrees Coordinate bounds are calculated as follows RA max RA Radius RA min RA Radius DEC max DEC Radius DEC min DEC Radius Free coordinates search Coordinate bounds can explicitly be set using the Free coordinates search panel Square Free RA min RA max DEC min DEC max NOTE Coordinates format is HH MM Sec for Right Ascension DD MM Sec for Declination and DD MM Sec for Radius 4 5 Query actions Once all values are set the query is ready to be submitted Identically to the ObsProject query panel the number of SchedBlock per page can be set using the Results per page drop down list Results per page 10iv Search Reset The Search button performs the query There is a maximum value of 10000 records returned see 3 4 ALMA Project Dee Date 2009 12 01 Status Draft S Observatory Operations Support Page 12 of 30 er Software Operations Manual The Reset button
8. time 10 hours To time 1 day 1 week 1 month Predefined Other ALMA Project Doc Date 2009 12 01 Status Draft Page 7 of 30 The first four options specify a time interval from the selected value 10 hours ago 1 day ago 1 week ago to the current time The last option Other enables the two date fields below From time To time where the user can specify two custom dates 3 3 Predefined Queries Predefined queries are shortcuts to those commonly used queries These queries fill some fields by default but still more fields can be added afterwards to narrow the search Predefined queries FEE EEE EEE EEE EEE EEE EEE ENTE EEE E EEE EN EE EEE TENE EEE TENE EEE ETE ETON NENT ERENT ET ERNE Eee ee LPeeeeer rere r errr rr rere rer terre tr ter etree errr ier tr ret r rT t rrr ttt tT tt tT rt ir ttt tt te Projects observed last week End of period 90 completed Projects observed last week Selects Fully Observed state and Last week option in the In The last field End of Period Selects all those not finished ObsProjects with more than 90 completed This means it searches for projects in Broken PartiallyObserved Phase2Submitted Ready or Repaired state and 90 percent completed 3 4 Query actions Once all values are set the query is ready to be performed Still one extra parameter can be set the number of returned ObsProjects per page Results per page 10i
9. with the following page ALMA Project Tracker A Q Project search Sched Block search ATACAMA LARGE MILLIMETER ARRAY From here the user has two options search for projects or search for schedule blocks to track A PI will typically search for his project and inspect the status of the schedule blocks therein whereas an Astronomer on Duty is more likely to track specific sets of schedule blocks irrespective of the project they belong to 3 Project search To search for projects we must click on the Project search button at the top left of the main window and the following panel pops up shadowing the rest of the window Project search PI Name Project Name Project ID Percent completed Project state history Cl Approved In the last _ Broken C Canceled Fi FullyObserved To tme Cl ObservingTimedOut C PartiallyObserved C Phase2Submitted Ll Processed Cl Ready Ll Repaired L verified Results per page 10v From time Predefined queries ALMA Project Doc Date 2009 12 01 A Status Draft ee Observatory Operations Support Pace 6 of 30 Software Operations Manual age E ALMA In this panel we have several search parameters divided into two groups Basic project search parameters top part and Project state history parameters bottom part 3 1 Basic Project query parameters These are the most basic and general details of the Project This sea
10. 2 01 Status Draft gt Observatory Operations Support Page 15 of 30 Software Operations Manual The following screenshots shows the sequence of events Displaying possible target states Project status os PreseiSibnied J Status Entity Id Phase2Submitted Cancel Project Change Projectto ObservingTimedOut Start time Change Projectto Approved End time Change Projectto Read Last update time Ready time Selecting target state Project status State Change Projectio Ready Change Status Status Entity Id uid X302 X323 X0 Asking for confirmation and Maeike about the state change State change T Project status changed State change Proceed with Project state change If the user is not authorized to perform such a state change or if the state change is not possible an error message will inform about tt 5 2 SchedBlock results page If a SchedBlock query was submitted results returned are a SchedBlock list matching the search criteria a Uw ALMA Project Observatory Operations Support Software Operations Manual Doc Date Status Page 2009 12 01 Draft 16 of 30 SB code uid X58 X110 X36b uid X58 X111 X26a uid X58 X13a X100 uid X58 X185 X21 uid X58 X19b Xc9 uid X58 X203 X166 uid X58 X21a X38e uid X58 X274 X20 uid X58 X27e X248 uid X58 X2c7 X170 i ee ALMA Project Tracker aeuvesssssvssscs
11. Atacama Large Millimeter Array ATACAMA LARGE MILLIMETER ARRAY Project Tracker Operations Manual Version 0 3 Status Draft 2010 09 17 Prepared By Name s and Signature s Francesc Julbe Lopez ESO 2009 12 01 Eelco van Kampen ESO 2010 09 17 Approved By rr Name and Signature Released By Name and Signature Doc Date 2009 12 01 Status Draft gt Observatory Operations Support Page 1 of 30 pa Software Operations Manual ALMA ALMA Project Change Record Version Date Affected Change Request Reason Initiation Remarks Section s ef 2010 05 06 Extensions overall Added sections for specific actors 2010 09 17 pf Version for the second integrated test ALMA Project Doc Date 2009 12 01 Status Draft Observatory Operations Support Page 2 0f30 Software Operations Manual i Table of Contents L OVE VU o eswesounes setievayee eednvacencteuvaetiesscuceetssaucssaussetvesucunteesecuedssseeetaesceueeks 4 A WSIS me Proet Vr aC RO a ne se ch vanes nce weenie cance eceiedecussmebecteecudeucdssecusndeaeccaesedars 4 3 Project SCAU CU oesie aa E Aaaa aara ANETA ENES EEAS enD 5 J le BASIC Projectgue ry parameters sv snissiectnvcisdvencascsissaadacesatsadindsnstescsdascuaiesbeavieeseiucensncbsvudveseiuiasiaewsacsnadivanates 6 3 2 Project state Distory feldS xssissessisei ninaa a Naaa EE SaRaNa 6 Ks 7 ed 96 os E E E eee ee cee ee ee 6 SFP VIG WAT VANS tcc secede
12. E CHANGES ia E A E ES 24 ALMA Project Dee Date 2009 12 01 Status Draft Observatory Operations Support Page 3 of 30 Software Operations Manual W Proe OV emer irra re E E reer eee e eeenere 24 10 2 2 Schedule block leVel oii csssssscccsscesscccsscecsececseccsececseessesecsecessaeseseecsacessacesaaessecessesesusssaeecsueesneeeseeesnaeess 24 PAS PACS Ey lE eoria E EEE A 25 ALMA Project Doc Date 2009 12 01 Status Draft Page 4 of 30 Observatory Operations Support Software Operations Manual 1 Overview The aim of the Project Tracker is to track the status of an ALMA observing project and its constituent parts eg scheduling blocks after the project is accepted and scheduled for observing This tracking can be done by various users including the Principal Investigator and Observatory Staff who play different roles during the lifetime of the project from acceptance to completion The following table shows the list of intended users Principal Investigator of an observational project Astronomer on Duty performing observations at the OSF ARC Astronomer dedicated to user support at an ALMA Regional Center Quality Assurance Astronomer performing QA activities at the OSC Super user experts with access to all areas of the project The Project Tracker allows control and monitoring of the life cycle of an observing project As projects and schedule blocks SBs flow through the ALMA system they c
13. Observed s ssssssssssunnnunnnunnnnnnunnnnnnnnnnnnnnnnnnnnnnn 18 7 User section for Principal Investigators P I sssssussunnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 20 Toke TE e A A E A E E E EA E A A A E A 20 Take POWER SCALE A BES a OEE EEEE EE 20 8 User section for Astronomers on Duty AOD ssssssssnssunnunnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 21 ok CN e seeuevdaecareaecenewesktoussucauiese seceusectuessaceuucetes act eceussecaucavennsoceees 21 8 2 Allowed SLAC CHANGES wcicsncssisiecesatensentudtaiebcaswescucinssicsuaccnad duteesiaadunensveastisbeusesssavasduintoeseseaseavnnendedeatencrasdandes 21 oak TOC Secession E E E sntaeceesaescent cette 21 oy S nedalo plock leye Denman nti niece tees mentee ionomers ee ore ere men renee mrt ere eer ewer ne crete era 21 9 User section for ARC Astronomers ArcA sssssnsssnsnunnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 22 2 TPAR aca E 22 92 Allowed state CANE CS sansan aaa EAEN ESERSE aaa 22 Dade PO POV Cisse ceca tein cts ceceetice cree lence cacti ecenn sai nae este E E 22 9 2 2 Schedule block IO VE sccssncastsesctezectetenesteesetescctscu cout xasaucincisuctnssnatinneicBlatsascnesenncuie cstoceueoosesascntodetletedesaenesiatencenetapents 23 10 User section for Quality Assurance Astronomers QAA ssssssssssnsnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnan 24 10L of es 50 Ase pn Se oer ne Be er eee Oe See ee eee eee 24 LOZ AMOWEG STAL
14. and Exec Status List These panels can be expanded or collapsed using the arrow buttons in the header of each one surrounded by a red circle in the screenshot below Expanded S Refresh PKS1413 135 B3 1 Name PKS1413 135 B3 2 lt lt 4 2 2 Collapsed Sched Block id Seconds observed Mode Expected exec time 21 22 22 Expected Exec count Name Primary Name Setup for H13C0 1 0 j Representative Frequency Min angular resolution Baseline cal valid Min hour angle Max PWC Phase stability Pointing accuracy Bandpass accuracy Polarization accuracy State FullyObserv N A Ready Time Start Time End Time 2009 11 06 2009 11 06 09 20 36 Sched Block PKS1413 135 B3 2 PKS1413 135 B3 2 uid X58 X2c7 X170 0 of 0 Single Field Interferometry 0 0 Sched Block details State Status entity id Ready uid X302 X323 xX14 Progress Standard mode Maximum exec time Delay Field Source List Dec d m s 13 20 23 Spectral Setups Transition name Preconditions and constraints 1 RA h m s 14 15 58 8 Dynamic range 7 10 86 75433 0 8 false 0 0 2 3000 0 0000 Dynamic range F Max angular resolution Polarization cal valid Max hour angle Max wind velocity 0 0000 Max seeing 0 0000 Calibration requirements Exec Status List 09 30 36 N A Last update time 1 0 0 1 0 1 Time of Creation Array Name ExecBloc
15. attention Scheduling may also be used for this This will bubble up changing the parent ObsUnitSets and ObsProject to Broken No other SchedBlocks should be executed while the ObsProject is in the Broken state ALMA Project Doc Date 2009 12 01 Status Draft Page 22 of 30 9 User section for ARC Astronomers ArcA 9 1 Tracking An ARC Astronomer ArcA can track all projects and SBs An ArcA will mostly track projects and SBs he she has to verify or repair but will mostly make state changes at the project level 9 2 Allowed state changes 9 2 1 Project level Phase2Submitted Ready A Phase2Submitted project needs to be manually verified by the ArcA as being free of errors Once this verification 1s complete the project can be changed to Ready note this change trickles down to all Phase2Submitted ObsUnitSets and SchedBlocks changing them to Ready Phase2Submitted Approved If a Phase2Submitted project contains errors it can be changed back to Approved by the ArcA Repaired Broken The ArcA manually inspects the Repaired Project and determines that it contains errors that require attention from the PI The ArcA then changes the Project to Broken Repaired FullyObserved OR Repaired PartiallyObserved The ArcA manually inspects the Repaired Project and determines that it does not contain any errors There are then two options fit does not need any further observing The ArcA then changes the Pr
16. cece ce etcetera E Spe sen ta sen N OIE E 6 3 3 Prede ned QUETICS sssini aA aaa AEE ANE SEa NAERAA 7 SA OUO OODE iaa O ES 7 A CIRC ONO CI SCAN esetcce ect scaedsceuctatencue soceaeseceveecstt ce acesedeecusedsoecsccsiesexuceuscuevceescuesscuesyewsensursstusocedeseens 8 Aids Basicguery para melerS incite ciscantseceresntuvcnnasnssncnsvecsacansesssncuusanadeedvasuutestsasuvesiadcatsnidentsiieinuddsnrocessintsdsanaicensine 8 4 2 SchedBlock state history parameters 1 0 1cccccccssescsssnsssscecssnesssnessnnesensessnaeessnecesnessnseesneessnnesscnessnaessons 9 A CCRC TET OG CCS oe strc ac rete en cae EA 9 4 4 Bands and Coordinates searCh s sssnnsennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nann 9 AA Bon eeen E EE ES 10 BAZ SCOOT MM ASS AU e st ecacdecccecteesasasee aatcessacstucseearecectccteseusceeueeroeeesestesientennseeesiceeeeeetest 10 Tos COMP ACU NS acces cts nts nec tca oaemeesa ccs sav sccrnties E E 11 S RESONS DAA Oan E EER E 13 Sd OVC CU re SWN Se E 13 SEL Changing ODSPrOJECE SITOS posi T E 14 biz SCHEABIOCK PESUINS Dal 6 isc Ea O EAE EE 15 Dees Changing schedBlock state Sepen neea eNe Opa Eaa EEEE ETATER 17 6 Changing states using the Project Tracker egamples ssssssssnsnunnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnne 18 6 1 Changing an ObsProject state from Phase2Submitted to Ready sssssssssunsnnnnnnnnnnnnunnnnnnnnnnnnnnn 18 6 2 Changing a Sched Block from Suspended to Fully
17. clears all fields of the query panel Also each criteria narrows the search as they are ANDing the query see NOTE in 3 4 ALMA Project d A Observatory Operations Support Software Operat Results page Doc Date Status Page Draft ions Manual 13 of 30 2009 12 01 Once the query is submitted the results window displays a list of the returned records as follows Q Project search Q Sched Block search Project Code PI Name uid X58 X134 X27 uid X58 X68 X263 uid X58 X268 X291 uid X58 Xef X99 Thomas Powers I Thomas Powers II Thomas Powers III R Kurowski uid X58 X17a X2e5 Wikland T Combes F ALMA Project Tracker Name Progress OPT 1 6 bright polar stars State i Phase2Submitte 1 OPT 2 6 bright polar stars Phase2Submitte 2 OPT 3 6 bright polar stars Phase2Submitte 3 Galaxies Test project Phase2Submitte 0 Spectral line survey in high z molecular absorption systems Phase2Submitte 0 Priority Time of Creation 2008 03 07 15 43 18 2008 03 07 15 43 18 2008 03 07 15 43 18 Timed Out 5 1 Project results If an ObsProject is selected in the list two extra panels are displayed below the results list To the left there is a panel with a navigation tree To the right there are some extra panels Project Project status and Program status with detailed information of the selected item in the tr
18. ee C Project search X Sched Block search ALMA Project Tracker Project Code PI Name Thomas Powers I Time of Creation 2008 03 07 15 43 18 State Priority Phase2Submitte 1 Name OPT 1 6 bright polar stars Progress uid X58 X134 X27 uid X58 X68 X263 uid X58 X268 X291 uid X58 Xef xX99 Thomas Powers II Thomas Powers III R Kurowski uid X58 X17a X2e5 Wikland T Combes F Refresh _ Spectral line survey in high z molecular absorption systems na Observing Program J 1325 43 SFI 1325 43 B6 1 1325 43 B6 2 1325 43 B3 1 1325 43 B3 2 1325 43 B7 1 1325 43 B9 1 PKS1830 211 SFI PKS1830 211 B6 1 PKS1830 211 B6 2 PKS1830 211 B3 1 PKS1830 211 B3 2 PKS1830 211 B7 1 PKS1830 211 B9 1 J PKS1413 135 SFI PKS14134135 B6 1 PKS14134135 B6 2 gine 1 42 gt PI 1 20 22 f OPT 2 6 bright polar stars OPT 3 6 bright polar stars Galaxies Test project Spectral line survey in high z molecular absorption systems Name Code PI name Creation date Priority 0 Id uid X58 X17a xX2e5 Project status State Phase2Submitted Status Entity Id uid X302 X323 X0 Ready time Start time End time Last update time Phase2Submitte 2 Phase2Submitte 3 Phase2Submitte 0 Phase2Submitte 0 Project Wikland T Combes F Program status Seconds observed Unit sets completed Unit sets failed SBs completed
19. endix displays four life cycles two of which ObsProject and SchedBlock are tracked by the Project Tracker The life cycles themselves are expressed as UML state diagrams in the next four sections of this appendix They are described in detail in a separate document Life cycle of ObsProjects COMP nn nn nn nn nn A SPEC The life cycle is powered by the StateEngine State transitions are initiated by Actors an Actor or Role is some entity human or software capable of taking decisions and starting actions The following table lists the known actors they are represented as stereotypes e g lt lt AOD gt gt associated to the state transitions in the diagrams Column Color indicated the color used in the diagrams to identify transitions actions initiated by that actor ArcA ARC Astronomer dedicated to user support at the ALMA Regional Centers AoD Astronomer on Duty performing observations at the OSF No actor state transitions are initiated by trickle down and bubble up rules PI Principal Investigator of an ObsProject green Quality Assurance Astronomer performing QA activities at the OSC magenta ALMA Project G Observatory Operations Support Software Operations Manual A 2 ObsProject Life cycle Doc Date Status Page 2009 12 01 Draft 26 of 30 The life cycle of an ObsProject is shown in the following figure Proposal un approved Proposal Approved ObOps DSOA PHT PCH SCO ObOps
20. esesesesevesssevsusessesesessseseesuened SB name SB progress SB state PKS1830 211 B3 2 Ready PKS1830 211 B6 2 _ Ready 1325 43 B6 1 Ready 1325 43 B6 2 Ready 1325 43 B9 1 __ Ready PKS1830 211 B6 1 Ready PKS1830 211 B7 1 __ Ready 1325 43 B3 2 Running PKS1413 135 B6 1 Ready PKS1413 135 B3 2 Ready gt RA h m s DEC d m s 05 00 06 009 42 58 57 675 18 33 39 888 21 03 39 769 14 15 58 817 13 20 23 7112 Band ALMA_RB_03 Project code Project state uid X58 X17a X2 PartiallyObserved Priority ALMA_RB_06 uid X58 X17a X2 PartiallyObserved uid X58 X17a X2 PartiallyObserved uid X58 X17a X2 PartiallyObserved ALMA_RB_06 ALMA_RB_06 ALMA_RB_O9 uid X58 X17a X2 PartiallyObserved uid X58 X17a X2 PartiallyObserved uid X58 X17a X2 PartiallyObserved uid X58 X17a X2 PartiallyObserved uid X58 X17a X2 PartiallyObserved ALMA_RB_06 ALMA_RB_0O7 ALMA_RB_0O3 ALMA_RB_06 oe O TEAU oe G no O ae O ALMA_RB_0O3 uid X58 X17a X2 PartiallyObserved 1 10 16 When one SchedBlock is selected the ObsProject navigation tree see 5 1 appears with the corresponding SchedBlock selected and the summary window displays the SchedBlock details Again when browsing the ObsProject tree the summary windows update its contents according to the selected item The detailed information for a SchedBlock is grouped into three panels SchedBlock Name SchedBlock details
21. ges 8 2 1 Project level Phase2Submitted Ready A Phase2Submitted project needs to be manually verified by the ArcA as being free of errors Once this verification is complete the project can be changed to Ready Either an ArcA or a AoD can make this change An AoD might do this in case an ArcA has verified a project but cannot make the change him herself because of an internet connection failure for example Phase2Submitted Broken A SchedBlock was not properly fixed by the PI and can therefore be moved back to the Phase2Submitted state for the PI to attend to again using the Observing Tool 8 2 2 Schedule block level Suspended Ready If the SchedBlock was Suspended because scheduling was running in semi automatic mode or it failed execution because of a system failure changing weather conditions or QAO failures in any case not because of errors in the SchedBlock itself then the AoD may change the SchedBlock to Ready for re execution Suspended FullyObserved If execution of the SchedBlock completed successfully QAO was successful and no further execution repeats are required then AoD may change the SchedBlock to FullyObserved Scheduling may also be used for this Output notification to Quicklook Suspended Broken Execution of the SchedBlock failed and the AoD decides that the PI needs to repair the SchedBlock before it can be re executed The AoD changes the SchedBlock to Broken for the PI s
22. hange state and gather additional information All this information can be seen and managed using the Project Tracker but not all parts can be seen by all users The first part of this User Manual is contains information for all users The second part is split into four sections 6 to 9 inclusive focusing on the specific roles of the various users except for the SU as he she has all roles 2 Using the Project Tracker The Project Tracker is a Web application currently accessible at http www eso org protrack it will be part of the User Portal later on But before you start an important aspect of this application it uses a JavaScript framework technology so all events occur in the same page It is not convenient to use the Back and Forth buttons of your browser because this would reload the page prior to the Project Tracker and you ll lose all information you may have already loaded into the tool Refreshing the page would also remove any content you may have loaded in and it would reload the main page having a fresh start again Keeping this in mind Project Tracker is compatible with these Internet browsers Mozilla Firefox Internet Explorer Safari specifics on versions ALMA Project Dee Date 2009 12 01 Status Draft Page 5of 30 ee Observatory Operations Support oo Software Operations Manual ALMA Once the Project Tracker Web application is loaded the user is presented
23. hat applies to any SB belonging to a Verified Terminated for instance a project that has reached its allocated observing time or Canceled project ALMA Project Dee Date 2009 12 01 Status Draft S Observatory Operations Support Page 29 of 30 Software Operations Manual i A 5 CSV Sched Block life cycle CSVSuspended gt CS VReady ObOps StateEngine Pipeline Scheduling ObsPrep QAA PI ArcA AoD DSOA PHT PCH SCO OSF CSVReady CSVRunning gt S VReady ObOps StateEngine Pipeling Scheduling ObsPrep QAA PI ArcA AoD SOA PHT PCH CSVReady gt CSV Running ObOps StateEnging Pipeline Scheduling ObsPrep QAA PI ArcA AoD DSOA PHT PCH CO OSF CSVRunning CSVRegnning gt CSVSuspended ObOps StateEngine Pipeline Scheduling ObsPrep QAA Pl ArcA AoD DSOA PHT PCH SCO OSF CSVSuspended CSVReady gt CSVSuspended ObObs StateEngine Pipeline Scheduling ObsPrep QAA Pl ArcA AoD DSOA PHT PCH SCO OSF This is shown for completeness only and will disappear from the manual when CSV is finished
24. hedBlock is shown in the following figure Pi deletes SB 7 Only SBs that haven t run may be deleted ObsPrep Pl SCO Deleted SchedBlock is not fixed Scheduling ObOps AoD OSF SchedBlock problem was fixed Broken ObsPrep Pk SCO Faul in SchedBlock P must fix Scheduling ObOps AoD OSF SchedBlock can be re started Suspended Scheduling ObOps AoD OSF Schedblock failed or Scheduling running in semi auto mode Scheduling AoD OSF PI or Aod decides to Phase Submitted OUS Phase2Submitted gt Ready trickledown Or ArcA changes repaired SB s to Ready StateEngine ObOps ObsUnitSet ArcA SCO OSF Ready SB launched or re launched Scheduling AoD OSF SchedBlock executed has repeat count gt 1 and Scheduling in fully auto mode Scheduling AoD OSF Running terminate SB QAO SB observation ObsPrep Scheduling completed PI AoD Scheduling ObOps AoD OSF f SCO OSF QA2 failed broken SB ObOps QAA SCO FullyObserved Pipeline change OUS to Processed StateEngine ObsUnitSet SCO OUS Processed gt PipelineError StateEngine ObsUnitSet SCO QA2 failed must repeat ObOps QAA SCO Processed QA2 failed ObOps QAA SCO QA2 passed ObOps QAA SCO VerificationFailure Verified Note that SchedBlocks retain their state whatever state they are in when the containing ObsProject has finished observing T
25. k id 2009 11 06 09 10 36 123455 ALMA Project Doe Date 2009 12 01 ar o z Status Draft servatory Operations Support Page 17 of 30 Software Operations Manual Z Refresh Sched Block PKS1413 135 B3 2 PKS14134 135 B3 1 PKS14134 135 B3 2 4 4 2 2 21 22 22 Exec Status List Sched Block details 5 2 1 Changing SchedBlock states Project Tracker can change the SchedBlock state If the transition is possible the state field red circle in the screen shot below will display a drop down list with the possible target states If no state transitions are possible the current state is displayed without any other option Sched Block PKS1413 135 B3 2 Name PKS1413 135 B3 2 State Sched Block id uid X58 X2c7 X170 Status entity id uid X302 X323 xX14 Seconds observed 0 of 0 Progress ALMA Project Doc Date 2009 12 01 a Status Draft we Observatory Operations Support Page 18 of 30 ae Software Operations Manual 6 Changing states using the Project Tracker examples The Project Tracker can change some ObsProjects ObsUnit sets and SchedBlock states depending on the user role and on the life cycle of each entity Here we present two simple use cases 6 1 Changing an ObsProject state from Phase2Submitted to Ready When a Project is in Phase2Submitted all its Sched Block must be also in Phase2Submitted as well From that state allowed transitions for a project are Ready bac
26. k to Approved Observing TimedOut or Cancel Let s consider that the project is setup to become Ready Using the Project Tracker we can change the state to Ready if we have the appropriate role AoD ArcA in this case To perform the transition we must select the ObsProject in the project browser tree In the Project status section a dropdown list shows the possible target states Project status Penal Phase2Submitted aw Status Entity Id Phase2Submitted Cancel Project Ready time Change Projectto Observing TimedOut Start time Change Project to Approved End time Change Project to Ready Last update time If we select Ready and we click the Change Status button the project state will be changed after asking for confirmation This transition will trickle down the states transitions for its ObsUnit sets and Sched Block to Ready state as well o Project status changed We can navigate through the project browser tree and all entities belonging to the ObsProject should appear as Ready 6 2 Changing a Sched Block from Suspended to FullyObserved For this second brief example we will consider that we have a project with one single Sched Block The Project Tracker allows the Sched Block state transition from Suspended to FullyObserved if the user has the AoD role For the given example as the Sched Block is in Running or Suspended state the Project is in Partia
27. lly Observed state ALMA Project Doc Date 2009 12 01 Status Draft Observatory Operations Support Page 19 of 30 Software Operations Manual l Project Tracker will show the following Sched Block ECDFS Pe Source Name ECDFS State Suspended iv Anan A ne Anan ethene nee ne ene nnenen een nennnneenenneneenenneneeneeneneenennennensenenrenennenenneenenteneerentanenennnanad Sched Block id uid X22 X29 X60 Status entity id Change Sched Block to FullyObserved Seconds observed 0 of 0 Progress Change Sched Block to Broken Mode Standard Interferometry Standard mode Change Sched Block to Read Expected Exec count 1 Delay sec 0 0 Current executions 0 Maximum exec time sec 1800 0 To change the Sched Block state we must browse the project using the ObsProject tree and select the Sched Block we want to change the state In Sched Block detailed view we select FullyObserved as target state in the drop down list and we click on the Change state button the given Sched Block will become FullyObserved and it will bubble up the ObsUnit set and ObsProject state transition to FullyObserved To see the changes browse the ObsProject tree and the new states should be displayed in the detailed view of the ObsUnit set and ObsProject as shown in the following screenshots For the ObsUnit set ObsUnitSet ECDFS SFI State FullyObserved Status entity id uid X22 X29 X63 Child
28. oject to FullyObserved it does need to be observed further The ArcA then changes the Project to PartiallyObserved This change trickles down changing all Phase2Submitted ObsUnitSets and SchedBlocks to Ready other ObsUnitSets and SchedBlocks are not affected The Scheduler can now continue running the project AnyState ObservingTimedOut If no more observing should be performed for a project the ArcA can change a project from any state to ObservingTimedOut The project will then be moved to the Processed state internally AnyState Canceled A project can be Canceled at any time by the ArcA no further action will be taken no processing for example This is effectively an end state for the project and a dangerous transition to make ALMA Project DRG Date 2009 12 01 Status Draft a Observatory Operations Support Page 23 of 30 er Software Operations Manual 9 2 2 Schedule block level Phase2Submitted Ready This transition normally trickles down from the similarly named transition at the Project level but an also be performed at the SchedBlock level ALMA Project Dee Date 2009 12 01 Status Draft Observatory Operations Support Page 24 of 30 Se Software Operations Manual 10 User section for Quality Assurance Astronomers QAA 10 1 Tracking A Quality Assurance Astronomer QAA can track all projects and SBs A QAA will mostly track projects and SBs that fail QA2 and will
29. only make changes at the SB level all starting from the Processed state 10 2 Allowed state changes 10 2 1 Project level None 10 2 2 Schedule block level Processed Broken QA2 fails for the SchedBlock with errors that require the PI s attention QAA changes the SchedBlock to Broken This change bubbles up changing all the enclosing ObsUnitSets and the ObsProject to Broken Processed Ready QA2 fails and the SchedBlock requires re execution QAA changes the SchedBlock to Ready so that it gets re observed This change bubbles up changing all the enclosing ObsUnitSets and the ObsProject to PartiallyObserved Processed Verified The SchedBlock passes QA2 QAA changes the SchedBlock to Verified This change bubbles up to the enclosing ObsUnitSets and the ObsProject which will become Verified when all their children are Verified or VerificationFailure Processed Verification Failure The SchedBlock fails QA2 but there is no more observing time available for the ObsProject The ProjectWasTimedOut timestamp was set QAA changes the SchedBlock to VerificationFailure This change bubbles up to the enclosing ObsUnitSets and the ObsProject which will become Verified when all their children are Verified or VerificationFailure ALMA Project Doc Date 2009 12 01 Status Draft Page 25 of 30 Observatory Operations Support Software Operations Manual A Appendix Life cycles A l Overview This App
30. rch mode will mostly be used by Principle Investigators PIs and users who are collecting statistics on the progress of projects during a specific period or for certain categories of PIs eg executives PI Name The tool searches for any PI name containing the string provided It uses standard search wildcards to represent any substring to represent any single character Project Name Same behavior as the PI Name but applied to the Project Name field Project ID Same behavior as the PI Name but applied to the Project Code field Percent completed Queries for all project with the completed percentage equal or bigger to the specified 3 2 Project state history fields 3 2 1 States A specific state can be given to the query choosing among all possible states Approved Broken Canceled It is a multi selection list so several states can selected The multi selection has an OR logical operation so when choosing more than one state we are asking for states with state statel or state state2 or 3 2 2 Time intervals Time intervals can be also be specified to the query They are associated to the states so if no state is selected the time interval fields are not enabled In the Last field is a drop down list box with a set of predefined values 10 hours 1 day 1 week 1 month Other RLLLLLLLLLLLLLLLLLLLLLL A Inthelast IM From
31. t completed _ Sched Block state history Broken C Deleted LJ FullyObserved _ Phase2Submitted Processed LJ Ready C Running Suspended l VerificationFailure verified Bands and coordinates Results per page 10 4 1 Basic query parameters In the last From time To time Predefined queries SchedBlock can be searched by ObsProject parameters so the upper side of the panel offers the same search capabilities than the Project query panel Search by PI Name Project Name Project ID and Percent completed see 3 1 ALMA Project Doc Date 2009 12 01 Status Draft Page 9 of 30 4 2 SchedBlock state history parameters SchedBlock state history parameters allow the user to search for SchedBlocks depending on their state and for certain time intervals These two criteria work in the same way the Project query panel ones do see 3 2 4 3 Predefined queries Similarly to the ObsProject query panel some predefined and commonly used queries are defined for the SchedBlock search Predefined queries Dennen een eee tReet Reet eee Renee eee eee eee eee eee Ree eee eee eee eee Peer eee rere eee rere eeeeeeeeeeeeeeeeed SchedBlocks observed last week Start of shift SchedBlocks observed last week Those are the completed SchedBlock during the last week Selects FullyObserved state in the states list and fills the In the last field with 1 week Start of Shift Selec
32. ts FullyObserved Running and Verified states in the states list and fills the In the last field with 10 hours 4 4 Bands and Coordinates search This panel is collapsed by default It can be expanded or collapsed using the small button in the header of the panel red circle in the screenshot below ALMA Project Dee Date 2009 12 01 s Observatory Operations Support a Te ed Page 10 of 30 Software Operations Manual i Sched Block search PI Name Project Name Project ID Percent completed Sched Block state history Cl Broken In the last O Deleted FullyObserved Cl Phase2Submitted 39 as Processed C Ready Running EF Suspended _ verificationFailure L verified Bands and coordinates From time Predefined queries Cl Band 3 84 116 GHz Square Free O Band 4 125 169 GHz F IBand 5 163 211 GHz OBand 6 211 275 GHz PEC Ll Band 7 275 373 GHz Radius Cl Band 8 385 500 GHz Band 9 602 720 GHz Results per page 10 RA When expanded the SchedBlock panel offers two more search criteria Search by bands and search by coordinates 4 4 1 Bands Several receiver bands can be selected from Band 3 to Band 9 It is a multi select list so more than one can be picked and they are added with a logical OR operation band band3 OR band band4 OR 4 4 2 Coordinate search SchedBlock can also be returned to
33. v Search Reset This number can be selected in the results per page drop down list from 10 to 50 in 10 records steps The default value is 10 The Search button submits the query There is a maximum value of 10000 records returned Beyond that value an error message is displayed warning the user to narrow the search and try again This limit is set for performance issues Large result sets can cause the system to take long time for each query reducing usability and increasing the load on the server ALMA Project i gt Observatory Operations Support D Software Operations Manual Doc Date 2009 12 01 Status Draft Page 8 of 30 The Reset button clears all fields of the query panel NOTE As more fields you select more restrictive the query will be Each search parameter is AND ing to the next one the states select list is a single criteria although multiple states can be selected So the query would have the following form criterial AND criteria2 AND state states OR state states2 or AND criteria 3 4 SchedBlock search Project Tracker can search for individual SchedBlocks To perform a SchedBlock search we must click on the SchedBlock search button at the top left of the main window The panel displayed is similar to the project one but it has an extra panel collapsed by default labeled with a Bands and coordinates title header PI Name Project Name Project ID Percen

Project Tracker Operations Manual

Contents

Download Pdf Manuals

Related Search

Related Contents