segyio 2.0.0a1__cp312-cp312-win_amd64.whl

segyio/tracefield.py

@@ -0,0 +1,204 @@
+from . import Enum
+
+class TraceField(Enum):
+    """Trace header field enumerator
+
+    Warning
+    -------
+    This class is outdated as per SEG-Y rev 2 standard and works only for files
+    with default layouts.
+
+    See :meth:`~segyio.SegyFile.tracefield` for file-dependent fields.
+
+    See also
+    -------
+    segyio.su : Seismic unix aliases for header fields
+    """
+
+    TRACE_SEQUENCE_LINE = 1
+    TRACE_SEQUENCE_FILE = 5
+    FieldRecord = 9
+    TraceNumber = 13
+    EnergySourcePoint = 17
+    CDP = 21
+    CDP_TRACE = 25
+    TraceIdentificationCode = 29
+    NSummedTraces = 31
+    NStackedTraces = 33
+    DataUse = 35
+    offset = 37
+    ReceiverGroupElevation = 41
+    SourceSurfaceElevation = 45
+    SourceDepth = 49
+    ReceiverDatumElevation = 53
+    SourceDatumElevation = 57
+    SourceWaterDepth = 61
+    GroupWaterDepth = 65
+    ElevationScalar = 69
+    SourceGroupScalar = 71
+    SourceX = 73
+    SourceY = 77
+    GroupX = 81
+    GroupY = 85
+    CoordinateUnits = 89
+    WeatheringVelocity = 91
+    SubWeatheringVelocity = 93
+    SourceUpholeTime = 95
+    GroupUpholeTime = 97
+    SourceStaticCorrection = 99
+    GroupStaticCorrection = 101
+    TotalStaticApplied = 103
+    LagTimeA = 105
+    LagTimeB = 107
+    DelayRecordingTime = 109
+    MuteTimeStart = 111
+    MuteTimeEND = 113
+    TRACE_SAMPLE_COUNT = 115
+    TRACE_SAMPLE_INTERVAL = 117
+    GainType = 119
+    InstrumentGainConstant = 121
+    InstrumentInitialGain = 123
+    Correlated = 125
+    SweepFrequencyStart = 127
+    SweepFrequencyEnd = 129
+    SweepLength = 131
+    SweepType = 133
+    SweepTraceTaperLengthStart = 135
+    SweepTraceTaperLengthEnd = 137
+    TaperType = 139
+    AliasFilterFrequency = 141
+    AliasFilterSlope = 143
+    NotchFilterFrequency = 145
+    NotchFilterSlope = 147
+    LowCutFrequency = 149
+    HighCutFrequency = 151
+    LowCutSlope = 153
+    HighCutSlope = 155
+    YearDataRecorded = 157
+    DayOfYear = 159
+    HourOfDay = 161
+    MinuteOfHour = 163
+    SecondOfMinute = 165
+    TimeBaseCode = 167
+    TraceWeightingFactor = 169
+    GeophoneGroupNumberRoll1 = 171
+    GeophoneGroupNumberFirstTraceOrigField = 173
+    GeophoneGroupNumberLastTraceOrigField = 175
+    GapSize = 177
+    OverTravel = 179
+    CDP_X = 181
+    CDP_Y = 185
+    INLINE_3D = 189
+    CROSSLINE_3D = 193
+    ShotPoint = 197
+    ShotPointScalar = 201
+    TraceValueMeasurementUnit = 203
+    TransductionConstantMantissa = 205
+    TransductionConstantPower = 209
+    TransductionUnit = 211
+    TraceIdentifier = 213
+    ScalarTraceHeader = 215
+    SourceType = 217
+    SourceEnergyDirectionVert = 219
+    SourceEnergyDirectionXline = 221
+    SourceEnergyDirectionIline = 223
+    SourceMeasurementMantissa = 225
+    SourceMeasurementExponent = 229
+    SourceMeasurementUnit = 231
+    UnassignedInt1 = 233
+    UnassignedInt2 = 237
+
+keys = {
+    'TRACE_SEQUENCE_LINE'                   : 1,
+    'TRACE_SEQUENCE_FILE'                   : 5,
+    'FieldRecord'                           : 9,
+    'TraceNumber'                           : 13,
+    'EnergySourcePoint'                     : 17,
+    'CDP'                                   : 21,
+    'CDP_TRACE'                             : 25,
+    'TraceIdentificationCode'               : 29,
+    'NSummedTraces'                         : 31,
+    'NStackedTraces'                        : 33,
+    'DataUse'                               : 35,
+    'offset'                                : 37,
+    'ReceiverGroupElevation'                : 41,
+    'SourceSurfaceElevation'                : 45,
+    'SourceDepth'                           : 49,
+    'ReceiverDatumElevation'                : 53,
+    'SourceDatumElevation'                  : 57,
+    'SourceWaterDepth'                      : 61,
+    'GroupWaterDepth'                       : 65,
+    'ElevationScalar'                       : 69,
+    'SourceGroupScalar'                     : 71,
+    'SourceX'                               : 73,
+    'SourceY'                               : 77,
+    'GroupX'                                : 81,
+    'GroupY'                                : 85,
+    'CoordinateUnits'                       : 89,
+    'WeatheringVelocity'                    : 91,
+    'SubWeatheringVelocity'                 : 93,
+    'SourceUpholeTime'                      : 95,
+    'GroupUpholeTime'                       : 97,
+    'SourceStaticCorrection'                : 99,
+    'GroupStaticCorrection'                 : 101,
+    'TotalStaticApplied'                    : 103,
+    'LagTimeA'                              : 105,
+    'LagTimeB'                              : 107,
+    'DelayRecordingTime'                    : 109,
+    'MuteTimeStart'                         : 111,
+    'MuteTimeEND'                           : 113,
+    'TRACE_SAMPLE_COUNT'                    : 115,
+    'TRACE_SAMPLE_INTERVAL'                 : 117,
+    'GainType'                              : 119,
+    'InstrumentGainConstant'                : 121,
+    'InstrumentInitialGain'                 : 123,
+    'Correlated'                            : 125,
+    'SweepFrequencyStart'                   : 127,
+    'SweepFrequencyEnd'                     : 129,
+    'SweepLength'                           : 131,
+    'SweepType'                             : 133,
+    'SweepTraceTaperLengthStart'            : 135,
+    'SweepTraceTaperLengthEnd'              : 137,
+    'TaperType'                             : 139,
+    'AliasFilterFrequency'                  : 141,
+    'AliasFilterSlope'                      : 143,
+    'NotchFilterFrequency'                  : 145,
+    'NotchFilterSlope'                      : 147,
+    'LowCutFrequency'                       : 149,
+    'HighCutFrequency'                      : 151,
+    'LowCutSlope'                           : 153,
+    'HighCutSlope'                          : 155,
+    'YearDataRecorded'                      : 157,
+    'DayOfYear'                             : 159,
+    'HourOfDay'                             : 161,
+    'MinuteOfHour'                          : 163,
+    'SecondOfMinute'                        : 165,
+    'TimeBaseCode'                          : 167,
+    'TraceWeightingFactor'                  : 169,
+    'GeophoneGroupNumberRoll1'              : 171,
+    'GeophoneGroupNumberFirstTraceOrigField': 173,
+    'GeophoneGroupNumberLastTraceOrigField' : 175,
+    'GapSize'                               : 177,
+    'OverTravel'                            : 179,
+    'CDP_X'                                 : 181,
+    'CDP_Y'                                 : 185,
+    'INLINE_3D'                             : 189,
+    'CROSSLINE_3D'                          : 193,
+    'ShotPoint'                             : 197,
+    'ShotPointScalar'                       : 201,
+    'TraceValueMeasurementUnit'             : 203,
+    'TransductionConstantMantissa'          : 205,
+    'TransductionConstantPower'             : 209,
+    'TransductionUnit'                      : 211,
+    'TraceIdentifier'                       : 213,
+    'ScalarTraceHeader'                     : 215,
+    'SourceType'                            : 217,
+    'SourceEnergyDirectionVert'             : 219,
+    'SourceEnergyDirectionXline'            : 221,
+    'SourceEnergyDirectionIline'            : 223,
+    'SourceMeasurementMantissa'             : 225,
+    'SourceMeasurementExponent'             : 229,
+    'SourceMeasurementUnit'                 : 231,
+    'UnassignedInt1'                        : 233,
+    'UnassignedInt2'                        : 237,
+}

segyio/tracesortingformat.py

@@ -0,0 +1,6 @@
+from . import Enum
+
+class TraceSortingFormat(Enum):
+    UNKNOWN_SORTING = 0
+    CROSSLINE_SORTING = 1
+    INLINE_SORTING = 2

segyio/utils.py

@@ -0,0 +1,199 @@
+import warnings
+import numpy as np
+import xml.etree.ElementTree as ET
+
+def castarray(x, dtype):
+        try:
+            x.dtype
+        except AttributeError:
+            msg = 'Implicit conversion from {} to {} (performance)'
+            warnings.warn(msg.format(type(x), np.ndarray), RuntimeWarning)
+
+            try:
+                x = np.require(x, dtype = dtype, requirements = 'CAW')
+            except TypeError:
+                x = np.fromiter(x, dtype = dtype)
+
+        if not x.flags['C_CONTIGUOUS']:
+            msg = 'Implicit conversion to contiguous array'
+            warnings.warn(msg, RuntimeWarning)
+
+        if x.dtype != dtype:
+            # TODO: message depending on narrowing/float-conversion
+            msg = 'Implicit conversion from {} to {} (narrowing)'
+            warnings.warn(msg.format(x.dtype, dtype), RuntimeWarning)
+
+        # Ensure the data is C-order contiguous, writable, and aligned, with
+        # the appropriate dtype. it won't copy unless it has to, so it's
+        # reasonably fast.
+        return np.require(x, dtype = dtype, requirements = 'CAW')
+
+def to_c_endianness(endian):
+    endians = {
+        None: -1,
+        'little': 1,
+        'lsb': 1,
+        'big': 0,
+        'msb': 0,
+    }
+
+    if endian not in endians:
+        problem = 'unknown endianness {}, expected one of: '
+        opts = ' '.join(endians.keys())
+        raise ValueError(problem.format(endian) + opts)
+
+    return endians[endian]
+
+def to_c_encoding(encoding):
+    encodings = {
+        None: -1,
+        'ebcdic': 0,
+        'ascii': 1,
+    }
+
+    if encoding not in encodings:
+        problem = 'unknown encoding {}, expected one of: '
+        opts = ' '.join(encodings.keys())
+        raise ValueError(problem.format(encoding) + opts)
+
+    return encodings[encoding]
+
+class FileDatasourceDescriptor():
+    def __init__(self, filename, mode):
+        self.filename = filename
+        self.mode = mode
+
+    def __repr__(self):
+        return "'{}', '{}'".format(self.filename, self.mode)
+
+    def __str__(self):
+        return "{}".format(self.filename)
+
+    def readonly(self):
+        return self.mode == 'rb' or self.mode == 'r'
+
+    def make_segyfile_descriptor(self):
+        from . import _segyio
+        fd = _segyio.segyfd(
+            filename=str(self.filename),
+            mode=self.mode
+        )
+        return fd
+
+
+class StreamDatasourceDescriptor():
+    def __init__(self, stream, minimize_requests_number):
+        if stream is None:
+            raise ValueError("stream object is required")
+        self.stream = stream
+        self.minimize_requests_number = minimize_requests_number
+
+    def __repr__(self):
+        return "'{}'".format(self.stream)
+
+    def __str__(self):
+       return str(self.stream)
+
+    def readonly(self):
+        return not self.stream.writable()
+
+    def make_segyfile_descriptor(self):
+        from . import _segyio
+        fd = _segyio.segyfd(
+            stream=self.stream,
+            minimize_requests_number=self.minimize_requests_number,
+        )
+        return fd
+
+
+class MemoryBufferDatasourceDescriptor():
+    def __init__(self, buffer):
+        if buffer is None:
+            raise ValueError("buffer object is required")
+        self.buffer = buffer
+
+    def __repr__(self):
+        return "'memory buffer'"
+
+    def __str__(self):
+       return "memory buffer"
+
+    def readonly(self):
+        return False
+
+    def make_segyfile_descriptor(self):
+        from . import _segyio
+        fd = _segyio.segyfd(
+            memory_buffer=self.buffer,
+        )
+        return fd
+
+
+class TraceHeaderLayoutEntry:
+    def __init__(self, name, byte, type, requires_nonzero_value):
+        self.name = name
+        self.byte = int(byte)
+        self.type = type
+        self.requires_nonzero_value = bool(int(requires_nonzero_value))
+
+    def __repr__(self):
+        msg = "TraceHeaderLayoutEntry(name='{}', byte={}, type='{}', requires_nonzero_value={})"
+        return msg.format(self.name, self.byte, self.type, self.requires_nonzero_value)
+
+
+class TraceHeaderLayout:
+    def __init__(self, entries):
+        self.entries = list(entries)
+        self._by_byte = {entry.byte: entry for entry in self.entries}
+        self._by_name = {entry.name: entry for entry in self.entries}
+
+    def entry_by_byte(self, byte):
+        return self._by_byte.get(byte)
+
+    def entry_by_name(self, name):
+        return self._by_name.get(name)
+
+    def __iter__(self):
+        return iter(self.entries)
+
+    def __len__(self):
+        return len(self.entries)
+
+
+def parse_trace_headers_layout(xml):
+    """
+    Parse an XML string into a dict of header name: TraceHeaderLayoutEntry.
+    """
+    try:
+        xml = xml.strip()
+        root = ET.fromstring(xml)
+    except ET.ParseError as e:
+        raise ValueError("Invalid XML: {}".format(e))
+
+    if root.tag != 'segy-layout':
+        msg = "Root must be 'segy-layout', found '{}'"
+        raise ValueError(msg.format(root.tag))
+
+    headers = [root]
+    headers.extend([child for child in root if child.tag == 'extension'])
+
+    layout = {}
+
+    for header in headers:
+        if header.tag == 'segy-layout':
+            name = 'SEG00000'
+        else:
+            name = header.get('name')
+            if not name:
+                raise ValueError("Extension header is missing name attribute")
+        entries = [
+            TraceHeaderLayoutEntry(
+                child.get('name'),
+                child.get('byte'),
+                child.get('type'),
+                child.get('if-non-zero', '0')
+            ) for child in header if child.tag == 'entry'
+        ]
+        layout[name] = entries
+
+    return layout

segyio-2.0.0a1.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: segyio
+Version: 2.0.0a1
+Summary: Simple & fast IO for SEG-Y files
+Author: Equinor ASA
+License-Expression: LGPL-3.0-or-later
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Other Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Project-URL: homepage, https://github.com/equinor/segyio
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.10
+Description-Content-Type: text/markdown
+
+=======
+SEGY IO
+=======
+
+https://segyio.readthedocs.io
+
+Introduction
+------------
+
+Segyio is a small LGPL licensed C library for easy interaction with SEG Y
+formatted seismic data, with language bindings for Python and Matlab. Segyio is
+an attempt to create an easy-to-use, embeddable, community-oriented library for
+seismic applications. Features are added as they are needed; suggestions and
+contributions of all kinds are very welcome.
+
+Feature summary
+---------------
+ * A low-level C interface with few assumptions; easy to bind to other
+   languages.
+ * Read and write binary and textual headers.
+ * Read and write traces, trace headers.
+ * Easy to use and native-feeling python interface with numpy integration.
+
+Project goals
+-------------
+
+Segyio does necessarily attempt to be the end-all of SEG-Y interactions;
+rather, we aim to lower the barrier to interacting with SEG-Y files for
+embedding, new applications or free-standing programs.
+
+Additionally, the aim is not to support the full standard or all exotic (but
+correctly) formatted files out there. Some assumptions are made, such as:
+
+ * All traces in a file are assumed to be of the same sample size.
+ * It is assumed all lines have the same number of traces.
+
+The writing functionality in Segyio is largely meant to *modify* or adapt
+files. A file created from scratch is not necessarily a to-spec SEG-Y file, as
+we only necessarily write the header fields segyio needs to make sense of the
+geometry. It is still highly recommended that SEG-Y files are maintained and
+written according to specification, but segyio does not mandate this.

segyio-2.0.0a1.dist-info/RECORD

@@ -0,0 +1,25 @@
+segyio/__init__.py,sha256=EvX66aHHQPJLqAMdvM68-0rukLfwUTlSD2vNMpHwdrk,3736
+segyio/_segyio.cp310-win_amd64.pyd,sha256=zl6_zLiu2SZhAiZHWrLrdOWWEnGcu0Web62IbzGd8Kk,143872
+segyio/_segyio.cp311-win_amd64.pyd,sha256=AWZt4LCYZOdKITeVV_JKXve5iXkixnGSdATAzcpyArs,143872
+segyio/_segyio.cp312-win_amd64.pyd,sha256=rdFXvPvli2xSVZdTa_GVg-GfFDdwvppzkpRY6gCTaBc,144384
+segyio/binfield.py,sha256=MsfRDzRprPKg8TJz4Kd9MWRe90Y51Urb18z7zLoUWSE,4948
+segyio/create.py,sha256=0S_b9hWY7uRRADqxUzwU2b2ihrY5SsKmWP72Rm6EOYg,10366
+segyio/depth.py,sha256=XrlzBmX5aX7zkSAP-PUDn0Xh-quGEAPmxjZfuQeBdBM,5684
+segyio/field.py,sha256=hVZQ0yIlXcurO6kJVb4tIdKGRlsnKIHqf2lkhvCiCm0,23487
+segyio/gather.py,sha256=rKutfM6SvlNVDceH2ccBbW2-oh2MAWeQnMeuhITVQM4,13543
+segyio/line.py,sha256=SlsVTSHXcYY7WVp6-5BJRA6kjt5K1PC18w6TMqIIpaY,17329
+segyio/open.py,sha256=h64ivYFOuYMvJFGt6sVldm76dH0U_qSMhef7wugt8oY,9637
+segyio/segy.py,sha256=tCNH7VNYK3rA6foRKKWMVFCIr31LzWKEhI1j6Tn7ro4,33657
+segyio/segyio.cpp,sha256=kAUcTIWpFAk7HjZgpYFzNIRL996QrjNeyBC99EOfiME,110691
+segyio/segysampleformat.py,sha256=270R67qgsU34z1YXVqYIkOIVsOimItwiAHviHK8WHfw,529
+segyio/su/__init__.py,sha256=4xDXkp_BYI4-arr9i7Q0jPqpiTzcwQRrakXNyG8jR24,46
+segyio/su/file.py,sha256=EMx9jPX3KmHYpctmlNqxEYt0aGUj2GV-B0cEq757B-Y,3105
+segyio/su/words.py,sha256=FXkpkzQPQki0TjMdiZjsYPCK4ORABVlAI7wqfG-U5mQ,5165
+segyio/tools.py,sha256=i2Wp3Vj3JZEk3cr7EfHgNgy4x6f63VPFAASbnr86grg,21883
+segyio/trace.py,sha256=SaQYpARZFC71HDu0agjw9Uq6Oh17TxAXQ1s4bgaxGOk,48875
+segyio/tracefield.py,sha256=oLEpKf4N_MncNghidFEVSYjNQZpeLvPF4q79kqyPWfQ,7684
+segyio/tracesortingformat.py,sha256=3pcdt2iyhtHxr-IaFC348PN8BeLfoyEuLUm3q9owUXc,131
+segyio/utils.py,sha256=VCbczqJOxu6ZRfSh6tj21uxRhQDb2wBOavkKOleYY2Q,5840
+segyio-2.0.0a1.dist-info/METADATA,sha256=_VX692IjDZERZLcWV8y8OVLREnXPb5wlas6mVX3mYsU,2626
+segyio-2.0.0a1.dist-info/WHEEL,sha256=chqeLhPBtPdrOoreR34YMcofSk3yWDQhkrsDJ2n48LU,106
+segyio-2.0.0a1.dist-info/RECORD,,

segyio-2.0.0a1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: scikit-build-core 0.11.6
+Root-Is-Purelib: false
+Tag: cp312-cp312-win_amd64
+