SOD is a program that automates tedious data selection, downloading, and routine processing tasks in seismology. It allows you to define your desired data based on earthquakes, recording stations, and the resulting combination of information. SOD then retrieves the data that matches the criteria and applies any number of processing steps using processors included in SOD and ones you've written yourself. All of this works for historical data, but as the name says, you can specify a "standing order" with SOD. If your criteria stretch off into the future, SOD will run until that day gathering seismograms for earthquakes as they occur.
To get started, read Getting Started, which will walk you through downloading, installing, and using SOD.
If you find SOD useful, please consider citing our SRL paper about SOD:
T. J. Owens, H. P. Crotwell, C. Groves, and P. Oliver-Paul. SOD: Standing Order for Data. Seismological Research Letters, 75:515–520, 2004.
Fixing a few bugs discovered in version 3.2.2, SOD 3.2.3 is available. This includes some work arounds for how the IRIS DMC event web service handles magType and catalog/contributor. There were valid SOD configurations that resulted in no events returned. Also, SOD has been tested with the USGS implementation of the FDSN Event services. You can access it by setting the <host>comcat.cr.usgs.gov</host> within the <fdsnEvent>. Lastly, if you are trying to get restricted data with a <fdsnDataSelect> source, the <fdsnStation> network source will automatically ask for restricted networks, which did not happen in the previous version. Please post questions to the SOD email list.
Fixing a few bugs discovered in version 3.2.1, SOD 3.2.2 is available. There was a serious bug with pulling the response from the new FDSN Station web service. Any response or polezero files pulled from the FDSN Station web service with SOD 3.2.0 or 3.2.1 are wrong. Please download and enjoy. Please post questions to the SOD email list.
On the longest day of the year, SOD 3.2.0 is finally available! A few more bugs found in beta3, largely with the timeout support. Please download and enjoy. Please post questions to the SOD email list. The old documentation for version 3.1 is here.
SOD 3.2.0beta3 is available! This is a beta release that fixes a few bugs found in beta2, in vectorTrim, restricted data and better timeout support. Please download and test and let us know if you find and bugs. Also feel free to post questions to the SOD email list. The new documentation (still in progress), is here.
SOD 3.2.0beta2 is available! This is a beta release that fixes a few bugs found in beta1, mainly related to space-space loc ids in the FDSNStation web service. Please download and test and let us know if you find and bugs. Also feel free to post questions to the SOD email list. The new documentation (still in progress), is here.
SOD 3.2.0beta1 is available! This is a beta release that fixes a few bugs and adds support for the new FDSN web services (Event, Station and DataSelect) now available from the IRIS DMC. Please download and test and let us know if you find and bugs. Also feel free to post questions to the SOD email list. The new documentation (still in progress), is here.
SOD 3.1.0 is released! This release fixes a few bugs and adds a few processors, including a new idea for measurements such as rms, min and max. Also add iterative deconvolution receiver functions and filtering using the very nice OregonDSP package.
A couple of more bugs and issues were found with the second release candidate and so we have put up a third release candidate for playing with. Please use it and give us feedback if you find any issues or have ideas for new features.
A couple of bugs and issues were found with the first release candidate and so we have put up a second release candidate for playing with. Please use it and give us feedback if you find any issues or have ideas for new features.
We have been hard at work on a new verson of SOD, 3.0, and have put up a release candidate for playing with. Please use it and give us feedback if you find any issues or have ideas for new features. The documentation for this version can be found here. Because this is a major version release, we have not maintained backwards compatibility for the recipe structure. So, you may find some previously valid recipes no longer work. Please email us if you have trouble migrating your recipes.
Changes and New Ingredients
- New networkArm sources, including earthworm/winston and IRIS DMC ws/station stationXML
- New waveform sources, including earthworm/winston and IRIS DMC ws/dataselect
- New database system, based on hibernate
- Many internal reliability improvements
- Scriptable Ingredients
- Site and Channel combined
...and many bug fixes and small improvements.
We've released a maintaince version of SOD today, 2.2.3. The only change is the addition of access to restricted data at the DMC.
We've released a maintaince version of SOD today, 2.2.2. It adds a few new features and fixes several bugs.
- networkTimeRange, networkStartTime and networkEndTime - these can be used to specify that events must occur during the active time of channels retrieved by the networkArm.
- pointDistance - a point distance passed directly to the event server.
- SOD will recover from the network being down at the start of a run instead of qutting immediately.
- Starting a SOD run with an existing database will print a warning rather than merrily tromping ahead. If you intend to do this, the warning can be turned off with --replace-recipe
- collapseOverlaps no longer throws an Exception if a seismogram is completely contained in another
- Running SOD with GCJ now outputs a helpful message about how to upgrade to Sun's Java instead of throwing exceptions.
SOD 2.2.1 is out today. This release contains the debut of the new SOD Command Line Tools(CLT). They're a set of scripts that allow you to harness much of the power of SOD from the command line without actually editing an XML recipe file. Check out the Tools section of this site for more information.
Beyond the addition of the tools, this release gives upgrades to several ingredients:
- networkCode - takes a two digit year in addition to a two character network code to fully specify temporary networks
- channelCode - allows * to specify that any value is acceptable in a code
- sacWriter - writes Intel byte order sac files if the <littleEndian/> tag is added
The SOD_HOME environmental variable required by SOD's scripts in previous versions has been removed. Instead of using SOD_HOME to find the location of the SOD's library, the invoked script locates them relative to its location. If SOD_HOME is still present, it will be ignored. As always, many bugs have been fixed. You can grab the new version on the download page.
SOD 2.2.1beta1 is out today. Many new features have been added:
- Server errors are clearly deliniated from SOD errors.
- Computationally intensive SOD processors will run in multiple threads simultaneously
- Password protected DHI servers are accessible using darkMagic
- New processors div, mul decimate and invertFlippedChannel.
After letting it age for a week, we're ready to release 2.2rc1 as SOD 2.2. No new bugs were discovered and no new features have been added since 2.2rc1. You can get this release on the download page.
Based on feedback at the IRIS meeting, we've added a few new features and changed the structure of a couple ingredient tags. Since we've made some larger changes we've decided to skip the 2.1.2 release and have released SOD 2.2rc1 today.
It adds six new ingredients:
- netDCRequest - generates NetDC files to be emailed
- differentiate - differentiates waveforms
- collapseOverlaps - merges overlapping seismograms(as returned by the POND)
- percentCoverage - requires only a certain percent of the data request to be available
- subrequestCoverage - checks that a particular subset of the original request is available
- backwardsEventFinder - processes events starting at the end time and going to the begin time
Finally we've documented the externals system in SOD that allows you to write custom Java code that hooks into your recipes. Check out the externals documentation if you need SOD to do something it doesn't do yet.
Go to the download page to get the new version. In the absence of any major new bugs, this will become SOD 2.2 in a week or so.
SOD 2.1.2rc2 is out. It fixes several bugs and annoyances in the new sacWriter and mseedWriter from 2.1.2rc1 and that magnitudeType wasn't recognized by csvEventSource. It also includes several documentation and tutorial fixes. Go to the download page to get the new version.
SOD 2.1.2rc1 has been released. 2.1.2rc1 adds the ability to subset by an area polygon, includes documentation on the CSV event system and templating, and fixes a multitude of bugs and annoyances. We're putting out this release candidate so that users that have reported issues can ensure they've been fixed. However, unless they uncover unforseen problems, this release candidate will become 2.1.2 within a couple weeks. Go to the download page to get the new version.