well-log-toolkit 0.1.121__py3-none-any.whl → 0.1.123__py3-none-any.whl

well_log_toolkit/well.py

@@ -335,9 +335,18 @@ class Well:
         # Mark source as modified
         self._sources[source_name]['modified'] = True
 
-    def load_las(self, las: Union[LasFile, str, Path], sampled: bool = False, resample_method: Optional[str] = None, merge: bool = False) -> 'Well':
+    def load_las(
+        self,
+        las: Union[LasFile, str, Path, list[Union[str, Path]]],
+        path: Optional[Union[str, Path]] = None,
+        sampled: bool = False,
+        resample_method: Optional[str] = None,
+        merge: bool = False,
+        combine: Optional[str] = None,
+        source_name: Optional[str] = None
+    ) -> 'Well':
         """
-        Load LAS file into this well, organized by source.
+        Load LAS file(s) into this well, organized by source.
 
         Properties are grouped by source (LAS file). The source name is derived
         from the filename stem (without extension), sanitized for Python attribute
@@ -346,8 +355,12 @@ class Well:
 
         Parameters
         ----------
-        las : Union[LasFile, str, Path]
-            Either a LasFile instance or path to LAS file
+        las : Union[LasFile, str, Path, list[Union[str, Path]]]
+            Either a LasFile instance, path to LAS file, or list of LAS file paths.
+            When providing a list, filenames can be relative to the path parameter.
+        path : Union[str, Path], optional
+            Directory path to prepend to all filenames. Useful when loading multiple
+            files from the same directory. If None, filenames are used as-is.
         sampled : bool, default False
             If True, mark all properties from this source as 'sampled' type.
             Use this for core plug data or other point measurements where
@@ -365,6 +378,15 @@ class Well:
             properties into the existing source instead of overwriting it.
             When merging with incompatible depth grids, resample_method must be specified.
             If False (default), existing source is overwritten with warning.
+        combine : str, optional
+            When loading multiple files (list), combine them into a single source:
+            - None (default): Load files as separate sources, no combining
+            - 'match': Combine using match method (safest, errors on mismatch)
+            - 'resample': Combine using resample method (interpolates to first file)
+            - 'concat': Combine using concat method (merges all unique depths)
+        source_name : str, optional
+            Name for combined source when combine is specified. If not specified,
+            uses 'combined_match', 'combined_resample', or 'combined_concat'
 
         Returns
         -------
@@ -381,28 +403,103 @@ class Well:
 
         Examples
         --------
-        >>> well = manager.well_36_7_5_B
+        >>> # Load single file
         >>> well.load_las("36_7-5_B_CorePor.las")  # Source name: "CorePor"
-        >>> well.load_las("36_7-5_B_Log.las")      # Source name: "Log"
-        >>> well.load_las("formation_tops.las")    # Source name: "formation_tops"
+
+        >>> # Load multiple files as separate sources
+        >>> well.load_las(["file1.las", "file2.las", "file3.las"])
+        >>> print(well.sources)  # ['file1', 'file2', 'file3']
+
+        >>> # Load and combine multiple files
+        >>> well.load_las(
+        ...     ["file1.las", "file2.las", "file3.las"],
+        ...     combine="match",
+        ...     source_name="CombinedLogs"
+        ... )
+        >>> print(well.sources)  # ['CombinedLogs']
+
         >>> # Load core plug data as sampled
         >>> well.load_las("36_7-5_B_Core.las", sampled=True)
-        >>> # Load data with incompatible depths
-        >>> well.load_las("interpreted.las", resample_method='linear')
-        >>> # Merge additional properties into existing source
+
+        >>> # Load with resample combining
+        >>> well.load_las(
+        ...     ["log1.las", "log2.las"],
+        ...     combine="resample",
+        ...     source_name="CombinedLogs"
+        ... )
+
+        >>> # Merge into existing source (legacy behavior)
         >>> well.load_las("CorePor.las")  # Load initial properties
-        >>> well.load_las("CorePor_Extra.las", merge=True)  # Merge new properties into "CorePor"
-        >>> # Access by source
-        >>> well.CorePor.PHIE
-        >>> well.Log.GR
-        >>> # Access directly if unique
-        >>> well.PHIE  # Error if both CorePor and Log have PHIE
+        >>> well.load_las("CorePor_Extra.las", merge=True)  # Merge new properties
+
+        >>> # Load multiple files from same directory
+        >>> well.load_las(
+        ...     ["file1.las", "file2.las", "file3.las"],
+        ...     path="data/well_logs",
+        ...     combine="match",
+        ...     source_name="AllLogs"
+        ... )
+        >>> # Loads: data/well_logs/file1.las, data/well_logs/file2.las, etc.
+
+        >>> # Mix of relative and absolute paths
+        >>> well.load_las(
+        ...     ["log1.las", "log2.las"],
+        ...     path="/absolute/path/to/logs"
+        ... )
         """
+        # Handle list of files
+        if isinstance(las, list):
+            # Prepend path to all filenames if provided
+            if path is not None:
+                base_path = Path(path)
+                las_files = [base_path / las_file for las_file in las]
+            else:
+                las_files = las
+
+            # Load all files as separate sources
+            loaded_sources = []
+            for las_file in las_files:
+                # Recursively call load_las for each file (without merge or combine, path already prepended)
+                self.load_las(las_file, path=None, sampled=sampled, resample_method=resample_method, merge=False, combine=None)
+                # Get the source name that was just created
+                loaded_sources.append(self.sources[-1])
+
+            # Combine if requested
+            if combine in {'match', 'resample', 'concat'}:
+                # Determine combined source name
+                combined_source_name = source_name or f'combined_{combine}'
+
+                # Merge all loaded sources
+                self.merge(
+                    method=combine,
+                    sources=loaded_sources,
+                    source_name=combined_source_name
+                )
+
+                # Remove original sources
+                self.remove_source(loaded_sources)
+
+            return self
+
+        # Single file logic below
+        # Validate combine parameter for single file
+        if combine is not None:
+            raise ValueError(
+                f"combine='{combine}' is only valid when loading multiple files (list). "
+                f"For single file loading, use merge=True to merge into existing source."
+            )
+
         # Parse if path provided
         filepath = None
         if isinstance(las, (str, Path)):
-            filepath = Path(las)
-            las = LasFile(las)
+            # Prepend path if provided
+            if path is not None:
+                las_path = Path(path) / las
+            else:
+                las_path = Path(las)
+
+            filepath = las_path
+            las = LasFile(las_path)
         elif hasattr(las, 'filepath') and las.filepath:
             filepath = Path(las.filepath)
 

{well_log_toolkit-0.1.121.dist-info → well_log_toolkit-0.1.123.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: well-log-toolkit
-Version: 0.1.121
+Version: 0.1.123
 Summary: Fast LAS file processing with lazy loading and filtering for well log analysis
 Author-email: Kristian dF Kollsgård <kkollsg@gmail.com>
 License: MIT

{well_log_toolkit-0.1.121.dist-info → well_log_toolkit-0.1.123.dist-info}/RECORD

@@ -8,8 +8,8 @@ well_log_toolkit/regression.py,sha256=7D3oI-1XVlFb-mOoHTxTTtUHERFyvQSBAzJzAGVoZn
 well_log_toolkit/statistics.py,sha256=_huPMbv2H3o9ezunjEM94mJknX5wPK8V4nDv2lIZZRw,16814
 well_log_toolkit/utils.py,sha256=O2KPq4htIoUlL74V2zKftdqqTjRfezU9M-568zPLme0,6866
 well_log_toolkit/visualization.py,sha256=xb870FG5FghU2gEkqdn1b2NbWNu07oDmFDN1Cx1HIi0,157280
-well_log_toolkit/well.py,sha256=xPTdVuhlctjinHaFrmLWImAC5JUchXQs9jTazZzdlnU,99609
-well_log_toolkit-0.1.121.dist-info/METADATA,sha256=qXxUw5-wiWwTDjeulBwpuZ2vCuwW0X5r22cL1XOi3e4,59810
-well_log_toolkit-0.1.121.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-well_log_toolkit-0.1.121.dist-info/top_level.txt,sha256=BMOo7OKLcZEnjo0wOLMclwzwTbYKYh31I8RGDOGSBdE,17
-well_log_toolkit-0.1.121.dist-info/RECORD,,
+well_log_toolkit/well.py,sha256=kIN3Zr0sI3Zt3DeHbxDXADbQfWnVxXCQrHZ4UEMyeqI,103343
+well_log_toolkit-0.1.123.dist-info/METADATA,sha256=gI89Dn-k1W6yy9ODs-5Roj1wiZ2GpMlc7deaBcpq3KA,59810
+well_log_toolkit-0.1.123.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+well_log_toolkit-0.1.123.dist-info/top_level.txt,sha256=BMOo7OKLcZEnjo0wOLMclwzwTbYKYh31I8RGDOGSBdE,17
+well_log_toolkit-0.1.123.dist-info/RECORD,,