Skip to content

Releases: LLNL/coda-calibration-tool

CCT 1.0.16

18 Mar 19:39
Compare
Choose a tag to compare

CCT Release 1.0.16

Changes

  • The Site and Measurement results now include a flag in the results and a visual indicator on the plots if we believe the inversion is likely to be poorly constrained.
  • Added a new toggle button to go into and out of click-to-pick mode for moving f-markers in the waveform views.
  • The multi-waveform display panel will now follow custom sort orders, if they are set, when browsing the data tab.
  • New site term and relative site term plots in the site tab
  • Updates and changes to styling, labels, locations, etc. of information and plots based on user community feedback.

Bugfixes

  • Fixed a small bug where the f-marker was occasionally plotting incorrectly when moving the marker rapidly in f-picking mode.
  • Fixed a bug that was sometimes stopping the validation details from being added to the summary table.
  • Fixed a problem where sorting in the data table was being disabled while a filter was active.
  • Fixed a library bug that was reporting the julian date incorrectly.

CCT 1.0.15

23 Dec 20:09
4b866da
Compare
Choose a tag to compare

CCT Release 1.0.15

  • Added a new station count filter to the path plot. Now the overall standard deviation plot will only display points with shared station counts >= the selected filter count. The data is still used for calculating statistics and doing the inversion, but eliminating the dots from the plot for low information points can help see if the overall correction is working well.
  • Updated displays for site and measurement tabs to move additional details on the summary figure to a sidebar column.
  • Updated site and measurements results figures to also output the three new energy plots on snapshot.
  • Added minimum and maximum coda parameter time lines to coda waveform plots. The min and max times reflect the relevant entry in the parameter table but the maximum is only displayed if it would fit on the waveform plot.
  • New updates to the way polygon selection works:
  • Changed the criteria for include/exclude to work against stations and events separately rather than treating them as a joint entity. You give up a little bit of control but the new logic should be more intuitive for end users based on feedback.
  • Polygons now can handle overlapping polygon regions and degenerate (self intersecting) polygons when calculating include/exclude intersection.
  • Includes patches to third party libraries to address critical CVEs

CCT 1.0.14

11 Nov 22:20
Compare
Choose a tag to compare
  • Refactored the spectral plot displays for site and measurement tabs:

    • Removed the “Path Corrected” spectra and moved the “Raw” spectra to a collapsed tab.
    • Added three new plots to the results tab: log moment vs apparent stress, log moment vs corner frequency, and log moment vs energy
    • Updated the headers with new styling for better visual distinction
    • Updated the labels to better reflect group consensus and add additional values of interest
  • Added group velocity lines to coda waveform plots. The start and stop times are calculated based on the critical distance and velocities found in the parameter table. The velocity lines are note plotted by default but may be toggled on using the 'GV' button on the top bar of the waveform plots.

  • Updated the plots so that when a selection event happens, the f-marker is moved as well. This allows the f-marker to be moved by clicking on the plotted waveform.

  • Added an alpha configuration example for how to build a CCT GUI docker image from an Ironbank UBI container. It can be found in the docker folder at the top level of the repository.

CCT 1.0.13

13 Sep 23:30
Compare
Choose a tag to compare

This release adds two significant features including the addition of energy calculations (BETA) and a new data table filter feature.
In the current beta code we have integrated theoretical spectra to determine empirically the necessary integration constant to give the correct energy value. In the final version of the code we will tie this to the analytical form of the seismic energy.

Features and Improvements

  • Energy calculation feature (BETA) is based on Mayeda, K., and Walter, W. R. (1996), with updates made for CCT
    • Converted the energy calculation algorithm to MKS units
    • Utilized a numerically derived term for the k constant, analytical form derivation in progress
    • Reformulated the p-Wave contribution from a constant of 7%, as in Mayeda, K., and Walter, W. R. (1996), to a derived formula using the MDAC paramaterization based on Walter and Taylor, 2001
  • Implementation of energy calculation feature includes the addition of new data columns containing calculation results
  • Added total energy calculation values to be displayed in the area directly above spectral plots
  • Renamed spectral plot FIT as Mw_coda
  • Added a data filter feature that allows users to filter the results displayed in a data table by event id, station etc.
  • Updated data tables to show a filter icon in the column headers, which will open the filter dialog
  • Included auto-completion and search of filter terms within the filter dialog feature

CCT 1.0.12

15 Jun 18:51
Compare
Choose a tag to compare

Features and improvements

  • This release is focused around replacing all of our plots with new HTML5 based plots that utilize PlotlyJS and D3.js.
    • Our existing plotting codes have been moved to the llnl.gnem.core.gui.swing package.
    • All plots now share a common look-and-feel and have a common interface through the toolbar available by mousing over the top right corner of each plot.
    • New plots all support export via SVG in addition to existing snapshot functionality.
  • We now have navigation buttons on the top bar of the waveform display when you are looking at a single waveform that allow you to quicky navigate to different frequency bands for that event/station pair.
  • Added a menu item under the Data menu item to mark all picks in a data set as reviewed.
  • Additional data exposed in the UI based on user feedback.
    • Added depth and julian day information in site/meas event view.
    • Added an ISO 8601 date column to the results tables.
    • Added station count and frequency band coverage QC metric columns in the results tables.
    • Added network code column to the data and parameter tables.
  • Waveform plots are now aligned on the time axis such that 0 aligns to the event origin time.
  • Site and measurement tabs for individual events now only show stations that contributed measurements to that event.
  • Spectral plots now include a right Y-axis that displays the Mw value in addition to the existing Y-axis in log dyne-cm.
  • Spectral plot frequency axis is now plotting as log labels rather than the center frequency (label change only, no change to plot of data values).
  • Plots now allow turning elements on and off by clicking on the legend entry for that element.

CCT 1.0.11.1

30 Apr 18:40
Compare
Choose a tag to compare

This is a hotfix patch to address a bug report relating to the spectral fitting inversion and should supersede the 1.0.11 release.

CCT 1.0.11

02 Apr 20:18
Compare
Choose a tag to compare

CCT 1.0.11 Release Notes

Features and changes

  • Collapsed the envelope and common modules down into calibration and moved the envelope tool from a standalone app to a sub-application in the tool menu.

  • Updated the site and measurement Mw fitting algorithm to re-weight the fits by the standard error of the frequency band population in an effort to improve the fitting robustness and get better uncertainty estimates

  • Autopicking updates

    • Now a two-step iterative process where we first take the SNR end pick, compute shapes, measure the deviation of each fit against the frequency model, pick the divergence point, and then re-measure with the new endpoint as a variable.
    • See the new Parameters->Shape Constraints->Fit Length parameter to adjust the tradeoff of envelope length vs. misfit. The range is [0,1] and is the ratio of weight given to the length where 0 dis-regards length and 1 disregards misfit.
  • Constraint changes

    • Maximum stress changed from 10 to 100 MPa
    • Widened the path constraints in Joint1DPathCorrection to admit much higher Q values and allow longer crossover distances to support additional regions and higher frequency bands.
  • Adjusted the spectra truncation feature that is enabled when you have both a GT source spectra and Mw only reference events to use the MDAC sigma/psi-based falloff to compute the truncation corner frequency rather than an arbitrarily low value. This allows you to control how many bands on average are used for the Mw only events as site term constraints. This change was introduced for situations where the GT spectra events might not contain sufficient measurements below the corner frequency.

Bugfixes

  • Addressed three potential NPEs and nine potential resources handle leaks
  • Updated all the entry points to set the default locale to English to prevent numbers being converted from using periods in countries that use comma separators. This is a temporary workaround to prevent functional errors related to envelope creation and reading.
    Updates for the latest release versions of all dependencies.

CCT 1.0.10

14 Sep 16:31
Compare
Choose a tag to compare

CCT 1.0.10 Release Notes

Features and improvements

This is a smaller release focused around creating and using bounding polygons in the CCT map.

Mapping

  • Includes the Leaflet Geoman library to support drawing and editing bounding boxes and arbitrary polygons on the map
  • Support for importing and exporting polygons is now included as a field in the calibration JSON definition as a GeoJSON formatted block
  • Include/exclude options to toggle activation status on event/station pairs based on if they are bounded by a polygon
    • Excludes require that both the station and the event meet the criteria, that is inside or outside the polygon, to be selected for disabling
    • Includes require that either the station and the event meet the criteria, that is inside or outside the polygon, to be selected for enabling
  • Added REST endpoints for managing polygon related tasks via service calls as well

Plotting

  • Site/Measurement now plot the estimated corner frequency (~Fc) line on spectral plots when a fit is available.

CCT 1.0.9

15 Jul 23:50
Compare
Choose a tag to compare

CCT 1.0.9 Release Notes

Features and improvements

Validation events

New support for having validation events in addition to reference events.

  • Do not alter the calibration or measurements and are intended to serve as a way to compare asssessments.
  • Appear as black squares in the Mw related plots and as a blue dashed line in the spectra plots.
  • Can be created from reference events by selecting the reference event in the table and right-clicking->"Toggle Validation".
  • Two new related columns for validation Mw and validation stress in the Mw tables; hidden by default in the expanded column list ("+").

Mapping

  • The map now includes a scalebar and distance measurement tool.

Miscellaneous

  • Site/Measurement now share a common set of diagnostic plots for easier validation during routine measurement.
  • Added event depth field to the headers on the envelope tool output, a column for depth on the data tab, and to the JSON in/output for calibration.
  • Support for cancelling in progress calibrations.

Bug-fixes

  • Corrected an issue when plotting waveforms with synthetic models producing exactly one point at the given time-scale for the plots.
  • Corrected a pagination bug with the multiple-waveform plot when plotting waveforms >= page-size but < 2 * page-size.

CCT 1.0.8

10 Mar 22:58
Compare
Choose a tag to compare

CCT 1.0.8

New features

  • MW spectra truncation
    • When a calibration is performed with events with and without apparent stress both loaded
      • Those events with apparent stress values are treated as GT spectra and will not use the loaded MDAC model. These events will impact the site term fitting across the entire frequency spectra.
      • Those events with only Mw values will be treated as a constraint on the magnitude by setting a very low apparent stress value and truncating the spectra at the computed corner frequency. In effect these events can still influence your overall site correction terms at the low frequency, and thereby help constrain the Mw value, but don't contribute to the roll-off shape of the spectra overall.
    • Enabled by default you can toggle the old behavior back on via the --spectraTruncationEnabled=false flag at runtime.
  • BETA UQ measurements for the final spectra results in calibration and measurement
    • The confidence regions presently generated are relative to the optimizer's inversion walk on the theoretical spectra model vs. the measured values. This should be interpreted as the inversions confidence in finding a global minimum in the model misfit and should not be treated as a confidence on the data itself.
    • A variety of metrics that can be diagnostic for QC, including misfit and data counts per event, are now reported in the Mw tables and exported JSON.
      • e.g. A model may have a very low misfit, and tight confidence bounds, but still be suspect due to having good spectra coverage on only the long period level at a few stations.
    • These metrics are very much a work in progress but can be useful and community input on additional reporting that may prove useful is welcome.
  • Persistent measurement intermediary artifacts
    • Measurements will now save auto-picks, synthetics, and various other intermediary measurements that a calibration would typically be recording to support iterative QC from the GUI when looking at the spectra and inspecting related waveforms.
    • The GUI has this feature enabled by default for the interactive workflow.
    • The REST API now includes options to enable/disable this function (disabled by default)
  • Capability to export diagnostic plots as images
    • Export individual plots to SVG where possible
    • Export specific overall views as high resolution PNGs
    • Export polygon based map layers as SVG (icons, events, paths, etc)
    • Export raster based map layers as high resolution PNGs (aerial imagery, topography, lithography, etc)

Improvements and Bugfixes

  • Significant performance improvements to the envelope tool across the board when generating envelopes.
  • Minor performance improvements on Path calibration.
  • Corrected an envelope stacking bug related to performance (no behavior changes).
  • Updates to support very long, very low sample rate envelopes w.r.t. shape fitting and envelope creation.
  • Updated the example notebook to have the latest API changes for the REST endpoints.