Extract Topography

This example will demonstrate how to add a cell data field to an input data set that defines whether that cell should be active. The activity of the cell is determined by whether it is beneath and input topography surface.

This filter adds a new cell data field to an input data source defining whether that cell is beneath some input topography surface.

This example demos PVGeo.grids.ExtractTopography

We add a cell data field to the input data set as this allows us to use a wide range of input data types. We also add this data array as it will enable users to create model discretizations within ParaView for export to external processing software that need the entire model discretization with an active cells field.

Also posted on PVGeo: https://pvgeo.org/examples/grids/extract-topography.html

# sphinx_gallery_thumbnail_number = 6
import os

from PVGeo.grids import ExtractTopography
from PVGeo.model_build import CreateTensorMesh
import pooch
import pyvista

/opt/hostedtoolcache/Python/3.8.18/x64/lib/python3.8/site-packages/pyvista/utilities/__init__.py:69: PyVistaDeprecationWarning: The `pyvista.utilities` module has been deprecated. `convert_string_array` is now imported as: `from pyvista.core.utilities import convert_string_array`.
  warnings.warn(
/opt/hostedtoolcache/Python/3.8.18/x64/lib/python3.8/site-packages/pyvista/utilities/__init__.py:69: PyVistaDeprecationWarning: The `pyvista.utilities` module has been deprecated. `get_vtk_type` is now imported as: `from pyvista.core.utilities import get_vtk_type`.
  warnings.warn(

For the grid data set, let’s use one of the Model Building sources with the following parameters:

• Origin: [793000, 9192500, 2690]

• X Cells: '1000 500 50*250 500 1000'

• Y Cells: '1000 500 55*250 500 1000'

• Z Cells: '30*100.0 5*250.0 500'

mesh = CreateTensorMesh(
    origin=[793000, 9192500, 2690],
    xcellstr="1000 500 50*250 500 1000",
    ycellstr="1000 500 55*250 500 1000",
    zcellstr="30*100.0 5*250.0 500",
).apply()

mesh.plot(show_grid=True, color=True, show_edges=True)

Now load the topography file from the example data:

url = "https://dl.dropbox.com/s/gw5v3tiq68oge3l/Example-Extract-Topo.zip?dl=0"
file_paths = pooch.retrieve(url=url, known_hash=None, processor=pooch.Unzip())
file_path = [f for f in file_paths if os.path.basename(f) == "topo.vtk"][0]

topo = pyvista.read(file_path)
topo

Header	Data Arrays
PolyData Information N Cells 39764 N Points 20164 N Strips 0 X Bounds 7.937e+05, 8.078e+05 Y Bounds 9.194e+06, 9.208e+06 Z Bounds 1.182e+03, 2.690e+03 N Arrays 3	Name Field Type N Comp Min Max elevation Points float64 1 1.182e+03 2.690e+03 column integer Points float32 1 1.000e+00 1.420e+02 row integer Points float32 1 1.000e+00 1.420e+02

p = pyvista.Plotter()
p.add_mesh(topo, cmap="terrain")
p.add_mesh(mesh, color=True, show_edges=False, opacity=0.75)
p.show_grid()
p.show()

Now that you have the topography and a grid data set, let’s go ahead and use the Extract Topography filter. Be sure to properly select the inputs to the algorithm.

extracted = ExtractTopography().apply(mesh, topo)
extracted.plot(scalars="Extracted")

op=’underneath’, tolerance=0.001, offset=0.0, invert=False, remove=False This will show the cells that are active underneath the topography surface (0 for above surface and 1 for below surface). Now we can threshold this gridded data set to remove parts of the model that are above the topography surface by applying a Threshold filter to chop out all values below 1.

The resulting grid with cells above the topography extracted will look like the rendering below:

threshed = extracted.threshold(0.5, scalars="Extracted")
threshed.plot(color=True, show_edges=True)

How well did this remove cells above the topography surface?

p = pyvista.Plotter()
p.add_mesh(topo, cmap="terrain")
p.add_mesh(threshed, color=True, show_edges=True)
p.show_grid()
p.show()

Is that extraction too close to the topography surface? To better extract the topographic surface, you can set a tolerance:

extracted = ExtractTopography(tolerance=100.0, remove=True).apply(mesh, topo)

p = pyvista.Plotter()
p.add_mesh(topo, cmap="terrain")
p.add_mesh(extracted, color=True, show_edges=True)
p.show_grid()
p.show()

Note that there are other extraction operations like an 'intersection':

extracted = ExtractTopography(op="intersection", remove=True, tolerance=100.0).apply(mesh, topo)
extracted.plot(color=True, show_edges=True)