Configuration

Chart Settings

Overview Chart - Custom Data Mappings

Several custom settings that are not available in the base Webcharts library have been added to the Test Results Over Time chart to facilitate data mapping. Default values are provided to map data from the AdAM Adverse Event data standard to the Webcharts configuration object. The defaults can be overwritten to use other data standards by the user when initializing a chart.

Settings Variable	Variable	Description	Default	Required?
id_col	Participant ID	Unique participant identifier	USUBJID	Y
time_col	Measure Timing	Timing of collection	VISITN	Y
measure_col	Measure	Name of measure	TEST	Y
value_col	Value	Value of measure	STRESN	Y
unit_col	Unit	Unit of measure	STRESU	Y
normal_col_low	Normal Range - Low	Lower limit of expected measure normal values	STRNLO
normal_col_high	Normal Range - High	Upper limit of expected measure normal values	STRNHI
sex_col	Sex	Participant sex	SEX	Y
race_col	Race	Participant race	RACE	Y

#Custom appearance Settings Two additional custom settings, not used for data mapping, are included in this library.

Parameter	Default	Details
start_value	null	Specifies a value of settings.measure_col to be displayed when the chart is loaded
rotateX	true
missingValues	["NA",""]	An array of values (found in settings.value_col) to be ignored when rendering the histogram
boxplots	true
violins	false

Overview Chart - Webcharts Settings

The following Webcharts settings are provided by default, but can be overwritten by the user when initializing the chart. Additional documentation for each setting is available in the Webcharts wiki

Parameter	Default	Details
x.label	null
x.type	'linear'
x.column	'wc_value'	wc_value is created in the 'init' callback using the lengthenRaw() utility function
y.label	null
y.sort	'earliest'
y.type	'ordinal'
y.column	See details	Synced to current value of settings.id_col
y.behavior	'flex'
margin	{"top":50}
legend.mark	"circle"
legend.label	"severity"
marks[0].type	"line"	There are 2 sets of marks for each AE: a line (showing duration) and circles (showing start and stop date)
marks[0].per	See details	Synced to the current values of [settings.id_col, settings.seq_col] to give one line per unique AE
marks[0].attributes	{ 'stroke-width': 5, 'stroke-opacity': .8 }
marks[0].tooltip	'System Organ Class: settings.soc_col\nPreferred Term: settings.term_col\nStart Day: settings.stdy\nStop Day: settings.endy'	Tooltip uses synced settings values as shown
marks[1].type	"circle"
marks[1].per	See details	Synced to the current values of [settings.id_col, settings.seq_col,'wc_value'] to give one line per unique AE.
marks[1].tooltip	'System Organ Class: settings.soc_col\nPreferred Term: settings.term_col\nStart Day: settings.stdy\nStop Day: settings.endy'	Tooltip uses synced settings values as shown
color_by	See details	Synced to current values of settings.sev_col so that all marks are colored by AE severity
colors	['#66bd63', '#fdae61', '#d73027', '#6e016b']	[Red, Orange, Yellow, Green]
date_format	"%m/%d/%y"
resizable	true
max_width	1000
y_behavior	'flex'
gridlines	"y"
no_text_size	false
range_band	15

Overview Chart - Controls

Default controls. The filters are automatically populated using the custom data mappings defined above.

Control Type	Column/Setting	Control Object
Setting	y.sort	{label: "Sort Ptcpts", type: "dropdown", option: "y.sort", values: ["earliest", "alphabetical-descending"], require: true}
Filter	settings.sev_col	{label: "AEBODSYS", type: "subsetter"}
Filter	settings.id_col	{label: "Subject ID", type: "subsetter"}
Filter	settings.rel_col	{label: "Related to Treatment", type: "subsetter"}
Filter	settings.sev_col	{label: "Severity", type: "subsetter", multiple: true}

Details Chart - Settings

The timeline created in the details view is a standard webchart, with settings as follows.

Parameter	Default	Details
x.label	''
x.type	'linear'
x.column	'wc_value'
y.label	''
y.sort	'alphabetical-descending'
y.type	'ordinal'
y.column	See Details	Synced to current value of `settings.seq_col
marks[0].type	'line'
marks[0].per	See details	Synced to current value of [settings.seq_col]
marks[0].attributes	attributes:{'stroke-width': 5, 'stroke-opacity': .8 }
marks[1].type	'circle'
marks[1].per	See details	Synced to current value of [settings.seq_col, wc_value]
color_by	See details	Synced to current value of settings.sev_col
colors	['#66bd63', '#fdae61', '#d73027', '#6e016b']
legend.mark	'circle'
legend.label	'severity'
legend.date_format	'%d%b%Y:%X'
transitions	false
max_width	1000
gridlines	"y"
no_text_size	false
range_band	28