| Name | las JSON |
| Version |
0.0.5
JSON |
| download |
| home_page | https://github.com/WarrenWeckesser/las |
| Summary | A reader for Canadian Well Logging Society LAS (Log ASCII Standard) files. |
| upload_time | 2024-06-02 20:30:27 |
| maintainer | None |
| docs_url | None |
| author | Warren Weckesser |
| requires_python | None |
| license | BSD |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
las
===
The ``las`` module implements a reader for LAS (Log ASCII Standard) well log files (LAS 2.0).
For more information about this format, see the Canadian Well Logging Society web page
(https://www.cwls.org/products/).
Example 1
---------
The following file, "example1.las", is from "LAS Version 2.0: A Digital Standard for
Logs; Updated January 2014"::
~VERSION INFORMATION
VERS. 2.0 : CWLS LOG ASCII STANDARD -VERSION 2.0
WRAP. NO : ONE LINE PER DEPTH STEP
~WELL INFORMATION
#MNEM.UNIT DATA DESCRIPTION
#----- ----- ---------- -------------------------
STRT .M 1670.0000 :START DEPTH
STOP .M 1669.7500 :STOP DEPTH
STEP .M -0.1250 :STEP
NULL . -999.25 :NULL VALUE
COMP . ANY OIL COMPANY INC. :COMPANY
WELL . ANY ET AL 12-34-12-34 :WELL
FLD . WILDCAT :FIELD
LOC . 12-34-12-34W5M :LOCATION
PROV . ALBERTA :PROVINCE
SRVC . ANY LOGGING COMPANY INC. :SERVICE COMPANY
DATE . 13-DEC-86 :LOG DATE
UWI . 100123401234W500 :UNIQUE WELL ID
~CURVE INFORMATION
#MNEM.UNIT API CODES CURVE DESCRIPTION
#------------------ ------------ -------------------------
DEPT .M : 1 DEPTH
DT .US/M 60 520 32 00 : 2 SONIC TRANSIT TIME
RHOB .K/M3 45 350 01 00 : 3 BULK DENSITY
NPHI .V/V 42 890 00 00 : 4 NEUTRON POROSITY
SFLU .OHMM 07 220 04 00 : 5 SHALLOW RESISTIVITY
SFLA .OHMM 07 222 01 00 : 6 SHALLOW RESISTIVITY
ILM .OHMM 07 120 44 00 : 7 MEDIUM RESISTIVITY
ILD .OHMM 07 120 46 00 : 8 DEEP RESISTIVITY
~PARAMETER INFORMATION
#MNEM.UNIT VALUE DESCRIPTION
#-------------- ---------------- -----------------------------------------------
MUD . GEL CHEM : MUD TYPE
BHT .DEGC 35.5000 : BOTTOM HOLE TEMPERATURE
BS .MM 200.0000 : BIT SIZE
FD .K/M3 1000.0000 : FLUID DENSITY
MATR . SAND : NEUTRON MATRIX
MDEN . 2710.0000 : LOGGING MATRIX DENSITY
RMF .OHMM 0.2160 : MUD FILTRATE RESISTIVITY
DFD .K/M3 1525.0000 : DRILL FLUID DENSITY
~OTHER
Note: The logging tools became stuck at 625 metres causing the data
between 625 metres and 615 metres to be invalid.
~A DEPTH DT RHOB NPHI SFLU SFLA ILM ILD
1670.000 123.450 2550.000 0.450 123.450 123.450 110.200 105.600
1669.875 123.450 2550.000 0.450 123.450 123.450 110.200 105.600
1669.750 123.450 2550.000 0.450 123.450 123.450 110.200 105.600
Sample python session::
>>> import las
>>> log = las.LASReader('example1.las')
>>> log.start
1670.0
>>> log.stop
1669.75
>>> log.step
-0.125
>>> log.null
-999.25
>>> log.well.COMP
LASItem(name='COMP', units='', data='ANY OIL COMPANY INC.', descr='COMPANY')
>>> log.well.COMP.value
'ANY OIL COMPANY INC.'
>>> log.well.FLD.value
'WILDCAT'
>>> print(log.other)
Note: The logging tools became stuck at 625 metres causing the data
between 625 metres and 615 metres to be invalid.
The log data is stored as a numpy structured array in ``log.data``::
>>> log.data
array([(1670.0, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6),
(1669.875, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6),
(1669.75, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6)],
dtype=[('DEPT', '<f8'), ('DT', '<f8'), ('RHOB', '<f8'), ('NPHI', '<f8'), ('SFLU', '<f8'), ('SFLA', '<f8'), ('ILM', '<f8'), ('ILD', '<f8')])
>>> log.data['RHOB']
array([ 2550., 2550., 2550.])
>>> log.data[0]
(1670.0, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6)
The data is also available as a two-dimensional numpy array. First we'll
adjust numpy's output format. This is not necessary, but it makes the values
easier to read::
>>> import numpy as np
>>> np.set_printoptions(precision=4)
The two-dimensional view of the data is called ``data2d``::
>>> log.data2d
array([[ 1.6700e+03, 1.2345e+02, 2.5500e+03, 4.5000e-01,
1.2345e+02, 1.2345e+02, 1.1020e+02, 1.0560e+02],
[ 1.6699e+03, 1.2345e+02, 2.5500e+03, 4.5000e-01,
1.2345e+02, 1.2345e+02, 1.1020e+02, 1.0560e+02],
[ 1.6698e+03, 1.2345e+02, 2.5500e+03, 4.5000e-01,
1.2345e+02, 1.2345e+02, 1.1020e+02, 1.0560e+02]])
>>> log.data2d.shape
(3, 8)
Example 2
---------
The next example reads a file from the Kansas Geological Survey and makes
a plot of the gamma ray data versus depth using ``matplotlib``.
First, the imports::
>>> import numpy as np
>>> import matplotlib.pyplot as plt
>>> import las
>>> import io
>>> try:
... from urllib.request import urlopen
... except ImportError:
... from urllib import urlopen
...
Next, read the file::
>>> url = "http://www.kgs.ku.edu/software/DEWL/HELP/pc_read/Shamar-1.las"
>>> f = io.StringIO(urlopen(url).read().decode('iso-8859-1'))
>>> log = las.LASReader(f, null_subs=np.nan)
Finally, make the plot using ``matplotlib``::
>>> plt.figure(figsize=(9, 5))
>>> plt.plot(log.data['DEPT'], log.data['GR'])
>>> plt.xlabel(log.curves.DEPT.descr + " (%s)" % log.curves.DEPT.units)
>>> plt.ylabel(log.curves.GR.descr + " (%s)" % log.curves.GR.units)
>>> plt.title(log.well.WELL.data + ', ' + log.well.DATE.data)
>>> plt.grid()
>>> plt.show()
.. image:: https://raw.githubusercontent.com/WarrenWeckesser/las/main/examples/example2.png
:alt: Example 2 plot
:align: center
Raw data
{
"_id": null,
"home_page": "https://github.com/WarrenWeckesser/las",
"name": "las",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Warren Weckesser",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/7b/e3/0b7273a0953707d8004075c5f74a31aa53eb02f943f00e25f935b26fbc51/las-0.0.5.tar.gz",
"platform": null,
"description": "las\n===\n\nThe ``las`` module implements a reader for LAS (Log ASCII Standard) well log files (LAS 2.0).\nFor more information about this format, see the Canadian Well Logging Society web page\n(https://www.cwls.org/products/).\n\nExample 1\n---------\n\nThe following file, \"example1.las\", is from \"LAS Version 2.0: A Digital Standard for\nLogs; Updated January 2014\"::\n\n ~VERSION INFORMATION\n VERS. 2.0 : CWLS LOG ASCII STANDARD -VERSION 2.0\n WRAP. NO : ONE LINE PER DEPTH STEP\n ~WELL INFORMATION \n #MNEM.UNIT DATA DESCRIPTION\n #----- ----- ---------- -------------------------\n STRT .M 1670.0000 :START DEPTH\n STOP .M 1669.7500 :STOP DEPTH\n STEP .M -0.1250 :STEP \n NULL . -999.25 :NULL VALUE\n COMP . ANY OIL COMPANY INC. :COMPANY\n WELL . ANY ET AL 12-34-12-34 :WELL\n FLD . WILDCAT :FIELD\n LOC . 12-34-12-34W5M :LOCATION\n PROV . ALBERTA :PROVINCE \n SRVC . ANY LOGGING COMPANY INC. :SERVICE COMPANY\n DATE . 13-DEC-86 :LOG DATE\n UWI . 100123401234W500 :UNIQUE WELL ID\n ~CURVE INFORMATION\n #MNEM.UNIT API CODES CURVE DESCRIPTION\n #------------------ ------------ -------------------------\n DEPT .M : 1 DEPTH\n DT .US/M 60 520 32 00 : 2 SONIC TRANSIT TIME\n RHOB .K/M3 45 350 01 00 : 3 BULK DENSITY\n NPHI .V/V 42 890 00 00 : 4 NEUTRON POROSITY\n SFLU .OHMM 07 220 04 00 : 5 SHALLOW RESISTIVITY\n SFLA .OHMM 07 222 01 00 : 6 SHALLOW RESISTIVITY\n ILM .OHMM 07 120 44 00 : 7 MEDIUM RESISTIVITY\n ILD .OHMM 07 120 46 00 : 8 DEEP RESISTIVITY\n ~PARAMETER INFORMATION\n #MNEM.UNIT VALUE DESCRIPTION\n #-------------- ---------------- -----------------------------------------------\n MUD . GEL CHEM : MUD TYPE\n BHT .DEGC 35.5000 : BOTTOM HOLE TEMPERATURE\n BS .MM 200.0000 : BIT SIZE\n FD .K/M3 1000.0000 : FLUID DENSITY\n MATR . SAND : NEUTRON MATRIX\n MDEN . 2710.0000 : LOGGING MATRIX DENSITY\n RMF .OHMM 0.2160 : MUD FILTRATE RESISTIVITY\n DFD .K/M3 1525.0000 : DRILL FLUID DENSITY\n ~OTHER\n Note: The logging tools became stuck at 625 metres causing the data \n between 625 metres and 615 metres to be invalid.\n ~A DEPTH DT RHOB NPHI SFLU SFLA ILM ILD\n 1670.000 123.450 2550.000 0.450 123.450 123.450 110.200 105.600\n 1669.875 123.450 2550.000 0.450 123.450 123.450 110.200 105.600\n 1669.750 123.450 2550.000 0.450 123.450 123.450 110.200 105.600\n\n\nSample python session::\n\n >>> import las\n >>> log = las.LASReader('example1.las')\n >>> log.start\n 1670.0\n >>> log.stop\n 1669.75\n >>> log.step\n -0.125\n >>> log.null\n -999.25\n >>> log.well.COMP\n LASItem(name='COMP', units='', data='ANY OIL COMPANY INC.', descr='COMPANY')\n >>> log.well.COMP.value\n 'ANY OIL COMPANY INC.'\n >>> log.well.FLD.value\n 'WILDCAT'\n >>> print(log.other)\n Note: The logging tools became stuck at 625 metres causing the data \n between 625 metres and 615 metres to be invalid.\n\n\nThe log data is stored as a numpy structured array in ``log.data``::\n\n >>> log.data\n array([(1670.0, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6),\n (1669.875, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6),\n (1669.75, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6)], \n dtype=[('DEPT', '<f8'), ('DT', '<f8'), ('RHOB', '<f8'), ('NPHI', '<f8'), ('SFLU', '<f8'), ('SFLA', '<f8'), ('ILM', '<f8'), ('ILD', '<f8')])\n >>> log.data['RHOB']\n array([ 2550., 2550., 2550.])\n >>> log.data[0]\n (1670.0, 123.45, 2550.0, 0.45, 123.45, 123.45, 110.2, 105.6)\n\nThe data is also available as a two-dimensional numpy array. First we'll\nadjust numpy's output format. This is not necessary, but it makes the values\neasier to read::\n\n >>> import numpy as np\n >>> np.set_printoptions(precision=4)\n\nThe two-dimensional view of the data is called ``data2d``::\n\n >>> log.data2d\n array([[ 1.6700e+03, 1.2345e+02, 2.5500e+03, 4.5000e-01,\n 1.2345e+02, 1.2345e+02, 1.1020e+02, 1.0560e+02],\n [ 1.6699e+03, 1.2345e+02, 2.5500e+03, 4.5000e-01,\n 1.2345e+02, 1.2345e+02, 1.1020e+02, 1.0560e+02],\n [ 1.6698e+03, 1.2345e+02, 2.5500e+03, 4.5000e-01,\n 1.2345e+02, 1.2345e+02, 1.1020e+02, 1.0560e+02]])\n >>> log.data2d.shape\n (3, 8)\n\n\nExample 2\n---------\n\nThe next example reads a file from the Kansas Geological Survey and makes\na plot of the gamma ray data versus depth using ``matplotlib``.\n\nFirst, the imports::\n\n >>> import numpy as np\n >>> import matplotlib.pyplot as plt\n >>> import las\n >>> import io\n >>> try:\n ... from urllib.request import urlopen\n ... except ImportError:\n ... from urllib import urlopen\n ...\n\nNext, read the file::\n\n >>> url = \"http://www.kgs.ku.edu/software/DEWL/HELP/pc_read/Shamar-1.las\"\n >>> f = io.StringIO(urlopen(url).read().decode('iso-8859-1'))\n >>> log = las.LASReader(f, null_subs=np.nan)\n\nFinally, make the plot using ``matplotlib``::\n\n >>> plt.figure(figsize=(9, 5))\n >>> plt.plot(log.data['DEPT'], log.data['GR'])\n >>> plt.xlabel(log.curves.DEPT.descr + \" (%s)\" % log.curves.DEPT.units)\n >>> plt.ylabel(log.curves.GR.descr + \" (%s)\" % log.curves.GR.units)\n >>> plt.title(log.well.WELL.data + ', ' + log.well.DATE.data)\n >>> plt.grid()\n >>> plt.show()\n\n.. image:: https://raw.githubusercontent.com/WarrenWeckesser/las/main/examples/example2.png\n :alt: Example 2 plot\n :align: center\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "A reader for Canadian Well Logging Society LAS (Log ASCII Standard) files.",
"version": "0.0.5",
"project_urls": {
"Homepage": "https://github.com/WarrenWeckesser/las"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "72d72f21b9fda3d6abe0bdfe5b5ea29e968ed6b9157690b11eae23740129b5bd",
"md5": "4ae8444c317c255f6d7d2e663cfb2c74",
"sha256": "a7226635e63f66003a8d244e0523f77f4901860dc9c2869de420cd987aae62f9"
},
"downloads": -1,
"filename": "las-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4ae8444c317c255f6d7d2e663cfb2c74",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7954,
"upload_time": "2024-06-02T20:30:26",
"upload_time_iso_8601": "2024-06-02T20:30:26.728834Z",
"url": "https://files.pythonhosted.org/packages/72/d7/2f21b9fda3d6abe0bdfe5b5ea29e968ed6b9157690b11eae23740129b5bd/las-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7be30b7273a0953707d8004075c5f74a31aa53eb02f943f00e25f935b26fbc51",
"md5": "6617c24ec7a1eece6380cb49005ab685",
"sha256": "3e867fa5e8b4e7ffb08c4a8a92636b04cf16cfbc7e5d97b9f0420d9d8e4171e1"
},
"downloads": -1,
"filename": "las-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "6617c24ec7a1eece6380cb49005ab685",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 10567,
"upload_time": "2024-06-02T20:30:27",
"upload_time_iso_8601": "2024-06-02T20:30:27.832291Z",
"url": "https://files.pythonhosted.org/packages/7b/e3/0b7273a0953707d8004075c5f74a31aa53eb02f943f00e25f935b26fbc51/las-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-02 20:30:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WarrenWeckesser",
"github_project": "las",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "las"
}
