abv-hub / las-util-cpp

LAS (Log Ascii Standard v2.0) parser in c++: beta-level-software

NAME

LAS-Util-Cpp - LAS parser in C++

TABLE-OF-CONTENTS

• DESCRIPTION
• SYNOPSIS
• OPTIONS
• INSTALL-COMPILE-AND-RUN
• EXAMPLES
• PROJECT-ROADMAP
• FEATURE-REQUEST
• BUGS
• COPYRIGHT

DESCRIPTION

Caution: This is beta software!

basic LAS (Log Ascii Standard) well-log parser in c++

lasUtil partially reads a las formatted file.

The parser currently parses and displays the following sections:

• Version
• Well-Information
• Curve
• Parameter
• Other

The current goal of LAS-Util are:

• Parse LAS header meta-data records(lines)
• Explore the LAS file format specifications
• Explore design decisions related to CPP-Lang

LAS file format versions are written and maintained by
the Canadian Well Logging Society at
https://www.cwls.org/products/

SYNOPSIS

Usage: lasUtil -f <las_filename> [-p <sections_to_print>]

Sections to print:
Specify which sections to display by listing the letters following '-p'

Letter	Section
v	Version Information Section
w	Well Information Section
c	Curve Section
p	Log Parameter Section
o	Other Section
a	Drilling Data Section

INSTALL-COMPILE-AND-RUN

Note: Currently validated with GNU's g++-9 compiler

git clone https://github.com/dcslagel/las-util-cpp
cd las-util-cpp/src  
make clean
make  
cd ..
./src/lasUtil -f examples/sample_2.0.las

EXAMPLES

• Display help
  ./src/lasUtil -h

• Display all sections of a given LAS file
  ./src/lasUtil -f examples/sample_2.0.las

• Display only the well information section of a given LAS file
  ./src/lasUtil -p w -f examples/sample_2.0.las

• Display the version and well information sections of a given LAS file
  ./src/lasUtil -p vw -f examples/sample_2.0.las

OPTIONS

-f LAS file to parse

-p options for displaying section information

-h display help

PROJECT-ROADMAP

las-util-cpp's project road-map is managed in github milestones at:

https://github.com/dcslagel/las-util-cpp/milestones

1. The current work-in-progress milestone is 0.0.3:

https://github.com/dcslagel/las-util-cpp/milestone/5

• Goals:
  • Add Add a REPL command loop
  • Add additional tests

FEATURE-REQUEST

To request and discuss a potential feature create an issue at:

• https://github.com/dcslagel/las-util-cpp/issues

BUGS

• Functionality is very basic.

• Report bugs by creating an issue at:

  • https://github.com/dcslagel/las-util-cpp/issues

COPYRIGHT

Copyright (c) 2019, 2020 DC Slagel and contributors