Contrib multiSolver/Post processing
multiPost -command 'options' [-global] [-local] [-doNotPurge] [-doNotSet]
Contents
1 -command
Choose one of:
- list - list data available
- load - copy specified data to case/time
- purge - delete specified data
- set - change case directory to match supplied solver domain
1.1 list
Takes no options. Giving options will provide an error.
multiPost -list
1.2 load
Loads the data specified in options. Additional options:
- -global, -local - By default, load will copy by localTime, unless the times overlap, in which case it loads by globalTime. These options force it to load by the specified time.
- -doNotPurge - By default, load will purge the case/time directories before copying the new data in. This option disables this behaviour.
- -doNotSet - By default, if all the specified load data is from a single solverDomain, load will automatically set the case directory to this solverDomain. This option disables this behaviour.
multiPost -load all
Load all data.
multiPost -load icoFoam -global
Load all data from icoFoam solverDomain, using globalTime.
multiPost -load scalarTransportFoam 1 2 5:9 -doNotPurge
Load all data from scalarTransportFoam, superLoops 1, 2, and 5 through 9, but do not delete the case/time directories first.
1.3 purge
Purges the data specified in options.
multiPost -purge root
Delete all the case/time directories.
multiPost -purge 5:9
Delete superloops 5 through 9 in all solverDomains.
multiPost -purge all
Delete all data in all solverDomains (except for initial directories).
1.4 set
Sets the case directory to a given solverDomain. That is, any dictionary that changes content is swapped to the correct solverDomain; and a controlDict is written. The controlDict doesn't have all the data for the given solverDomain, but it (importantly) points to the first case/time directory as its startFrom. paraFoam uses this to initialize.
Set can only take a single solverDomain in options. Any superLoop specifications, or additional solverDomain names will result in error.
2 'options'
The options to the command. If the options have whitespace characters (i.e. are more than 1 word), they must be enclosed in apostrophes. Options come in two parts: solverDomains, followed by superLoops. Each can have any number of entries, including zero, but options cannot be empty unless using -list.
2.1 solverDomainNames
A simple word list, space delimited. List any solverDomains you want to load data from. e.g.:
scalarTransportFoam icoFoam customSolver
or
icoFoam
Omitting solverDomainNames indicates that *all* solverDomains will be used.
2.2 superLoop numbers
A space delimited number list in any order. Can include ranges using a : character. A value of -1 indicates the initial directory. e.g.:
3 5 6 9:12
or
-1 5
Omitting superLoop numbers entirely indicates that *all* superLoops will be used.
2.3 Special words
There are two special words reserved for some of the commands:
- all - indicates all solverDomains and all superLoops. Useable by -load and -purge.
- root - indicates all case/time directories. Useable by -purge only.
e.g.:
multiPost -load all multiPost -purge root