Next: Chart Options, Previous: Notes and Comments, Up: Signalling Chart Language Reference [Contents]

### 9.9 Parallel Blocks

Sometimes it is desired to express that two (or more) separate processes happen side-by-side. Parallel blocks allow this. Simply place the the parallel blocks between ‘`{}`’ marks and write them one after the other, as in Drawing Things in Parallel. You can specify as many parallel blocks as you want. The last (and only the las) parallel block shall be followed by a semicolon. The order of the blocks is not much relevant, with the exception of numbering, which goes in the order the blocks are specified in the source file. It is possible to place anything in a parallel block, arrows, boxes, or other parallel blocks, as well. Below the series of parallel blocks the next element will be drawn after the longest of the parallel blocks.

There are two ways to lay out parallel blocks. They differ in how they handle cases when elements from the individual blocks would overlap. For non-overlapping cases they function the same way. The first algorithm, called `one-by-one` places elements from blocks one by one always taking the next element from the block which is currently the shortest (has its bottom end the highest). Elements are placed so as to avoid overlap between them. The other algorithm, called `overlap` lays out the blocks independently and allows overlap. The algorithm to use can be selected by the `layout` attribute that can be specified for the entire parallel block series before the first block.

The `one_by_one` algorithm has a variant, called `one_by_one_merge`, which behaves differently in case of nested parallel blocks. If you apply this algorithm to the inner parallel block, they will be merged with the outer blocks. In contrast, `one_by_one` results in laying out the inner parallel blocks on their own as if they were a single element.

Note that with `one_by_one` and `one_by_one_merge` Msc-generator not only avoids overlap between elements, but in addition keeps a minimum distance between two elements. This means that arrows to/from the same entity cannot be drawn completely besides each other, since in that case they would touch. Thus one of them is drawn a little lower. If this is not intended, use `overlap`.

If you use the `overlap` algorithm, you can also specify vertical alignment of the individual blocks via the `vertical_ident` attribute, which can be set to `top`, `middle` or `bottom`.

The default behaviour is `one_by_one_merge`, which allows fine parallelism, but avoids ugly overlaps52.

You can mark entire parallel block series, with the `parallel` and `overlap` keywords (and attributes). This results in elements after the entire parallel block series to be laid out besides and over the elements in the parallel blocks, respectively. In addition, you can set the `keep_with_next` and `keep_together` attributes to influence automatic pagination.

> Parallel block serieses also have `compress` and `vspacing` attributes. These govern, how they are laid out under the previous element. For block series with `layout=overlap` and `layout=one_by_one`, first the entire block series is laid out without regard to already placed elements. Then, if compress is on (or `vspace=compress` is set, which is equivalent) the whole block series is moved upwards as one until some parts of it bump into an already placed element. If a nonzero vertical spacing is used, the whole block series is shifted down such that the requested spacing appears between the top of the block series and the prior element.

> For `layout=one_by_one_merge` with `compress=yes` the first elements of the parallel blocks are individually moved upwards until they hit one of the elements above. In case a positive `vspacing` is specified, the behaviour is the same as for `layout=one_by_one`. The `compress` and the `vspacing` attribute of the first element in each parallel block can modify this behaviour (e.g., by adding vertical spacing).

> Note that if the `vspacing` chart option is set to a positive number, the `vspacing` attribute of parallel blocks is set to zero instead of this number by default. This is to avoid having this vertical space twice: once for the parallel block series and once for the first elements in the blocks. You can nevertheless assign a nonzero vertical space for the block series by manually specifying the `vspacing` attribute for the parallel block. If case of `vspacing=compress` or `compress=yes` chart options, the corresponding attribute of parallel block series is set according to the value of the chart option.

One design goal with `layout=one_by_one_merge` was that in case the parallel block series contains just one block, it should get laid out exactly as if its content were not enclosed between ‘`{}`’ marks. This allows you to put ‘`{}`’ marks around any set of elements, creating a new scope (see Scoping), where any changes to styles or options take effect only inside the scope.

#### Footnotes

##### (52)

Setting the `classic_parallel_layout` chart option to `yes` causes the default to be `overlap`, because prior v3.6 the only algorithm available was `overlap`. This chart option is now deprecated and will be removed in future releases. Use `layout=overlap` instead.

Next: Chart Options, Previous: Notes and Comments, Up: Signalling Chart Language Reference [Contents]