{"id":19705888,"url":"https://github.com/llnl/coda-calibration-tool","last_synced_at":"2025-04-29T16:32:02.922Z","repository":{"id":27657981,"uuid":"114670393","full_name":"LLNL/coda-calibration-tool","owner":"LLNL","description":"Tool for calibrating seismic coda source models","archived":false,"fork":false,"pushed_at":"2025-02-26T21:26:37.000Z","size":43385,"stargazers_count":25,"open_issues_count":1,"forks_count":1,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-05T18:05:11.765Z","etag":null,"topics":["application","java"],"latest_commit_sha":null,"homepage":"https://software.llnl.gov/coda-calibration-tool/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LLNL.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-18T17:42:33.000Z","updated_at":"2025-03-07T05:22:56.000Z","dependencies_parsed_at":"2024-01-18T17:27:54.627Z","dependency_job_id":"45de811f-6582-49d2-b267-254ed449fbff","html_url":"https://github.com/LLNL/coda-calibration-tool","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2Fcoda-calibration-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2Fcoda-calibration-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2Fcoda-calibration-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2Fcoda-calibration-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LLNL","download_url":"https://codeload.github.com/LLNL/coda-calibration-tool/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251540283,"owners_count":21605875,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["application","java"],"created_at":"2024-11-11T21:31:27.401Z","updated_at":"2025-04-29T16:31:57.899Z","avatar_url":"https://github.com/LLNL.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Livermore logo](llnl-logo.gif)\n\n**Additional documentation is available at the project [GitHub pages site](https://software.llnl.gov/coda-calibration-tool/).**\n\n---\n\nThe `Coda Calibration Tool` (CCT) is a Java based application for calibrating 1D shear wave coda measurement models to observed data using a much smaller set of reference MWs calculated from other means (waveform modeling, etc.).\n\u003cbr/\u003eThese calibrated measurement models can then be used in other tools to generate coda MW measurements, source spectra, estimated stress, and other useful measurements against the rest of the events and any new data collected in the calibrated region.\n\n\u003e **_\u003csub\u003enote\u003c/sub\u003e_** \u003cbr/\u003e\n\u003e The `Coda Calibration Tool` currently only does calibration; it requires data to be pre-processed for loading using other tools.\n\n---\n\n## [Demo](#demo)\n\nhttps://user-images.githubusercontent.com/10851365/179833833-8bc0eadc-abf7-49b1-a831-9555675d3aa8.mp4\n\n\u003csub\u003eData courtesy of [Northern California Earthquake Data Center](http://ncedc.org/)\u003c/sub\u003e\n\n---\n\n## [Structure](#structure)\n\nCCT is split into three basic components.\n\nA REST service that consumes Waveform objects containing stacked coda envelope segments and information about the station and event locations. This service does all the actual calculations to calibrate the model.\n\nA JavaFX/HTML5/Swing GUI application that understands how to convert stack files (see [Data](#data)) to Waveform objects, interact with the REST Calibration service, and display useful diagnostic plots with the resulting data.\n\nAnd a wrapper project (Standalone) that combines both into a single runnable JAR file to allow end users to run the GUI and Service together the same way they would run any other desktop application.\n\nCCT is based on [Spring 5.0](https://spring.io/); primarily Boot and Data. By default, it uses a [H2](http://www.h2database.com/html/main.html) in-memory database for storing loaded Waveforms and the resulting calibration artifacts.\n\n---\n\n## [Building](#building)\n\nCCT uses [Apache Maven](https://maven.apache.org/) for building and dependency management.\n\nFrom the top level `coda-calibration` directory you can build the entire project using the parent pom by running:\n\n```shell\nmvn clean install\n```\n\n---\n\n## [Running](#running)\n\n#### **As a single runnable JAR**\n\n```shell\njava -jar coda-calibration/calibration-standalone/target/calibration-standalone-1.0.22-runnable.jar\n```\n\n#### **GUI alone**\n\n```shell\njava -jar coda-calibration/calibration-gui/target/calibration-gui-1.0.22-runnable.jar\n```\n\n#### **Calibration REST service alone**\n\n```shell\njava -jar coda-calibration/calibration-service/application/target/application-1.0.22-runnable.jar\n```\n\n#### A note about HTTPS\n\nIf you look at the REST service and the GUI client packages you might have noticed 'selfsigned.crt' and 'coda-truststore.jks' in the resources directory. CCT uses HTTPS by default and these are the default certificates we include for the handshake between the client and the GUI.\n\nYou can use these as-is or use your own by changing these properties using any of the [Spring external configuration](https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-external-config.html) mechanisms:\n\n- On the client:\n\n```text\nwebclient.trustStoreName\nwebclient.trustStorePass\n```\n\n- On the REST service:\n\n```text\nserver.ssl.key-alias\nserver.ssl.key-password\nserver.ssl.key-store\nserver.ssl.key-store-provider\nserver.ssl.key-store-type\n```\n\nThis additional step is recommended for deployments where the REST service is bound to a non-loopback adapter.\n\n---\n\n## [Data Formats](#data)\n\nAs of 1.0, CCT is capable of loading four basic file types\n\n1. Stacked coda envelopes\n\n   These stacked envelopes are filtered into the same frequency ranges as those defined in the coda model parameters (3). Presently, the CCT GUI only has converters for [SAC](http://ds.iris.edu/ds/nodes/dmc/software/downloads/sac/) files and, as a result, requires the file names to follow a specific format to capture the frequency band information.\n\n   ```text\n   STATION_CHANNEL_EVENTID_LOWFREQ_HIGHFREQ_UNITS_.*.env\n   (e.g. ANMO_STACK_999999_1.0_1.5_VEL_.env)\n   ```\n\n2. Reference events\n\n   A simple space delimited text file of format:\n\n   ```text\n   EVID MW [APPARENT_STRESS_IN_MPA|0.0]\n   (e.g. 999999 5.1 0.0)\n   ```\n\n   \u003e **_\u003csub\u003enote\u003c/sub\u003e_** \u003cbr/\u003e\n   \u003e The EVID here should match the one defined in either the KEVNM or NEVID (tested in that order) fields of the SAC files being loaded so the envelope waveforms can be associated correctly during calibration.\n\n3. Coda model parameters\n\n   This defines the frequency bands and some corresponding frequency dependent parameters to be used during calibration.\n   ​\n\n4. Phase and frequency model parameters for distance amplitude correction curves\n\n   \u003e **_\u003csub\u003enote\u003c/sub\u003e_** \u003cbr/\u003e\n   \u003e\n   \u003e While CCT supports loading MDAC2 model descriptor files, it presently only uses it for predicted source spectra.\n   \u003e As a result, the two parameters of most interest for calibration purposes are Psi and Sigma. These correspond to apparent or actual stress drop of the spectra depending on their values.\n   \u003e See the [additional reading](#references) for more information.\n\n---\n\n## [Contributing](#contributing)\n\nContributing to CCT is easy: just send us a [pull request](https://help.github.com/articles/using-pull-requests/).\n\nWhen you send your request, make `develop` the destination branch.\n\nThe `develop` branch contains the latest contributions, and `master` always points to the latest stable.\n\nIssues, suggestions, discussion, documentation, general code cleanup, and automated tests are also all valuable ways to contribute and are more than welcome!\n\nAny contributions are assumed to also be licensed for release as Apache V2.\n\n---\n\n## [Additional Reading](#references)\n\n[Mayeda, K.M., A. Hofstetter, J.L. O Boyle, W.R. Walter (2003). Stable and transportable regional magnitudes based on coda-derived moment-rate spectra, Bull. Seism. Soc. Am., 93, 224-239.](http://bssa.geoscienceworld.org/content/93/1/224)\n\n---\n\n## [Versioning](#versioning)\n\nWe use [Semantic Versioning](http://semver.org/) for versioning. For the versions available, see the tags on this repository.\n\n---\n\n## [License](#license)\n\nThe `Coda Calibration Tool` is provided under the [Apache License](LICENSE.txt).\n\n```text\n Copyright 2022 Lawrence Livermore National Laboratory\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n```\n\n---\n\n## [Disclaimer](#disclaimer)\n\n```text\n  This work was performed under the auspices of the U.S. Department of Energy\n  by Lawrence Livermore National Laboratory under Contract DE-AC52-07NA27344.\n```\n\n`LLNL-CODE-743439, LLNL-CODE-848318`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllnl%2Fcoda-calibration-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fllnl%2Fcoda-calibration-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllnl%2Fcoda-calibration-tool/lists"}