List of changes

Unreleased changes (Available on GitHub)

  • Fix #322 - provide a way to consistently retrieve header items which may or may not be present in the header:

    If you try ordinary item-style access, as is normal in Python, a KeyError exception will be raised if it is missing:

    >>> permit = las.well['PRMT']
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
      File "c:\devapps\kinverarity\projects\lasio\lasio\las_items.py", line 313, in __getitem__
        raise KeyError("%s not in %s" % (key, self.keys()))
    KeyError: "PRMT not in ['STRT', 'STOP', 'STEP', 'NULL', 'COMP', 'WELL', 'FLD', 'LOC', 'PROV', 'SRVC', 'DATE', 'UWI']"
    

    A better pattern is to use the lasio.SectionItems.get() method, which allows you to specify a default value in the case of it missing:

    >>> permit = las.well.get('PRMT', 'unknown')
    >>> permit
    HeaderItem(mnemonic="PRMT", unit="", value="unknown", descr="")
    

    You can use the add=True keyword argument if you would like this header item to be added, as well as returned:

    >>> permit = las.well.get('PRMT', 'unknown', add=True)
    >>> las.well
    [HeaderItem(mnemonic="STRT", unit="M", value="0.05", descr="FIRST INDEX VALUE"),
    HeaderItem(mnemonic="STOP", unit="M", value="136.6", descr="LAST INDEX VALUE"),
    HeaderItem(mnemonic="STEP", unit="M", value="0.05", descr="STEP"),
    HeaderItem(mnemonic="NULL", unit="", value="-99999", descr="NULL VALUE"),
    HeaderItem(mnemonic="COMP", unit="", value="", descr="COMP"),
    HeaderItem(mnemonic="WELL", unit="", value="Scorpio E1", descr="WELL"),
    HeaderItem(mnemonic="FLD", unit="", value="", descr=""),
    HeaderItem(mnemonic="LOC", unit="", value="Mt Eba", descr="LOC"),
    HeaderItem(mnemonic="SRVC", unit="", value="", descr=""),
    HeaderItem(mnemonic="CTRY", unit="", value="", descr=""),
    HeaderItem(mnemonic="STAT", unit="", value="SA", descr="STAT"),
    HeaderItem(mnemonic="CNTY", unit="", value="", descr=""),
    HeaderItem(mnemonic="DATE", unit="", value="15/03/2015", descr="DATE"),
    HeaderItem(mnemonic="UWI", unit="", value="6038-187", descr="WUNT"),
    HeaderItem(mnemonic="PRMT", unit="", value="unknown", descr="")]
    

Version 0.30 (12 May 2022)

  • Fixes for #446 (Implement a numpy-based reader for the data section; #452) and #444 (Provide a way to benchmark speed performance of LASFile.read; #449). This leads to a more than two-fold improvement in speed (e.g. from 1091 msec to 341 msec for a large sample file).
  • Fixes for #439 (Data section containing non-numeric chars is parsed entirely as str) and #227 (NULL value replacing valid value in DEPT) by allowing different data types for different columns (PRs #459, #460, #461)
  • Partially fix #375 (allow writing mnemonics in ~ASCII line; PRs #466, #471, #465)
  • Partial fix for #265 (Parse comma-delimited ~ASCII sections; #485)
  • Fix #83 (LAS file with more curves defined in ~C section than available in ~A section; #480)
  • Improve visibility and access to the Code of Conduct (#469)
  • Fix #453 (rounding issues when writing LAS file) (#455)
  • Fix #268 (remove side-effects from writer) (#447, #451)
  • Documentation updates (#475, #477, #481, #501, #498, #500)
  • Fix #473 (Header lines without a period are discarded unnecessarily)
  • Fix #472 (Detect and raise IOError exception for LiDAR files; #482)
  • Fix #483 (perfomance decrease in DEBUG logging level; #484)
  • Fix #478 (:1 :2 should only be appended to mnemonics when using LASFile.read) with #479: Add update_curve and replace_curve_item methods to LASFile
  • Fix #490 (LAS 2.1 reading error; #491)
  • Fix #486 (Adding a citation file, and maybe a DOI; #487)
  • Fix #392 (ignore_comments not mentioned in documentation; #495)
  • Fix #332: Describe default read_policies in docstring, with #489
  • Fix #502 (NumPy type conversion alias deprecation; #503)
  • minor performance improvements (#470, )

Version 0.29 (14 April 2021)

  • Fix #404 (lasio changes STEP with imprecise floating-point number behaviour; #432)
  • Add option len_numeric_field=-1, lhs_spacer=" ", and spacer=" " to writer.py:write (see #412; PR #418)
  • Fix #271 (Read quoted strings in data section properly; #423)
  • Fix #427 (Change null_policy to handle small non-zero values; #429)
  • Fix #417 (Fix parsing for empty ~Other section; #430)
  • Fix #402 (fixes issue when unit starts with dot; #403)
  • Fix #395 (Update doc examples to reflect new HeaderItem repr; #410)
  • Fix #426 (Update urllib.request to be the preferred urllib; #428)
  • Add check for pushed tag version to version tests (#396)
  • Update GitHub Action Python CI testing (#399, #400)
  • Improve las_items.py:HeaderItem.__repr__ truncation logic (#397)
  • Remove codecs import (unused) and fix typo (#406)
  • Exclude LAS files from GitHubs Language Stats (#411)
  • Re-add try-except check around call to reader.read_data_section_iterative() (#401)
  • Remove reader.py:read_file_contents - unused code (see #401; #393)
  • Add test for timestring with colon in ~Well section (see #419 - PR #420)
  • Fix SyntaxWarning in writer.py (#425)
  • Add bugfix and feature request issue templates to GitHub repository
  • Apply black code style to all Python files (#438, #398)
  • Update demo notebook for using logging levels with current behaviour
  • Update contributing guide (#437, #441)

Version 0.28 (12 September 2020)

  • Major re-write of reader code working towards LAS 3.0 support (#327; #347, #345, #353, #355, #358, #367, #368, #369)
  • Fix #377 (writing “None” as the value instead of “”; #377)
  • Fix #373 (enable GitHub Actions CI testing on MacOS, Windows, Ubuntu; #374, #387)
  • Fix #363 (parse composite units such as “1000 lbf” correctly; #390)
  • Fix #319 (allow skipping comment lines in data sections; #391)
  • Avoid unnecessary exceptions on reading LAS 3.0 data sections (#385)
  • Fix broken ReadTheDocs build

Version 0.27 (4 September 2020)

  • Fix #380 (install failed without git installed; #382)

Version 0.26 (31 August 2020)

  • This is the final version which works on Python 2.7 (#364)
  • Fix #333 (header lines not parsed when colon is in description; #335)
  • Fix #359 (sections not found when leading whitespace in line; #360, #361)
  • Fix #350 (bug with NULL; #352)
  • Fix #339 (0.1IN not recognised as index unit; #340, #349)
  • Fix #31 (add command-line script to convert between LAS versions; #329)
  • Fix #75 (add Cyrillic variant for metres; #330)
  • Fix #326 (Support header-only LAS files–don’t lose the last header section before a missing ~A section)
  • Improve documentation regarding deleting items and curves (#315, #325)
  • Add deprecation markers (#331)
  • Align json.dumps and LASFile.to_json() (#328)
  • Fixes and updates to setup.py relating to the adoption of setuptools_scm (#312, #317, #318)
  • Clean up and background changes related to future LAS 3.0 support: #334, #337, #338, #341, #342, #346, #348, #372

Version 0.25.1 (1 May 2020)

  • Shift to setuptools_scm (#311)
  • Fix #321 (EOF character causes error on read)
  • Fix #182 (remove side-effect LASFile.write causing LASFile.version.VERS to change)
  • Fix #310 (remove LASFile.metadata which was not working)

Version 0.25 (28 March 2020)

  • Add stack_curves() method to allow joining a set of curves into a 2D array (issue #284, PR #293)
  • Add lasio.examples module (#296)
  • Fix #278 (leading zeroes were being stripped from API/UWI numbers)
  • Fix #286 (error on trying to write a file with one row of data)
  • Fix #258 (do not catch Ctrl+C when reading file)
  • Fix #292 (improve error checking for when trying to write non-2D data)
  • Fix #277 (allow pathlib objects to lasio.read)
  • Fix #264 (allow periods in mnemonics to be retained in specific cases)
  • Fix #201 (adjust descr parsing in ~P section to allow times in the descr, see PR #298)
  • Fix #302 (change in str(datetime) handling)
  • Fixes to JSON output (#300, #303)
  • Fix #304 (add column_fmt argument to LASFile.write method)

Version 0.24

  • Fix #256 (parse units in brackets and add index_unit kwarg)

Version 0.23

  • Fix #259 (error when encoding missing from URL response headers)
  • Fix #262 (broken build due to cchardet dependency)

Version 0.22

  • Fix #252 (removing case sensitivity in index_unit checks)
  • Fix #249 (fix bug producing df without converting to floats)
  • Attempt to fix Lasso classification on GitHub

Version 0.21

  • Fix #236 and #237 (can now read ASCII in ~Data section)
  • Fix #239 (Petrel can’t read lasio output)

Version 0.20

  • Fix #233 (pickling error lost Curve.data during multiprocessing)
  • Fix #226 (do not issue warning on empty ~Parameter section)
  • Revised default behaviour to using null_policy=’strict’ (ref. #227)
  • Fix #221 (depths > 10000 were being rounded by default)
  • Fix #225 (file handle leaked if exception during parsing)

Version 0.19

  • Fix #223 (critical version/installation bug)

Version 0.18

  • Fix version numbering setup
  • Fix #92 (can ignore blah blah lines in ~C section)
  • Fix #209 (can now add curves with LASFile[‘mnemonic’] = [1, 2, 3])
  • Fix #213 (LASFile.data is now a lazily generated property, with setter)
  • Fix #218 (LASFile.append_curve was not adding data=[…] properly)
  • Fix #216 (LASFile now raises KeyError for missing mnemonics)
  • Fix #214 (first duplicate mnemonic when added was missing the :1)

Version 0.17

  • Add Appveyor continuous integration testing
  • Add example notebook for how to use python logging module
  • Fix #160 (add methods to LASFile for inserting curves)
  • Fix #155 (implement del keyword for header items)
  • Fix #142 (implement slicing for SectionItems)
  • Fix #135 (UWI numbers losing their leading zeros)
  • Fix #153 (fix SectionItems pprint repr in Python 3)
  • Fix #81 (accept header items with missing colon)
  • Fix #71 (add Docker build for lasio to DockerHub)
  • Fix #210 (allow upper/lowercase standardization of mnemonics on read)
  • Document recent additions (nearly up to date) (in Sphinx docs)

Version 0.16

  • Add read_policy and null_policy keywords - see documentation for details
  • Fix bugs around files with missing ~V ~W ~P or ~C sections (#84 #85 #78)
  • Fix #17 involving files with commas as a decimal mark
  • Improve LASHeaderError traceback message
  • Fix bug involving files with ~A but no data lines following
  • Fix bug with blank line at start of file
  • Fix bug involving missing or duplicate STRT, STOP and STEP mnemonics

Version 0.15.1

  • Major performance improvements with both memory and speed
  • Major improvement to read parser, now using iteration
  • Add LASFile.to_excel() and LASFile.to_csv() export methods
  • Improve las2excelbulk.py script
  • Published new and updated Sphinx documentation
  • Improved character encoding handling when chardet not installed
  • autodetect_encoding=True by default
  • Allow reading of multiple non-standard header sections (#167, #168)
  • Add flexibility in reading corrupted headers (ignore_header_errors=True)
  • Add ability to avoid reading in data (ignore_data=True)
  • Remove excessive debugging messages
  • Fix bug #164 where FEET was not recognised as FT
  • Fix major globals() bug #141 affecting LASFile.add_curve
  • Add command-line version script $ lasio to show version number.

Version 0.14 and 0.15 skipped due to broken PyPI upload.

Version 0.13

  • Other minor bug fixes inc inability to rename mnemonics in written LAS file.

Version 0.11.2

  • Fix bug with not correctly figuring out units for LASFile.write()
  • Add LASFile.add_curve(CurveItem) method which automatically goes to the old method at LASFile.add_curve_raw(mnemonic=, data=, ...) if necessary, so it should be transparent to users

Version 0.11

  • Reorganise code into modules
  • various

Version 0.10

  • Internal change to SectionItems for future LAS 3.0 support
  • Added JSON encoder
  • Added examples for using pandas DataFrame (.df attribute)
  • LAS > Excel script refined (las2excel.py)

Version 0.9.1 (2015-11-11)

  • pandas.DataFrame now as .df attribute, bugfix

Version 0.8 (2015-08-20)

  • numerous bug fixes, API documentation added

Version 0.7 (2015-08-08)

  • all tests passing on Python 2.6 through 3.4

Version 0.6 (2015-08-05)

  • bugfixes and renamed from las_reader to lasio

Version 0.5 (2015-08-01)

  • Improvements to writing LAS files

Version 0.4 (2015-07-26)

  • Improved handling of character encodings, other internal improvements

Version 0.3 (2015-07-23)

  • Added Python 3 support, now reads LAS 1.2 and 2.0

Version 0.2 (2015-07-08)

  • Tidied code and published on PyPI