Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DraftMASTDOCS and version 22.07
Excerpt
hiddentrue

Create subscriptions to receive updates about observing program data

Panel
borderColor#00617E
borderWidth2
borderStylesolid

On this page...

Table of Contents
maxLevel3
indent24px

Status of Program Data from Active Missions

You may elect to be notified automatically when data from an HST or JWST observing program

:
  • first appears in the Archive,
  • is reprocessed for some reason, or
  • becomes available to the public after the expiration of the Exclusive Access Period (EAP).

are first archived, are updated, or become publicly available.

On this page...

Table of Contents
maxLevel3
indent24px

Anchor
subscriptions
subscriptions
Creating Subscriptions

Setting up notifications requires logging in to the Portal, setting up a subscription, and specifying how you prefer to receive notifications.

Note

Subscriptions can only be created for certain missions, i.e., those for which STScI operates calibration processing pipelines: HST and JWST.

Creating Subscriptions

There are two ways to create subscriptions to data: through the subscriptions manager, and through the actions menu for individual observations in the Portal results table. The methods are described below.

Note

Subscriptions can only be created for HST and JWST observations.

Notifications are generated when certain events are triggered on data to which you are subscribed.

Anchorsubscriptions

These events map to the subscription type, which is one of: 

  • New: Triggers whenever any data for a program appear in MAST for the first time
  • First: Triggers when the first data for a program appear in MAST (JWST only) 
  • Reprocessed: Triggers when existing program data in MAST have been reprocessed by the pipeline as a result of improved calibration software or reference files
  • Public: Triggers when data for program transition to "public" access from "exclusive access" protection (EAP) 
Tip

Subscriptions may be created for any program, even before data appear in MAST.

subscriptions

Subscriptions Manager

If you wish to be notified about processing events that relate to an observing program, even before any observations have been executed, use the subscriptions manager as described below.


InstructionNotes
1Login to the Portal. Then click Subscriptions… in the login panel located on the upper-right.

Portal log-in dialogImage Modified


The subscription manager will appear, which will look similar to the image below.

Portal subscription managerImage Added

2Click the Add button at the upper-right of the Subscriptions manager.

3

Create subscriptions to one or more programs with the pop-up menu, specifying the type (email or via the Portal) and frequency. You can specify the method of notifications as both the portal and via email by creating separate subscriptions, one with each type.

When creating subscriptions...

:

  • Notification Type (Email or Portal)
  • Notification Frequency (Fast, Daily, Weekly, Monthly)
  • Specify the
  • Mission (HST or JWST)
  • The subscription type is one or more of:
    • New: Triggers whenever any data for observation appears in MAST for the first time
    • Reprocessed: Triggers when existing data in MAST have been reprocessed by the pipeline
    • Public: Triggers when data for an observation transition to "public" access from "exclusive access" protection (EAP) 
    • First: Triggers when the first data for a program appears in MAST (JWST only) 
  • Type the Proposal ID.
Tip

Subscriptions may be created for any HST or JWST program, even before data appear in MAST.

For a given Proposal ID, you may optionally specify the full Observation ID: that is, the unique identifier that corresponds to only one observation in a proposal.

Subscribers to JWST programs may optionally specify
  • Subscription Type (all; see above)
  • Proposal ID
  • Observation ID
  • Optional (JWST only: 2 or 3. Specify the data product level of calibration processing. Higher levels translate to more highly calibrated and combined data products.)
Tip
titleMultiple delivery methods

You can specify the method of notifications as both the portal and via email by creating separate subscriptions, one with each type.

The Portal subscription creation menuImage Modified

4Click the plus icon to create additional subscriptions. When finished, click the Save button.

5After establishing one or more subscriptions, you can modify the attributes by clicking the appropriate icon (edit, pause, delete). Pausing an individual subscription leaves the subscription in place, but turns off notifications.


Tip
titleContext help

Some additional information about Context help for subscriptions is available with the Help button  in the subscriptions window.

Note
titleCaveats

No validity check is performed on new subscriptions. Thus it is possible to subscribe to, e.g., a non-existent proposal or observation number. Naturally, you will receive no notifications from that subscription.

Selecting "Fast" notification frequency for a "Reprocessed" subscription type may result in very many notifications as program data are generated by the calibration pipeline. It my be preferable in this case to select a "Daily" notification.

Portal Actions Menu

If you wish to be notified of events related to individual observations after the data have appeared in MAST, you may subscribe via the Actions menu in the Portal results panel, as described below.


InstructionNotes
1

Login to the Portal, and perform a search for Observations of interest. 

Note

It is not possible to subscribe to data from the results of a JWST Instrument Keywords search.

Portal log-in dialogImage Modified

2

After a Portal search, choose a

result

row in the results table on which you would like to establish a subscription. Click the More Actions icon Image Modified on the Actions pull-down menu, and select Create a Subscription.

Image Modified

3Follow the instructions above, located under Subscriptions Manager.

Anchor
Update Subscriptions
Update Subscriptions
Updating Subscriptions

You may modify the parameters of existing subscriptions, suspend notifications, or delete them altogether using the Subscriptions Manager window.


InstructionNotes
1Login to the Portal, and bring up the subscriptions manager (see step 1 in the Subscriptions Manager instructions above).
2Select one or more rows, then click the Edit icon to bring up the editor menu.

Image Added

3

Check the boxes of the attributes you wish to edit, and select the changes with the pull-down menu(s). In this case, change the frequency of the selected subscriptions to Daily.

Then click the Save button.

Portal subscriptions editorImage Added

4Click OK in the pop-up confirmation dialog.

Pop-up message to confirm edit(s) to subscription(s)Image Added

You can delete a subscription entirely by clicking the trash can Image Added in any row, or select multiple rows and click the trashcan button.

Receiving Notifications

Notifications are batched into time intervals corresponding to the requested notification frequency. Multiple events of a given type (say, for reprocessing) will be combined prior sending a notification. "Fast" notifications are generated with a frequency of several minutes.

Note
titleNotifications occur for calibrated products

Notifications will only be generated for calibrated products. If pipeline processing terminates after generating only raw or intermediate-level products, no notification will be generated.

Email Notifications


InstructionNotes
1If the Notification Type was set to Email, users should receive an email from "Space Telescope Science Institute <noreply@stsci.edu>" when the designated milestone is reached.

Example email with a MAST notificationImage Modified

2

The email will provide one or more links:

  • Other links wil be present, one per progam. should Clicking one will open a browser tab with the MAST Portal, showing results for the subscribed program.

Portal Notifications


InstructionNotes
1If the Notification Type was set to Portal, users who are logged into the MAST Portal should see a notification (a bell icon with a number next to it) in the user login panel at the upper right.

Portal log-in dialog, with an indicator of an unread notificationImage Modified

2Clicking the bell icon in the login panel, will open a tab with all your Portal notifications.

Portal notifications managerImage Modified

3

Selecting the desired a notification will open a pop-up window with a link to query the MAST Portal for data from the subscribed program.

Tip
titleNotification Details

A single notification may contain information for multiple observations in the same program, depending on the user's subscriptions.

Portal notification message, with link to the dataImage Modified

4(Optional) You may delete individual or all selected notifications by clicking the trash icon.