---
id: xtgeoviz
version: "0.3.2"
license: GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this… (full text in the JSON record)
license_treatment: copyleft
maintenance: active
---

# xtgeoviz — Plotting library for xtgeo objects

License: copyleft · Maintenance: active · Downloads: 127.4K/mo

## What it is and what it does

xtgeoviz is a thin plotting layer built on top of xtgeo and matplotlib, designed for visualizing subsurface and geospatial data common in energy and reservoir engineering. It wraps matplotlib to provide convenient functions for rendering xtgeo objects without requiring users to write low-level matplotlib code directly.

The package depends on PyYAML, matplotlib, numpy, scipy, and xtgeo. It is in beta (Development Status 4) and actively maintained. It requires Python 3.11 or later and is available as a pure Python wheel, making installation straightforward across common platforms.

Use it for:

- Quickly visualize subsurface surfaces loaded from xtgeo without writing matplotlib boilerplate
- Generate plots of reservoir maps and geological structures in energy workflows
- Explore and validate geospatial data during subsurface modeling and analysis tasks
- Integrate plotting into scientific Python pipelines for reservoir engineering work

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides plotting functions for xtgeo objects, enabling visualization of subsurface and geospatial data through matplotlib-backed rendering.

Yes, if you work with xtgeo objects and need straightforward plotting. Low install friction, active maintenance, and no known vulnerabilities support adoption. The copyleft license (LGPLv3) requires that any modifications or derivative works remain open-source; this is a non-issue for internal use but matters if you plan to embed or redistribute modified versions.

## Install

pip install xtgeoviz
uv add xtgeoviz
poetry add xtgeoviz

## Installing xtgeoviz

Before you install: Low install friction with a pure Python wheel. Active maintenance with a recent release 44 days ago. Supports Python 3.11, 3.12, 3.13, and 3.14 across macOS, Windows, and Linux.

License in practice: Licensed under LGPLv3 (copyleft). Derivative works and modifications must be distributed under the same license; proprietary applications using this library must comply with copyleft obligations or obtain an alternative license.

Quickstart:

pip install xtgeoviz

import xtgeoviz.plot as xtgplot
import xtgeo

surf = xtgeo.surface_from_file("somemap.gri")
xtgplot.quickplot(surf)

Requires Python 3.11 or later.

Verify before relying:

- Specific plotting capabilities and supported xtgeo object types beyond the quickplot example
- Performance characteristics with large datasets or complex geometries
- Interactive vs. static plotting modes and customization depth

## Package facts

- License: GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this… (full text in the JSON record) (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 127.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

xtgeo plotting visualization, subsurface map visualization, geospatial data plotting, reservoir engineering visualization, scientific surface plotting, energy data visualization, matplotlib wrapper for xtgeo, geospatial-visualization, subsurface-engineering

[View on SkillFed](https://skillfed.io/packages/xtgeoviz) · [View on PyPI](https://pypi.org/project/xtgeoviz/)