adepro Package Manual

Nicole Mentenich, Jens Hooge, Christoph Tasto, Bastian Becker


AdEPro (Animation of Adverse Event Profiles) is a Shiny application for the (audio-)visualization of adverse events during clinical trials. Typically, Shiny applications are hosted on a dedicated Shiny server, but due to the sensitivity of patient data in clinical trials, which are protected by informed consents, the upload of this data to an external server is prohibited. Therefore we provide our tool as a stand-alone application that can be launched from any local machine on which the data is stored. In order to work with this application simply call the function launch_adepro().


The database in a clinical trial contains vast information on adverse events, involving hundreds of different adverse event terms with varying severity grades and different start and end dates. Despite this plethora of information, insight into the adverse events in a clinical study is usually limited to simple summary tables of absolute and relative numbers of adverse event occurrences. AdEPro, an innovation of Bayer’s Biostatistics Innovation Center, is an unparalleled approach to audio-visualize the safety profile of both the individual patient and of the entire study cohort, which enables every study team member to experience the study and emphasize with the patients. The AdEPro Shiny app depicts the temporal progress of all adverse events in every study subject and enables the user to give profound answers to complex questions surrounding adverse events such as the frequency, duration and correlation of adverse events of interest. The incorporated sound components stresses changes in the adverse event profile of the study.


Upload your adverse event data and patient data in the Upload data panel. For more information on the required data structure see Input data.

In the Modify data panel, you can select a certain category of adverse events (such as serious or study drug-related) by clicking on the Type of Adverse Event option. Moreover, the patients can be sorted by other variables than the randomization number (default) such as the patients’ overall adverse event frequency or other input variables additonally included in the input patient data set.

Every subject in the safety analysis set is represented by a dark grey circle containing differently colored slices. Each of these slices represents a different adverse event. Only eight different adverse events can be shown at the same time to keep an easy overview. The size of the slices indicates the intensity of the respective adverse event. To choose other adverse events than the eight most frequent ones, the drop-down menu Adverse Events for Animation and the option Choose Adverse Events for display can be used.

Apart from the functionality to select other adverse events for display, the Adverse Events for Animation panel also offers the opportunity to follow the progress of one specific adverse event via an audio component. For this, an adverse event can be chosen with the Choose Adverse Events for audio option. Furthermore, it can be decided for which treatment group a sound should be heard with the option Choose Treatment Group for first sound. In order to be able to compare the sound profile with another group, a second treatment group can be selected with the option Choose Treatment Group for second sound. The sound you will hear represents a categorized and normalized frequency grade of the chosen adverse event given the size of the treatment group and the overall frequency of this adverse event. Four different sounds exist, the lowest meaning that no such adverse event has occurred in the selected group and the other three symbolizing equidistant increases in frequency the higher the sound gets. If you selected a treatment group for the first sound and for the second sound, two such sounds will be played after one another so that they can be compared directly. You will only be able to hear a sound if there is a change in the frequency grading in any of the treatment groups of the study. The audio component can be switched off completely by choosing - none - in both cases (default).

The slider in the top bar of the app allows to view another day of the study. It can either be moved day by day or played automatically by clicking the blue “Play” button.

Input Data

AdEPro provides the option to upload your data in comma separated files by means of the Upload Data panel: First, a data set containing information on adverse events (study day of start and end of an adverse event, etc.) is needed where each row represents a different adverse event occurrence for each subject. Secondly, a data set with the subject information (subject ID, treatment allocation etc.) should be uploaded where each line represents one subject. If the subject IDs of these two data sets do not match, there will be an error.

The first data set containing the adverse event information should have the following variables (in this order):

If the adverse events should be classified into certain categories mentioned below, further optional columns with dummy variables (1=yes, 0=no) can be attached to the data set:

The second data set with the subject information should contain the following variables (in this order):

Additional information

Please make sure to use a monitor or beamer in Full HD quality and a platform with an audio player in order to make best use of AdEPro.