[](https://github.com/agile-geoscience/welly/actions/workflows/run-tests.yml)
[](https://github.com/agile-geoscience/welly/actions/workflows/build-docs.yml)
[](https://pypi.python.org/pypi/welly/)
[](https://pypi.org/project/welly//)
[](https://pypi.org/project/welly/)
**`welly` facilitates the loading, processing, and analysis of subsurface wells and well data, such as striplogs, formation tops, well log curves, and synthetic seismograms.**
## Installation
pip install welly
For developers, there are `pip` options for installing `test`, `docs` or `dev` (docs plus test) dependencies.
## Quick start
```python
from welly import Well, Project
w = Well.from_las('my_wells/my_well.las') # Load a single well.
p = Project.from_las('my_wells/*.las') # Load lots of wells.
gr = w.data['GR'] # One log...
gr.plot() # ...with some superpowers!
```
Next, check out the tutorial notebooks.
## Documentation
[The `welly` documentation](https://code.agilescientific.com/welly) is a work in progress.
## Questions or suggestions?
[](https://swung.slack.com/)
**If you'd like to chat about `welly` with us or other users, look for the **#welly-and-lasio** channel in the [Software Underground's Slack](https://softwareunderground.org/slack).**
To report bugs or suggest new features/improvements to the code, please [open an issue](https://github.com/agile-geoscience/welly/issues).
## Contributing
Please see [`CONTRIBUTING.md`](https://github.com/agile-geoscience/redflag/blob/main/CONTRIBUTING.md).
## Philosophy
The [`lasio`](https://github.com/kinverarity1/lasio) project provides a very nice way to read and write [CWLS](http://www.cwls.org/) Log ASCII Standard files. The result is an object that contains all the LAS data — it's more or less analogous to the LAS file.
Sometimes we want a higher-level object, for example to contain methods that have nothing to do with LAS files. We may want to handle other well data, such as deviation surveys, tops (aka picks), engineering data, striplogs, synthetics, and so on. This is where `welly` comes in.
`welly` uses `lasio` for data I/O, but hides much of it from the user. We recommend you look at both projects before deciding if you need the 'well-level' functionality that `welly` provides.
Raw data
{
"_id": null,
"home_page": "https://github.com/agile-geoscience/welly",
"name": "welly",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "The Welly Authors",
"author_email": "hello@agilescientific.com",
"download_url": "https://files.pythonhosted.org/packages/dd/24/5d35acc704ea5a8af234c72252d371fc10a7cfb429311a6f260ed4affc27/welly-0.5.2.tar.gz",
"platform": "",
"description": "\n\n[](https://github.com/agile-geoscience/welly/actions/workflows/run-tests.yml)\n[](https://github.com/agile-geoscience/welly/actions/workflows/build-docs.yml)\n[](https://pypi.python.org/pypi/welly/)\n[](https://pypi.org/project/welly//)\n[](https://pypi.org/project/welly/)\n\n**`welly` facilitates the loading, processing, and analysis of subsurface wells and well data, such as striplogs, formation tops, well log curves, and synthetic seismograms.**\n\n\n## Installation\n\n pip install welly\n\nFor developers, there are `pip` options for installing `test`, `docs` or `dev` (docs plus test) dependencies.\n\n\n## Quick start\n\n```python\nfrom welly import Well, Project\n\nw = Well.from_las('my_wells/my_well.las') # Load a single well.\np = Project.from_las('my_wells/*.las') # Load lots of wells.\n\ngr = w.data['GR'] # One log...\ngr.plot() # ...with some superpowers!\n```\n\nNext, check out the tutorial notebooks.\n\n\n## Documentation\n\n[The `welly` documentation](https://code.agilescientific.com/welly) is a work in progress.\n\n\n## Questions or suggestions?\n\n[](https://swung.slack.com/)\n\n**If you'd like to chat about `welly` with us or other users, look for the **#welly-and-lasio** channel in the [Software Underground's Slack](https://softwareunderground.org/slack).**\n\nTo report bugs or suggest new features/improvements to the code, please [open an issue](https://github.com/agile-geoscience/welly/issues).\n\n\n## Contributing\n\nPlease see [`CONTRIBUTING.md`](https://github.com/agile-geoscience/redflag/blob/main/CONTRIBUTING.md).\n\n\n## Philosophy\n\nThe [`lasio`](https://github.com/kinverarity1/lasio) project provides a very nice way to read and write [CWLS](http://www.cwls.org/) Log ASCII Standard files. The result is an object that contains all the LAS data \u2014\u00a0it's more or less analogous to the LAS file.\n\nSometimes we want a higher-level object, for example to contain methods that have nothing to do with LAS files. We may want to handle other well data, such as deviation surveys, tops (aka picks), engineering data, striplogs, synthetics, and so on. This is where `welly` comes in.\n\n`welly` uses `lasio` for data I/O, but hides much of it from the user. We recommend you look at both projects before deciding if you need the 'well-level' functionality that `welly` provides.\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Tools for making and managing well data.",
"version": "0.5.2",
"project_urls": {
"Homepage": "https://github.com/agile-geoscience/welly"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bf5db1b7297c38c9fb1c9bbd9d00e30dad413b9951e2a62f9a49dc5dc1dfb4a2",
"md5": "91ca7e6416547adfe19792f31e25b745",
"sha256": "de6769ceca0844dbd8812823738feed1f631233943466d8ca47bbb747b71315d"
},
"downloads": -1,
"filename": "welly-0.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "91ca7e6416547adfe19792f31e25b745",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 79210,
"upload_time": "2022-02-28T13:54:32",
"upload_time_iso_8601": "2022-02-28T13:54:32.860389Z",
"url": "https://files.pythonhosted.org/packages/bf/5d/b1b7297c38c9fb1c9bbd9d00e30dad413b9951e2a62f9a49dc5dc1dfb4a2/welly-0.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dd245d35acc704ea5a8af234c72252d371fc10a7cfb429311a6f260ed4affc27",
"md5": "fafcbef15fc91a7510ecf17af7722307",
"sha256": "db23e0414ed961064fd31db4c1a6e76884a23a03664acd4315a729ff94febdea"
},
"downloads": -1,
"filename": "welly-0.5.2.tar.gz",
"has_sig": false,
"md5_digest": "fafcbef15fc91a7510ecf17af7722307",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 20316812,
"upload_time": "2022-02-28T13:54:34",
"upload_time_iso_8601": "2022-02-28T13:54:34.734654Z",
"url": "https://files.pythonhosted.org/packages/dd/24/5d35acc704ea5a8af234c72252d371fc10a7cfb429311a6f260ed4affc27/welly-0.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-02-28 13:54:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "agile-geoscience",
"github_project": "welly",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "welly"
}
JSON
