https://github.com/softlandia/glasio

golang library for read/write/control las files
https://github.com/softlandia/glasio

data-format data-mining geology golang golang-library golang-package las las-files log-ascii-standart petroleum petroleum-engineering

Last synced: 2 months ago
JSON representation

golang library for read/write/control las files

• Host: GitHub
• URL: https://github.com/softlandia/glasio
• Owner: softlandia
• License: other
• Created: 2019-08-03T14:11:48.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-07-16T23:23:55.000Z (over 5 years ago)
• Last Synced: 2024-06-20T19:24:08.731Z (almost 2 years ago)
• Topics: data-format, data-mining, geology, golang, golang-library, golang-package, las, las-files, log-ascii-standart, petroleum, petroleum-engineering
• Language: Go
• Size: 6.01 MB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# golang las library #

(c) softlandia@gmail.com

>download: go get -u github.com/softlandia/glasio  

>install: go install

The library makes it easy to read or write data in LAS format.

The main reason for the development was the need to read and standardize a large number of LAS files obtained from various sources

Features:

1. The encoding is determined automatically

2. On reading perform validation of the key parameters and integrity of the structure LAS file

3. Messages are generated for all inconsistencies:

    - zero value of important parameters

    - depth step change in data section

    - lack of curves section

    - conversion errors to a numerical value

    - mismatch of the step parameter declared in the header to the actual

    - duplication of curve names

4. Excluding critical errors, the library allows you to read the file and get data

5. Saving a file ensures the integrity of the structure and its readability for most other programs

6. It is possible to specify a dictionary of standard mnemonics; when reading a file, messages about curves that do not match the specified ones will be generated

7. It is possible to specify a dictionary of automatic substitution of mnemonics, respectively, curves with the given names will be renamed

Wrapped (__WRAP__) las files are not supported

## dependences ##

- github.com/softlandia/cpd

- github.com/softlandia/xlib

## examples ##

simple

- make empty LAS file

- reads sample file "expand_points_01.las", write md file with messages

- saves the recovered LAS file "expand_points_01+.las"

repaire

- reads all LAS files in current folder

- saves the recovered files to the same folder

lasin

- reads LAS file

- print warning

## tests ##

coverage 91%  

The "data" folder contains files for testing, no remove/change/add

## technical info ##

### how type Las store data ###

access to main parameters:  

las.VERS()  

las.WRAP()  

las.STEP()  

las.STRT()  

las.STOP()  

las.NULL()  

las.WELL()

number of points and curves:  

las.NumPoints() - number of points

len(las.Logs) - number of curves

access to curves and data:  

las.Logs[0].D[0] - first depth  

las.Logs[1].V[100] - value of first curve on 101 depth step  

las.Logs[2].Name - name of second curve  

las.Logs[2].Unit - unit of second curve  

las.Logs[2].Mnemonic - mnemonic of second curve, the value is determined if the dictionary was applied  

if las file contains duplication of any parameter, then use the first in curve

section used all curves name. The subsequent duplicated parameter is renamed.

## warnings generated when reading a LAS file ##

### warning format ###

extended:  

> x, y, "message text"  

> x - section number  

> y - line number of input file