las-read-rs 0.1.6__cp38-abi3-macosx_11_0_arm64.whl

las_read_rs-0.1.6.dist-info/METADATA

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: las-read-rs
+Version: 0.1.6
+Requires-Dist: pandas
+Requires-Dist: numpy
+Summary: A high-performance LAS (Log ASCII Standard) file reader written in Rust
+Author-email: Emiliano Flores <jemilianofl@github.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# las_read_rs 🦀
+
+[![PyPI version](https://badge.fury.io/py/las-read-rs.svg)](https://pypi.org/project/las-read-rs/)
+[![CI](https://github.com/jemilianofl/lasio-rs/actions/workflows/ci.yml/badge.svg)](https://github.com/jemilianofl/lasio-rs/actions)
+
+**High-performance LAS (Log ASCII Standard) file reader written in Rust** with Python bindings. A faster alternative to pure Python implementations, capable of parsing large geophysical log files efficiently.
+
+## ⚡ Performance
+
+Benchmarked with a **92 MB** LAS file (400 curves, 21,842 points each):
+
+| Library | Read Time | Speedup |
+|---------|-----------|---------|
+| **las_read_rs** (Rust) | ~1.0s | **9x faster** 🚀 |
+| lasio (Python) | ~9.0s | baseline |
+
+## 🚀 Installation
+
+**Requirements:**
+- Python 3.8 or higher
+- Supported OS: Windows, macOS, Linux
+
+```bash
+pip install las_read_rs
+```
+
+**Optional dependencies for export features:**
+```bash
+pip install pandas          # For DataFrame and CSV export
+pip install openpyxl        # For Excel export
+pip install polars          # For Polars DataFrame
+```
+
+## 📖 Quick Start
+
+```python
+import lasio_rs
+
+# Read a LAS file
+las = lasio_rs.read("well_log.las")
+
+# Access metadata
+print(las.version['VERS'].value)  # "2.0"
+print(las.well['WELL'].value)     # Well name
+
+# Access curve data directly
+depth = las['DEPT']  # Returns list of floats
+gr = las['GR']       # Gamma Ray values
+
+# List all curves
+for curve_name in las.keys():
+    curve = las.curves[curve_name]
+    print(f"{curve_name} ({curve.unit}): {len(curve.data)} points")
+```
+
+## 📊 DataFrame Conversion
+
+```python
+# Convert to pandas DataFrame
+df = las.to_df()
+print(df.head())
+
+# Convert to polars DataFrame
+df_polars = las.to_polars()
+```
+
+## 💾 Export Formats
+
+### CSV Export
+```python
+las.to_csv("output.csv")
+```
+
+### Excel Export
+```python
+las.to_excel("output.xlsx", sheet_name="Well Data")
+```
+
+### LAS Export (2.0 and 3.0)
+```python
+# Export as LAS 2.0
+las.to_las("output_v2.las", version="2.0")
+
+# Export as LAS 3.0
+las.to_las("output_v3.las", version="3.0")
+```
+
+## 🔧 API Reference
+
+### `lasio_rs.read(path)`
+Reads a LAS file and returns a `LASFile` object.
+
+### `LASFile` Properties
+| Property | Description |
+|----------|-------------|
+| `version` | Version section (VERS, WRAP) |
+| `well` | Well information (STRT, STOP, STEP, NULL, WELL, etc.) |
+| `curves` | Curve metadata and data |
+| `params` | Parameter section |
+
+### `LASFile` Methods
+| Method | Description |
+|--------|-------------|
+| `las[mnemonic]` | Get curve data as list |
+| `las.keys()` | List curve mnemonics |
+| `las.to_df()` | Convert to pandas DataFrame |
+| `las.to_polars()` | Convert to polars DataFrame |
+| `las.to_csv(path)` | Export to CSV |
+| `las.to_excel(path)` | Export to Excel |
+| `las.to_las(path, version)` | Export to LAS format |
+
+## 🏗️ Building from Source
+
+Requirements:
+- Python 3.7+
+- Rust (cargo, rustc)
+- maturin
+
+```bash
+git clone https://github.com/jemilianofl/lasio-rs.git
+cd lasio-rs
+pip install maturin
+maturin develop --release
+```
+
+## 📋 Supported LAS Versions
+
+- ✅ LAS 2.0
+- ✅ LAS 3.0 (read support)
+- ✅ Export to LAS 2.0/3.0
+
+## 🤝 Compatibility with lasio
+
+`las_read_rs` provides a similar API to the popular `lasio` library:
+
+```python
+# lasio style
+import lasio
+las = lasio.read("file.las")
+depth = las['DEPT']
+
+# las_read_rs style (same!)
+import lasio_rs
+las = lasio_rs.read("file.las")
+depth = las['DEPT']
+```
+
+## 📄 License
+
+MIT
+
+## 🙏 Acknowledgments
+
+- Built with [PyO3](https://pyo3.rs/) for Python bindings
+- Uses [nom](https://github.com/Geal/nom) for parsing
+- Inspired by [lasio](https://github.com/kinverarity1/lasio)
+

las_read_rs-0.1.6.dist-info/RECORD

@@ -0,0 +1,7 @@
+las_read_rs-0.1.6.dist-info/METADATA,sha256=1GVnr5NMXJizwiK06vMYjOUY9NzpGpavZKNL6m3cHbw,3979
+las_read_rs-0.1.6.dist-info/WHEEL,sha256=82nIVBZDB2dcFlYZh5-bKZ63xGZXWMnioaoSK06flpU,103
+lasio_rs/__init__.py,sha256=xYmJ9tdZoIRkXmot_OmqsH18AOP8kFUE_o3ne81VO90,19
+lasio_rs/_lasio_rs.abi3.so,sha256=JjWa0mERYHAmk9YklJcl3Koh9eEq1EC1KPRf-MZVQmo,780224
+lasio_rs/_lasio_rs.cp313-win_amd64.pyd,sha256=QTph_VU95twdlp_ToKpVo-F9O7HC3N4qY40I7gPQ1wI,1380352
+lasio_rs/las.py,sha256=YSW0wO1BMu_osxe7nUHzmx2INo6vsd2RB3BHYxpiTT0,7577
+las_read_rs-0.1.6.dist-info/RECORD,,

las_read_rs-0.1.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.11.5)
+Root-Is-Purelib: false
+Tag: cp38-abi3-macosx_11_0_arm64

lasio_rs/__init__.py

@@ -0,0 +1 @@
+from .las import *

lasio_rs/las.py

@@ -0,0 +1,235 @@
+from ._lasio_rs import read as _rust_read
+import json
+
+try:
+    from ._lasio_rs import read as _rust_read
+except ImportError as e:
+    # Esto da un error mucho más claro al usuario
+    raise ImportError(
+        "No se pudo cargar el binario de Rust (_lasio_rs). "
+        "Asegúrate de haber instalado el paquete correctamente para tu plataforma."
+    ) from e
+
+class SectionItems:
+    def __init__(self, data_dict):
+        # Allow init from dict of HeaderItems or dict of dicts (from json)
+        self._data = {}
+        for k, v in data_dict.items():
+            if isinstance(v, dict):
+                # Check if it is a Curve dict or Header dict
+                self._data[k] = HeaderItem(v)
+            else:
+                self._data[k] = v
+
+    def __getitem__(self, key):
+        item = self._data.get(key)
+        if item:
+            return item
+        raise KeyError(f"{key} not found")
+
+    def keys(self):
+        return self._data.keys()
+
+    def values(self):
+        return self._data.values()
+
+    def items(self):
+        return self._data.items()
+
+    def get(self, key, default=None):
+        return self._data.get(key, default)
+
+    def __repr__(self):
+        return f"SectionItems({list(self.keys())})"
+
+
+class HeaderItem:
+    def __init__(self, item_dict):
+        self.mnemonic = item_dict.get("mnemonic")
+        self.unit = item_dict.get("unit")
+        self.value = item_dict.get("value")
+        self.descr = item_dict.get("descr")
+        self.original_mnemonic = self.mnemonic  # Compatibility
+
+    def __repr__(self):
+        return f'HeaderItem(mnemonic="{self.mnemonic}", unit="{self.unit}", value="{self.value}", descr="{self.descr}")'
+
+
+class CurveItem(HeaderItem):
+    def __init__(self, item_dict, las_file_ref):
+        super().__init__(item_dict)
+        self._las = las_file_ref
+        self._data = None
+
+    @property
+    def data(self):
+        if self._data is None:
+            # Lazy load from Rust
+            self._data = self._las._rust.get_curve_data(self.mnemonic)
+            if self._data is None:
+                self._data = []
+        return self._data
+
+    def __getitem__(self, index):
+        return self.data[index]
+
+    def __len__(self):
+        return len(self.data)
+
+    def __repr__(self):
+        return f'CurveItem(mnemonic="{self.mnemonic}", unit="{self.unit}", value="{self.value}", descr="{self.descr}", data.shape=({len(self)},))'
+
+
+class LASFile:
+    def __init__(self, rust_las):
+        self._rust = rust_las
+
+        # Hydrate metadata from JSON
+        header_json = rust_las.json_headers
+        header_data = json.loads(header_json)
+
+        self.version = SectionItems(header_data.get("version", {}))
+        self.well = SectionItems(header_data.get("well", {}))
+        self.params = SectionItems(header_data.get("params", {}))
+
+        # Curves needs special handling to link back to Rust for data
+        raw_curves = header_data.get("curves", {})
+        self.curves = SectionItems({})
+        # Overwrite with CurveItems
+        curve_dict = {}
+        for k, v in raw_curves.items():
+            curve_dict[k] = CurveItem(v, self)
+        self.curves = SectionItems(curve_dict)
+
+    def __getitem__(self, key):
+        # Access curve data directly by mnemonic
+        if isinstance(key, str):
+            if key in self.curves.keys():
+                return self.curves[key].data
+        raise KeyError(f"Curve {key} not found")
+
+    def keys(self):
+        return self.curves.keys()
+
+    def to_df(self):
+        """Convert LAS data to a pandas DataFrame.
+
+        Returns:
+            pandas.DataFrame: DataFrame with curve mnemonics as columns.
+        """
+        try:
+            import pandas as pd
+        except ImportError:
+            raise ImportError(
+                "pandas is required for to_df(). Install with: pip install pandas"
+            )
+
+        data = {}
+        for mnemonic in self.curves.keys():
+            curve = self.curves[mnemonic]
+            data[mnemonic] = curve.data
+        return pd.DataFrame(data)
+
+    def to_polars(self):
+        """Convert LAS data to a polars DataFrame.
+
+        Returns:
+            polars.DataFrame: DataFrame with curve mnemonics as columns.
+        """
+        try:
+            import polars as pl
+        except ImportError:
+            raise ImportError(
+                "polars is required for to_polars(). Install with: pip install polars"
+            )
+
+        data = {}
+        for mnemonic in self.curves.keys():
+            curve = self.curves[mnemonic]
+            data[mnemonic] = curve.data
+        return pl.DataFrame(data)
+
+    def to_csv(self, path, **kwargs):
+        """Export LAS data to CSV file.
+
+        Args:
+            path: Output file path.
+            **kwargs: Additional arguments passed to pandas.DataFrame.to_csv()
+        """
+        df = self.to_df()
+        df.to_csv(path, index=False, **kwargs)
+
+    def to_excel(self, path, sheet_name="Data", **kwargs):
+        """Export LAS data to Excel file.
+
+        Args:
+            path: Output file path.
+            sheet_name: Name of the Excel sheet.
+            **kwargs: Additional arguments passed to pandas.DataFrame.to_excel()
+
+        Note: Requires openpyxl. Install with: pip install openpyxl
+        """
+        df = self.to_df()
+        df.to_excel(path, sheet_name=sheet_name, index=False, **kwargs)
+
+    def to_las(self, path, version="2.0"):
+        """Export LAS data to LAS file format.
+
+        Args:
+            path: Output file path.
+            version: LAS version ("2.0" or "3.0"). Default is "2.0".
+        """
+        with open(path, "w") as f:
+            # Version Section
+            f.write("~Version Information\n")
+            f.write(
+                f" VERS.                  {version} : CWLS LOG ASCII STANDARD - VERSION {version}\n"
+            )
+            f.write(" WRAP.                  NO  : One line per depth step\n")
+
+            # Well Section
+            f.write("~Well Information\n")
+            for mnem in self.well.keys():
+                item = self.well[mnem]
+                f.write(
+                    f" {mnem:18s}.{item.unit or '':8s} {item.value or '':30s}: {item.descr or ''}\n"
+                )
+
+            # Curve Section
+            f.write("~Curve Information\n")
+            for mnem in self.curves.keys():
+                curve = self.curves[mnem]
+                f.write(
+                    f" {mnem:18s}.{curve.unit or '':8s}                              : {curve.descr or ''}\n"
+                )
+
+            # Parameter Section (if exists)
+            if len(list(self.params.keys())) > 0:
+                f.write("~Parameter Information\n")
+                for mnem in self.params.keys():
+                    item = self.params[mnem]
+                    f.write(
+                        f" {mnem:18s}.{item.unit or '':8s} {item.value or '':30s}: {item.descr or ''}\n"
+                    )
+
+            # ASCII Data Section
+            f.write("~A")
+            for mnem in self.curves.keys():
+                f.write(f" {mnem}")
+            f.write("\n")
+
+            # Get data length from first curve
+            first_curve = self.curves[list(self.curves.keys())[0]]
+            nrows = len(first_curve.data)
+
+            for i in range(nrows):
+                row = []
+                for mnem in self.curves.keys():
+                    val = self.curves[mnem].data[i]
+                    row.append(f"{val:12.6f}")
+                f.write(" ".join(row) + "\n")
+
+
+def read(file_path):
+    rust_obj = _rust_read(str(file_path))
+    return LASFile(rust_obj)