Safety Histogram

Overview

Safety Histogram is a JavaScript library built with Webcharts (1, 2) that creates an interactive histogram plotting the distribution of lab measures, vital signs, and other measures related to safety in clinical trials. A typical chart created with safety-histogram looks like this:

By default the chart expects SDTM-structured data, but can be configured for any dataset with one record per measurement. View full chart configuration details here.

Users can view a histogram of each measure in the data, update the x-axis limits, toggle display of the normal range, and click the chart to view the raw data. View full chart functionality here.

Typical Usage

In the simplest case, the chart can be created with a single line of code provided the input dataset meets the default requirements:

    safetyHistogram().init(data);

Alternatively, the chart can be configured for a different data standard, such as for ADaM in the example below:

    const element = 'body'; // element in which to draw the chart
    const settings = {
        measure_col: 'PARAM',
        value_col: 'AVAL',
        id_col: 'USUBJID',
        normal_col_low: 'ANRLO',
        normal_col_high: 'ANRHI',
        filters: [
            {value_col: 'SEX'    , label: 'Sex'},
            {value_col: 'RACE'   , label: 'Race'},
            {value_col: 'ARM'    , label: 'Arm'},
            {value_col: 'AVISIT' , label: 'Visit'},
            {value_col: 'SITE'   , label: 'Site'},
        ],
    }; // custom chart settings
 
    d3.csv(
        'https://raw.githubusercontent.com/RhoInc/data-library/master/data/clinical-trials/adam/advs.csv', // data file location
        function(data) {
            safetyHistogram(element, settings).init(data);
        } // callback function in which the chart is created
    );

Click here to open an interactive example.

Links

• Interactive Example
• Wiki
• API
• Configuration
• Data Guidelines
• Technical Documentation