![]() ![]() BRAHMS
User Guide » Developing Systems » Advanced Topics » Windowed Logs
This documentation is offline - click here to go online
Index | Search: Go online to use Search
| ||
OverviewYour Process may generate a large amount of data during the whole execution, and logging data can be slow. If you are only interested in reviewing its output in one or more time windows, you can set these logging windows in advance of execution. Currently, all windows have to be specified explicitly in advance of execution. Instants and windowsYou can request that an individual output be logged by using the following syntax (in Matlab): M Source Code (against 995)
To have a particular time instant logged, and no other, use this syntax: M Source Code (against 995)
This will log the output at t=0.2 seconds, and turn off logging at all other sample times. To log in a particular time range, use this syntax: M Source Code (against 995)
This will log from 0.2 to 0.4 seconds. Note that the output for t=0.2 is logged, that for t=0.4 is not - to include the output at t=0.4 as well, specify the t=0.4 instant explicitly: M Source Code (against 995)
Any number of instants and ranges can be included in this comma-separated string, to build up any pattern of logging you require. Periodic loggingIt may happen that you want to record the logs periodically. You could specify each logging range explicitly using the syntax outlined above, but that may make for a very long string. Alternatively, you can specify periodic logging. Examine the following: M Source Code (against 995)
This will log the window t=0.2 seconds to t=0.4 seconds, and the window t=1.2 to t=1.4, etc., up until the last at t=9.2 to t=9.4. The sub-string beginning with the '@' character is the 'origin specifier', because it specifies ten time instants at which we specify the virtual time to be zero, t_v=0, relative to which the range t_v=0.2 to t_v=0.4 is then logged. Complex examplesMore formally, the 'window specifier' (the whole string passed) is made up of multiple 'origin specifiers', separated by semi-colons. '0.2:0.4,0.4' and '@0:1:10,0.2:0.4' are examples of origin specifiers. The second of these begins with a 'repeat specifier' (a sub-string beginning with the "@" character). The first is, by lacking a repeat specifier, the 'global origin specifier', and implies the base time origin (i.e. the single non-repeating window beginning at t=0, not repeating, and not ending). The remainder of both origin specifiers is a comma-separated list of time instants and time ranges, relative to the specified repeating window (or base window), at which logging should be performed. Most window specifier cases will be very simple - to illustrate a complex case, consider the following taken from M Source Code (against 995)
window
This example will log the output Whole systemYou can set windowing for the whole system - settings for individual logs will override it, if present. Just use, for instance: M Source Code (against 995)
window
|
||
This is a documentation page for the BRAHMS Modular Execution (Simulation) Framework. For details of licensing and distribution, please click here. To advise of an error or omission, please click here. |