obspy.core.trace.Trace.slice¶

Trace.slice(starttime=None, endtime=None, nearest_sample=True)[source]¶

Return a new Trace object with data going from start to end time.

Parameters:

starttime (UTCDateTime) Specify the start time of slice. endtime (UTCDateTime) Specify the end time of slice. nearest_sample (bool, optional) If set to True, the closest sample is selected, if set to False, the inner (next sample for a start time border, previous sample for an end time border) sample containing the time is selected. Defaults to True. Given the following trace containing 6 samples, “|” are the sample points, “A” is the requested starttime: | |A | | B | | 1 2 3 4 5 6 nearest_sample=True will select samples 2-5, nearest_sample=False will select samples 3-4 only.

Returns:

New Trace object. Does not copy data but just passes a reference to it.

Example

>>> tr = Trace(data=np.arange(0, 10))
>>> tr.stats.delta = 1.0
>>> t = tr.stats.starttime
>>> tr2 = tr.slice(t + 2, t + 8)
>>> tr2.data
array([2, 3, 4, 5, 6, 7, 8])