Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Field nameContentExamples
Scheduler

Type of scheduling to use. Default is to use the dynamic scheduler, so scheduling units are picked up automatically, but it is possible to specify fixed time scheduling.

Dynamic
Fixed time

time atRun observations at this specific time. Only use this if really required, e.g., the target is also observed with another telescope. Specifying this option circumvents priority scheduling and should be used with care.
time after

Minimum start time of this scheduling unit. Default: start of cycle

(info) Observations will by default also be scheduled only in the cycles connected to the project.

2021-06-01 00:00:00
time beforeMaximum end time of this scheduling unit. Default: end of cycle2021-11-30 23:59:59
time betweenOnly schedule within the time windows specified here. More time-windows can be specified by pressing the + button below. This can be used to distinguish observations that should run monthly be specifying a few days where these observations could run.From: 2021-07-08 00:00:00
Until:
2021-07-10 23:00:00
time not betweenDo not schedule within the time windows specified here. More time-windows can be specified by pressing the + button below.From: 2021-07-08 00:00:00
Until:
2021-07-10 23:00:00
Daily

require_day : Day time observations. Run when the sun is higher than 10 degrees above the horizon at the Superterp.

require_night : Night time observations. Run when the sun is lower than 10 degrees above the horizon at the Superterp.

avoid_twilight : Avoid sunrise and sunset. Run when the sun is higher than 10 degrees above the horizon at the Superterp, or lower than 10 degress below the horizon.


transit_offsetOffset in (UTC) seconds from transit for all target beams in the observation. Alternatively, use you can specify the reference pointing as the reference for transit. When the observation is split into shorted chunks to be observed at different LST ranges. Please take into account a one minute gap between subsequent observations.from -7200 to 7200
from -7200 to -3600
from 3600 to 7200
min_distance

Minimum distance to the Sun, Moon and Jupiter (latter mostly relevant below 30 MHz) in degrees (backend uses radians).

Current default 30, or 28.64 degrees

Sun: 30
Moon: 30
Jupiter: 30 (< 40 MHz ) else 15
min_elevation.targetMinimum elevation for all SAPs in the target observations
min_elevation.calibratorMinimum elevation for the SAP of all calibrator observations
Reference pointing

If true, will be used for scheduling calculations taking into account the transit_offset

Note: If used, the reference pointing direction should be identical to the tile beam pointing direction (for HBA).

enabled=false

enabled=true
pointing.angle1=12h30m00s
pointing.angle2=50d00m00s
pointing.reference_frame=J2000
pointing.target = LST=12.5

...

Task ParameterPresent in these strategiesDescriptionExamples
Duration All except BF FE - Ionospheric Scintillation and FE RT TestObservation duration in hour:min:sec. For HBA strategies there are additional duration fields for the calibrators and/or additional targets/beam pointing. Similarly some modes have Target Duration which is given in seconds.

00:02:00 (hour:min:sec)

28800 (sec)

Observation Description All except BF FE - Ionospheric Scintillation and FE RT TestUsually target (and/or calibrator) name

OOO.O _Target_name_

FRB YYYYMMDDA

Paaa+01 & Paaa+02

Pipeline Description All except BF FE - Ionospheric Scintillation and FE RT TestUsually target pipeline (and/or calibrator pipeline) name

oOOO.O _Target_name_

FRB YYYYMMDDA/pulp

Paaa+01/TP

Target Pointing All except BF FE - Ionospheric Scintillation and FE RT TestDefine pointing to target(s and/or calibrator(s)) given in Angle 1 (RA), Angle 2 (DEC), Reference frame (J2000) and target name

Angle 1: 02h31m49.09s

Angle 2: 89d15m50.8s

Reference frame: J2000

Target: _Target_name_

Digifil optionsBF CV FRB

Relevant options for siggle-pulse searches

DM: 0.0001

Nr of Frequency Channels: 320

Coherent Dedispersion: true

Integration time: 4

Raw outputBF CV FRB and BF CV Timing ScintillationWhether to include the raw data in each output data product

false

true

Sub-band per fileBF CV FRB and BF CV Timing Scintillation

The maximum number of sub-bands to write in each output data product.


20

Optimize period and DM

BF CV Timing Scintillation and BF Pulsar Timing

false

true

Sub-integration time

BF CV Timing Scintillation and BF Pulsar Timing
10

Frequency channel per file

BF CV Timing ScintillationNumber of frequency channels per part (multiple of subbands per part).120
Duration FE (1..4)
BF FE - Ionospheric Scintillation, FE RT Test and Solar CampaignDuration of (one of the) the fly's eye (FE) observation in seconds. Needs to fit within the overall SU duration.
300 (sec)
Description FE (1..4)
Solar Campaign
IPS FE1
Pointing FE (1..4)
Solar CampaignDefine FE pointing given in Angle 1 (RA), Angle 2 (DEC), Reference frame (J2000) and IPS name

Angle 1: 02h31m49.09s

Angle 2: 89d15m50.8s

Reference frame: J2000

Target: _Target_name_IPS

FrequencyIM HBA 1 beam and IM LBA 1 beamFrequency range of the observation, i.e. bandwidth covered.

LBA: 21.4-69.0

HBA: 120.2-126.7,126.9-131.9,132.1-135.3 etc.

Sub-bandsIM HBA 1 beam and IM LBA 1 beamSub-band numbers specification (alternative to frequency). For Range enter Start and End separated by 2 dots. Multiple ranges can be separated by comma. Minimum should be 0 and maximum should be 511. For example 11..20, 30..50

false

true


HBA: 104..136,138..163,165..180,182..184,187..209,212..213, etc.

Run adderIM HBA 1 beam, IM LBA 1 beam, IM HBA LoTSS 2 beam and IM LBA LoDSS 5 beamDo/Don't create plots from the QA file from the observation

false

true

Tile BeamIM HBA LoTSS 2 beamHBA Only, insert pointing of the tile beam given in Angle 1 (RA), Angle 2 (DEC), Reference frame (J2000) and target name. Should be between (average of) the SAP pointings.

Angle 1: 02h31m49.09s

Angle 2: 89d15m50.8s

Reference frame: J2000

Target: Paaa+01Paaa+02REF

FilterIM LBA 1 beamBandpass filter applied

LBA_10_90

HBA_110_190

Antenna setIM LBA 1 beamSelect the antenna mode to observe with

LBA_SPARSE_EVEN

HBA_DUAL_INNER

Time averaging steps

IM LBA 1 beam, IM LBA 1 beam and IM LBA Survey 3 beamFactor used to average the data in time2

Freq averaging steps

IM LBA 1 beam, IM LBA 1 beam and IM LBA Survey 3 beamFactor used to average the data in frequency3
Demix pipelineIM LBA 1 beam and IM LBA Survey 3 beam.Given in several drop-down menus per target/calibrator where the user can select what sources to demix. Note that the time step and frequency step in this menu have to be multiples of the previously defined averaging steps.

Sources: CasA, CygA, HerA, HydraA, TauA, VirA

Time step: 8

Ignore Target: false

Frequency step: 64

...

It is possible that an observing session failsresults in bad data. This can be either due to not matching the requirements specified in the tasks or due to external circumstances (e.g. observing conditions poor). This It means that the data can't be accepted, so the corresponding flag needs to be set. It requires the FoP to:

    • Set the corresponding SU data acceptance flag to 
      Status
      colourRed
      titlefailedfalse
      (see procedure below)
      Evaluate if repeating the failed observing session described by the . Warning: This should be done using the QA workflow interface, but a manual procedure using the TMSS API is also available.
    • Evaluate if repeating the failed observing session described by the failed SU is within the policy for the project (i.e. check priority and if the failed session was already a repetition)
    • If possible, add more tasks to the SU; to this aim new tasks can be added in a SU by using in the "Scheduling Unit - Details" menu and then clicking on the 'paper-and-pencil' icon next to the "Task Details" section. 
    • If possible repeat the process of specification and submission by generating a copy of the SU draft; to this aim copy the failed blueprint of the SU to a (renamed) draft SU and blueprint it. In this case, make sure that the new SU does not retain any fixed timeslot from the failed copy. Also, make sure that any archived data related to the failed SU to be removed from the LTA via opening a ticket in the Helpdesk (project users) or directly cleaning up the archive (for SDCO operators).

In order to set a SU data explicitly to

Status
colourRed
titlefailedfalse
the following procedure can be used:

...

    • To confirm the change, we click the 'Patch' button at the bottom of the page.
    • Now, the SU data acceptance flag will be set to
      Status
      colourRed
      titlefailedfalse
      , and any related (also pinned) data to the SU will be deleted, or have to be deleted manually if the SU was set to failed prior steps were performed before the associated cleanup task has run.
    • If data were archived, an LTA cleanup action can be requested by project users via opening a ticket in the Helpdesk or directly performed by SDCO operators.

...

Each of the users / roles in the workflow steps can approve or disapprove of the data quality and enter an appropriate comment. The approval state is reflected by the state of a checkbox at the bottom of the page after all of the user roles have decided on the QA state. Then, the QA assessment is finished, and the PI has an overview of the procedure. The data is unpinned / deleted or archived depending on the QA outcome. The Data Accepted columnin the blueprint listing on the TMSS project view page will indicate whether data for a given executed SU blueprint is accepted or not (false).

Please note that SDCO is still using the Jira system for handling observation reports . After the observations and subsequent processing are completed, the PI and project users will be notified to complete the QA workflow via the Jira ticket associated to the project and the requested data products will be made available through the Long Term Archive (LTA) as soon as possiblecorresponding ticket.

The Radio Observatory will not have the opportunity to check all data manually before it is exported to the LTA, although some automatic diagnostics are generated for system monitoring, and offline technical monitoring will be carried out regularly. The FoP or the expert user in charge of project support will send to the project PI a notification after each observation with detailed information on where to find the relevant plots. The project team is encouraged to analyze the data, at least preliminarily, soon after the observations, and to get in touch through the ASTRON helpdesk about any possible problems. Observations that turn out to have an issue that makes them unusable may be considered for only one re-run, as soon as the observing schedule allows.

...

As a contact author, you will be notified by e-mail or by JIRA ticket if new reports are ready for inspection. Please make sure you can receive e-mail from (TODO: add sending address). You will see (TO DO: add screenshot).
You ASTRON domains. You can also see all assigned tasks to you by going to the workflow page and filtering on "assigned to me".

You are asked to confirm you will accept the data. Please write your confirmation or rejection in the box. In case there are issues that you want to raise for which you consider not accepting the data, then please add in the comment box and untick the "PI accepts box". For the data policy, please consult (TODO: add link)the relevant information page. Your friend-of-project will contact you in JIRA for the final decision on what to do with the data. After this period you still have 4 weeks for a detailed data inspection. In case there are issues, please report them in JIRA. Please note that in case you do not accept the data, this data cannot be used and should be removed from your systems. We will also remove them from the LTA. A repetition will be scheduled instead if your observation is eligible for one, see again the policies.

...