Skip to content

BIDSBehEvent

Bases: dict

A class that represents events of behavioral experiments.

This class is used for events that do not include the mandatory onset and duration columns. Events are, for example, stimuli presented to the participant or participant responses.

Examples:

>>> from psychopy_bids import bids
>>> event = bids.BIDSBehEvent(trial=1, resp='L')
Notes

For more details on behavioral experiment files, see BIDS Specification.

Source code in psychopy_bids/bids/bidsbehevent.py 
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
class BIDSBehEvent(dict):
    """A class that represents events of behavioral experiments.

    This class is used for events that do not include the mandatory onset and duration columns.
    Events are, for example, stimuli presented to the participant or participant responses.

    Examples
    --------
    >>> from psychopy_bids import bids
    >>> event = bids.BIDSBehEvent(trial=1, resp='L')

    Notes
    -----
    For more details on behavioral experiment files, see [BIDS Specification](https://bids-specification.readthedocs.io/en/stable/04-modality-specific-files/07-behavioral-experiments.html).
    """

    def __init__(self, *args: tuple, **kwargs: dict) -> None:
        """Initialize a BIDSBehEvent object.

        Parameters
        ----------
        *args : tuple
            Any arguments that the object's superclass's `__init__` method might require.
        **kwargs : dict
            Any keyword arguments that the object's superclass's `__init__` method might require.
        """
        super().__init__(*args, **kwargs)
        self.__dict__ = self

    # -------------------------------------------------------------------------------------------- #

    def __repr__(self) -> str:
        """Return a printable representational string of the given object.

        This method returns a string representation of the BIDSBehEvent object containing its
        attribute-value pairs.

        Returns:
        -------
        str
            A string representation of the BIDSBehEvent object.
        """
        items = [f"{key}={value}" for key, value in self.items() if value is not None]
        return f"BIDSBehEvent({', '.join(items)})" if items else "BIDSBehEvent()"

__init__(*args, **kwargs)

Initialize a BIDSBehEvent object.

Parameters:

Name Type Description Default
*args tuple

Any arguments that the object's superclass's __init__ method might require.

 ()
**kwargs dict

Any keyword arguments that the object's superclass's __init__ method might require.

 {}
Source code in psychopy_bids/bids/bidsbehevent.py 
20
21
22
23
24
25
26
27
28
29
30
31
def __init__(self, *args: tuple, **kwargs: dict) -> None:
    """Initialize a BIDSBehEvent object.

    Parameters
    ----------
    *args : tuple
        Any arguments that the object's superclass's `__init__` method might require.
    **kwargs : dict
        Any keyword arguments that the object's superclass's `__init__` method might require.
    """
    super().__init__(*args, **kwargs)
    self.__dict__ = self

__repr__()

Return a printable representational string of the given object.

This method returns a string representation of the BIDSBehEvent object containing its attribute-value pairs.

Returns:

str A string representation of the BIDSBehEvent object.

Source code in psychopy_bids/bids/bidsbehevent.py 
35
36
37
38
39
40
41
42
43
44
45
46
47
def __repr__(self) -> str:
    """Return a printable representational string of the given object.

    This method returns a string representation of the BIDSBehEvent object containing its
    attribute-value pairs.

    Returns:
    -------
    str
        A string representation of the BIDSBehEvent object.
    """
    items = [f"{key}={value}" for key, value in self.items() if value is not None]
    return f"BIDSBehEvent({', '.join(items)})" if items else "BIDSBehEvent()"