Archive

The Archive view represents a visual view of the data stored in the Yamcs archive. Through this view we can also initialize and control replays of archived telemetry.

User Interface

The Archive view always works on a range of indexed data, which it fetches from the server. All further actions like zooming happen client-side on the loaded data range.

Choosing a Data Range

As a first step you should select your data range. Click the pull-down icon Pull-down Menu to bring up this menu:

Choose Data Range

You can choose one of the predefined half-open time intervals, or you can select Custom… to specify your preferred range. Ranges can be half-open, which means they will always grow to include more bordering data as it becomes available.

If you choose for example Last Day, Yamcs Studio will fetch an index of the archive for that time period, and refresh your view.

Your chosen data range is stored in your user preferences and will be restored the next time you open Yamcs Studio.

Selecting Data

If this is the first time you have opened Yamcs Studio on your workstation, you won’t see anything other than some empty zones named:

  • Completeness Index APID
  • TM Histogram
  • PP Histogram
  • CMDHIST Histogram

Archive with Hidden Data

You need to choose which index data you actually want to display in your view. If there is data available for a zone, you can right-click it to bring up a pop-up menu where you select Add Packets > … > All Packets. Your view will then update to show the selected packets.

We say packets since this is typically what we are interested in when browsing the Archive, but any recorded data can in reality be displayed through the Archive view.

Archive

Note that the view does not refresh itself, so hit Refresh Refresh whenever you want to load the latest data for your selected time range.

The vertical red locator shows the current time as provided by Yamcs. When we hover the mouse over the view, a greyed-out locator indicates the current mouse position.

It is also possible to Zoom In Zoom In or Zoom Out Zoom Out. If you are interested in a specific range, select a time range by clicking and dragging your mouse over the range before you zoom in using the zoom in button.

Notice that as you are zooming in and out, a horizontal scroll bar appears. This allows you to scroll left and right within the initially load time range.

To clear your zoom stack, select Clear Zoom Clear Zoom.

Replaying data

We can use this view to replay archived data. Click Replay Replay.

Replay Dialog

In the dialog box, confirm or filter the suggested selection of data. Currently only telemetry packets and processed parameters that were made visible in the Archive are part of the selectable data.

Modify Start At to the time and date you want to start the replay from.

Yamcs will create a processor (next to the built-in realtime processor) with the name that you provide in the Name field. The exact name that you choose is of no importance (although it needs to be unique), it helps you to identify the processor.

Click OK to start the replay. Yamcs Studio will reset any operator displays you may have opened, and will automatically switch to the newly created replay processor, as visible in the processor indicator in the top-left of your window.

Replay Processor

Notice also that the Archive view is now equipped with an additional control bar.

Replaying

The red locator shows you the current time of the replay processing. Double click anywhere to the left or to the right to make the processing jump to another point in time.

Click Pause Pause to pause the processing, and use Forward Forward to increase the speed of the processing. This button currently cycles through 5 predefined speed steps.

Original Speed
2x Original Speed
4x Original Speed
8x Original Speed
16x Original Speed

Speeding up will not cause any reset of your displays, as the same data is arriving, just faster.

When you want to leave the replay, there are several possibilities to follow:

  • Hit Return to Realtime Return to Realtime;
  • Open the pull-down menu ▼ next to the Replay Replay button to choose a different processor;
  • Click on the processor info bar in the top left of the window, to choose a different processor.