Have ideas to improve npm?Join in the discussion! »


    0.0.32 • Public • Published


    WELLIOVIZ is a JavaScript library that provides functionality to visualize well logs, particularly those already converted to JSON, using the d3.js visualization library.



    Demos & Examples

    Full Websites

    1. HTML demo as github pages page in this repository

    Observable Demos

    1. Hello Wellioviz Mini Demo in ObservableHQ.com
    2. More GUI-like Experience in an ObservableHQ notebook
    3. Demo in Observable of Most Recent Published Code with 3 Examples:
    4. Observable Notebook Where Code is Developed. Has functions written-out inline.
      • Status: May be ahead of code in this repository sometimes.
      • Link: here

    Community Built Demos!


    Alterative Observable-notebook-based demos out of date


    Docs will be here: https://justingosses.github.io/wellioviz/ They are only partially up to date currently.


    For more information on how wellioviz is organized, check out the ARCHITECTURE.MD document.


    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.

    1. 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.

    2. 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.

    3. 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.


    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.

    Organization of Issues on Kanban board here: https://github.com/JustinGOSSES/wellioviz/projects/1

    Code of Conduct

    Code of Conduct

    Further Thinking...



    npm i wellioviz

    DownloadsWeekly Downloads






    Unpacked Size

    142 kB

    Total Files


    Last publish


    • avatar