Importing Grid Models

Currently, Petres supports importing grids only from Eclipse .GRDECL files, with a limited set of supported keywords. Importing allows you to load grid geometry, grid properties, and the active cell mask into a CornerPointGrid object.

Note

For a detailed description of the keywords used in .GRDECL files and their structure, see the Corner-Point Grid Representation in Eclipse section.

Importing Grid Geometry

A grid can be imported directly from a .GRDECL file using the from_grdecl() method:

from petres.grids import CornerPointGrid

grid = CornerPointGrid.from_grdecl("model.grdecl")
grid.show()

By default, this method automatically reads:

  • Grid geometry (COORD, ZCORN, SPECGRID, or DIMENS)

  • Active cell mask (ACTNUM)

If present in the file, the following metadata keywords are also preserved:

  • MAPAXES

  • MAPUNITS

  • GRIDUNIT

  • COORDSYS

  • PINCH

To skip loading these metadata keywords, set use_metadata=False. These keywords are currently not used internally, but they are preserved when the grid is exported again using the to_grdecl() method.

Important

The file must contain the required grid geometry keywords (COORD, ZCORN, and either SPECGRID or DIMENS).

To import the grid without the active cell mask, set use_actnum=False:

grid = CornerPointGrid.from_grdecl(
    "model.grdecl",
    use_actnum=False,
)

This is useful when ACTNUM will be defined manually after import.

Importing Properties

Properties stored in the Eclipse file can be imported by specifying their keywords in the properties argument:

grid = CornerPointGrid.from_grdecl(
   "model_with_props.grdecl",
   properties=["PORO", "PERMX"],
)
porosity = grid.properties["PORO"]
permeability = grid.properties["PERMX"]

Only the specified properties are imported.