The noise-pdf-browser web service returns browsable views of PDF noise plots.
There are three service query methods:
Produces a grid of PDF images where the columns are selected calendar intervals (for example months) while the rows are selected targets.
For specified target, produces a plot of a calendar interval (for example a year) along with plots of the sub-intervals (for example months) that comprise it.
Produces a column of spectrogram images for selected targets and time range.
Produces a list of targets with the date-ranges of available PDF information.
- Overview of Service
- /gallery method
- /breakout method
- /spectrogram method
- /summary method
- target selection
- Simultaneous Request Limitations, Lazy Image Loading and Printing)
- See Also
Overview of Service
The noise-pdf-browser web service provides a calendar centric view into the Probability Density Function (PDF) information generated by the mustang system. Along with allowing for the discovery of what PDF calculations have been made, the service makes it possible to quickly discover instrument noise characteristics problems and to pinpoint the dates at which these problems have happened.
/breakout methods use date range intervals. Five types of intervals are supported:
all interval represent the entire time range of PDF measurements for any given target. The
year interval represents regular calendar years. The
month interval represents regular calendar months. The
week interval represents weeks running Sunday through Saturday. The
day interval represent regular days. All dates are GMT.
interval parameter is used to select the desired calendar interval type; for example
/gallery method displays a grid of PDF images. The horizontal rows are selected targets. The vertical columns are calendar intervals. For example, if
interval=year is selected, the columns might be the years 2001, 2002, 2003 and 2004. If no
interval parameter is specified,
interval=year is used.
maxintervals parameters select which years, months, weeks or days are displayed.
interval=all is chosen, rows are grouped by the first three letters of the channel name.
interval=all is chosen, the
maxintervals parameter is ignored. The
endtime parameters can be used to time-window the displayed data.
starttime not specified.
endtime not specified:
The most recent intervals, for which there is data available for the selected targets, are displayed. If the
maxintervalparameter is not specified, at most 4 intervals are displayed. Example: If the most recent PDF data available was in the year 2016 and interval=year&maxintervals=5 were selected, the years 2012, 2013, 2014, 2015, 2016 would be shown.
endtime not specified:
The earliest intervals, going back in time to the given
starttime, for which there is data available for the selected targets, are displayed. If the
maxintervalparameter is not specified, at most 4 intervals are displayed. Example: If PDF data is available from 2000 to 2010 and interval=year&maxintervals=3&starttime=2001-01-01 were selected, the years 2001, 2002, 2003 would be shown.
starttime not specified.
The most recent intervals, going forward in time to the given
endtimefor which there is data available for the selected targets, are displayed. If the
maxintervalparameter is not specified, at most 4 intervals are displayed. Example: If PDF data is available from 2000 to 2010 and interval=year&maxintervals=3&endtime=2009-01-01 were selected, the years 2006, 2007, 2008 would be shown.
All intervals overlapping (either partially or completely) by the specified time range are displayed.
maxintervalscannot be specified. Example: If PDF data is available from 2000 to 2010 and ...@interval=year&starttime=2001-01-01&endtime=2004-01-01@... were selected, the years 2001, 2002, 2003, 2004 would be shown.
Important Note On Interval Selection
endtime parameters select which calendar intervals are displayed. They do not clip those intervals. The intervals which are selected are those that overlap with the selected data range;
endtime exclusive. However, this behavior is different for
endtime clip the display data.
Assuming data is available, the following table illustrates what years would be returned for the given parameters:
||2000, 2001, 2002, 2003, 2004|
||2000, 2001, 2002, 2003, 2004|
||2000, 2001, 2002, 2003, 2004, 2005|
||1999, 2000, 2001, 2002, 2003, 2004|
/breakout method displays one main interval and the sub-intervals which cover it.
||years available for the selected target|
||months available for the selected year and target|
||days available for the selected month and target|
||days for the selected week and target|
The selected main calendar interval is determined by the
interval parameters. The
time parameter defaults to the current time.
The selected calendar interval will include the given
time (start inclusive, end exclusive).
For example: both
interval=year&time=2001-11-11 will select the year 2001
/spectrogram method displays spectrogram images for the selected targets and time ranges.
Plot date range selection and display
For any given request, the generated spectrogram plots will all have the same date ranges. If
end[time] parameters are specified, the generated plots will reflect those date range limits. If
end[time] parameters are not specified, the time ranges of the generated plots will be determined by the earliest and/or latest dates of measurements available for the selected targets.
By default, displayed spectrograms will have dimensions of 1000 × 500 pixels. The
imgheight parameters allow this to be customized. They are passed to the spectrogram service as its
Plot Power Range
By default, displayed spectrograms will have auto generated power ranges. Although this is useful for identifying visual patterns in the spectrograms, it can be useful to have all displayed spectrograms use the same power range. This is accomplished with the
powerrange parameter. The
powerrange parameter is passed to the spectrogram service as its
plot.powerscale.range parameter. It takes two comma-separated integers. The order of the numbers does not matter.
It is also possible to adjust how power ranges are auto generated. This is accomplished with the
autorange parameter. It takes a number greater than zero (0) and less than or equal to one (1). The number determines which percentile values of range will be used. The default value is
0.95. If a value of
1.0 is selected, the full power range of the spectrograms will be displayed. This generally will have a washed out appearance as most spectrograms contain a few extreme outliers.
Differencing power levels to noise models and median values
output parameter, which is passed directly to the spectrogram service determines what the plots display.
output value is
power. With this value powers are directly displayed.
output=powerdlnm will difference the power values to the Peterson low noise model.
output=powerdhnm will difference the power values to the Peterson high noise model.
output=powerdmedian will difference the power values to the median power levels per frequency for the selected date range per target. This is especially useful for highlighting noise level changes.
Custom Noise models
noisemodel.byperiod parameters make it possible to specify custom noise models for noise level comparison. The values associated with these parameters will be directly passed to the spectrogram service via identically named parameters. See Spectrogram Noise Model Comparison for more information.
Please note that the
noisemodel.byperiod parameters will only effect displayed plots when
output=powerdnm is specified.
Custom noise models can be generated using the
noise-pdf webservice. See PDF Noise Profile Options
/summary method displays a list of available targets and the date extents of available PDF measurements. It provides hyper-links to the
/breakout view with
There are two ways to select targets.
- Use the
Target selection for /breakout method
/breakout method allows for only one target to be selected. Therefore, wildcarding is not allowed.
Two ways to select the same target in the breakout method:
Target selection for /gallery and /summary methods
Target selection is flexible. Any combination of the
quality parameters can be used.
/summary methods allow for multiple targets to be selected.
Wild carding and CSV lists:
quality parameters take glob style wild carding characters * and ? as well as comma separated values CSV list.
- select all channels starting with BH:
- select BH1 BH2 and BHZ channels:
- select two targets:
Automatic wild carding:
If any of the
quality parameters are selected, any of the non-selected parameters will be wild carded.
network=IU&channel=BHZ will select all of the targets with channel names BHZ in the IU network:
Simultaneous Request Limitations, Lazy Image Loading and Printing
If the Mustang PDF plotting service (http://service.iris.edu/mustang/noise-pdf/1/) receives too many simultaneous requests from any given client, the offending client will be shut out for 60 seconds. The
/breakout services are capable of producing HTML output with image links to this service that will cause web-browsers to reach this limit. In order to prevent this from happening, the HTML output made by the
When printing from a web browser, it may be necessary to scroll all of the images into view before printing.