lasfile 0.2.5

A Python library for reading LAS files.

lasfile

Library for reading CWLS Log ASCII Standard v. 1.2, 2.0, and 3.0 .las files.

Installation

pip install lasfile

Usage

Read LAS file

import lasfile

las = lasfile.LASFile(file_path='path/to/file.las')

In order for an lasfile to properly read, and pass a critical error check, it must have the following sections:

• Version
• Well
• Curves
• Data

View sections in LAS file

las.sections

View section data in LAS file

Using dot notation

As raw ascii text

las.well.raw_data

As pandas dataframe

las.well.df

Using dictionary notation

As raw ascii text

las['well']['raw_data']

As pandas dataframe

las['well']['df']

Write LAS file

The write function allows you to write LAS files based on the sections available in the LASFile object.

Usage:

from lasfile import write

write(las, overwrite=False, file_path='path/to/output/file.las')

Functionality:

• If a 'file_path' is not passed to the function, the 'write' function will attempt to overwrite the existing file stored in the 'file_path' variable of the LASFile object. Overwrite functionality is disabled by default but can be enabled by setting the 'overwrite' attribute to 'True'.

Limitations:

• Currently, the write functionality cannot write LAS v. 3.0 files. This feature is under development.
• LAS v. 3.0 files can be written to LAS v. 2.0 format by setting the 'version' keyword argument of the 'write' function to '2.0'. However, this will result in the loss of any data stored in sections not found in the LAS v. 2.0 format.

Read and Write Capabilities

Version	Read	Write
1.2	✔ Working	✔ Working
2.0	✔ Working	✔ Working
3.0	✔ Working	🚧 In Development

Errors

View all errors

las.errors

View specific errors

las.open_error
las.read_error
las.split_error
las.version_error
las.parse_errors
las.validate_errors

Check for errors

Check for only critical errors

lasfile.error_check(las)

Check for all errors

lasfile.error_check(las, critical_only=False)

LASSection objects can also be passed to error_check

lasfile.error_check(las.well)

License

MIT