Project

General

Profile

Task #2297

Transfer prallelisation information from old webpage to new one

Added by Paul Bauer about 2 years ago. Updated 11 months ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
documentation
Target version:
Difficulty:
simple
Close

Description

Copy of Szilárds email here where we discussed what to do ...

As we discussed on Monday, the main documentation additions should go
into the user guide and website; not sure we need much if anything in
the manual given that nothing changes in terms of algorithms.

User guide
I think a review/rewrite of the old "Acceleration and parallelization"
page and the the partially overlapping "Getting good performance" page
of the user guide is a good start. This is where most of the PME-GPU
related content should go.

To be honest, I still prefer a lot of the original structure/content
that was left behind (or greatly shortened), but I am naturally
biased. Firstly, the intent of the original page was to explain the
different means of parallelization to the users (some of which is
referred to these days as acceleration). For this reason, the original
page first explained what "acceleration" refers to (i.e. accelerated
kernels like SIMD and GPU) followed by explanations of what different
means of parallelization are employed (MPI, OpenMP, MPI+OpenMP,
MPI+OpenMP+GPU, etc.), finally building up examples of how to
use/control the aforementioned parallelization modes. In contrast, the
new page has little of the former structure and it seems to tend to
explain command line options and how the options should be used
(rather than the parallelization modes and how these should be used).
The end result may be more "dummy-user" friendly (I mean novice ,
but I think it removes a lot of the "educational" value of the former.

Again, naturally, I'm biased towards the original structure and
content (as well as towards not treating users as dummies), but a page
with rich content pointing to external pages etc. is perhaps not the
right stuff for the version manual.

Website
Along the lines of what I proposed a few weeks ago, the GPU
acceleration should perhaps get a separate page on the new website. It
would be the ideal place to port over the old gromacs.org/gpu content,
refresh the illustrations. I have some and will make new versions of
those that include dynamic pruning and PME (unless someone else wants
to . We should also update the performance numbers on that page --
and BTW, let's not loose the benchmark systems we have there as these
are the only "official" GROMACS benchmark inputs that people have
access to and do work (the public PRACE benchmarks are still
group-scheme only).
This page should not be versioned, I think.

Cheers
--
Szilárd

Associated revisions

Revision 4dd59a16 (diff)
Added by Paul Bauer 11 months ago

Copy parallelisation info from old webpage

Copied the information for parallelisation from old webpage
to the user guide. Removed some redundant information.

Refs #2297, #2146, #2656

Change-Id: Id472ab779a6e2ca982b117a95429898a0277dc23

History

#1 Updated by Gerrit Code Review Bot about 2 years ago

Gerrit received a related patchset '1' for Issue #2297.
Uploader: Paul Bauer ()
Change-Id: gromacs~master~Id472ab779a6e2ca982b117a95429898a0277dc23
Gerrit URL: https://gerrit.gromacs.org/7187

#2 Updated by Mark Abraham about 1 year ago

Szilard, if you think things are missing or can be expressed better, please write/update some words. It's not everybody else's job to make things different in a way that you prefer. The content that I imported and restructured from the wiki in 2015 is still substantially unchanged, so it seems everybody has voted with their feet. There are still TODOs regarding PME-on-GPU documentation that would also be good to clarify.

We modified the original GROMACS use of "acceleration" years ago, when we dropped GMX_CPU_ACCELERATION in favour of GMX_SIMD.

#3 Updated by Gerrit Code Review Bot 11 months ago

Gerrit received a related patchset '1' for Issue #2297.
Uploader: Paul Bauer ()
Change-Id: gromacs~release-2019~Id472ab779a6e2ca982b117a95429898a0277dc23
Gerrit URL: https://gerrit.gromacs.org/8835

#4 Updated by Paul Bauer 11 months ago

  • Status changed from New to Resolved

#5 Updated by Paul Bauer 11 months ago

  • Target version set to 2019

#6 Updated by Paul Bauer 11 months ago

  • Status changed from Resolved to Closed

Also available in: Atom PDF