boris-behav-obs 9.7.7__py3-none-any.whl

boris/boris_cli.py

@@ -0,0 +1,340 @@
+"""
+BORIS CLI
+
+Behavioral Observation Research Interactive Software Command Line Interface
+
+Copyright 2012-2025 Olivier Friard
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+  MA 02110-1301, USA.
+"""
+
+import argparse
+import sys
+import re
+import pathlib
+import utilities
+import project_functions
+from config import *
+import db_functions
+import export_observation
+import irr
+import plot_events
+import version
+
+__version__ = version.__version__
+__version_date__ = version.__version_date__
+
+
+def cleanhtml(raw_html):
+    raw_html = raw_html.replace("<br>", "\n")
+    cleanr = re.compile("<.*?>")
+    cleantext = re.sub(cleanr, "", raw_html)
+    return cleantext
+
+
+def all_observations(pj):
+    return [idx for idx in sorted(pj[OBSERVATIONS])]
+
+
+commands_list = ["check_state_events", "export_events", "irr", "subtitles", "check_project_integrity", "plot_events"]
+commands_usage = {
+    "check_state_events": (
+        "usage:\nboris_cli -p PROJECT_FILE -o OBSERVATION_ID --command check_state_events\n"
+        "where\n"
+        "PROJECT_FILE is the path of the BORIS project\n"
+        "OBSERVATION_ID is the id of observation(s) (if ommitted all observations are checked)"
+    ),
+    "export_events": (
+        "usage:\nboris_cli -p PROJECT_FILE -o OBSERVATION_ID --command export_events [OUTPUT_FORMAT]\n"
+        "where:\n"
+        "PROJECT_FILE is the path of the BORIS project\n"
+        "OBSERVATION_ID is the id of observation(s) (if ommitted all observations are exported)\n"
+        "OUTPUT_FORMAT can be tsv (default), csv, xls, xlsx, ods, html"
+    ),
+    "irr": (
+        'usage:\nboris_cli -p PROJECT_FILE -o "OBSERVATION_ID1" "OBSERVATION_ID2" --command irr [INTERVAL] [INCLUDE_MODIFIERS]\n'
+        "where:\n"
+        "PROJECT_FILE is the path of the BORIS project\n"
+        "INTERVAL in seconds (default is 1)\n"
+        "INCLUDE_MODIFIERS must be true or false (default is true)"
+    ),
+    "subtitles": (
+        'usage:\nboris_cli -p PROJECT_FILE -o "OBSERVATION_ID" --command subtitles [OUTPUT_DIRECTORY]\n'
+        "where:\n"
+        "OUTPUT_DIRECTORY is the directory where subtitles files will be saved"
+    ),
+    "check_project_integrity": "usage:\nboris_cli -p PROJECT_FILE --command check_project_integrity",
+    "plot_events": (
+        "usage:\nboris_cli - p PROJECT_FILE -o OBSERVATION_ID --command plot_events "
+        "[OUTPUT_DIRECTORY] [INCLUDE_MODIFIERS] [EXCLUDE_BEHAVIORS] [PLOT_FORMAT]\n"
+        "where\n"
+        "OUTPUT_DIRECTORY is the directory where the plots will be saved\n"
+        "INCLUDE_MODIFIERS must be true or false (default is true)\n"
+        "EXCLUDE_BEHAVIORS: True: behaviors without events are not plotted (default is true)\n"
+        "PLOT_FORMAT can be png, svg, pdf, ps"
+    ),
+}
+
+parser = argparse.ArgumentParser(description="BORIS CLI")
+parser.add_argument("-v", "--version", action="store_true", dest="version", help="BORIS version")
+parser.add_argument("-p", "--project", action="store", dest="project_file", help="Project file path")
+parser.add_argument("-o", "--observation", nargs="*", action="store", default=[], dest="observation_id", help="Observation id")
+parser.add_argument("-i", "--info", action="store_true", dest="project_info", help="Project information")
+parser.add_argument("-c", "--command", nargs="*", action="store", dest="command", help="Command to execute")
+
+args = parser.parse_args()
+
+pj, observations_id_list = {}, {}
+
+if args.version:
+    print("version {}".format(__version__))
+    sys.exit()
+
+if args.command:
+    if args.command[0].upper() == "LIST":
+        for command in commands_list:
+            print(command)
+            print("=" * len(command))
+            if command in commands_usage:
+                print(commands_usage[command])
+            print()
+        print()
+        sys.exit()
+
+if args.project_file:
+    if not args.command:
+        print("Project path: {}".format(args.project_file))
+
+    project_path, project_changed, pj, msg = project_functions.open_project_json(args.project_file)
+    if "error" in pj:
+        print(pj["error"])
+        sys.exit()
+    if msg:
+        print(msg)
+
+if args.observation_id:
+    observations_id_list = args.observation_id
+    """
+    if not args.command:
+        print("\nObservations:")
+        for observation_id in observations_id_list:
+            if observation_id in pj[OBSERVATIONS]:
+                print("Id: {}".format(observation_id))
+            else:
+                print("{}: NOT FOUND in project".format(observation_id))
+        print()
+    """
+
+if args.project_info:
+    if not args.command:
+        if pj:
+            print("Project name: {}".format(pj[PROJECT_NAME]))
+            print("Project date: {}".format(pj[PROJECT_DATE]))
+            print("Project description: {}".format(pj[PROJECT_DESCRIPTION]))
+            print()
+
+            if not observations_id_list:
+                print("Ethogram\n========")
+                print("Number of behaviors in ethogram: {}".format(len(pj[ETHOGRAM])))
+                for idx in utilities.sorted_keys(pj[ETHOGRAM]):
+                    print(
+                        "Code: {}\tDescription: {}\tType: {}".format(
+                            pj[ETHOGRAM][idx][BEHAVIOR_CODE], pj[ETHOGRAM][idx]["description"], pj[ETHOGRAM][idx][TYPE]
+                        )
+                    )
+                """print("Behaviors: {}".format(",".join([pj[ETHOGRAM][k]["code"] for k in utilities.sorted_keys(pj[ETHOGRAM])])))"""
+                print()
+
+                print("Subjects\n========")
+                print("Number of subjects: {}".format(len(pj[SUBJECTS])))
+                for idx in utilities.sorted_keys(pj[SUBJECTS]):
+                    print("Name: {}\tDescription: {}".format(pj[SUBJECTS][idx]["name"], pj[SUBJECTS][idx]["description"]))
+                print()
+
+                print("Observations\n============")
+                print("Number of observations: {}".format(len(pj[OBSERVATIONS])))
+                print("List of observations:")
+                for observation_id in sorted(pj[OBSERVATIONS].keys()):
+                    print("Id: {}\tDate: {}".format(observation_id, pj[OBSERVATIONS][observation_id]["date"]))
+
+            else:
+                for observation_id in observations_id_list:
+                    print("Observation id: {}".format(observation_id))
+                    if pj[OBSERVATIONS][observation_id][EVENTS]:
+                        for event in pj[OBSERVATIONS][observation_id][EVENTS]:
+                            print("\t".join([str(x) for x in event]))
+                    else:
+                        print("No events recorded")
+                    print()
+        else:
+            print("No project")
+        sys.exit()
+
+if args.command:
+    print("Command: {}\n".format(" ".join(args.command)))
+
+    if not pj:
+        print("No project")
+        sys.exit()
+
+    if "check_state_events" in args.command:
+        if not observations_id_list:
+            print("No observation selected. Command applied on all observations found in project\n")
+            observations_id_list = all_observations(pj)
+
+        for observation_id in observations_id_list:
+            ret, msg = project_functions.check_state_events_obs(observation_id, pj[ETHOGRAM], pj[OBSERVATIONS][observation_id], HHMMSS)
+            print("{}: {}".format(observation_id, cleanhtml(msg)))
+        sys.exit()
+
+    if "export_events" in args.command:
+        if not observations_id_list:
+            print("No observation selected. Command applied on all observations found in project\n")
+            observations_id_list = [idx for idx in pj[OBSERVATIONS]]
+
+        behaviors = [pj[ETHOGRAM][k]["code"] for k in utilities.sorted_keys(pj[ETHOGRAM])]
+        subjects = [pj[SUBJECTS][k]["name"] for k in utilities.sorted_keys(pj[SUBJECTS])] + [NO_FOCAL_SUBJECT]
+
+        output_format = "tsv"
+        if len(args.command) > 1:
+            output_format = args.command[1]
+
+        for observation_id in observations_id_list:
+            ok, msg = export_observation.export_events(
+                {"selected subjects": subjects, "selected behaviors": behaviors},
+                observation_id,
+                pj[OBSERVATIONS][observation_id],
+                pj[ETHOGRAM],
+                utilities.safeFileName(observation_id + "." + output_format),
+                output_format,
+            )
+            if not ok:
+                print(msg)
+
+        sys.exit()
+
+    if "irr" in args.command:
+        if len(observations_id_list) != 2:
+            print("select 2 observations")
+            sys.exit()
+
+        behaviors = [pj[ETHOGRAM][k]["code"] for k in utilities.sorted_keys(pj[ETHOGRAM])]
+        subjects = [pj[SUBJECTS][k]["name"] for k in utilities.sorted_keys(pj[SUBJECTS])] + [NO_FOCAL_SUBJECT]
+
+        ok, msg, db_connector = db_functions.load_aggregated_events_in_db(pj, subjects, observations_id_list, behaviors)
+
+        if not ok:
+            print(cleanhtml(msg))
+            sys.exit()
+
+        cursor = db_connector.cursor()
+
+        interval = 1
+        if len(args.command) > 1:
+            interval = utilities.float2decimal(args.command[1])
+
+        include_modifiers = True
+        if len(args.command) > 2:
+            include_modifiers = "TRUE" in args.command[2].upper()
+
+        K, out = irr.cohen_kappa(cursor, observations_id_list[0], observations_id_list[1], interval, subjects, include_modifiers)
+
+        print(("Cohen's Kappa - Index of Inter-Rater Reliability\n\nInterval time: {interval:.3f} s\n").format(interval=interval))
+
+        print(out)
+        sys.exit()
+
+    if "subtitles" in args.command:
+        if not observations_id_list:
+            print("No observation selected. Command applied on all observations found in project\n")
+            observations_id_list = all_observations(pj)
+
+        behaviors = [pj[ETHOGRAM][k]["code"] for k in utilities.sorted_keys(pj[ETHOGRAM])]
+        subjects = [pj[SUBJECTS][k]["name"] for k in utilities.sorted_keys(pj[SUBJECTS])] + [NO_FOCAL_SUBJECT]
+
+        export_dir = "."
+        if len(args.command) > 1:
+            export_dir = args.command[1]
+            if not pathlib.Path(export_dir).is_dir():
+                print("{} is not a valid directory".format(export_dir))
+                sys.exit()
+
+        ok, msg = project_functions.create_subtitles(
+            pj,
+            observations_id_list,
+            {"selected subjects": subjects, "selected behaviors": behaviors, "include modifiers": True},
+            export_dir,
+        )
+        if not ok:
+            print(cleanhtml(msg))
+        sys.exit()
+
+    if "check_project_integrity" in args.command[0]:
+        msg = project_functions.check_project_integrity(pj, HHMMSS, args.project_file)
+        if msg:
+            print(cleanhtml(msg))
+        else:
+            print("No issuses found in project")
+        sys.exit()
+
+    if "plot_events" in args.command[0]:
+        if not observations_id_list:
+            print("No observation selected. Command applied on all observations found in project\n")
+            observations_id_list = all_observations(pj)
+
+        behaviors = [pj[ETHOGRAM][k]["code"] for k in utilities.sorted_keys(pj[ETHOGRAM])]
+        subjects = [pj[SUBJECTS][k]["name"] for k in utilities.sorted_keys(pj[SUBJECTS])] + [NO_FOCAL_SUBJECT]
+
+        export_dir = "."
+        if len(args.command) > 1:
+            export_dir = args.command[1]
+            if not pathlib.Path(export_dir).is_dir():
+                print("{} is not a valid directory".format(export_dir))
+                sys.exit()
+
+        include_modifiers = True
+        if len(args.command) > 2:
+            include_modifiers = "TRUE" in args.command[2].upper()
+
+        exclude_behaviors = True
+        if len(args.command) > 3:
+            exclude_behaviors = False if "FALSE" in args.command[3].upper() else True
+
+        plot_format = "png"
+        if len(args.command) > 4:
+            plot_format = args.command[4].lower()
+
+        plot_events.create_events_plot(
+            pj,
+            observations_id_list,
+            {
+                "selected subjects": subjects,
+                "selected behaviors": behaviors,
+                "include modifiers": include_modifiers,
+                "exclude behaviors": exclude_behaviors,
+                "time": TIME_FULL_OBS,
+                "start time": 0,
+                "end time": 0,
+            },
+            plot_colors=BEHAVIORS_PLOT_COLORS,
+            plot_directory=export_dir,
+            file_format=plot_format,
+        )
+        sys.exit()
+
+    print("Command {} not found!".format(args.command[0]))
+
+print()

boris/cmd_arguments.py

@@ -0,0 +1,49 @@
+"""
+BORIS
+Behavioral Observation Research Interactive Software
+Copyright 2012-2025 Olivier Friard
+
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+  MA 02110-1301, USA.
+
+"""
+
+from optparse import OptionParser
+
+
+def parse_arguments():
+    # check if argument
+    usage = 'usage: %prog [options] [-p PROJECT_PATH] [-o "OBSERVATION ID"]'
+    parser = OptionParser(usage=usage)
+
+    parser.add_option("-d", "--debug", action="store_true", default=False, dest="debug", help="Use debugging mode")
+    parser.add_option("-q", "--quit", action="store_true", default=False, dest="quit", help="Quit after launch")
+    parser.add_option("-v", "--version", action="store_true", default=False, dest="version", help="Print version")
+    parser.add_option("-n", "--nosplashscreen", action="store_true", default=False, help="No splash screen")
+    parser.add_option("-p", "--project", action="store", default="", dest="project", help="Project file")
+    parser.add_option("-o", "--observation", action="store", default="", dest="observation", help="Observation id")
+    parser.add_option("-i", "--ipc", action="store_true", default="", dest="ipc", help="MPV IPC mode")
+
+    parser.add_option(
+        "-f",
+        "--no-first-launch-dialog",
+        action="store_true",
+        default=False,
+        dest="no_first_launch_dialog",
+        help="No first launch dialog (for new version automatic check)",
+    )
+
+    return parser.parse_args()

boris/coding_pad.py

@@ -0,0 +1,280 @@
+"""
+BORIS
+Behavioral Observation Research Interactive Software
+Copyright 2012-2025 Olivier Friard
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+  MA 02110-1301, USA.
+"""
+
+from PySide6.QtCore import Qt, Signal, QEvent, QRect
+from PySide6.QtGui import QFont
+from PySide6.QtWidgets import QWidget, QPushButton, QHBoxLayout, QGridLayout, QComboBox, QMessageBox
+
+from . import config as cfg
+from . import utilities as util
+
+
+class Button(QWidget):
+    def __init__(self, parent=None):
+        super(Button, self).__init__(parent)
+        self.pushButton = QPushButton()
+        self.pushButton.setFocusPolicy(Qt.NoFocus)
+        layout = QHBoxLayout()
+        layout.addWidget(self.pushButton)
+        self.setLayout(layout)
+
+
+class CodingPad(QWidget):
+    clickSignal = Signal(str)
+    sendEventSignal = Signal(QEvent)
+    close_signal = Signal(QRect, dict)
+
+    def __init__(self, pj: dict, filtered_behaviors, parent=None):
+        super().__init__(parent)
+        self.pj: dict = pj
+        self.filtered_behaviors = filtered_behaviors
+
+        self.behavioral_category_colors_list: list = []
+        self.behavior_colors_list: list = []
+
+        self.behavioral_category_colors: dict = {}
+        self.behavior_colors: dict = {}
+
+        self.preferences: dict = {"button font size": 20, "button color": cfg.BEHAVIOR_CATEGORY}
+
+        self.button_css: str = "min-width: 50px; min-height:50px; font-weight: bold; max-height:5000px; max-width: 5000px;"
+
+        self.setWindowTitle("Coding pad")
+
+        self.grid = QGridLayout(self)
+
+        self.installEventFilter(self)
+
+    def config(self):
+        """
+        Configure the coding pad
+        """
+        if self.cb_config.currentIndex() == 1:  # increase text size
+            self.preferences["button font size"] += 4
+        if self.cb_config.currentIndex() == 2:  # decrease text size
+            self.preferences["button font size"] -= 4
+        if self.cb_config.currentIndex() == 3:
+            self.preferences["button color"] = cfg.BEHAVIOR_CATEGORY
+        if self.cb_config.currentIndex() == 4:
+            self.preferences["button color"] = "behavior"
+        if self.cb_config.currentIndex() == 5:
+            self.preferences["button color"] = "no color"
+
+        self.cb_config.setCurrentIndex(0)
+        self.button_configuration()
+
+    def compose(self):
+        """
+        Add buttons to coding pad
+        """
+        for i in reversed(range(self.grid.count())):
+            if self.grid.itemAt(i).widget() is not None:
+                self.grid.itemAt(i).widget().setParent(None)
+
+        # combobox for coding pad configuration
+        vlayout = QHBoxLayout()
+        self.cb_config = QComboBox()
+        self.cb_config.setFocusPolicy(Qt.NoFocus)
+        self.cb_config.addItems(
+            [
+                "Choose an option to configure",
+                "Increase button text size",
+                "Decrease button text size",
+                "Color button by behavioral category",
+                "Color button by behavior",
+                "No color",
+            ]
+        )
+        self.cb_config.currentIndexChanged.connect(self.config)
+        vlayout.addWidget(self.cb_config)
+        self.grid.addLayout(vlayout, 0, 1, 1, 1)
+
+        self.all_behaviors = [self.pj[cfg.ETHOGRAM][x][cfg.BEHAVIOR_CODE] for x in util.sorted_keys(self.pj[cfg.ETHOGRAM])]
+
+        # behavioral category colors
+        self.unique_behavioral_categories = sorted(
+            set([self.pj[cfg.ETHOGRAM][x].get(cfg.BEHAVIOR_CATEGORY, "") for x in self.pj[cfg.ETHOGRAM]])
+        )
+        for idx, category in enumerate(self.unique_behavioral_categories):
+            self.behavioral_category_colors[category] = self.behavioral_category_colors_list[
+                idx % len(self.behavioral_category_colors_list)
+            ]
+
+        # sorted list of unique behavior categories
+        behaviorsList = [
+            [self.pj[cfg.ETHOGRAM][x][cfg.BEHAVIOR_CATEGORY], self.pj[cfg.ETHOGRAM][x][cfg.BEHAVIOR_CODE]]
+            for x in util.sorted_keys(self.pj[cfg.ETHOGRAM])
+            if cfg.BEHAVIOR_CATEGORY in self.pj[cfg.ETHOGRAM][x] and self.pj[cfg.ETHOGRAM][x][cfg.BEHAVIOR_CODE] in self.filtered_behaviors
+        ]
+
+        # square grid dimension
+        dim = int(len(behaviorsList) ** 0.5 + 0.999)
+
+        c = 0
+        for i in range(1, dim + 1):
+            for j in range(1, dim + 1):
+                if c >= len(behaviorsList):
+                    break
+                self.addWidget(behaviorsList[c][1], i, j)
+                c += 1
+
+        self.button_configuration()
+
+    def addWidget(self, behavior_code: str, i: int, j: int) -> None:
+        self.grid.addWidget(Button(), i, j)
+        index = self.grid.count() - 1
+        widget = self.grid.itemAt(index).widget()
+
+        if widget is not None:
+            widget.pushButton.setText(behavior_code)
+            widget.pushButton.clicked.connect(lambda: self.click(behavior_code))
+
+    def button_configuration(self):
+        """
+        configure the font and color of buttons
+        """
+
+        state_behaviors_list = util.state_behavior_codes(self.pj[cfg.ETHOGRAM])
+
+        for index in range(self.grid.count()):
+            if self.grid.itemAt(index).widget() is None:
+                continue
+            behavior_code = self.grid.itemAt(index).widget().pushButton.text()
+
+            if self.preferences["button color"] == cfg.BEHAVIOR_CATEGORY:
+                behav_cat = [
+                    self.pj[cfg.ETHOGRAM][x][cfg.BEHAVIOR_CATEGORY]
+                    for x in self.pj[cfg.ETHOGRAM]
+                    if self.pj[cfg.ETHOGRAM][x][cfg.BEHAVIOR_CODE] == behavior_code
+                ][0]
+                if cfg.BEHAVIORAL_CATEGORIES_CONF in self.pj:
+                    behav_cat_color = util.behav_category_user_color(self.pj[cfg.BEHAVIORAL_CATEGORIES_CONF], behav_cat)
+                else:
+                    behav_cat_color = None
+                if behav_cat_color is None:
+                    color = self.behavioral_category_colors[behav_cat]
+                else:
+                    color = behav_cat_color
+
+            if self.preferences["button color"] == "behavior":
+                # behavioral categories are not defined
+                behavior_position = int(
+                    [x for x in util.sorted_keys(self.pj[cfg.ETHOGRAM]) if self.pj[cfg.ETHOGRAM][x][cfg.BEHAVIOR_CODE] == behavior_code][0]
+                )
+
+                # behavior button color
+                behav_color = util.behavior_user_color(self.pj[cfg.ETHOGRAM], behavior_code)
+
+                if behav_color is not None:
+                    color = behav_color
+                else:
+                    color = self.behavior_colors_list[behavior_position % len(self.behavior_colors_list)].replace("tab:", "")
+
+            if self.preferences["button color"] == "no color":
+                color = ""
+
+            # set checkable if state behavior
+            self.grid.itemAt(index).widget().pushButton.setCheckable(behavior_code in state_behaviors_list)
+            self.grid.itemAt(index).widget().pushButton.setStyleSheet(self.button_css + (f"background-color: {color};" if color else ""))
+            font = QFont("Arial", self.preferences["button font size"])
+            self.grid.itemAt(index).widget().pushButton.setFont(font)
+
+    def resizeEvent(self, event):
+        """
+        Resize event
+        button are redesigned with new font size
+        """
+        self.button_configuration()
+
+    def click(self, behavior_code: str) -> None:
+        """
+        Button clicked
+        """
+        self.clickSignal.emit(behavior_code)
+
+    def eventFilter(self, receiver, event) -> bool:
+        """
+        send event (if keypress) to main window
+        """
+        if event.type() == QEvent.KeyPress:
+            self.sendEventSignal.emit(event)
+            return True
+        else:
+            return False
+
+    def closeEvent(self, event) -> None:
+        """
+        send event for widget geometry memory
+        """
+        self.close_signal.emit(self.geometry(), self.preferences)
+
+
+def show_coding_pad(self):
+    """
+    show coding pad window
+    """
+    if self.playerType in cfg.VIEWERS:
+        QMessageBox.warning(self, cfg.programName, "The coding pad is not available in <b>VIEW</b> mode")
+        return
+
+    if hasattr(self, "codingpad"):
+        self.codingpad.filtered_behaviors = [self.twEthogram.item(i, 1).text() for i in range(self.twEthogram.rowCount())]
+        if not self.codingpad.filtered_behaviors:
+            QMessageBox.warning(self, cfg.programName, "No behaviors to show!")
+            return
+        self.codingpad.show()
+
+        # update colors
+        self.codingpad.behavior_colors_list = self.plot_colors
+        self.codingpad.behavioral_category_colors_list = self.behav_category_colors
+
+    else:  # coding pad does not exist
+        filtered_behaviors = [self.twEthogram.item(i, 1).text() for i in range(self.twEthogram.rowCount())]
+        if not filtered_behaviors:
+            QMessageBox.warning(self, cfg.programName, "No behaviors to show!")
+            return
+        self.codingpad = CodingPad(self.pj, filtered_behaviors)
+
+        self.codingpad.behavior_colors_list = self.plot_colors
+        self.codingpad.behavioral_category_colors_list = self.behav_category_colors
+
+        self.codingpad.compose()
+
+        self.codingpad.setWindowFlags(Qt.WindowStaysOnTopHint)
+        self.codingpad.sendEventSignal.connect(self.signal_from_widget)
+
+        self.codingpad.clickSignal.connect(self.click_signal_from_coding_pad)
+        self.codingpad.close_signal.connect(self.close_signal_from_coding_pad)
+        self.codingpad.show()
+
+        if self.config_param.get(cfg.CODING_PAD_GEOMETRY, None):
+            self.codingpad.setGeometry(
+                self.config_param[cfg.CODING_PAD_GEOMETRY].x(),
+                self.config_param[cfg.CODING_PAD_GEOMETRY].y(),
+                self.config_param[cfg.CODING_PAD_GEOMETRY].width(),
+                self.config_param[cfg.CODING_PAD_GEOMETRY].height(),
+            )
+        else:
+            self.codingpad.setGeometry(100, 100, 660, 500)
+
+        if self.config_param.get(cfg.CODING_PAD_CONFIG, {}):
+            self.codingpad.preferences = self.config_param[cfg.CODING_PAD_CONFIG]
+            self.codingpad.button_configuration()