UPSCALE_CAP(1)

📦
version 2025.10 · 3 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 UPSCALE_CAP(1) — bestie edition

okay so real quick, the manual name for this one is User Commands, and we're talking about upscale_cap — the little icon that upscales your capillary pressure + water saturation. iykyk. ✨

🎀 NAME 🎀

upscale_cap — upscale capillary pressure and water saturation. that's it, that's the whole vibe. 🦋

✨ SYNOPSIS ✨

upscale_cap [option value] [grid file] [rock file 1] [rock file 2] [rock
file 3] ...

lowkey the simplest little invocation ever. you feed it a grid file and then as many rock files as your heart desires. 💖

🌸 DESCRIPTION 🌸

so what this does is upscale the capillary pressure function and the water saturation — and it does both for the whole geometry and also on a per-rocktype basis. not one or the other, both. we love a multitasker. 👑

Example usage, and yes this is the actual thing you type:

upscale_cap grid.grdecl swof1.inc swof2.inc

Now. If your input is isotropic, the rock file has four columns and it looks exactly like this, no cap:

-- Stone 1 -- Sw           Krw             Kro     J-func
  1.42000E-01  0.00000E+00  1.00000E+00  2.25999E+00
  2.79250E-01  1.93652E-03  5.03619E-01  5.76122E-02
  4.14850E-01  1.09648E-02  2.36036E-01  -1.23421E-02
  6.14150E-01  4.10007E-02  3.95006E-02  -8.96693E-02
  7.26100E-01  1.41398E-01  9.30808E-03  -1.19849E-01
  9.48000E-01  8.40000E-01  0.00000E+00  -1.42553E+00

four columns bestie: Sw, Krw, Kro, and the J-func. memorise it. 🍓

💅 OPTIONS 💅

one bullet per flag, we're being thorough, periodt.

  • -points — number of saturation points to upscale for, uniformly distributed. defaults to 30. ✨
  • -jFunctionCurve — if upscaleBothPhases is false and the input is isotropic, this is the column number in the stone-files that represents the Leverett J-function. defaults to 4.
  • -surfaceTension — surface tension in dynes/cm to use in the J-function/Pc conversion. Contact angle is not supported, and — yeah the sentence just kinda trails off there in the original, not me editing it, that's genuinely where it ends 💀
  • -output — filename for where to write the upscaled values. 📝
  • -maxPermContrast — maximal permeability contrast in the model. defaults to 1e7. 🔥
  • -minPerm — minimum value allowed for phase permeability. defaults to 1e-12. 🧚

😭 REPORTING BUGS 😭

found a bug? do NOT suffer in silence bestie, report it on the github repository right here:

https://github.com/OPM/opm-upscaling/issues

👑 SEE ALSO 👑

  • upscale_relperm — its sibling, go say hi 🫶

okay that's the whole page!! this is upscale_cap 2023.10, dated October 2023 — version and date dropped right here at the end like a lil signature. mwah. 💋 stay upscaled, bestie 💖✨🎀🦋🌸

📦 where this page comes from