dlisio is an LGPL licensed library for working with well logs in Digital Log Interchange Standard (DLIS V1), also known as RP66 V1. DLIS V2 is out-of-scope for this project, as it is quite different and hardly in use in the industry. It is an attempt at a powerful community-driven, portable, easy-to-use and flexible library for well logs, that can be used to build a wide array of applications.
As of version 0.3.0, dlisio is extended to also read Log Information Standard 79 (LIS79). An extended version of the LIS79 standard called LIS84/Enhanced LIS exists, but this version is currently not supported by dlisio. Please note that the LIS reader is experimental and lacks the same thorough testing and real world experience as the DLIS reader.
Features are added as they are needed; suggestions, defect reports, and contributions of all kinds are very welcome.
dlisio is in rapid development, and the interfaces are not stable. We welcome any users and will try our best to accomodate your needs, but we currently make no guarantees that code that works today will work tomorrow.
The end-user should go through the python library, as the core library is intended for developers only. The pre-built alpha releases are available through pypi
pip3 install dlisioOnce dlisio is stable it will also be available as debian, fedora, and conda packages.
To develop dlisio, or to build a particular revision from source, you need:
- A C++11 compatible compiler (tested daily on gcc, clang, and msvc 2015)
- CMake version 3.5 or greater
- Python version 3.6 or greater
- fmtlib tested mainly with 5.3.0
- mpark_variant
- pybind11 version 2.6 or greater
- setuptools version 28 or greater
- layered-file-protocols
- python packages pytest, pytest-runner, and numpy
If you do not have pybind11 installed on your system, the easiest way to get a
working copy is to pip3 install pybind11 (NP! pybind11, not pybind)
layered-file-protocols has to be installed from source if you don't already have it on your system:
git clone https://github.com/equinor/layered-file-protocols.git
mkdir layered-file-protocols/build
cd layered-file-protocols/build
cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=ON
-DLFP_FMT_HEADER_ONLY=ON
make
make installTo then build and install dlisio:
mkdir dlisio/build
cd dlisio/build
cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=ON
makedlisio follows common cmake rules and conventions, e.g. to set install prefix
use -DCMAKE_INSTALL_PREFIX. To build the python library it is usually a good
idea to build shared libraries. To disable python, pass -DBUILD_PYTHON=OFF.
By default, the python library is built.
dlisio's documentation is hosted on readthedocs. Please refer there for proper introduction to dlisio, and the file-formats DLIS and LIS. With dlisio it is easy to read the curve-data from DLIS-files:
from dlisio import dlis
with dlis.load('myfile.dlis') as files:
for f in files:
for frame in f.frames:
curves = f.curves()
# Do something with the curvesand from LIS-files:
from dlisio import lis
with lis.load('myfile.lis') as files:
for f in files:
for format_spec in f.data_format_specs:
curves = lis.curves(f, format_spec)
# Do something with the curvesIn both cases the curves are returned as structured numpy.ndarray with the curve mnemonics as field names (column names).
We welcome all kinds of contributions, including code, bug reports, issues, feature requests, and documentation. The preferred way of submitting a contribution is to either make an issue on github or by forking the project on github and making a pull request.