[][install_pip]
[][install_conda]
[][python version]
[][status]
[][apache 2.0 license]
[][tests]
[][codecov]
[][read the docs]
[][pre-commit]
[][ruff]
[][pypi_]
[][conda-forge_]
[pypi_]: https://pypi.org/project/segy/
[conda-forge_]: https://anaconda.org/conda-forge/segy
[status]: https://pypi.org/project/segy/
[python version]: https://pypi.org/project/segy
[read the docs]: https://segy.readthedocs.io/
[tests]: https://github.com/TGSAI/segy/actions/workflows/tests.yaml
[codecov]: https://app.codecov.io/gh/TGSAI/segy
[pre-commit]: https://github.com/pre-commit/pre-commit
[ruff]: https://github.com/astral-sh/ruff
[install_pip]: https://segy.readthedocs.io/en/stable/installation.html#using-pip-and-virtualenv
[install_conda]: https://segy.readthedocs.io/en/stable/installation.html#using-conda
# 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][read the docs] for more information.
This is not an official TGS product.
## Features
The library utilizes `numpy` and `fsspec`, includes the reading from various local
and remote resources at a high speed. It also allows the users to build their own
SEG-Y specifications.
## Installing `segy`
Clone the repo and install it using pip:
Simplest way to install `segy` is via [pip] from [PyPI]:
```shell
$ pip install segy
```
or install `segy` via [conda] from [conda-forge]:
```shell
$ conda install -c conda-forge segy
```
> Extras must be installed separately on `Conda` environments.
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)
### 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](https://www.tgs.com/). Current
maintainer is [Altay Sansal](https://github.com/tasansal) 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.
[hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python
[pypi]: https://pypi.org/
[conda-forge]: https://conda-forge.org/
[file an issue]: https://github.com/TGSAI/segy/issues
[pip]: https://pip.pypa.io/
[conda]: https://docs.conda.io/
<!-- github-only -->
[apache 2.0 license]: https://github.com/TGSAI/segy/blob/main/LICENSE
[contributor guide]: https://github.com/TGSAI/segy/blob/main/CONTRIBUTING.md
[command-line usage]: https://segy.readthedocs.io/en/stable/cli_usage.html
[api reference]: https://segy.readthedocs.io/en/stable/api_reference.html
[installation instructions]: https://segy.readthedocs.io/en/stable/installation.html
Raw data
{
"_id": null,
"home_page": "https://github.com/TGSAI/segy",
"name": "segy",
"maintainer": "Altay Sansal",
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": "altay.sansal@tgs.com",
"keywords": "segy, seismic, data, geophysics",
"author": "TGS",
"author_email": "sys-opensource@tgs.com",
"download_url": "https://files.pythonhosted.org/packages/05/f3/41390928d5a93ffb201313378445f8f168404e0c18b4b62915de1dc6cb42/segy-0.2.3.tar.gz",
"platform": null,
"description": "[][install_pip]\n[][install_conda]\n[][python version]\n[][status]\n[][apache 2.0 license]\n\n[][tests]\n[][codecov]\n[][read the docs]\n\n[][pre-commit]\n[][ruff]\n\n[][pypi_]\n[][conda-forge_]\n\n[pypi_]: https://pypi.org/project/segy/\n[conda-forge_]: https://anaconda.org/conda-forge/segy\n[status]: https://pypi.org/project/segy/\n[python version]: https://pypi.org/project/segy\n[read the docs]: https://segy.readthedocs.io/\n[tests]: https://github.com/TGSAI/segy/actions/workflows/tests.yaml\n[codecov]: https://app.codecov.io/gh/TGSAI/segy\n[pre-commit]: https://github.com/pre-commit/pre-commit\n[ruff]: https://github.com/astral-sh/ruff\n[install_pip]: https://segy.readthedocs.io/en/stable/installation.html#using-pip-and-virtualenv\n[install_conda]: https://segy.readthedocs.io/en/stable/installation.html#using-conda\n\n# SEG-Y\n\n> \ud83d\udea7\ud83d\udc77\ud83c\udffb This project is under active development, expect breaking changes\n> the to API \ud83d\udc77\ud83c\udffb\ud83d\udea7\n> _\\- March, 2024_\n\nThis is an efficient and comprehensive SEG-Y parsing library.\n\nSee the [documentation][read the docs] for more information.\n\nThis is not an official TGS product.\n\n## Features\n\nThe library utilizes `numpy` and `fsspec`, includes the reading from various local\nand remote resources at a high speed. It also allows the users to build their own\nSEG-Y specifications.\n\n## Installing `segy`\n\nClone the repo and install it using pip:\n\nSimplest way to install `segy` is via [pip] from [PyPI]:\n\n```shell\n$ pip install segy\n```\n\nor install `segy` via [conda] from [conda-forge]:\n\n```shell\n$ conda install -c conda-forge segy\n```\n\n> Extras must be installed separately on `Conda` environments.\n\nFor details, please see the [installation instructions]\nin the documentation.\n\n## Using `segy`\n\nPlease see the [Command-line Usage] for details.\n\nFor Python API please see the [API Reference] for details.\n\n### Reading Capabilities\n\nIt supports reading from local and cloud files (object store). It can read:\n\n- Sequential traces (fastest)\n- Disjoint sequential regions (fast)\n- Random traces (slow)\n\nThe library will also try to infer the endianness and the revision of the SEG-Y\nfile automatically. If it can't, users can override the endianness, revision, and\nmore parameters using the settings.\n\n### High Performance\n\nThe performance is high and to be proven with upcoming benchmarks. The initial\nsubjective benchmarks is very acceptable.\n\n### Flexibility\n\nThe library provides a fully flexible, schematized SEG-Y structure, including\ndata models and JSON schema parsing and validation.\n\n### Predefined SEG-Y Standards\n\nIt supports predefined SEG-Y \"standards\" for various versions. However, some versions\nare still in progress and not all validation logic is implemented yet:\n\n- \u2705 Rev 0 (1975)\n- \u2705 Rev 1 (2002)\n- \u2705 Rev 2 (2017)\n- \ud83d\udd32 Rev 2.1 (2023)\n\n### Custom SEG-Y Standards\n\nYou can build your own SEG-Y \"standard\" with composition of specs for:\n\n- Text header (file + extended)\n- Binary header\n- Traces (header + extended header + samples)\n\n## Contributing to `segy`\n\nContributions are very welcome.\nTo learn more, see the [Contributor Guide].\n\n## Licensing\n\nDistributed under the terms of the [Apache 2.0 license].\n`segy` is free and open source software.\n\n## Issues\n\nIf you encounter any problems,\nplease [file an issue] along with a detailed description.\n\n## Credits\n\nThis project was established at [TGS](https://www.tgs.com/). Current\nmaintainer is [Altay Sansal](https://github.com/tasansal) with the support\nof many more great colleagues.\n\nThe CI/CD tooling is loosely based on [Hypermodern Python Cookiecutter]\nwith more modern tooling applied elsewhere.\n\n[hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python\n[pypi]: https://pypi.org/\n[conda-forge]: https://conda-forge.org/\n[file an issue]: https://github.com/TGSAI/segy/issues\n[pip]: https://pip.pypa.io/\n[conda]: https://docs.conda.io/\n\n<!-- github-only -->\n\n[apache 2.0 license]: https://github.com/TGSAI/segy/blob/main/LICENSE\n[contributor guide]: https://github.com/TGSAI/segy/blob/main/CONTRIBUTING.md\n[command-line usage]: https://segy.readthedocs.io/en/stable/cli_usage.html\n[api reference]: https://segy.readthedocs.io/en/stable/api_reference.html\n[installation instructions]: https://segy.readthedocs.io/en/stable/installation.html\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "The Ultimate Python SEG-Y I/O with Cloud Support and Schemas",
"version": "0.2.3",
"project_urls": {
"Documentation": "https://segy.readthedocs.io",
"Homepage": "https://github.com/TGSAI/segy",
"Repository": "https://github.com/TGSAI/segy"
},
"split_keywords": [
"segy",
" seismic",
" data",
" geophysics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e17c8a7e8771fb5f4c69f6d345b3a02c425fb4f4ecbac6248cb407e94142d23e",
"md5": "cc4ceeb75db7e5a805dba6ee5e79febc",
"sha256": "a5bcfa7056b64addb3382690bcf9e90745bd814a626b2321674e4d6f7320b187"
},
"downloads": -1,
"filename": "segy-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cc4ceeb75db7e5a805dba6ee5e79febc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 50583,
"upload_time": "2024-10-03T16:06:22",
"upload_time_iso_8601": "2024-10-03T16:06:22.630385Z",
"url": "https://files.pythonhosted.org/packages/e1/7c/8a7e8771fb5f4c69f6d345b3a02c425fb4f4ecbac6248cb407e94142d23e/segy-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "05f341390928d5a93ffb201313378445f8f168404e0c18b4b62915de1dc6cb42",
"md5": "bc24518cc932c40eeaded844edc2ada3",
"sha256": "271fa61c7b50978cc055d9d945a211e644d4185d212cfe62274822af654cc485"
},
"downloads": -1,
"filename": "segy-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "bc24518cc932c40eeaded844edc2ada3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 42232,
"upload_time": "2024-10-03T16:06:24",
"upload_time_iso_8601": "2024-10-03T16:06:24.412039Z",
"url": "https://files.pythonhosted.org/packages/05/f3/41390928d5a93ffb201313378445f8f168404e0c18b4b62915de1dc6cb42/segy-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-03 16:06:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TGSAI",
"github_project": "segy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "segy"
}
JSON
