restart_copying

(experimental) copy alias definition for additional boundary elements during restart

Copy the alias definition of the pre-restart alias CopyFromAlias to the new alias CopyToNewAlias for additional boundary elements that are introduced during restart via restart_additionalBE.
restart_copying = ( CopyFromAlias, CopyToNewAlias ) Restart_Copying = ( CopyFromAlias, CopyToNewAlias ) # alternative definition
Requirements and Basic Behavior:
  • CopyFromAlias must already exist as an alias in the pre-restart input. The name must match exactly (including any chamber index in curly brackets, e.g. alias1 or alias1{3}, see below). If it does not exist, reading the restart input is aborted with an error (hard exit).
  • The pre-restart alias CopyFromAlias has to be equipped with a suitable BC_PASSON or IDENT_PASSON flag (depending on the application). See FreeJet_Exchange and Pipe_Exchange for examples.
  • A new alias CopyToNewAlias is created and inherits all properties of CopyFromAlias. Only boundary elements that are newly introduced during restart use CopyToNewAlias. Existing pre-restart boundary elements keep their original alias.

Multi-Chamber Scenarios

In multiphase simulations, MESHFREE automatically generates unique names from the user-defined geometry aliases by appending the chamber index in curly brackets, e.g. alias1{1}, alias1{2}, ...
  • If CopyFromAlias is given with a chamber index, only for this chamber the copying will be triggered. For example, in case of
    restart_copying = ( alias1{3}, alias2{3} )
    only alias2{3} is created and it inherits the properties of alias1{3}. No aliases are created for other chambers.
  • If CopyFromAlias is given without a chamber index, for every chamber index k where a chamber-specific alias alias1{k} exists, a corresponding alias alias2{k} is automatically created and inherits the properties of alias1{k}. If no alias alias1{k} exists for a chamber k, no alias2{k} is created for that chamber.
    restart_copying = ( alias1, alias2 )
  • Nested or repeated chamber indices such as alias1{1}{2} or alias2{3}{4} are not permitted.
Note: Copying requires additional boundary elements to be included by restart_additionalBE. Pre-restart aliases and their associated boundary elements can be removed on restart by restart_toberemoved.