NSF SAGE Facility MUSTANG metrics Web Service Documentation

ts_percent_availability Instantaneous percentage of data available per day


This metric reports the percentage of data available for each 24-hour window calculated at query time. 100% data available means that data for the reported start and end time is complete. It calculates availability based on information stored in the rapidly-accessible IRIS SEED and PH5 archive database indexes (ts_index), as returned by the service.iris.edu/fdsnws/availability web service or the service.iris.edu/ph5ws/availability web service.

In contrast, the standard MUSTANG percent_availability metric retrieves and analyzes the archived time series in order to calculate availability, which is a much slower process. Measurements for percent_availability are calculated according to a schedule and updated regularly, but their values reflect the completeness of the archive when the measurement was made (lddate) rather than at query time.

The ts_percent_availability metric is currently a prototype that will eventually replace the standard MUSTANG percent_availability metric.


ts_percent_availability values can be averaged to give data completeness for a channel over an integer number of days. The metric also indicates whether or not data for a given channel/day is available for request from the IRIS DMC.

Data Analyzed

Traces – one N.S.L.C (Network.Station.Location.Channel) per measurement
Window – 24 hours starting at 00:00:00 UTC
Data SourceIRIS archive database time series index (ts_index)

SEED Channel Types – All Time Series Channels


  • Assemble availability web service trace extents for 24 hours on each matching N.S.L.C.
  • Sum the data gaps in seconds for this period of time.
  • Calculate the percentage from the ratio of data found (omitting gaps) to data expected for the full day:
    percent_available = 100 - ( 100 * gap_seconds / total_seconds )

Metric Values Returned

value – availability of data expressed as a percentage
target – the trace analyzed, labeled as N.S.L.C.Q (Network.Station.Location.Channel.Quality)
start – beginning of the data day requested (00:00:00 UTC)
end – end of the data day requested (truncated as 23:59:59 UTC)
lddateUTC date/time the measurement was made


If the user specified end date does not include hour:min:sec, then it defaults to 00:00:00

If the requested start time is earlier than the metadata start time for the station-channel, the first 24-hour day returned will be 00:00:00-23:59:59 UTC for the day the metadata begins.

If the requested end time is later than the metadata end time for the station-channel, the last 24-hour day returned will be 00:00:00-23:59:59 UTC for the day the metadata ends.


  • Robert Casey


See Also