https://github.com/laslibs/las-go
Go library for parsing standard well log files (Geophysical well logs)
https://github.com/laslibs/las-go
geophysics go golang las las-go lasgo well-logs
Last synced: 24 days ago
JSON representation
Go library for parsing standard well log files (Geophysical well logs)
- Host: GitHub
- URL: https://github.com/laslibs/las-go
- Owner: laslibs
- License: mit
- Created: 2019-12-18T15:54:16.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-11-07T21:13:18.000Z (over 5 years ago)
- Last Synced: 2024-06-19T04:13:12.599Z (over 1 year ago)
- Topics: geophysics, go, golang, las, las-go, lasgo, well-logs
- Language: Go
- Homepage:
- Size: 112 KB
- Stars: 8
- Watchers: 2
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# las-go is a GoLang library/package for parsing .Las file (Geophysical well log files).
### Currently supports only version 2.0 of [LAS Specification](https://www.cwls.org/wp-content/uploads/2017/02/Las2_Update_Feb2017.pdf). For more information about this format, see the Canadian Well Logging Society [product page](https://www.cwls.org/products/).
## How to use
- Installing
> GO GET
```sh
go get github.com/laslibs/las-go
```
- Test
```sh
go test ./...
```
- Usage
```go
import (
lasgo "github.com/laslibs/las-go"
)
```
- Read data
> Use `Las.Data()` to get a 2-dimensional slice containing the readings of each log
```go
func main() {
las, err := lasgo.Las("sample/A10.las")
if err != nil {
panic(err)
}
fmt.Println(las.Data())
/**
[[2650.0 177.825 -999.25 -999.25],
[2650.5 182.5 -999.25-999.25]
[2651.0180.162 -999.25 -999.25]
[2651.5 177.825 -999.25 -999.25]
[2652.0 177.825 -999.25 -999.25] ...]
*/
}
```
- Get the log headers
```go
// ...
headers := las.Header();
fmt.Println(headers);
// [DEPTH GR NPHI RHOB]
// ...
```
- Get the log headers descriptions as `map[string]string`
```go
//...
headerAndDesc := las.headerAndDesc()
fmt.Println(headerAndDesc)
// [DEPTH: DEPTH GR: Gamma Ray NPHI: Neutron Porosity RHOB: Bulk density]
// ...
```
- Get a particular column, say Gamma Ray log
```go
// ...
gammaRay := las.Column("GR");
fmt.Println(gammaRay);
// [-999.25 -999.25 -999.25 -999.25 -999.25 122.03 123.14 ...]
// ...
```
- Get the Well Parameters
### Presents a way of accessing the details of individual well parameters.
### The details include the following:
1. description - Description/ Full name of the well parameter
2. unit - Its unit of measurement
3. value - Value measured
```go
// ...
well := las.WellParams()
start := well["STRT"].value // 1670.0
stop := well["STOP"].value // 1669.75
null_value := well["NULL"].value // -999.25
// Any other well parameter present in the file, can be gotten with the same syntax above
// ...
```
- Get the Curve Parameters
### Presents a way of accessing the details of individual log columns.
### The details include the following:
1. description - Description/ Full name of the log column
2. unit - Unit of the log column measurements
3. value - API value of the log column
```go
// ...
curve := las.CurveParams()
NPHI := curve["NPHI"].description // Neutron Porosity
RHOB := curve["RHOB"].description // Bulk density
// This is the same for all log column present in the file
// ...
```
- Get the Parameters of the well
### The details include the following:
1. description - Description/ Full name of the log column
2. unit - Unit of the log column measurements
3. value - API value of the log column
```go
// ...
param := await las.LogParams(); // BOTTOM HOLE TEMPERATURE
BHT := param["BHT"].description // BOTTOM HOLE TEMPERATURE
BHTValaue := param["BHT"].value // 35.5
BHTUnits := param["BHT"].unit // DEGC
// This is the same for all well parameters present in the file
// ...
```
- Get the number of rows and columns
```go
// ...
numRows := las.RowCount() // 4
numColumns := las.ColumnCount() // 3081
// ...
```
- Get the version and wrap
```go
// ...
version := las.Version() // 2.0
wrap := las.Wrap() // true
// ...
```
- Get other information
```go
// ...
other := myLas.Other()
fmt.Println(other)
// Note: The logging tools became stuck at 625 metres causing the data between 625 metres and 615 metres to be invalid.
// ...
```
- Export to CSV
### This writes a csv file to the current working directory, with headers of the well and data section
```go
//...
las.ToCSV("result")
//...
```
> result.csv
| DEPT | RHOB | GR | NPHI |
| ---- | ------- | ------- | ----- |
| 0.5 | -999.25 | -999.25 | -0.08 |
| 1.0 | -999.25 | -999.25 | -0.08 |
| 1.5 | -999.25 | -999.25 | -0.04 |
| ... | ... | ... | ... |
| 1.3 | -999.25 | -999.25 | -0.08 |