segyio

library1.9.14pypypi✓ verified 85d ago

segyio is a library for simple and fast reading and writing of SEG-Y files, a standard format for seismic data. Version 1.9.14 requires Python >=3.10. It is widely used in geoscience for efficient seismic data I/O. Release cadence is irregular.

data database

pip install segyio

github ↗package ↗

INSTALL

IMPORT

SIG · SEGYIO

segyio

datapythonv1.9.14

Install

3.7s avg

Import

288ms

Disk

88MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.9.14 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.7s · import 0.288s · 86MB

88MB installed

● package 88MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

segyio

✓ import segyio

Direct import of the top-level module.

Open a SEG-Y file and display the number of traces.

import segyio with segyio.open('data.sgy') as segyfile: print(f'Number of traces: {segyfile.tracecount}')

Debug

Known issues

gotchaTrace headers are accessed via numpy structured arrays; use segyfile.header[trace_index] and to modify use segyfile.header[trace_index] = new_values. Incorrect indexing can cause silent corruptions.

fix

Always use integer trace indices or slice objects. For example: header = segyfile.header[0].

affects: >=1.0

gotchaThe segyio.open() mode parameter defaults to 'r'. For writing, explicitly pass segyio.open('file.sgy', 'r+') or segyio.create(). Doing the wrong mode can cause permission errors.

fix

Use segyio.open('file.sgy', 'r+') for read/write on existing files or segyio.create('new.sgy') for new files.

affects: >=1.0

deprecatedThe segyio.tools module (e.g., segyio.tools.wrap) is deprecated. Prefer using the main segyio functions.

fix

Use segyio.open() and segyio.create() directly instead of segyio.tools.

affects: >=1.9

Errors

Common errors & fixes

ImportError: cannot import name 'tools' from 'segyio'

segyio.tools module was removed in version 1.9 or later.

fix

Update code to use the main segyio functions: segyio.open() instead of segyio.tools.wrap().

AttributeError: 'SegyFile' object has no attribute 'trace_count'

The correct attribute is 'tracecount' (no underscore).

fix

Use segyfile.tracecount instead of segyfile.trace_count.

Upgrade

Version history

1.9.14latest on PyPI · released Dec 2, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/equinor/segyio ↗

packagehttps://pypi.org/project/segyio/ ↗