SEG-Y
🚧👷🏻 This project is under active development, expect breaking changes the to API 👷🏻🚧 - March, 2024
This is an efficient and comprehensive SEG-Y parsing library.
See the documentation for more information.
This is not an official TGS product.
Key Features
- Thrive for SEG-Y correctness while allowing flexibility.
- Utilize fast decoding and parsing logic (
numpy+numba). - Use
fsspececosystem to read / write files to and from disk, cloud,http,ftp. - Support legacy and current SEG-Y standards.
- Allow users to specify and register their customizations as new "standards".
- Header field names are canonical and interactive alias recommendation based on popular libraries.
- Automatic detection of file endianness and SEG-Y revision.
- Configuration mechanism to override bad headers that hinders automatic parsing.
Installing segy
Clone the repo and install it using pip:
Simplest way to install segy is via pip from PyPI:
$ pip install segy
or install segy via conda from conda-forge:
$ conda install -c conda-forge segy
Extras must be installed separately on
Condaenvironments.
For details, please see the installation instructions in the documentation.
Using segy
Please see the Command-line Usage for details.
For Python API please see the API Reference for details.
Reading Capabilities
It supports reading from local and cloud files (object store). It can read:
- Sequential traces (fastest)
- Disjoint sequential regions (fast)
- Random traces (slow)
The library will also try to infer the endianness and the revision of the SEG-Y file automatically. If it can't, users can override the endianness, revision, and more parameters using the settings.
High Performance
The performance is high and to be proven with upcoming benchmarks. The initial subjective benchmarks is very acceptable.
Flexibility
The library provides a fully flexible, schematized SEG-Y structure, including data models and JSON schema parsing and validation.
Predefined SEG-Y Standards
It supports predefined SEG-Y "standards" for various versions. However, some versions are still in progress and not all validation logic is implemented yet:
- ✅ Rev 0 (1975)
- ✅ Rev 1 (2002)
- ✅ Rev 2 (2017)**
- ✅ Rev 2.1 (2023)**
** The XML stanzas and extended trace headers are not currently supported.
Custom SEG-Y Standards
You can build your own SEG-Y "standard" with composition of specs for:
- Text header (file + extended)
- Binary header
- Traces (header + extended header + samples)
Contributing to segy
Contributions are very welcome. To learn more, see the Contributor Guide.
Licensing
Distributed under the terms of the Apache 2.0 license.
segy is free and open source software.
Issues
If you encounter any problems, please file an issue along with a detailed description.
Credits
This project was established at TGS. Current maintainer is Altay Sansal with the support of many more great colleagues.
The CI/CD tooling is loosely based on Hypermodern Python Cookiecutter with more modern tooling applied elsewhere.
Release files for segy 0.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| segy-0.6.1.tar.gz | 47.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| segy-0.6.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 106.5 kB
Release files / segy-0.6.1.tar.gz
| Download URL | segy-0.6.1.tar.gz |
|---|---|
| Size | 47.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1894f7c145a886a5e4d2f2e92bd9c191a9587b44aff40052c67faee9383ce45a
|
|
BLAKE2b-256 checksum How to use checksums |
043b20cfdae356eb2b1f1ce0b92caeeeda8e1fd8007fc12efed1e0275fb49c81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / segy-0.6.1-py3-none-any.whl
| Download URL | segy-0.6.1-py3-none-any.whl |
|---|---|
| Size | 59.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9cf919b6cc33877dcf4a3c7ac732b3240daba5fe23c3085b30b7fd63c77ab353
|
|
BLAKE2b-256 checksum How to use checksums |
b3052b23ef102a9653968391d06caf900f4f40f958659a7157e273dd3665b96d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
