mkgeo_ball(1rheolef)

📦
version 7.2 · 4 versions
, in debian trixie, ubuntu noble, ubuntu questing

💖 mkgeo_ball — bestie's guide to unstructured ellipsoid meshes 💖

okay so this is mkgeo_ball, a page from the rheolef manual (that's rheolef-7.2, mwah 💅). It lives in section 1rheolef of the man pages, and it's literally here to hand you an unstructured mesh of an ellipsoid. no cap. let's go 🦋

✨ NAME ✨

mkgeo_ball — unstructured mesh of an ellipsoid (rheolef-7.2)

🌸 SYNOPSIS 🌸

mkgeo_ball [options] [n]

🎀 EXAMPLE 🎀

mkgeo_ball -t 10 | geo -

So that command up there? It builds a triangle-based, 2d unstructured mesh of the unit ball. iconic. 👑

🫶 DESCRIPTION 🫶

This command is so useful when you're testing programs on simple geometries — like, why fight a complicated mesh when you can just vibe with a ball?

Calling it works pretty much the same as calling mkgeo_grid(1). Under the hood it calls gmsh as the unstructured mesh generator, so you don't have to sit there preparing an input file for a mesh generator yourself. not me saving you a whole afternoon 😌

The optional n argument is an integer that says how much to subdivide in each direction. Default is n=10. And the mesh files? They go straight to standard output. periodt.

💜 THE MESH ORDER 💜

  • -order int — the polynomial approximation mesh order, for the curved boundary, exactly as defined by gmsh. Default is order=1.

🌈 ELEMENT TYPE OPTION 🌈

pick your fighter:

  • -e — 1d mesh using edges.
  • -t — 2d mesh using triangles.
  • -q — 2d mesh using quadrangles (rectangles).
  • -T — 3d mesh using tetrahedra.
  • -P — 3d mesh using prisms.
  • -H — 3d mesh using hexahedra.
  • -tq — 2d mesh using both triangles and quadrangles.
  • -TP, -PH, -TPH — 3d mixed mesh combining tetrahedra, prisms and/or hexahedra.

🦋 THE GEOMETRY 🦋

  • -a float
  • -b float
  • -c float
  • -d float
  • -f float
  • -g float

The geometry can be an ellipse/ellipsoid inscribed in the [a,b]x[c,d] rectangle, or in the [a,b]x[c,d]x[f,g] parallelepiped. By default a=c=f=-1 and b=d=g=1, so you get the unit balls. 🍓

  • -s — only a surface mesh gets generated: a curved line in 2d, or a curved surface mesh in 3d. And in 3d it supports both the -t and -q options. slay.

👑 BOUNDARY DOMAINS 👑

The meshes define a domain named boundary that groups all boundary sides. one name, all the edges, very main character energy.

⭐ OTHERS OPTIONS ⭐

  • -[no]fix — by default, internal face and volume nodes from gmsh are recomputed, because they have incorrect coordinates that destroy the convergence properties of isoparametric high order elements (order >= 3). The -nofix option skips this correction — it's available for test purpose only.
fr fr, don't be out here turning off fix unless you're just testing. the convergence properties said please. 😭
  • -[no]clean — clear temporary files (this is the default).
  • -[no]verbose — print intermediate commands and information messages.

🧚 IMPLEMENTATION 🧚

This documentation has been generated from file main/sbin/mkgeo_ball.sh. yep, it's a shell script, she's humble like that 💅

🌸 AUTHOR 🌸

Pierre Saramito <Pierre.Saramito@imag.fr>

Copyright   (C)  2000-2018  Pierre  Saramito  <Pierre.Saramito@imag.fr>
GPLv3+: GNU GPL version 3 or later  <http://gnu.org/licenses/gpl.html>.
This  is  free  software:  you  are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

and that's the whole page bestie 🫶 this is rheolef, Version 7.2, dated with the mkgeo_ball(1rheolef) footer energy — go build yourself a ball, you've got this ✨🎀

📦 where this page comes from