wellio_Viz.js
WELLIOVIZ is a JavaScript library that provides functionality to visualize well logs, particularly those already converted to JSON, using the d3.js visualization library.
IT IS IN PROGRESS.....
Demos & Examples
Observable Demos
- Hello Wellioviz Mini Demo in ObservableHQ.com
- Link: https://observablehq.com/@justingosses/hello-wellioviz
- Status: Up to date.
- Demo in Observable of Most Recent Published Code with 3 Examples:
- Link: https://observablehq.com/@justingosses/first-wellio-example-with-all-wellioviz-functions-from-npm
- Status: Code is pulled from NPM, so this reflects the latest code that has been published to NPM. May lag slightly compared to the code on this github repository in master branch.
- Observable Notebook Where Code is Developed. Has functions written-out inline.
- Status: May be ahead of code in this repository sometimes.
- Link: here
Full Websites
- HTML demo as github pages page in this repository
- Status: Up to Date (almost always). Currently a bare-bones example but plan to flesh out more.
- Link: Building a basic webpage demo here: https://justingosses.github.io/wellioviz/demo.html
Community Built Demos!
<INSERT YOUR EXAMPLE HERE VIA A PULL REQUEST !!!>
Alterative Observable-notebook-based demos out of date
- Status: Way out of date! but usefull to check out for illustrative purposes maybe.
- Link: Other older Observable notebooks that use older versions of wellioviz code but give further idea what is possible are:
- https://observablehq.com/@justingosses/well-log-in-d3-js-v5
- https://observablehq.com/@justingosses/overly-simplified-stratigraphic-modeling
- https://observablehq.com/@justingosses/well-log-curve-cross-sections
DOCS
Docs will be here: https://justingosses.github.io/wellioviz/ They are only partially up to date currently.
Architecture
For more information on how wellioviz is organized, check out the ARCHITECTURE.MD document.
Why?
Most geologists who make charts of well logs via code seem to do so in Python, often working in Jupyter notebooks. This is fine for a lot of things, but there are some use-cases where having a JavaScript visualization library makes for a better option.
-
GUIs for well correlation. Currently, there really isn't a free open-source application for well log correlation, at least to the best of my knowledge. This means if you don't have Enterprise scale money, (academics, non-profits, hobbyest, students, people in between jobs, etc.) you're often limited to correlating a handfull of wells at most using paper and pencil. Wellio (something to convert LAS files to JSON) and Wellioviz (something to visualize well logs as JSON into SVGs on a webpage) are critical pieces for a free non-code web-based well log visualization to exist. Although a full GUI (graphic user interface) is slightly out of scope for wellioviz, wellioviz could be extended to do this.
-
Websites that provide well logs to audiences on the web. Although PNG images of well logs could be created and stored on server before being sent on demand to the front-end, this is less than ideal as all the images have to be created, stored, and loaded before the user needs them. This takes a lot of storage space. Additionally, it prevents scrolling, zooming, and overlays. Visualizing the logs on the fly in JavaScript is a better option for websites that want to given users an idea what a well log contains.
-
Interactive well plotting with export into SVG or full HTML Pages from inside Jupyter Notebook Building the visualization in JavaScript also opens up the possibility of working in a Jupyter notebook and exporting wells as SVGs or full HTML webpages. Additionally, there aren't any limits on interactivity that you might hit in a python visualization package that is wrapping JavaScript behind the scenes. Kepler.gl in Jupyter is an example of this functionality where beautiful maps get created inside Jupyter notebook and get published as self-contained front-end only full HTML/CS/JS pages.
Point of Caution: To some of extent, all of these are not completely in scope of the project. Wellioviz is a visualization library. 1,2,&3 also require graphic user interfaces and other things that are better to be built as projects that utilize wellioviz.
Contributing
Check out the Contributing Guidelines. Issues, documentation, pull requests, examples, test cases, and questions needed!
I also have a description in Contributing.md of how I tend to work on the project and what things to expect will always be in sync in case there are questions on that.