ESV Intersection component

A reusable component to create intersection visualizations for wells

Part of the Equinor Subsurface Visualization project

• Repository: https://github.com/equinor/esv-intersection
• NPM Package: https://www.npmjs.com/package/@equinor/esv-intersection
• Documentation: https://equinor.github.io/esv-intersection/
• Storybook (latest release): https://equinor.github.io/esv-intersection/storybook/latest
• Storybook (master branch): https://equinor.github.io/esv-intersection/storybook/master

Getting started

Installation

Using npm:

npm install --save @equinor/esv-intersection

Using yarn:

yarn add @equinor/esv-intersection

To run application in your machine :

$ git clone [email protected]:equinor/esv-intersection
$ git submodule update --init --recursive
$ npm run storybook

Usage

import { Controller, GridLayer } from '@equinor/esv-intersection';

const container = document.createElement('div');
const controller = new Controller({ container: container });

// the controller initially has zero height
controller.adjustToSize(400, 400);

controller.addLayer(new GridLayer('grid'));

For more examples, check out our stories in our online storybook.

Technical choices

• Compiler: Typescript
• Module bundler: Vite
• Testing: Vitest
• Documentation: TypeDoc
• Miscellaneous:
  • Architecture: A container component that holds several layers, specialized for the type of data and visualization they address (analogous to the VidEx-map component https://github.com/equinor/videx-map)
  • Browser support: Target Edge, Chrome, Firefox, Safari
  • Linting and unit tests run automatically on Github Actions

Development

• The project is maintained by the VidEx team and the Heap Purple team
• New features could be requested by opening a dedicated issue or, even better, by opening a Pull Requests

Support

If you are an Equinor employee, the easiest way to get in touch with the maintainers is through the #esv-intersection channel on Slack.

Otherwise, Github issues are the main communication channel with the maintainers. If you have a bug report, a feature request, or need some help using the component, simply create an issue in the repository and one of the maintainers will pick it up. Before creating an issue, please have a look at the following guidelines. Also keep in mind that creating Pull Requests is the preferred way to contribute to the project.

Help needed

Describe your use case in details, make sure to include the version of the component you are using, and relevant software that are part of your pipeline (eg, Chrome/Firefox/Safari, Node, npm, …), including their version as well

Bug reports

Follow the instructions from the Help needed section above, but also include precise instructions about how to reproduce the bug. If any data is required for reproducing the bug, it would be beneficial to have access to it as well.

Feature requests

Give a precise description of your use case. It would be best if you could formulate your request as a user story, using the format As a <subject> I would like to <the feature you need> so that <the task you want to accomplish>

Contribution

See the contribution page

License

The large majority of the files in this repository are released under the MIT license. There are 2 exceptions:

• the CONTRIBUTION.md file, which uses BSD 2-Clause "Simplified" License, as described at the end of the file itself
• the content of the esv-intersection-data submodule uses the same license as Equinor's Volve dataset, which is also available in the submodule