# Reports and Dashboards
Beside the table listing and download option generally available in the StudyBuilder application the system also support NeoDash reports and dashboards.
# Open NeoDash
To open NeoDash reports:
- Click on the Reports button placed on the main StudyBuilder page
- The NeoDash login page should be displayed
- Select to use 'SSO' and then click the 'Sign in' button.
Note: Select the database in which the neodash report is stored. Typically the mdr and not neo4j.
- If requested to select a browser account, select your Microsoft identity account you use for the application.
- The NeoDash report should open
Note: The URL to access the NeoDash report will follow this pattern, where text in '[ ]' is optional and italic text is replaced by environment specific values: [open]studybuilder[.environment].domain/neodash/
# Select Neodash report
In the lower left corner of the neodash window you will find the Expand and Collapse
icons for the left side navigation panel. Upon expanding the navigation panel, available neodash reports can be opened and reviewed.
In the following sections the current neodash reports are briefly described, and first tab of each report holds a short ReadMe instruction as well.
# Activity Library Dashboard
Additionally to the Application, a Neo4j Dashboard is available to browse and understand biomedical concepts which are the activities in the StudyBuilder.
Within the StudyBuilder application, you can define and see the activities in the "Library" -> "Concepts" -> "Activities" part.
The activities are managed in groups and subgroups. Whereas the "Activity" can be viewed as an "umbrella" that defines all general attributes, the "ActivityInstance" is the detailed specification of the logical observation. This includes reference to context and qualifier values. For example, the ActivityInstance includes references to ADaM BDS PARAM/PARAMCD or column name in ADSL, it also includes internal unique identification as well as internal topic code. This detailed specification will enable unique identification of source data, representation in SDTM by several qualifiers, and representation in ADaM BDS by PARAMCD value.
# Activity Dashboard
The activity dashboard is an option to view the activities from a different perspective. Especially when working with biomedical concepts from the StudyBuilder and others like the CDISC CoSMOS, it might be valuable to have a database closer access as the dashboard provides. When you have access to the StudyBuilder environment, see guide on how to open NeoDash in previous section.
The dashboard is organized in different tabs supporting different purposes.
ReadMe This tab provides a quick overview of the numbers of Activities and ActivityInstances.
Search top-down/bottom-up These two tabs are designed to navigate the "Activity Lib" either via a top-down or bottom-up search.
Activity to SDTM Then there is the option to view how Activities relates to SDTM using a specific implementation guide.
Activity in COSMOS format As the CDISC collaboration with the CoSMOS initiative is very important, there is also a mapping of activities in the StudyBuilder to the CDISC CoSMOS format.
Activities used in studies An overview of the activity usage in studies. It shows which activities being used in a study by visit.This view is preliminary and will be expanded with more study details.
Search Activity Instance This is a page for searching directly from ActivityInstance level.
Basic dashboard features In the panels there are options to expand/maximise and to refresh
# Introduction / ReadMe
The first dashboard page gives an overview of activities, their grouping and the types including counting statistics.
The first graphic (A) shows the "Groupings of Activities" as a circle-packing, which shows the available types and sub-types. To drill-down click on one of the circles. To get back click on the refresh icon in the top-right corner of the panel.
Next to this, there are the numbers of activities and instances (B). An instance is the specific definition of an observation which is used in studies. The table for "Number of Activities and Instances by group and subgroup" (C) can be used to get an overview of the groups and subgroups whereas the table "Number of Activities and Instances by type and subtype" shows the overview with type and sub type (D).
# Activity Lib (search top-down)
The second tab allows you to look at activities from the top-down perspective. You can browse the class and sub-class followed by the group and subgroup.
The description section in the top of the page provides a short guide to the selection panel below. Start typing from the left-most panel and move toward the right side.
In the selection area (A) a class is provided (fx Findings, Events, Interventions) to narrow down the list of Activities. Then the sub-class is provided (fx Numeric Finding, Categoric Finding etc), group and finally sub-group.
Note: specifying a sub-group will display all the individual activities in the histogram as individual bars. The hight of the bar indicates the number of instances for the activity.
The "Number of activities" histogram (B) updates with the concrete numbers when you filter the activities.
Depending on your selection in filter (A), the "List of activities" (C) lists the activities matching your filter. When clicking one concrete activity, the details of this activity are displayed (D).
We can see that the PULSE RATE
has an associated domain, a test_name_code which consists of a code and a name, a unit_dimension and a standard_unit.
Below we can see the representation of that activity as in the graph database in the logical view or physical view (E). The complex model enables us to link all information. The following screenshot shows the logical view for PULSE RATE
.
The last part displays information about concrete activities instances. There is the selection part (F) and the display as logical view part (G).
When we select for example ALBUMIN
as activity, it could have three different instances depending on the purpose of activity collection.
There is an instance for "Albumin Urine", where the specimen is "Urine", the second instance is for the specimen "Serum" and the third one is collected differently with the purpose for "AE Requiring Additional Data".
# Activity Lib (search bottom-up)
The search bottom-up tab enables you to search for one or more activities in the search field (A) and get an overview of the groups (B) and sub-groups (C) the selected activities belong to. In (D) you can select the activity belonging to the group and sub-group of interest and have its details displayed in (E).
# Activity to SDTM
The "Activity to SDTM" tab provides a detailed view of how activities are linked to specific SDTM items within a particular implementation guide. This feature allows you to visualize the relationship between activities and SDTM items, enhancing your understanding of the data structure.
The dashboard has a 1000 row limitation to display, so to limit the number of activity instances, you can select the activity sub-group and the corresponding activity instance belonging to the selected sub-group are listed in (A). Given that SDTM standards evolve over time, item definitions and structures may change. Therefore, you have the option to select a specific implementation version (B). Once selected, the mapping as defined in the implementation guide is displayed (C). Please note that for some activities, the mapping may not yet be available in the database. In such cases, the mapping will not be displayed until it is added.
# Activity in COSMoS format
In an effort to standardize and streamline the representation of Biomedical Concepts, CDISC initiated the Conceptual and Operational Standards Metadata Services (COSMoS) project in 2022. More details about this project can be found on their homepage. As part of this initiative, CDISC has adopted the YAML format for displaying biomedical concepts.
Our dashboard has been designed to align with this standard. It can map the activities defined in StudyBuilder into a valid COSMoS format, ensuring compatibility and interoperability with other systems that adhere to the same standard.
The following section presents an example of how the activity instance "TEMPERATURE" is represented in the COSMoS format.
category:
- Vital Signs
dataElementConcepts:
- dataType: string
conceptId: C44276
exampleSet:
- TEMPERATURE
shortName: unit_dimension
href: https://ncithesaurus.nci.nih.gov/ncitbrowser/ConceptReport.jsp?dictionary=NCI_Thesaurus&ns=ncit&code=C44276
- dataType: string
conceptId: C82587
exampleSet:
- C
shortName: standard_unit
href: https://ncithesaurus.nci.nih.gov/ncitbrowser/ConceptReport.jsp?dictionary=NCI_Thesaurus&ns=ncit&code=C82587
- dataType: string
conceptId: C25341
exampleSet:
- SKIN
shortName: location
href: https://ncithesaurus.nci.nih.gov/ncitbrowser/ConceptReport.jsp?dictionary=NCI_Thesaurus&ns=ncit&code=C25341
packageType: bc
definition: A measurement of the temperature of the body.
synonym:
- TEMP
- Temperature
resultScale:
- Quantitative
conceptId: C174446
domain: VS
parentConceptId: C25206
shortName: Body Temperature
href: https://ncithesaurus.nci.nih.gov/ncitbrowser/ConceptReport.jsp?dictionary=NCI_Thesaurus&ns=ncit&code=C174446
packageDate: 2023-04-30
Note: As the report is accessing NCI terminology via API it may run for bit before the yaml structure is displayed.
# Activities used in Studies
This provides a view of where specific activities are utilized across different studies. This feature allows you to track the usage of activities.
In the selection box (A), you can choose one or more activities. Upon selection, the dashboard dynamically displays the studies in which these activities are used (B).
# Search Activity Instance
This view provides a quick way to display details of one or more activity instances without having to specify the activity.
# Audit Trail Report
The Audit Trail Report can be used to browse the audit trail information from the database. The StudyBuilder system is based on a linked graph database, and the audit trail system is an integrated part of how the versioning is supported, see more in Versioning and Audit Trail
The report have beside the ReadMe tab two main sections:
- Library Audit Trail for browsing history of changes across all library elements.
- In the library part you can filter and search by a specific user, start date and/or end date.
- In the library part you can filter and search by a specific user, start date and/or end date.
- Study Audit Trail for browsing history of changes across all study definitions.
- In the study part you can additionally select a study uid.
The audit trail report list:
- initial entry and changes (value before and after change was made).
- what was changed (field and data identifiers).
- by whom a change was made (user, role and organisation).
- when a change was made (time stamp including date).
- why a change was made (reason for change in a GCP compliant manner for library elements).
- Note, for study definitions reason for change is captured for a complete locked study and can be browsed under study versioning.
NOTE: The audit trail report is not a good tool for viewing changes to a specific component in the database. Here the History pages within the StudyBuilder pages will provide a better overview.
# Data Exchange Data Models
The Data Exchange Data Models report can be used to browse both CDISC defined data models, Sponsor extensions to CDISC data models as well as sponsor defined data exchange data models. This can be e.g. the CDISC SDTMIGs, sponsor extended SDTMIGs and e.g. file-based lab data exchange data MODELS.
Note: the data exchange data model dashboard is experimental and initial version, additions and improvements will come in next release.
Beside the ReadMe tab the report holds the following tabs:
- Catalogues Exploring overviews of data models in a graphical display.
- Models Select data model, version, and general domain class, browse variable classes and use in dataset classes.
- Implementation Guides - Excl. CDASH select implementation guide, version, and dataset, browse variables and extended sponsor model attributes.
- Sponsor Models select SDTM sponsor model version and dataset and browse extended variable attributes as well as selecting dataset classes and browsing extended variable class attributes.
- Implementation Guides - CDASH select CDASHIG, versions and datasets, browse variable attributes.
# Study Metadata Comparison
The Study Metadata Comparison report can be used to compare content between two specific studies, or between two versions of a study.
In addition to the ReadMe tab, the report includes a tab for study selection, followed by six sections, each displaying the differences within an area of the study specification.
On the Select studies tab you can:
- Select the option to only display differences, or all content of the two compares.
- You can filter on the projects to limit the study list (multi selection is enabled here).
- Then select the select the base study and version of the compare.
- Next select the study and version for the compare.
- The selected studies and version info is then displayed here as well as on the header card on each of the compare tabs.
The following six tabs display the compare result for:
- Study fields which provides comparison of simple study selections and values from study title, registry identifiers, study properties, study criteria.
- Objectives/Endpoints which compares objectives and the related endpoints
- Criteria which compares inclusion, exclusion, run-in, randomisation, dosing and withdrawal criteria.
- Planned visits which compares visits and the individual visits details.
- Collections which compares the planned activities the 'X's in the in the schedule of activity (SoA).
- Activities which compares the selected activities for the SoA and how they are organised within the SoA.
# Select studies
you can
- select to show differences only or not (Yes/No). Default is set to Yes.
- Limit the list of studies by selecting one or more projects.
- Select the Base study
- Select the Compare study
- View the selection. This panel will repeated in the other tabs.
# Study fields
On the Study fields tab, the list of differences in various study fields are displayed.
If you choose 'Differences Only' as 'No' on the Select studies tab then also similarities are displayed
To filter on a specific study filed, you can filter on the Study Field column
# Objectives/Endpoints
On the Objectivate/endpoint tab, the differences in Objectives and endpoints are listed
To show similarities, you need to select 'Differences Only' as 'No' on the Select studies tab.
# Criteria
On the Criteria tab, the differences in Inclusion and Exclusion criteria are listed
To show similarities, you need to select 'Differences Only' as 'No' on the Select studies tab.
# Planned visits
On the planned visits you can se differences in visits.
To allow for the timeline view to display, you need to select a date in the Planned Study Start Date.
The timeline will display both differences and similarities. Click on the purple bar to see visit details
To filter on a particular Visit Property Type, you can use the filter
To show similarities, you need to select 'Differences Only' as 'No' on the Select studies tab.
# Collections
On the Collections tab you can see the differences in planned collections, i.e. the 'X's in the flowchart
Note This report isn't controlled by the 'Differences Only' selection on the Select studies tab. Is will show Added, Deleted and No change
# Activities
On the Activities tab you can see the differences in planned activities and if they have been moved in flowchart hierarchy.
Note This report isn't controlled by the 'Differences Only' selection on the Select studies tab. Is will show Activity added, Activity deleted, Activity moved and No change
# Syntax Template Dashboard
The Syntax Template Dashboard report can be used to browse all syntax templates by template parameters, parameter values, library, filtering by type and sub type as well as see study usage. Beside the ReadMe tab the report holds the following tabs:
- Select Template Parameter Value tab enable browsing and selection of template parameters and their values.
- Parent Templates tab list all Parent Templates. Note this include user defined templates (can be filtered by library), and list is filtered based on Template Parameter selection on first tab.
- Pre-instance Templates tab list all Pre-instantiations of Parent Templates. These are to support study search and selections but will never be related to a study.
- All Templates tab is a union display of both parent templates and pre-instance templates.
- Template Instantiations tab list all instantiations in latest version.
- Study Usage tab list instantiations with reference to study usage.
- Templates by Library gives a summary overview on number of templates by type and library (being sponsor standards or user defined).
# Select Template Parameter Value
On this tab you can list and search in all available template parameters as well as all available template parameter values. The search can be by one of the columns in each table, or by selecting specific Template Parameters or Template Parameter Values from the two top report panels.
In this example the 'day' and 'days' is selected as template parameter values, the template parameters holding one of these are listed in the left report panel.
Note, the selections of Template Parameters or Template Parameter Values from the two top report panels will be applied on all following tabs.
# Parent Templates
On this tab you can search in all parent syntax templates of any type in any library. The display is filtered to parent syntax templates that refer to currently selected template parameters listed in the top report panel.
In this example the 'Activity' template parameter value is selected and the listing shows 3 syntax templates referring to the Activity parameter, each of different type and in different libraries.
Note, A user defined syntax template is technically also a parent template and will show up on the list. These can be removed by additional filtering on the library.
# Pre-instance Templates
On this tab you can search in all pre-instance syntax templates of any type in any library. The display is filtered to pre-instance syntax templates that refer to currently selected template parameters and values listed in the top report panel.
In this example the 'ActivityInstance' template parameter value is selected and the listing shows 1 syntax templates referring to the ActivityInstance parameter.
Note, A pre-instance syntax template is made only to support selection of syntax templates with pre-selected values for template parameters.
# All Templates
On this tab you can do a joined search in all parent and pre-instance syntax templates of any type in any library. The display is filtered to syntax templates that refer to currently selected template parameters and values listed in the top report panel.
In this example both the 'Activity' and 'ActivityInstance' template parameter value is selected and the listing shows a number of syntax templates referring to these two parameters.
# Template Instantiations
On this tab you can search instantiations of syntax templates of any type in any library, i.e. a syntax template actually being used on a study. The display is filtered to syntax templates that refer to currently selected template parameters and values listed in the top report panel.
In this example both the 'Activity' and 'ActivityInstance' template parameter value is selected and the listing shows a number of syntax template instantiations referring to these two parameters.
Note, the list of template instantiations includes instantiations of user defined templates including their template parameter values. These can be removed by additional filtering on the library. Note, next tab list details on the studies using these template instantiations.
# Study Usage
On this tab you can search study usage of syntax templates of any type in any library. The display is filtered to syntax templates that refer to currently selected template parameters and values listed in the top report panel.
In this example both the 'Activity' and 'ActivityInstance' template parameter value is selected and the listing shows the studies using syntax templates referring to these two parameters.
Note, the list of template instantiations includes instantiations of user defined templates including their template parameter values. These can be removed by additional filtering on the library. Note, previous tab list more details for these template instantiations.
# Templates by Library
On this tab you get an overview of all syntax templates in the system, grouped by type and library. You can change the layout of the bar chart by field selections below the chart.
In this example each bar represent a template type with colour coding by library