ObsPy: A Python Toolbox for seismology/seismological observatories.
This is the second bug fix release in the 1.0.x series.
Full changelog:
1.0.2: (doi: 10.5281/zenodo.49636)
- obspy.core:
* Added workaround for numpy issue where many FFTs of various lengths fill
a cache that never gets cleared, effectively creating a memory leak
(see #1424).
* Trace.filter and Stream.filter don't work on masked arrays anymore because
it produced unpredictable results due to the un-initialized data-chunk.
The uninitialized masked gap is now also initialized to np.nan in case
of floating point data which and a consistent fill value in case of
integer data. (see #1363)
- obspy.clients.fdsn:
* Fixing issue with location codes potentially resulting in unwanted data
to be requested. (see #1422)
* Included low-gain seismometers in default channel filters in
mass-downloader, also included non-oriented channels by default
(see #1373).
- obspy.db:
* Fixed a bug in obspy-indexer command line script (see #1369,
command line script was not working, probably since 0.10.0)
- obspy.imaging:
* Fixed a bug that leads to pressure/tension color blending when plotting
semi-transparent DC beachball patches (i.e. with "alpha" not equal to 1,
see #1464)
* Fixed a bug when plotting non-DC beachball patches without fill colors
(i.e. with "nofill=True", see #1464)
* Fix arbitrary units in waveform section plot's offset axis, making it
possible to add customizations to the plot afterwards (see #1382, see
#1383)
- obspy.io.ascii:
* Fixed a bug that lead to wrong header information in output files when
writing non-integer sampling rate data to SLIST or TSPAIR formats
(see #1447)
- obspy.io.cmtsolution:
* Make sure newer CMTSOLUTION files can also be read (see #1479).
- obspy.io.gse2:
* Fixed a bug that could lead to network code not present in GSE2 output
(see #1448)
- obspy.io.mseed:
* Fixed a bug in obspy-mseed-recordanalyzer (see #1386)
- obspy.io.nlloc:
* Use geographic coordinates from the NonLinLoc Hypocenter-Phase file if
no custom coordinate converter is provided. (see #1390)
* Fix reading NonLinLoc Hypocenter-Phase files with more than one
hypocenter in it. (see #1480)
* Fix reading NonLinLoc Hypocenter-Phase files with unicode characters in
them. (see #1483)
- obspy.io.quakeml:
* Fixed issue with improperly raised warnings when the same file is read
twice. (#1376)
* Fix writing empty network/station/channel codes in WaveformStreamID
objects to QuakeML. (see #1483)
- obspy.io.sac:
* Try to set SAC distances (dist, az, baz, gcarc) on read, if "lcalda" is
true. If "dist" header is found, distances aren't calculated.
* SACTrace class returns header values as native Python types instead of
NumPy types.
* SACTrace.iqual is no longer accepts enumerated string values, but
arbitrary integer values. (see #1472)
* SACTrace.read now replaces non-ASCII and null-termination characters in
string headers with whitespace unless the "debug_strings=True" flag is
used. (see #1432)
- obspy.io.stationxml:
* Always set the number attribute for poles and zeros. (see #1481)
- obspy.signal:
* PPSD.plot(): fix plotting of percentiles, mode and mean and setting
period limits when using "xaxis_frequency=True" (see #1406, #1416)
* Work around a bug in SciPy that results in wrong results for bandpass
filter when using Nyquist frequency (or higher) as high corner of the
passband (see #1451)
- obspy.taup:
* Fixing path for Pn. (see #1392)
This is the first bug fix release in the 1.0.x series.
Full changelog:
1.0.1: (doi: 10.5281/zenodo.48254)
- General:
* Some methods might have unnecessarily upcasted float32 arrays to float64.
Now methods for which it makes sense and which don't lose accuracy don't
upcast float32 arrays. Integers are still upcasted. Trace.resample() will
also no longer return the original dtype which might have resulted in a
large loss of accuracy but it now always returns float64 arrays.
(see #1302)
- obspy.core:
* Trace.normalize() does no longer divide by zero in case an all-zeros
data trace is being used. (see #1343)
* Inventory.select() and consorts now behave as expected even with empty
child elements. (see #1126, #1348)
* Code formatting is no longer checked for clean release versions. Thus
updates to the linters no longer break the tests for releases.
(see #1312)
* remove_response(..., pre_file=None, plot=True) works again. (see #1320)
- obspy.clients.arclink:
* Restored ArcLink encryption support. (see #1352, #1347)
- obspy.clients.fdsn:
* Local URLs are now recognized as valid URLs. (see #1309)
* Some bug fixes for the mass downloader. (see #1293, #1304)
* The NOA node has been added to the list of known nodes.
(see 2347a25714bc3e16068031f4b6138fafd627d34e)
- obspy.io.sac:
* More automatic merging of SAC and ObsPy headers. The new `obspy.io.sac`
modules thus behaves more like the old one and more in line with
expectations of users. (see #1285)
* No more out of bounds errors when assigning coordinates. (see #1300)
* The evdp header can be set again. (see #1345)
* Correctly propagating sampling rate changes to the SAC headers.
(see #1317)
* Always set nvhdr, leven, lovrok, iftype to ensure valid SAC files.
(see #1204)
- obspy.io.xseed:
* The Parser.get_paz() method now works with multiple blockette 53s.
(see #1281)
- obspy.taup
* Fixed wrong azimuth direction for paths > 180 degrees distance (see #1289)
* Azimuth is appended to arrivals as well (see #1289)
* Fixed issue with taup cache function on Python 2.7. (see #1308)
This is a big release with significant internal changes, new features, stability improvements, and much more to prepare ObsPy for future challenges and get rid of accumulated technical debt. It is now stable enough to officially declare it version 1.0. Changes are broad and numerous - follow this link to learn more:
Full Changelog
1.0.0:
- General:
* Requirements have been increased to reflect latest distributions:
* Removed support for Python 2.6.
* Added support for Python 3.5.
* matplotlib >= 1.1.0 is now required.
* numpy >= 1.6.1 is now required
* scipy >= 0.9.0 is now required
* Reorganized the submodule structure. We provide a deprecation path so the
old imports will continue to work for one ObsPy version.
* Consistent naming scheme across the code base. This results in some
functions having different names. Most things that worked with ObsPy 0.10
will continue to work with this version, but starting with the next
version they will fail. Pay attention to the deprecation warnings.
* Support for additional waveform data formats:
- Read support for the ASCII format for waveforms from the K-NET and
KiK-net strong-motion seismograph networks.
* Support for additional event data formats:
- CMTSOLUTION files used by many waveform solvers.
- ESRI shapefile write support, useful in GIS applications (see #1066)
- Google Earth KML output.
* Support for additional station data format:
- The FDSN web service station text format can now be read.
- Read support for the NIED's moment tensor TEXT format (see #1125)
- Google Earth KML output.
- Read support for SeisComP3 inventory files.
- obspy.core:
* New method for generating sliding windows from Stream/Trace windows.
(see #860)
* Stream/Trace.slice() now has the optional `nearest_sample` argument from
Stream/Trace.trim().
* Trace.remove_response() now has `plot` option to show/output a plot of all
individual steps of instrument response removal in frequency domain
(see #1116).
* New method Stream/Trace.remove_sensitivity() to remove instrument
sensitivity
* Fix incorrect parsing of some non-ISO8601 date/time strings. (see #1215)
* Added plotting method to Event (customizable subplots from a selection
of map, beachball and farfield radiation plots, see #1192)
- obspy.clients.fdsn:
* Replace FDSN webservice shortcut `NERIES` with `EMSC` and deprecate the
`NERIES` shortcut, will be removed in a future release (see #1146).
* Now requests gzipped data for the XML files. Much smaller files!
* The station service can now also be used to download files in the text
format. This has limited information but is much faster.
* New mass downloader to assist in downloading data across a large number
of FDSN web services.
* Catch invalid URLs when initialising Client and avoid confusing error
messages (see #1162)
- obspy.clients.filesystem.sds:
* New client to read data from local SDS directory structure (see #1135).
* Command line script `obspy-sds-report` to generate html page with
information on latency, data availability percentage and number of gaps
for a local SDS archive (see #1202)
- obspy.clients.neries:
* Removed the dedicated client. Data can still be accessed by using the FDSN
client.
- obspy.clients.syngine:
* New client for the IRIS Syngine service to retrieve custom synthetic
seismograms.
- obspy.imaging:
* Experimental support for Cartopy when plotting maps. Use the `method`
argument to functions that plot maps to select between Basemap or Cartopy.
* New default colormap for all plots. A backport of the new viridis colormap
from matplotlib is available for those using older matplotlib releases.
* Added plotting routines for farfield radiation patterns of moment tensors
- obspy.io.kml:
* New module for Google KML output of Inventory and Catalog objects
(e.g. for use in Google Earth)
- obspy.io.mseed:
* Upgrade to libmseed 2.16
- obspy.io.seiscomp.sc3ml:
* New module reading SeisComP3 inventory files to ObsPy inventory objects
(see #1182).
- obspy.io.shapefile:
* New module for ESRI shapefile write support (see #1066)
- obspy.io.stationtxt:
* New module reading the FDSN station files.
- obspy.signal:
* Switch to second-order sections for filters; backported from SciPy 0.16.0
(see #1028)
* New Lanczos interpolation/resampling (see #1101)
* Higher order detrending methods (see #1173)
* PPSD (see #931, #1108, #1130, #1187):
- Algorithm for PSD computation was improved, especially affecting results
at long periods (for detailed discussion see #931 and #1108).
- Keywords `paz` and `parser` were removed in favor of new keyword
`metadata`. PPSD now accepts `metadata` in a much wider range
of formats:
* Inventory objects (e.g. from StationXML or from FDSN webservice)
* obspy.io.xseed Parser objects (e.g. from dataless SEED file)
* filename of a RESP file
* dictionary with poles and zeros information (like in
prior versions)
Most old codes should still work, issuing a deprecation warning, but
old code that specifies *both* `paz` and `parser` keywords will raise
an exception.
- Whenever possible (i.e. when using for `metadata` an Inventory,
a Parser or a RESP file), response calculation now takes into account
the full response (all stages) as opposed to only using the poles and
zeros response stage (as was done in previous versions when using a
Parser object). When using a poles and zeros dictionary response
calculation is unchanged (as no information on other stages is
available, of course).
- PPSD now stores the psd for each time segment that gets processed,
instead of only storing the stacked histogram. That way, differing
custom stacks with various selection criteria (e.g. time of day, by
weekday, etc.) can now be made from the same processed data
(see #1130).
- New save/load mechanism using numpy .npz binary format that circumvents
some problems with the old pickle mechanism:
`PPSD.save_npz()` and `PPSD.load_npz()` (and `PPSD.add_npz()` to add
data from additional npz files)
- Change default colormap to new obspy default sequential colormap
(matplotlibs new viridis colormap). The old PQLX colormap is provided by
`obspy.imaging.cm.pqlx` and can be used with
`PPSD.plot(..., cmap=...)`.
- new option `PPSD.plot(..., cumulative=True)` for a cumulative plot of
the histogram, i.e. a non-exceedence percentage visualization, similar
to the `percentile` option.
- x axis in `PPSD.plot()` can be switched to frequency in Hz with
`PPSD.plot(..., xaxis_frequency=True)` (see #1130)
- changes to special handling of rotational: now handled by kwarg
`special_handling="ringlaser"` (kwarg `is_rotational_data` is
deprecated, see #916)
- special handling option for hydrophone data (no differentiation, see
#916)
- bin width on frequency axis can now be controlled using
`PPSD(..., frequency_bin_width_octaves=...)` (in fractions of octaves,
default is the old fixed setting of 1/8 octaves as in PQLX)
- obspy.taup
* Added support for nd file format for input velocity models. Allows for
named discontinuities at arbitrary depths allowing for less Earth like
models (see #1147).
* Added three methods (`get_travel_times_geo()`, `get_pierce_points_geo()`
and `get_ray_paths_geo()`) to `TauPyModel` to handle station and
event location data as latitude and longitude, instead of the source to
station distance in degrees. In addition `get_ray_paths_geo()` and
`get_pierce_points_geo()` decorate the returned pierce points and ray
paths with the latitude and longitude of each point. Some functionality
needs the `geographiclib` module to be installed. (See #1164.)
* ObsPy now ships with a bunch of new velocity models in addition to the
existing ones: `prem`, `sp6`, `1066a,b`, `herrin` (See #1196).
* Add support for buried receivers (see #1103.)
* Port more accurate calculation of ray parameter from Java. The effect is
stronger for longer phases, but also corrects issues with shorter body and
surface waves (see #986.)
* Fix incorrect branch splitting which also caused issues for extremely
shallow phases (see #1057.)
* Proper cache for model splits resulting in much faster calculations if
the source depth is repeatedly the same (see #1248).
0.10.3:
- obspy.core:
* Fix reading of multiple catalog files using globs (see #1065).
* Fixed a bug when using
`Trace.remove_response(..., water_level=None)`.
With that setting that is supposed to not use any water level
stabilization in the inversion of the instrument response
spectrum actually the instrument response was never inverted and
thus instead of a deconvolution a convolution was performed
(see #1104).
* Fixing floating point precision/rounding issue with UTCDateTime when
initializing with floating point seconds, i.e. with microseconds,
that could lead to microseconds being off by 1 microsecond
(see #1096)
* Correct gap/overlap time returned by Stream.get_gaps() and printed
by Stream.print_gaps() which was incorrect by one time the sampling
interval (see #1151)
* Stream.get_gaps(): return overlaps specified in units of samples
as negative integers (see #1151)
- obspy.fdsn:
* More detailed error messages on failing requests (see #1079)
* Follows redirects for POST requests (see #1143)
- obspy.imaging:
* fix some bugs in `obspy-scan` (see #1138)
- obspy.mseed:
* Blockette 100 is now only written for Traces that need it. Previously
it was written or not for all Traces, depending on whether the last
Trace needed it or not. (see #1069)
* Fixed a bug that prevented microsecond accuracy for times before 1970
(see #1102).
* Updated to libmseed 2.17.
- obspy.signal:
* Bug fixed within rotate.rotate2zne(). Additionally it can now also
perform the inverse rotation (see #1061).
* Bug fixed in triggering. When using option `max_len_delete` and a trigger
occurred right before the end of data, one trigger was potentially lost
(see #1145 for details).
- obspy.station:
* Plotting responses across multiple channels is more robust now in
presence of some strange channels (e.g. with zero sampling rate,
happens e.g. for state of health channels, see #1115)
* ObsPy no longer assumes that the StationXML namespace is the default
namespace (see #1060).
* Checking if a file is a StationXML file is less rigorous (and much
faster) now (not checking strict validity against xsd schema but
only looking for a FDSNStationXML root element, see #1114).
This means that `read_inventory()` without explicitly specified
format will correctly detect more files as StationXML that have very
slight breaches of the schema but still can be interpreted as
StationXML.
* fix saving `xcorrPickCorrection()` results to an image file (see #1154)
- obspy.taup:
* Calculating arrival times for surface waves now works (see #1055)
* Calculating arrivals for underside reflections now works (see #1089)
- obspy.y:
* correct misspelled name of a Y specific header field (see #1127)
- obspy.zmap
* Add support for time values with sub-second precision (see #1093)
This is a maintenance release containing several bug fixes:
After over 2200 commits from 25 contributors ObsPy 0.10.1 is finished and has been released.
The key new features are support for Python 3, a slew of new file formats, and a new TauP implementation.
ObsPy 0.10.1 fixes some installation issues with ObsPy 0.10.0 thus ObsPy 0.10.0 is not a recommended release.
Full changelog:
interpolate() method for Stream/Trace objects.matchtimeseries parameter for the
station service."cyl" projection is now named "global". It is now the Mollweide
projection.details=True when reading will now write to
Trace.stats.mseed.blkt1001.timing_quality instead of
Trace.stats.mseed.timing_quality.details=True will now be set to
False instead of -1.obspy.mseed.util.set_flags_in_fixed_header()
giving the ability to overwrite flags in the fixed header of existing
MiniSEED files.obspy-mseed-recordanalyzer:
Client(base_url='NERIES', ...)), for access to ORFEUS waveform
data please use the obspy.fdsn client (use
Client(base_url='ORFEUS', ...)) and for travel times please use
obspy.taup.byteorder option for writing sac files to disk.easyseedlink providing an easier way to create
SeedLink clientsClient class providing a basic seedlink client for individual
requests of finite time windows (i.e. non-continuous programs)SLClient (MiniSEED record leak in packet parser,
see #918)Client.event.getEvents() to fetch a Catalog object
from a seishub server of version 1.4.0 or higher.weighted average slopes method from Wiggins 1976.After over 2200 commits from 25 contributors ObsPy 0.10.0 is finished and has been released.
The key new features are support for Python 3, a slew of new file formats, and a new TauP implementation.
Migration Guide from older ObsPy Versions
Full changelog:
interpolate() method for Stream/Trace objects.matchtimeseries parameter for the
station service."cyl" projection is now named "global". It is now the Mollweide
projection.details=True when reading will now write to
Trace.stats.mseed.blkt1001.timing_quality instead of
Trace.stats.mseed.timing_quality.details=True will now be set to
False instead of -1.obspy.mseed.util.set_flags_in_fixed_header()
giving the ability to overwrite flags in the fixed header of existing
MiniSEED files.obspy-mseed-recordanalyzer:
Client(base_url='NERIES', ...)), for access to ORFEUS waveform
data please use the obspy.fdsn client (use
Client(base_url='ORFEUS', ...)) and for travel times please use
obspy.taup.byteorder option for writing sac files to disk.easyseedlink providing an easier way to create
SeedLink clientsClient class providing a basic seedlink client for individual
requests of finite time windows (i.e. non-continuous programs)SLClient (MiniSEED record leak in packet parser,
see #918)Client.event.getEvents() to fetch a Catalog object
from a seishub server of version 1.4.0 or higher.weighted average slopes method from Wiggins 1976.This is a maintenance release and contains the collective bug fixes and minor feature improvements of around 150 commits so we advise all users to upgrade.
Changelog:
attach_response=True argument now uses a faster approach to
download the station dataThis release contains 1423 commits from 20 contributors. Thanks a bunch to everyone!
The new key features are full support for the FDSN web services (waveform, event, and station data) and the FDSN StationXML format including the calculation of instrument responses directly from StationXML files. Other notable changes are the support for the Nanometrics Y file format, the CSS (Center for Seismic Studies) waveform data format, the NEIC PDE bulletin event catalog files, a new client to access data from the NEIC CWB QueryServer, and numerous smaller enhancements and bug fixes.
Migration Guide from older ObsPy Versions
Full Changelog:
events kwarg.events kwarg.