# obspy.io.kinemetrics - Evt format support for ObsPy

Evt read support for ObsPy.

This module provides read support for the Evt Kinemetrics data format. It is based on the Kinemetrics description of the format and the provided C code (Kw2asc.c (see “KW2ASC.SRC” File in /doc section)).

copyright: | The ObsPy Development Team (devs@obspy.org), Henri Martin, Thomas Lecocq, Kinemetrics(c)
license: | GNU Lesser General Public License, Version 3 (https://www.gnu.org/copyleft/lesser.html)

## Reading

Similar to reading any other waveform data format using obspy.core:

    >>> from obspy import read
    >>> st = read("/path/to/BI008_MEMA-04823.evt")
    >>> st
    <obspy.core.stream.Stream object at 0x...>
    >>> print (st)
    3 Trace(s) in Stream:
    .MEMA..0 | 2013-08-15T09:20:28.000000Z - 2013-08-15T09:20:50.996000Z |
    250.0 Hz, 5750 samples
    .MEMA..1 | 2013-08-15T09:20:28.000000Z - 2013-08-15T09:20:50.996000Z |
    250.0 Hz, 5750 samples
    .MEMA..2 | 2013-08-15T09:20:28.000000Z - 2013-08-15T09:20:50.996000Z |
    250.0 Hz, 5750 samples

Each trace will have a `stats` attribute containing the usual information and a `kinemetrics_evt` dictionary with specific attributes.

Note

All the Header’s attributes are not read (can be implemented if necessary for someone.)

    >>> stats_evt = st[0].stats.pop('kinemetrics_evt')
    >>> print(st[0].stats)
             network:
             station: MEMA
            location:
             channel: 0
           starttime: 2013-08-15T09:20:28.000000Z
             endtime: 2013-08-15T09:20:50.996000Z
       sampling_rate: 250.0
               delta: 0.004
                npts: 5750
               calib: 1.0
             _format: KINEMETRICS_EVT
    >>> for k, v in sorted(stats_evt.items()):
    ...     print(k, v)
    ...
    a2dbits 24
    batteryvoltage -134
    chan_azimuth 0
    chan_calcoil 0.05000000074...
    chan_damping 0.70700001716...
    chan_east 0
    chan_fullscale 2.5
    chan_gain 1
    chan_id
    chan_natfreq 196.0
    chan_north 0
    chan_range 3
    chan_sensitivity 2.5
    chan_sensorgain 1
    chan_up 0
    comment MEMBACH
    duration 230
    elevation 298
    gpslastlock 2013-08-15T09:19:20.000Z
    gpsstatus Present ON
    installedchan 4
    instrument New Etna
    latitude 50.609794616...
    longitude 6.0092501640...
    maxchannels 12
    nchannels 3
    nscans 6
    samplebytes 3
    serialnumber 4823
    starttime 2013-08-15T09:20:28.000Z
    stnid MEMA
    temperature 76
    triggertime 2013-08-15T09:20:34.600Z

The actual data is stored as `numpy.ndarray` in the `data` attribute of each trace.

    >>> type(st[0].data)
    <... 'numpy.ndarray'>
    >>> print(st[0].data)
    [-0.02446475 -0.02453492 -0.02446709 ..., -0.02452556 -0.02450685
     -0.02442499]

## Writing

Not implemented

## Modules

`core` | Evt (Kinemetrics files) bindings to ObsPy’s core classes.

### Thank you!

We would like to thank our contributors, whose efforts make this software what it is. These people have helped by writing code and documentation, and by testing. They have created and maintained this product, its associated libraries and applications, our build tools and our web sites.

#### Contributors

- Ackerley, Nick
- Allgeyer, Sebastien
- Ammon, Charles J.
- Antunes, Emanuel
- Arnarsson, Ólafur St.
- Bank, Markus
- Barsch, Robert
- Behr, Yannik
- Bernardi, Fabrizio
- Bernauer, Felix
- Bes de Berc, Maxime
- Beyreuther, Moritz
- Boltz, Shawn
- Bonaimé, Sébastien
- Carothers, Lloyd
- Chamberlain, Calum
- Chambers, Derrick
- Chen, Zhao
- Clark, Adam
- Danecek, Peter
- Egdorf, Sven
- Engels, Fabian
- Ermert, Laura
- Eulenfeld, Tom

- Fabbri, Tommaso
- Falco, Nicholas
- Fee, Jeremy
- Grellier, Clément
- Grunberg, Marc
- Hammer, Conny
- Heimann, Sebastian
- Heiniger, Lukas
- Hope, Gaute
- Igel, Heiner
- Inza, Adolfo
- Isken, Marius
- Ketchum, David
- Koymans, Mathijs
- Kremers, Simon
- Kress, Victor
- Krieger, Lars
- Krischer, Lion
- Kula, Damian
- Käufl, Paul
- Köhler, Andreas
- Lecocq, Thomas
- Leeman, John
- Legovini, Paride

- Lesage, Philippe
- Li, Yulin
- Lomax, Anthony
- Lopes, Rui L.
- MacCarthy, Jonathan
- Maggi, Alessia
- Martin, Henri
- Medlin, Andrew
- Megies, Tobias
- Meschede, Matthias
- Michelini, Alberto
- Miller, Nathaniel C.
- Morgenstern, Bernhard
- Nof, Ran Novitsky
- Panning, Mark P.
- Parker, Tom
- Pestourie, Romain
- Rapagnani, Giovanni
- Reyes, Celso
- Ringler, Adam
- Rothenhäusler, Nicolas
- Russo, Emiliano
- Sales de Andrade, Elliott

- Satriano, Claudio
- Saul, Joachim
- Scheingraber, Chris
- Schneider, Simon
- Sippl, Christian
- Snoke, Arthur
- Stange, Stefan
- Stähler, Simon C.
- Sullivan, Benjamin
- Tian, Dongdong
- Trabant, Chad
- Trani, Luca
- Uieda, Leonardo
- Walker, Andrew
- Walther, Marcus
- Wassermann, Joachim
- Williams, Mark C.
- Winkelman, Andrew
- Zaccarelli, Riccardo
- Zad, Seyed Kasra Hosseini
- Zhu, Lijun
- van Driel, Martin
- van Wijk, Kasper

#### Funds

ObsPy was partially funded by the

- German Science Foundation (DFG) via grant DFG IG 16/9-1
- German Ministry for Education and Research (BMBF), GEOTECHNOLOGIEN grant 03G0646H.
- NERA project (Network of European Research Infrastructures for Earthquake Risk Assessment and Mitigation) under the European Community's Seventh Framework Programme (FP7/2007-2013) grant agreement n° 262330
- Leibniz Institute for Applied Geophysics (LIAG)
- VERCE EU-FP7 project (no. 283543)