obspy.core.trace.Trace.times

Trace.times(type='relative', reftime=None)[source]

For convenient plotting compute a NumPy array with timing information of all samples in the Trace.

Time can be either:

Note

The option `type="utcdatetime"` shouldn’t be used for Traces with a large sample size as it will generate an array of thousands of `UTCDateTime.timestamp` objects.

```>>> from obspy import read, UTCDateTime
>>> tr = read()[0]
```
```>>> tr.times()
array([  0.00000000e+00,   1.00000000e-02,   2.00000000e-02, ...,
2.99700000e+01,   2.99800000e+01,   2.99900000e+01])
```
```>>> tr.times(reftime=UTCDateTime("2009-01-01T00"))
array([ 20305203.  ,  20305203.01,  20305203.02, ...,  20305232.97,
20305232.98,  20305232.99])
```
```>>> tr.times("utcdatetime")
array([UTCDateTime(2009, 8, 24, 0, 20, 3),
UTCDateTime(2009, 8, 24, 0, 20, 3, 10000),
UTCDateTime(2009, 8, 24, 0, 20, 3, 20000), ...,
UTCDateTime(2009, 8, 24, 0, 20, 32, 970000),
UTCDateTime(2009, 8, 24, 0, 20, 32, 980000),
UTCDateTime(2009, 8, 24, 0, 20, 32, 990000)], dtype=object)
```
```>>> tr.times("timestamp")
array([  1.25107320e+09,   1.25107320e+09,   1.25107320e+09, ...,
1.25107323e+09,   1.25107323e+09,   1.25107323e+09])
```
```>>> tr.times("matplotlib")
array([ 14480.01392361,  14480.01392373,  14480.01392384, ...,
14480.01427049,  14480.0142706 ,  14480.01427072])
```
Parameters:
• type (str) – Determines type of returned time array, see above for valid values.

• reftime (obspy.core.utcdatetime.UTCDateTime) – When using a relative timing, the time used as the reference for the zero point, i.e., the first sample will be at `trace.stats.starttime - reftime` (in seconds).

Return type:
Returns:

An array of time samples in an `ndarray` if the trace doesn’t have any gaps or a `MaskedArray` otherwise (`dtype` of array is either `float` or `UTCDateTime`).