welly

Welly helps with well loading, wireline logs, log quality, data science

https://github.com/agilescientific/welly

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 19 committers (5.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.1%) to scientific vocabulary

Keywords

data-management data-mining geology geophysics petroleum petrophysics python swung-stack

Keywords from Contributors

well-log swung-t21 data-format geotechnical-engineering groundwater las-files lasio log-ascii-standard mineral-exploration wireline
Last synced: 6 months ago · JSON representation ·

Repository

Welly helps with well loading, wireline logs, log quality, data science

Basic Info
Statistics
  • Stars: 334
  • Watchers: 40
  • Forks: 137
  • Open Issues: 115
  • Releases: 6
Topics
data-management data-mining geology geophysics petroleum petrophysics python swung-stack
Created over 10 years ago · Last pushed about 1 year ago
Metadata Files
Readme Changelog Contributing License Code of conduct Citation Authors

README.md

Welly banner

Run tests Build docs PyPI version PyPI versions PyPI license

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.fromlas('mywells/mywell.las') # Load a single well. p = Project.fromlas('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 is a work in progress.

Questions or suggestions?

mattermost

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 Mattermost.**

To report bugs or suggest new features/improvements to the code, please open an issue.

Contributing

Please see CONTRIBUTING.md.

Philosophy

The lasio project provides a very nice way to read and write CWLS 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.

Owner

  • Name: Agile*
  • Login: agilescientific
  • Kind: organization
  • Email: hello@agilescientific.com
  • Location: Canada

Agile was a scientific computing and consulting company in Canada, but it is now closed for business.

Citation (CITATION.cff)

Welly contributors (2021). Welly, a Python package. https://github.com/agilescientific/welly

GitHub Events

Total
  • Create event: 4
  • Release event: 2
  • Issues event: 10
  • Watch event: 24
  • Delete event: 2
  • Issue comment event: 16
  • Member event: 1
  • Push event: 12
  • Pull request review comment event: 5
  • Pull request review event: 8
  • Pull request event: 17
  • Fork event: 8
Last Year
  • Create event: 4
  • Release event: 2
  • Issues event: 10
  • Watch event: 24
  • Delete event: 2
  • Issue comment event: 16
  • Member event: 1
  • Push event: 12
  • Pull request review comment event: 5
  • Pull request review event: 8
  • Pull request event: 17
  • Fork event: 8

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 576
  • Total Committers: 19
  • Avg Commits per committer: 30.316
  • Development Distribution Score (DDS): 0.391
Past Year
  • Commits: 20
  • Committers: 3
  • Avg Commits per committer: 6.667
  • Development Distribution Score (DDS): 0.15
Top Committers
Name Email Commits
kwinkunks m****t@a****m 351
patrick.reinhard p****d@s****m 99
EvanBianco e****n@a****m 35
Xiong W****g@s****m 30
Frank Male f****e@u****u 17
Zabamund f****l@g****m 7
Kent Inverarity k****y@h****m 5
Thomas 3****o 5
Steve Purves s****s@g****m 4
Evan Bianco E****n@E****l 3
CHooge 3****o 3
Jesper Dramsch j****r@d****t 3
dcslagel d****s@m****g 3
Guillermo Vargas g****2 3
Leguark l****m@g****m 3
NicolasCami 1****i 2
Martin Bentley m****b@m****t 1
Kent Inverarity 1
Wesley Banfield w****d@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 84
  • Total pull requests: 35
  • Average time to close issues: 8 months
  • Average time to close pull requests: 5 months
  • Total issue authors: 28
  • Total pull request authors: 11
  • Average comments per issue: 1.48
  • Average comments per pull request: 0.89
  • Merged pull requests: 24
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 4
  • Pull requests: 8
  • Average time to close issues: N/A
  • Average time to close pull requests: 11 days
  • Issue authors: 4
  • Pull request authors: 2
  • Average comments per issue: 1.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 6
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • kwinkunks (52)
  • ThomasMGeo (5)
  • EvanBianco (2)
  • OmriHerzfeld1 (1)
  • JackofAllTrades01 (1)
  • yummy527 (1)
  • justyna-przybysz (1)
  • astroChance (1)
  • LuisNavarro93 (1)
  • NicolasMorton (1)
  • gbene (1)
  • Zabamund (1)
  • pythonmobile (1)
  • jessepisel (1)
  • awgeo (1)
Pull Request Authors
  • patrick-reinhard (10)
  • frank1010111 (9)
  • Zabamund (7)
  • gavargas22 (6)
  • hyperiongeo (3)
  • ThomasMGeo (2)
  • dcslagel (1)
  • NicolasCami (1)
  • kinverarity1 (1)
  • discover-volve (1)
Top Labels
Issue Labels
bug (31) enhancement (20) question (1) maintenance (1)
Pull Request Labels
bug (1)

Dependencies

.github/workflows/build-docs.yml actions
  • JamesIves/github-pages-deploy-action v4.2.3 composite
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
.github/workflows/pypi-release.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • pypa/gh-action-pypi-publish 27b31702a0e7fc50959f5ad993c78deac1bdfc29 composite
.github/workflows/run-tests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
pyproject.toml pypi
requirements.txt pypi