GetDP(1)

📦
version 3.6.0 · 3 versions
, in debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 GetDP — the General environment for the treatment of Discrete Problems 💖

okay bestie, welcome to the GetDP manual page — yes that's the whole name, "a General environment for the treatment of Discrete Problems", she's a whole acronym AND a whole vibe. Pull up a chair, we're gonna go through every single option, no skips, no skimming. 🦋

✨ SYNOPSIS ✨

getdp [file] [options]

that's it, that's the whole summoning ritual 💅

🌸 DESCRIPTION 🌸

So. GetDP is a general finite element solver that uses mixed elements to discretize de Rham-type complexes in one, two and three dimensions. yes she's that girl. 👑

The main feature, the thing she's famous for, is how close she keeps your input data (the discrete problem definitions, which <em>you</em> write by hand in ASCII data files) to the symbolic mathematical expressions of those same problems. Like, the math and the file basically hold hands. 🫶

And important: GetDP is a command-line program. If you want a graphical front-end, go look at Gmsh.

⚠️ WARNING ⚠️

okay listen, this one is real: this man page does NOT describe the syntax of the input files. Like, at all. Not even a little. If you want that, you need to read the info documentation (for example with info getdp). Up-to-date versions of the manual in various formats live at http://getdp.info. go there, bestie, I'm begging. 😭

🎀 PROCESSING OPTIONS 🎀

  • file — this is an ASCII file holding the problem definition, i.e. the structures the Texinfo documentation will teach you to create (she's a teacher fr). This file can include other files, which means you should always give exactly one problem definition file on the command line — just one, okay? Input files with the problem definition structure usually get the .pro extension, and if they do, you don't even have to type the extension on the command line. Iconic. The name of this file (minus the extension) becomes the basis for all the intermediate files created during the pre-processing and processing stages. 💅
  • -pre resolution-id — performs the pre-processing associated with the resolution called resolution-id. During pre-processing, GetDP creates the geometric database (from the mesh file), identifies the degrees of freedom (aka the unknowns 👀) of the problem, and sets up the constraints on those degrees of freedom. This creates a file with a .pre extension. If you omit resolution-id, the list of available choices gets displayed instead. helpful queen.
  • -cal — performs the processing. This needs a pre-processing to have already happened, or a -pre option on the same command line. The resolution performed is the one given as an argument to the -pre option. In the processing stage, GetDP executes all the operations of the selected resolution (matrix assemblies, system resolutions, ... and so on). Creates a file with a .res extension. ✨
  • -pos post-operation-id(s) — performs the post-processing operations selected by post-operation-id(s). This needs a processing to have already happened, or a -cal option on the same command line. If post-operation-id is omitted, the list of available choices is displayed. 🎀
  • -msh filename — reads the mesh from filename instead of reading it from the default problem file name with .msh appended.
  • -msh_scaling value — multiplies the coordinates of all the nodes in the mesh by value. math girlie behavior.
  • -restart — resumes time loop processing from where it stopped. she remembers where she left off, unlike me. 🙈
  • -solve resolution-id — same as -pre resolution-id -cal. two birds, one vibe.
  • -split — saves processing results in separate files (one for each timestep).
  • -res filename(s) — loads processing results from filename(s) instead of from the default problem file name with .res appended.
  • -name string — uses string as the default generic file name for input or output of mesh, pre-processing and processing files.
  • -adapt filename(s) — reads adaptation constraints from filename(s).
  • -order float — specifies maximum interpolation order.

🔥 LINEAR SOLVER OPTIONS 🔥

  • -solver filename — specifies solver parameter file.
  • [PETSc options] — PETSc options, but only if GetDP was compiled with PETSc support. conditional slay. 💅

🔥 LINEAR SOLVER OPTIONS 🔥

(yes, again, she said it twice, and I'm not about to edit her — keep both, bestie, I don't make the rules 🫶)

  • -bin — creates binary output files. -v2 creates mesh-based Gmsh output files when possible.

🌈 OTHER OPTIONS 🌈

  • -check — lets you check the problem structure interactively. gossip session with your own code.
  • -v int — sets the verbosity level. A value of 0 means no information will be displayed during processing. Higher values increase the amount of information displayed. 0 = silent treatment, big numbers = she will NOT stop talking. 💀
  • -p int — sets the progress update rate. This controls the refreshment rate of the counter indicating the progress of the current computation.
  • -onelab name address — communicates with OneLab server through socket.
  • -version — displays the version number.
  • -info — displays detailed version information.
  • -help — displays a message listing basic usage and available options. your safety net fr fr.

👑 AUTHORS 👑

Patrick Dular (patrick.dular at ulg.ac.be) and Christophe Geuzaine (cgeuzaine at ulg.ac.be). See the documentation for a comprehensive list of contributors — there are more legends than just these two, go check. 🫶

🦋 SEE ALSO 🦋

Also: the full documentation for GetDP is maintained as a Texinfo manual. If the info and getdp programs are properly installed at your site, this command

info getdp

should give you access to the complete manual. 💖

okay and that's the whole page!! this one came from the 4th Berkeley Distribution, dated 27 April 2022, and it's the GetDP(1) manual page itself. 💜 mwah, go solve something, bestie ✨🌸

📦 where this page comes from