Syntax and conventions#

A plopm command selects input data, variables, and an output:

plopm -i INPUT -v VARIABLES [OPTIONS]

For example:

plopm -i SPE11C -v pressure -s ,1, -r 5

Use plopm --help for the options supported by the installed version.

Canonical option names#

Each option has a short and a long canonical name:

plopm -i SPE11C -v pressure
plopm --input SPE11C --variable pressure

Commands in this documentation use the short canonical names. The category pages show both forms.

Quote paths and values that contain spaces:

plopm -i "/path/to/my case/SPE11C" -v pressure

Separate input cases with spaces and quote the complete value:

plopm -i "SPE11C SPE11C_TUNED" -v pressure

Separate variables with commas:

plopm -i SPE11C -v pressure,sgas

Quote expressions containing spaces:

plopm -i SPE11C -v "pressure - 0pressure"

The spatial selection uses three comma-separated positions:

I,J,K

Select the plane at j=10:

plopm -i SPE11C -v pressure -s ,10,

Select layers 5 through 10:

plopm -i SPE11C -v pressure -s ,,5:10

Select one restart step:

plopm -i SPE11C -v pressure -r 5

Select several steps:

plopm -i SPE11C -v pressure -r 0,3,10

Select a range using start:end[:step]:

plopm -i SPE11C -v pressure -r 5:505:250

Select a range with -s and apply an aggregation method with -agg:

plopm -i SPE11C -v pressure -s ,,5:10 -agg mean -r 5

Supported methods are min, max, sum, mean, pvmean, harmonic, arithmetic, first, and last.

Some title and label options use two spaces to separate text for different plots. Quote the complete value:

plopm -i SPE11C -v pressure,sgas -sg 1,2 -t "Pressure  Gas saturation"

Use -m to select PNG, GIF, CSV, or VTK output:

plopm -i SPE11C -v pressure -m png
plopm -i SPE11C -v pressure -m gif
plopm -i SPE11C -v pressure -m csv
plopm -i SPE11C -m vtk

Display the built-in help:

plopm --help

Print the variables available for an input case:

plopm -i SPE11C -lv 1