log2frame 0.2.3

A function to facilitate loading well log data, in las or dlis format, as dataframe.

log2frame

import log2frame

A function to read well log data in LAS, LIS and DLIS formats and extract curves data as DataFrame.

The curves and header data are stored in an instance of Log class, designed to hold this data and operate with it. It provides convenient access to metadata like well name, UWI, and curve units (via .units or the safer .units_dict()). If multiple log files are read together, the Log instances are packed in a Pack instance, designed to hold Log instances and operate with them.

unit-aware mode

When simpandas is installed, log2frame can preserve curve units and index units through the use_simpandas option.

• log2frame.read(path, use_simpandas=False) returns plain pandas-backed Log instances.
• log2frame.read(path, use_simpandas=True) uses simpandas.SimDataFrame when available.
• If use_simpandas is omitted, the package defaults to the installed simpandas setting.

to read log files

Simply call the function read() with the path or path pattern as argument:

to export / write LAS files

Use write_las() to export a Log back to a LAS file:

• log2frame.write_las( log, path_to_file ) — writes LAS 2.0 by default
• log2frame.write_las( log, path_to_file, version=1.2 ) — LAS 1.2
• log.to_las( path_to_file ) — equivalent convenience method on Log

a single log file

To load a single .las, .lis or .dlis file. The function will return a Log instance containing the data:

• log2frame.read( path_to_file )

several files in a folder

To load several files at once. In this case the read() function will return a Pack instance containing a Log instance for each log file:

• log2frame.read( path_to_folder_containing_files/*.* ) By default, any invalid file will be ignored, thus, there is no problem to have other files in the same folder as the log files.

several files recursively

To read files recursively in subdirectories, use the appropriate fnmatch pattern:

• log2frame.read( path_to_folder_containing_files/**/*.* )

further examples and details

Please refer to the Jupyter notebook log2frame_demo for further examples and details on how to use log2frame.
The sample data is publicly available at NLOG.