Documentation Home Page HYPERSIM Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

TestView Command | General | Loop

Loop Dialog Box


The Loop command is used to iterate in the test sequence. The number of times can be user-defined or auto-detected. If it is auto-detected, TestView is looking for the enabled multi-param option in the other commands to define the number of iterations necessary.

The ‘Operation’ option enables loop numbering. It is important to understand this option as it affects the way data is saved and thus the behavior of other commands. If left unchecked, each loop is considered as an independent test. If checked, each loop will have a different index. To understand the difference, look at the way the pdf documents are generated. The table below presents the difference for a test with one loop that iterates three times.

On the left, the operation option is unchecked and hence, it creates three folders, one for each iteration. Conversely, when the operation is checked, the loops are numbered and thus only one folder is created for the test and the data for all iteration is saved in that folder.

This difference in architecture of the data makes a big difference in the way post-processing works as it only considers data in one folder. As an example, let’s suppose that we are looking for the maximum overcurrent value in post-processing. If 'Operation' is left unchecked, post-processing will only look at the last iteration (because it is the only one in the folder). Whereas if it is checked, it will compare all three iterations (because all three iterations are in the same folder).

The complexity increases when there is a loop in a loop. Below is an example of the pdf generated where the first loop has five iterations and the second three iterations.

As it is possible to see, when the 'Operation' option of each loop is unchecked, each iteration is considered as independent (15 different folders). When both loops are checked or only the second one, it creates one folder per main loop.

When only the first loop is checked, the pdf creator overwrites the same file each time.

The second loop “Operation” has priority over the first one, i.e. when the test numbering of the second loop is different than 1, it will force the first loop to create a new folder. Therefore, if only the first loop is checked, it will force to have only one folder. However, as the second loop is not incrementing (not checked), it will not force the first loop to create a new folder and instead will rewrite the same file several times.

In brief, the ‘Operation’ checkbox in loops affects the way data is saved and therefore can impact other functions such as post-processing and tableOut as they depend on the way data is saved.

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter