lisa.wlgen.rta.Periodic#

class lisa.wlgen.rta.Periodic(duty_cycle_pct=50, duration_s=1, period_ms=100, delay_s=0, sched_policy=None, priority=None, cpus=None, uclamp_min=None, uclamp_max=None, numa_nodes_membind=None, **kwargs)[source]#

Bases: RTAPhaseTree

Configure a periodic load. This is the simplest type of RTA task.

This class defines a task which load is periodic with a configured period and duty-cycle.

Parameters:

duty_cycle_pct (float) – the generated load in percents.
duration_s (float) – the phase duration in [s].
period_ms (float) – the period used to define the load in [ms].

See also

See Phase for the documentation of the following parameters:

cpus
uclamp_min
uclamp_max
numa_nodes_membind

Deprecated since version 2.0.

Periodic is deprecated and will be removed in version 4.0, use lisa.wlgen.rta.RTAPhase instead: Replaced by lisa.wlgen.rta.RTAPhase along with lisa.wlgen.rta.PeriodicWload workload

Attributes

__reversed__ ^inherited

See collections.abc.Mapping.__reversed__

Properties

`delay_s`
`loops`
`priority`
`sched_policy`
`children` ^inherited	Tree levels are transparent and their children expanded directly in their parent, as long as they have no properties on their own that could change the output of `topo_sort()`. This allows nested `RTAPhaseTree` to act as if it was just a flat node, which is useful since repeated composition with `+` operator will give nested binary trees like that.
`is_empty` ^inherited	`True` if the phase has no content and will result in an empty JSON phase(s).
`phases` ^inherited	Topological sort of the phases in the tree, with the properties merged along each path from the root to the leaves.

Methods

`__init_subclass__()`	Update the docstring used as a `str.format()` template with the following keys:.
`HASH_COERCE()` ^inherited	Used to coerce the values of `self.__dict__` to hashable values.
`__add__()` ^inherited	Compose two phases together by running one after the other.
`__await__()` ^inherited
`__class_getitem__()` ^inherited	See `collections.abc.Iterable.__class_getitem__()`
`__contains__()` ^inherited	See `collections.abc.Mapping.__contains__()`
`__getitem__()` ^inherited	Lookup the value of the given property on that phase.
`__iter__()` ^inherited
`__len__()` ^inherited
`__mul__()` ^inherited	Multiply the phase by `n`, in order to repeat it.
`__rmul__()` ^inherited
`get()` ^inherited	See `collections.abc.Mapping.get()`
`get_rtapp_repr()` ^inherited	rt-app JSON representation of the phase.
`items()` ^inherited	See `collections.abc.Mapping.items()`
`keys()` ^inherited	See `collections.abc.Mapping.keys()`
`split_prop_kwargs()` ^inherited	Split the `kwargs` into two categories:.
`topo_sort()` ^inherited	Topological sort of the tree, and combine the properties along each path from root to leaves at the same time.
`values()` ^inherited	See `collections.abc.Mapping.values()`
`with_delete_props()` ^inherited	Delete all the given property names, equivalent to `with_props(foo=delete())`.
`with_phase_properties()` ^inherited	Return a cloned instance with the properties combined with the given `properties` using `RTAPhaseProperties.__and__()` (`&`). The `properties` parameter is the left operand. If `properties` is `None`, just return the phase itself.
`with_properties_map()` ^inherited	Same as `with_phase_properties()` but with `properties` passed to `RTAPhaseProperties.from_polymorphic()` first.
`with_props()` ^inherited	Same as `with_phase_properties()` but using keyword arguments to set each property. The resulting dictionary is passed to `RTAPhaseProperties.from_polymorphic()` first.

Attributes#

Periodic.__reversed__ = None#

Properties#

property Periodic.delay_s#

property Periodic.loops#

property Periodic.priority#

property Periodic.sched_policy#

property Periodic.children#

Inherited property, see lisa.wlgen.rta.RTAPhaseTree.children

Tree levels are transparent and their children expanded directly in their parent, as long as they have no properties on their own that could change the output of topo_sort(). This allows nested RTAPhaseTree to act as if it was just a flat node, which is useful since repeated composition with + operator will give nested binary trees like that.

property Periodic.is_empty#

Inherited property, see lisa.wlgen.rta.RTAPhaseTree.is_empty

True if the phase has no content and will result in an empty JSON phase(s).

property Periodic.phases#

Inherited property, see lisa.wlgen.rta.RTAPhaseTree.phases

Topological sort of the phases in the tree, with the properties merged along each path from the root to the leaves.

Methods#

Periodic.__init_subclass__()#

Update the docstring used as a str.format() template with the following keys:

{prop_kwargs}: replaced by the Sphinx-friendly list of “prop_*” keyword arguments

Periodic.HASH_COERCE(x, coerce)#

Inherited method, see lisa.utils.SimpleHash.HASH_COERCE()

Used to coerce the values of self.__dict__ to hashable values.

Periodic.__add__(other)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.__add__()

Compose two phases together by running one after the other.

Periodic.__await__()#: Inherited method, see lisa.wlgen.rta.RTAPhaseBase.__await__()

classmethod Periodic.__class_getitem__()#: Inherited method, see collections.abc.Iterable.__class_getitem__()

Periodic.__contains__()#: Inherited method, see collections.abc.Mapping.__contains__()

Periodic.__getitem__(key)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.__getitem__()

Lookup the value of the given property on that phase.

Periodic.__iter__()#: Inherited method, see lisa.wlgen.rta.RTAPhaseBase.__iter__()

Periodic.__len__()#: Inherited method, see lisa.wlgen.rta.RTAPhaseBase.__len__()

Periodic.__mul__(n)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.__mul__()

Multiply the phase by n, in order to repeat it.

Periodic.__rmul__(n)#: Inherited method, see lisa.wlgen.rta.RTAPhaseBase.__rmul__()

Periodic.get()#: Inherited method, see collections.abc.Mapping.get()

Periodic.get_rtapp_repr(task_name, plat_info, force_defaults=False, no_force_default_keys=None, **kwargs)#

Inherited method, see lisa.wlgen.rta.RTAPhaseTree.get_rtapp_repr()

rt-app JSON representation of the phase.

Periodic.items()#: Inherited method, see collections.abc.Mapping.items()

Periodic.keys()#: Inherited method, see collections.abc.Mapping.keys()

static Periodic.split_prop_kwargs(kwargs, properties=None)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.split_prop_kwargs()

Split the kwargs into two categories:.

Periodic.topo_sort()#

Inherited method, see lisa.wlgen.rta.RTAPhaseTree.topo_sort()

Topological sort of the tree, and combine the properties along each path from root to leaves at the same time.

Periodic.values()#: Inherited method, see collections.abc.Mapping.values()

Periodic.with_delete_props(properties)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.with_delete_props()

Delete all the given property names, equivalent to with_props(foo=delete()).

Periodic.with_phase_properties(properties)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.with_phase_properties()

Return a cloned instance with the properties combined with the given properties using RTAPhaseProperties.__and__() (&). The properties parameter is the left operand. If properties is None, just return the phase itself.

Periodic.with_properties_map(properties, **kwargs)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.with_properties_map()

Same as with_phase_properties() but with properties passed to RTAPhaseProperties.from_polymorphic() first.

Periodic.with_props(**kwargs)#

Inherited method, see lisa.wlgen.rta.RTAPhaseBase.with_props()

Same as with_phase_properties() but using keyword arguments to set each property. The resulting dictionary is passed to RTAPhaseProperties.from_polymorphic() first.

lisa.wlgen.rta.Periodic#

Attributes#

Properties#

Methods#

This Page