From 3ffd6cb9b68a6779d35a79e4aa75a1d71226fa05 Mon Sep 17 00:00:00 2001 From: Sebastian Grimberg Date: Thu, 18 Jan 2024 09:58:19 -0800 Subject: [PATCH] make format --- docs/src/guide/parallelism.md | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/docs/src/guide/parallelism.md b/docs/src/guide/parallelism.md index 81baad27f..a0a5c57da 100644 --- a/docs/src/guide/parallelism.md +++ b/docs/src/guide/parallelism.md @@ -18,23 +18,25 @@ environment variable. Lastly, *Palace* supports GPU-acceleration using NVIDIA and AMD GPUs, activated with the build options `-DPALACE_WITH_CUDA=ON` and `-DPALACE_WITH_HIP=ON`, respectively. At runtime, -the [`config["Solver"]["Device"]`](../config/solver.md#config%5B%22Solver%22%5D) parameter in the -configuration file can be set to `"CPU"` (the default) or `"GPU"` in order to configure -*Palace* and MFEM to use the available GPU(s). The [`config["Solver"]["Backend"]`] -(../config/solver.md#config["Solver"]) parameter, on the other hand, controls the [libCEED -backend](https://libceed.org/en/latest/gettingstarted/#backends). Users typically do not -need to provide a value for this option and can instead rely on *Palace*'s default, which -selects the most appropriate backend for the given value of [`config["Solver"]["Device"]`] -(../config/solver.md#config["Solver"]). +the [`config["Solver"]["Device"]`](../config/solver.md#config%5B%22Solver%22%5D) parameter +in the configuration file can be set to `"CPU"` (the default) or `"GPU"` in order to +configure *Palace* and MFEM to use the available GPU(s). The +[`config["Solver"]["Backend"]`](../config/solver.md#config%5B%22Solver%22%5D) parameter, on +the other hand, controls the +[libCEED backend](https://libceed.org/en/latest/gettingstarted/#backends). Users typically +do not need to provide a value for this option and can instead rely on *Palace*'s default, +which selects the most appropriate backend for the given value of +[`config["Solver"]["Device"]`](../config/solver.md#config%5B%22Solver%22%5D). In order to take full advantage of the performance benefits made available by GPU- acceleration, it is recommended to make use of [operator partial assembly] (https://mfem.org/performance/), activated when the value of -[`config["Solver"]["PartialAssemblyOrder"]`](../config/solver.md#config%5B%22Solver%22%5D) is -less than [`config["Solver"]["Order"]`](../config/solver.md#config%5B%22Solver%22%5D). This feature -avoids assembling a global sparse matrix and instead makes use of data structures for -operators which lend themselves to more efficient asymptotic storage and application costs. -See also [https://libceed.org/en/latest/intro/](https://libceed.org/en/latest/intro/) for -more details. Partial assembly in *Palace* supports mixed meshes including both tensor -product elements (hexahedra and quadrilaterals) as well as non-tensor product elements +[`config["Solver"]["PartialAssemblyOrder"]`](../config/solver.md#config%5B%22Solver%22%5D) +is less than [`config["Solver"]["Order"]`](../config/solver.md#config%5B%22Solver%22%5D). +This feature avoids assembling a global sparse matrix and instead makes use of data +structures for operators which lend themselves to more efficient asymptotic storage and +application costs. See also +[https://libceed.org/en/latest/intro/](https://libceed.org/en/latest/intro/) for more +details. Partial assembly in *Palace* supports mixed meshes including both tensor product +elements (hexahedra and quadrilaterals) as well as non-tensor product elements (tetrahedra, prisms, pyramids, and triangles).