Logging

The logging of variables is affected by settings in numerous forms. This can be a source of confusion as the documentation of these settings is spread throughout the manual. This appendix overviews all these settings in one handy location.

I/O Points Formsio_points.png

Logging may be enabled on individual points in the three I/O points forms. Click on the Log to File checkbox to enable logging on that point, and select a Logging Period from the pull down menu. These are only the default settings for the point and may be overridden in other forms.

See Analog Points..., Digital Points..., and String Points....

Initial Conditionsinit_cond.png

The default settings for I/O points may be overridden using the Initial Conditions settings on a simulation test. For each point, the initial conditions can accept the default setting that was set in the I/O points forms or explicitly enable or disable logging. When explicitly enabled, the logging period may also be set here.

The Initial Conditions form is also where logging can be enabled for individual model parameters and signals. Logging for these is always off by default. The logging period may also be set for parameters and signals.

Which initial conditions set applies to a particular run of a test session is itself complicated. In the Tests form, a default initial conditions set is selected for each test. Every test has one called Default-models-RTDB.tests.png

When tests are collected together into test suites, the Test Suites form allows a different initial conditions set to be selected for each instance of a test added to the suite.

When test sessions are created for individual tests, the default initial conditions set may be overridden. Select .default to get the default initial condition set selected in the Tests form, or select any other one to select an explicit initial conditions set..test_sessions-edit-initializing.png

Test Sessionstest_sessions_record.png

Finally, logging may be turned on and off dynamically while a test is running by clicking on the Record toggle button. When this button is engaged, the default, any RTDB logging enabled by the previous means will take place. When disengaged, logging is interrupted until the toggle button is reengaged.