Circle Cardiovascular Imaging Inc.
1100, 800 5th Avenue SW
Calgary, AB, T2P 3T6
Telephone: 1 (403) 338-1870
Fax: 1 (403) 338-1895
©2020 CircleCardiovascular Imaging Inc.
The information contained herein is subject to change without notice. The only warranties for Circle products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be constructed as constituting an additional warranty. Circle shall not be liable for technical or editorial errors or omissions contained herein.
1 About report42
report42 is designed to facilitate documentation and reporting of cardiac images. Fields with import function and with calculation algorithms allow for a fast and easy transition from quantitative information such as volumetric and signal intensity data to a structured report. report42 is based on societal recommendations on structured reporting for cardiovascular imaging (Douglas et al., Journal of the American College of Cardiology 2009;53:76-90.) and can be integrated into patient information storage systems.
When linked with cvi42®, it automatically imports image analysis results and classifies them based on user-editable normal value sets. Standard phrases can be defined for preparing the report. A graphical interface allows for using mouse-clicks to verify regional function tissue pathology and grade stenoses. Results are automatically translated into a narrated findings summary, but includes a graphic presentation of the results.
2 Intended Use
report42 is a web browser-based networked software application intended to use for reporting the results of the cardiovascular MR or CT image analysis performed with a post processing software application or PACS (Picture Archive Communication System) and RIS (Radiology Information System). It can be used as a standalone reporting software application by manually entering necessary information.
report42 shall only be used to report the Cardiovascular Magnetic Resonance Image analysis or Computed Tomography analysis.
report42 is not a diagnostic software application.
Please note that the users of report42 shall review the contents for accuracy prior to releasing the report.
3 Working with report42
3.1 Open report42
In a desktop web browser:
report42 is a reporting tool base on web technologies and
works in a standard web browser.
- Open a web browser and navigate to the address of the report42 web server on your network.
- Type in name and password.
- report42 is a reporting tool base on web technologies and works in a standard web browser.
Configure the connection to report42
To access report42 from cvi42 you
have to configure Reporting in
Preferences → Reporting → Report server.
- Server type: select report42.
- Server URL: enter the web address for your report42 server, including port (default is 4280).
- Username and Password: These will be assigned to you by your administrator.
In the report module, click on the report42 tab
- To access report42 from cvi42 you have to configure Reporting in Preferences → Reporting → Report server.
- Configure the connection to report42
3.2 How to Display a Report
The functionality is based on the definition of users and roles.
3.2.1 View the worklist within cvi42
When opening a study in cvi42 you will be asked if you would like to create an instance in report42. If the instance has been created successfully, the report status will then be displayed in your patient list, if the attribute report42 has been selected. (Chapter Patient List).
3.2.2 View the worklist in report42
Go to the Report Module in cvi42 and click on the report42 tab. If an instance has been created the study can be selected from the work list. Clicking on the patient study opens the Report worksheet page.
3.2.3 How to push my report from cvi42 to report42
In the cvi42 modules, use the Add to Report button to automatically transfer the values to report42.
You are able to add images to your report by right-clicking in an image viewer and using the context menu's Add Frame to Report command.
3.2.4 Worklist Search
This Filter allows you to search for attributes such as Name, Study Description, Report Status and Visit.
126.96.36.199 Advanced Search
This Filter provides advanced search options that are
- Able to search for multiple search criteria including tags and custom defined measurements
- Able to match by searching text fields (contains, starts with, ends with, is exactly)
- Able to match by numeric data (less-than, less-than or equal-to, greater-than, greater-than or equal to, equal-to, or not equal to the specified value, or within a range of values)
- Able to save and retrieve defined search criteria for all or defined by the user
Any or All conditions may be matched by changing the Match term selection.
188.8.131.52 Bulk Export
An Export option allows for the export of single or multiple reports in CSV format for import into Excel or other table-oriented data aggregators. This option is available in the Advanced Search interface and exports all reports matching the current search criteria.
The default options produce standard-compliant CSV files. You can customize these options to better suit your analysis tool.
3.3 How to generate a report
- Review the report and make sure all relevant sections/analyses are present.
- If applicable, edit/update analysis sections as per the "how to" sections below.
Predefined text blocks are available for 2 sections:
- Findings *
- To add text, click on the relevant sections to enter editing mode.
- Select all relevant text blocks (see How to use Free-Form Findings/Summary and How to use Structured Findings below). The values will be automatically inserted as soon as you leave the editing mode.
- When you have finished editing, click Done.
- Changes are saved automatically.
- In the Export Options dialog you can choose a file format. Click OK when you are done.
- Go back to the top in the Report page and click the Export button to export a report immediately.
3.3.1 How to use Free-Form Findings/Summary
- To add text, click in the Free-Form Findings or Summary section.
From the dropdown menu, select relevant category.
- Click on the desired findings text and it will be displayed in both the text editing pane on the right-hand side, as well as the preview pane below.
- To edit or remove text, click in the editing pane and add/delete directly.
- Click Done when finished to return to View mode.
3.3.2 How to use Structured Findings
- To add text, click Edit All.
From the dropdown menu, select relevant category.
Check the desired finding(s) and, if applicable, specify any
- A comment can be added by clicking the speech bubble.
- Click Done when finished to return to View mode.
In View mode, flags indicate an undefined parameters.
Click and drag to reorder findings.
Add Comments – Free Text
3.3.3 How to use Z-Index Rulesets
Enable a Z-Value Report section.
When the patient matches z-score ruleset criteria, applicable rulesets
will be displayed. Select check box to enable and expand ruleset(s).
- For custom measurements, click in the Measurement field to assign one or more measurements. Custom measurements can be automatically imported from select modules in cvi42 via the Add to Report button.
Based on the selected measurements, report42 will then
calculate an input value for the z-score function according to the
rule set (i.e. min/max/average/mean).
- The Z-Value: The final Z-score is displayed in the Z-Value column.
Expected Z-Value: The expected Z-score is also displayed with “Z-Value”.
3.3.4 How to create a Tissue Diagram (CMR)
The purpose of the diagrams is to quickly visualize myocardial injury of the left ventricle as well as function.
184.108.40.206 Choose One of the Two Diagram Options
- Polarmaps using the AHA segmentation. Start by selecting a diagram type:
- Ischemic Heart Disease
- Non-Ischemic Heart Disease
- Legacy (Tissue Characteristics from report42 v2.0 and earlier)
This presentation allows the user to depict:
- Tissue Characteristics (left polarmap): Per segment as well as with their transmurality (50% or 100%)
- Segmental Function (right polarmap)
- You may also use report42-specific diagrams providing more detailed
information in multiple radial long axis and 3 short axis orientations.
Unlike the AHA segmentation where slices are displayed in an all-in-one polar map
view, the slices are displayed next to each other.
This presentation allows the user to depict:
- Tissue Characteristics (solid lined segments): Per segment as well as with their transmurality (50% or 100%)
- Segmental Function (dotted lines)
220.127.116.11 Ischemic vs. Non-Ischemic HD
This will determine applicable tissue characteristics
18.104.22.168 How to apply tissue qualities
- Start with the color/ tissue characteristics
- Click the affected segment, either endocardial, epicardial, or both layers
- To finish you can select Normal and apply to all by clicking the paintbrush
- Do the same for the Segmental Function
- The eraser will reset the diagram
- You will find the written findings in the Findings section
3.3.5 How to create an Axial Coronary Anatomy Diagram (CCT)
The purpose of the diagram is to quickly visualize quantitative stenosis grade and plaque type:
- Stenosis Grade: Represented by segmental fill colour.
- Stenosis Plaque: Represented by segmental outline colour.
22.214.171.124 How to apply Stenosis Grade and Plaque
- Select the color/stenosis grading
- Click the affected segments.
- Repeat for the plaque characteristics
- You will find the written findings in the Findings section
3.4 Edit Patient Data
Following data can now be edited (using click-to-edit) on the Report Page.
- Edit Patient demographics
- Edit Imaging Protocols and Sequences: The protocols define what analyses will be reported. Usually the software recognizes the protocol from the values that have been pushed over. You have the option to enter image quality and/or what contrast agent has been used in order to add it to the report.
- Edit exam-specific data like biometrical patient data and patient history
3.4.1 Add Referring Physicians
Add/edit a physician and/or address in the Edit Exam Section.
- Only the name, not the address will be printed on the report.
Addresses can only be changed or deleted in the
Referring Physician Admin area.
3.4.2 Edit Site Information
Site information can now be edited on the Report Page as well. User can upload logo and update site data on any report & the information will be updated site-wide.
3.5 Report Images
Within cvi42 you have the option to add images to your report via contex menu → add frame to report. Only these images show up in the report.
cvi42 polar maps will be automatically added to the Report Image section if polarmaps are enabled at the time the module data is added to the report.
- Editing of the images: title, order and deletion of images can now be done within the report page
- Images in the sidebar can be dragged into any section on the report page.
- Deleting an image from the report section will put it back in to the side bar imaging area. Deleting from sidebar will delete the image permanently from the report. Images in the side bar will not be printed in the HTML/PDF Reports, only the images present inside the report sections will be printed.
3.6 Export Report
3.6.1 Configure Export Options
Click the configuration button (gear icon) to set your Export Preferences:
The Export Options configuration dialog allows you to change the format of the report before saving, sending, or viewing a report:
- Paper format and orientation
- You can choose the number of images you would like to display in sequential columns.
You can include or exclude the LV tissue diagram as well as choose between
- combined LAX/SAX diagram or
- Polarmap diagram.
- You can include or exclude table values indexed by height or BSA.
- You can pick a color scheme (green, monochrome-light or monochrome).
For text reports, choose between different formatting styles:
- Layout: in formatted tables or plain (one line per report parameter).
- Character Width: for formatted tables, a maximum page width in characters can be selected.
- Field Padding: for formatted tables, empty space can be filled in with dots to prevent them from being collapsed by other reporting systems.
- Destination: on-screen or saved to a file.
3.6.2 Hide Report Fields
Individual fields of a report can be hidden by clicking on the Eye icon.
Select the drop down next to the eye icon
- Exam: allows to hide sections for the current report (Note that this is the only mode available to non-administrative users and will be used by default).
- Protocol: available to administrators, this mode will save the selection to the current protocol.
- Toggle the field-visibility switch to hide/show report fields. Fields highlighted in red will be hidden from the onscreen and printed/exported reports. Fields highlighted in green will be visible.
Click on the Eye icon again to return to report editing mode.
3.6.3 Export Format
The Export Options dialog allows you to set the report format to PDF, HTML or Text before saving or viewing a report.
You can also change the current export format quickly without returning to this dialog by using the arrow-menu next to the Export button on the report page.
3.7 Sending DICOM Reports to PACS
If one or more PACS destinations have been configured in report42, the Send to PACS button will be available. Furthermore, if the minimum report state required to send reports to PACS has been reached, the button will be enabled.
Clicking the Send to PACS button will transfer a DICOM copy of the report to the PACS specified with the arrow-menu:
The format options for a DICOM report are the same as for PDF or HTML reports.
3.8 How to Tag a Report
Every report page has a section for adding and removing new tags. Tags are short metadata descriptions of the qualities of a report that can assist in future searches, but do not print on the final report.
Tags could describe patient conditions, actions taken in the study, study status, ownership, or anything else that isn't directly searchable in a typical field. For example:
- needs review
- sent to referrer
Tags can be added to a study and created as you work by using the Plus icon in the Tags section.
Access to the Administrative section of report42 is limited by a user's Role and the corresponding Permissions.
report42 allows you to define multiple user and roles. You can Add a new user or Edit existing users.
Note: By default, report42 is configured to allow user and role management to take place entirely in cvi42 v5.5+. If cvi42 meets the minimum required version, you can do all of your user and role administration there. User details will automatically be synchronized to report42 when that user signs in, and their password will always be managed in cvi42.
It is possible to link older local report42 accounts to cvi42 so that all user management will take place in cvi42. It is also possible to have a mix of local report42-only users and users managed by cvi42.
The link icon indicates that a user is sourced and managed from cvi42.
Users sourced from cvi42 do not need to be added manually, they will appear in this list as they log in using their cvi42 credentials and will be granted the same roles.
A user is able to interact with the system in different ways, depending on what roles they are assigned. The following matrix shows which of the default roles can access which features and administrative sections:
|Permission/Role||Viewer||Technician||Analyst||Reporter||Data Administrator||User Administrator||System Administrator||PACS Administrator|
|View Not Read Exams
|Create Not Read Exams
|Edit Not Read Exams
|View In Progress Exams
|Create In Progress Exams
|Edit In Progress Exams
|View Preliminary Exams||•||•||•||•|
|Create Preliminary Exams||•||•|
|Edit Preliminary Exams||•||•|
|View Finalized Exams||•||•||•||•|
|Create Finalized Exams||•|
|Edit Finalized Exams||•|
|View Addendum Exams||•||•||•||•|
|Create Addendum Exams||•|
|Edit Addendum Exams||•|
|Create/Edit System Tag||•||•|
|Delete System Tag||•||•|
|Add/Remove System Tag to Study||•||•||•||•|
|Edit Role Tag||•||•||•||•||•||•|
|Admin Disease Clusters||•|
|Admin Site of Service||•||•|
|Admin Form List Options||•||•|
|Admin Study Descriptions||•||•|
|Admin Referring Physicians||•||•|
|Admin Patient History||•||•|
|Admin Normal Ranges||•||•|
|Admin Findings/Summary Text||•||•|
Add or customized existing Roles to suit the needs of a particular organization.
- In the Admin section Add a role.
- Provide a Role Name.
Select the Display on Exported Reports checkbox if this role
represents an organizational role within your centre, for example:
- Primary Reader
- Senior Reader
If you would like to keep the Role Name simple for administrative
purposes (such as matching with cvi42 roles) but would like a
more meaningful name to appear on exported reports:
- Select the Use a custom Role Name for Exported Reports checkbox.
- Enter that role name under Custom Role Name field.
- Select the Permissions that shall be associated with the role.
- When adding a user, select the role and thereby the set of permissions that you want to grant the user.
The system is able to operate in several languages. The language setting will take effect for every user of the system when they next log in.
Be aware that all content entered in the Report Content admin section is linked to the language in use when it was first created. If edits or additions are made and the language is subsequently changed, you will find your content missing.
4.1.4 Disease Clusters, Indications, and Protocols
Indication Driven Workflow was introduced in cvi42 version 5.6. For implementations using this workflow, the configuration of disease clusters, indications, protocols, and sequences is managed in cvi42, so report42 will display the following message:
For implementations not using the indication driven workflow, disease clusters, indications and protocols are managed in report42. report42 comes with a predefined disease, indication, and protocol hierarchy. To edit, go to their respective Admin sections.
126.96.36.199 Desease Clusters
Use the Desease Clusters section to view, add, or edit disease clusters.
Use the Indications section to view, add, or edit indications or
to assign them to a disease cluster.
Link an Indication to a Disease Cluster
After saving, use Ischemic HD checkboxes to select the
Indications indicating Ischemic Heart Disease
Protocols are used to define the structure of a report and are assigned to indications. Specifically, the protocol determines which report sections and sequences are used to address the respective indication.
Select the Protocols section
Click on Add Protocol or click the edit pencil next to an already
- Select the sections that should be displayed for that protocol
- Drag and drop the section into the preferred order
- Select the associated Sequences
4.1.5 PACS configuration
Here you may configure the DICOM PACS entities that report42 may send reports to, as well as the method of packaging reports as DICOM data.
AE Title: the Application Entity Title that report42
should use when communicating with a PACS.
- Note: Your PACS Administrator or PACS Vendor must configure your PACS to accept images from this AE-Title and the report42 server/host IP Address.
- Minimum State for DICOM Reporting: Allows you to restrict the state that a report must reach before being permitted to send report data to PACS (default: Finalized).
188.8.131.52 Adding and Editing PACS configuration
Use the Add New StoreSCU button to add a new PACS host to receive DICOM reports, or edit an existing host conifguration using the Pencil icon.
- Host Name: network host name or IP address of the PACS that will receive DICOM reports.
- AE Title: the Application Entity Title to target when sending data to this DICOM PACS node.
- Port: the TCP port that the PACS with this AE Title listens on.
- Description: a description of this PACS that the user will see when selecting from multiple PACS. This can be more descriptive than the AE Title or hostname, such as, "Clinical", "Research", "Radiology", "Cardiology", etc.
- Parameters: optional parameters suitable for DCMTK's storescu command. Only required for advanced tuning.
DICOM File Type: Choose the type of DICOM report that this
PACS will accept.
- A Secondary Image Capture Series is most commonly supported. The transfer syntax and resolution are configurable according to your PACS DICOM Conformance Statement. Exceeding 300dpi is not recommended due to higher rendering time and storage requirements.
- DICOM Encapsulated PDFs may be used if they are supported by your PACS and PACS Viewer. Generally this option yeilds the highest resolution and smallest data size, but is relatively rare.
- Test (C-ECHO): Sends a DICOM C-ECHO message to your PACS and displays the result. This is useful to confirm that the configuration is correct on the PACS and on this report42 instance.
Here you may search through the audit log for changes to the system and edits to report contents.
Here you may add and edit report tags for use by all users or by users having specific roles. Tags are short metadata descriptions of the qualities of a report that can assist in future searches, but do not print on the final report.
Tags could describe patient conditions, actions taken in the study, study status, ownership, or anything else that isn't directly searchable in a typical field.
Tags created for a user's personal use can only be edited by them in their user user profile page, accessible from the link (their full name) in the top-right of the report42 web page.
4.2 Report Content
4.2.1 Site of Service
The Site of Service information appears at the top of the first page of your report.
Here you can enter contact and accreditation information for your facility, as well as a logo. Logos can be quite large in terms of resolution (which will look sharper on printed reports), However you are advised to use a logo which is approximately square or roughly 2:3 (height:width) in dimension.
The Staff module allows you to define the list of people who operate your facility and participate in studies. These people can be added to a report in the Edit Exam page. Their names and all identifying information will appear on the exported reports. Staff are not necessarily users of report42 and are not granted access to the system. Refer to the Users module.
When editing staff, there are two options for the Type of Change:
- Updated Staff Profile: The old staff information (name, position, etc.) will be retained for existing reports, and this edited information will be used for old reports. This can be done many times, for example if a staff member changes their job title.
- Correction: Simply corrects the current record, for example if the staff person's name was misspelled.
4.2.3 Standard Form List Options
You are able to define parameter or options that offer different qualities: e.g. Image quality with a form list that offers the options good/moderate/bad.
These options will show up in the CMR Report page.
Sequences like T1 mapping sequence or First Pass Perfusion can be defined.
These sequences will be added to the list in the Edit Exam page and will be added quickly to a report header to make it more descriptive.
Note: An indication driven workflow was introduced in cvi42 version 5.6. For implementations using this workflow, the configuration of sequences is managed in cvi42; report42 will display the following message:
4.2.5 Study Descriptions
Newly defined study descriptions will be displayed in a drop down list in Edit → Exam and will be part of your report header. Study descriptions will also be entered automatically when report data is transferred from cvi42.
4.2.6 Referring Physician
You can create a list of referring physicians. Each referring physician can have multiple addresses to which a report might be returned.
They will be displayed in a checklist in Edit → Exam and if selected, will show up in the report header. Addresses will not be printed in report headers, they are there as a convenience for addressing returned reports.
Referring Physician names will also be entered automatically when transferred from cvi42.
4.2.7 Patient History
This allows to define canned text, that will be displayed in list format for selection in Edit → Exam.
4.2.8 Normal ranges
184.108.40.206 Export / Import Normal Ranges
To facilitate inter-center collaboration, administrators can import or export all/selected normal ranges in a readable PDF report or transferable JSON data format.
220.127.116.11 Editing Normal Ranges
Definition requires the following input:
- Field Value Exact Match: Allows you to set normal value text results for precise values. Recommended for Report Fields that provide exact, round numbers.
- Field Value Range Lookup: Allows you to set normal value text results for bounded ranges of values.
- Insert Field Value: Allows you to copy a report field's name into either another field or more commonly a piece of Findings or Summary Text that you will create later.
- Report Field Name: select the source field to use as the basis for the normal range.
- Target Report Field Name: for normal value rules intended to update form fields in report tables, as opposed to simply being used in Findings or Summary text, select the target report field here.
Citations can be:
- After creating a Field Value Range or Exact Value Lookup variable, you can start adding match rules.
18.104.22.168 Adding / Editing Normal Range Rules
To add a normal range rule, click the Plus button. To edit normal ranges, just start typing.
The normal range editor allows you to easily set up new ranges and classifications (normal/reduced/increased) which can be age and/or gender specific.
Click the Checkmark to save any unsaved changes.
4.2.9 Findings-Summary Text
Here you may add and edit to the text available in the Findings and Summary report modules.
- Findings/Summary Text Name: name of the text snippet as it appears in the Findings/Summary editor.
- Physician: Findings/Summary Text can be available to all physicians in report42, or just one in particular (for example a specialist with different reporting requirements).
- Findings/Summary Text: the text to appear on the report, adding in Normal Values to make the text dynamics and relevant to the current report data.
- Availability checkboxes: these control which report module the text should be associated with – Findings, Summary or both.
4.2.10 Structured Findings
Structured Findings is a report section and can be used as an alternative to Findings.
Add Structured Findings Text
Add new text. Optionally you can insert a normal value. Save Changes.
Add a new category.
To facilitate inter-center collaboration, administrators can import and export all findings texts (including their normal range dependencies) or selected categories of findings.
4.2.11 Z-Index Rulesets
22.214.171.124 Editing Z-Index Rule Sets
Rulesets correspond to a particular paper used for z-scoring, and so must be set up to use the same BSA Calculation and the same z-scoring / normal-value regression function used by the paper's authors.
- Define any limitations that apply to the rule (optional). For instance, the authors may state the upper or lower limits for age, BSA, etc. in their sample population, outside of which the paper should not be considered applicable.
- Select a the BSA Formula used in the paper. It does not matter what formula you use in cvi42 or report42 for your analysis, the BSA as calculated by the formula stated here will always be used as the input to the z-score formula to ensure consistency.
- Select the z-score and normal-value regression function used in the paper.
- Enter a citation.
- Save the entry.
126.96.36.199 Creating Z-Index Rules
Rules correspond to regression curve parameters found within a source paper and will represent a single measurement (length, volume, mass, etc.).
- Name the specific parameter being reported/calculated.
- Gender: Select whether the parameter is gender specific.
- Enter the parameters that define the linear regression curve (α, β, γ).
- Measurement Type: specify if the parameter is a volume, length or area measurement.
Source: length and area are derived from custom measurements.
The source for volumetric measurements can be selected from a drop down list.
- Unit: The unit will be entered based on the selection, but allows for customization.
- Selection: z score rulsets allows for the input to the regression function (i.e. "x") to be calculated from multiple measurements; the Selection option specifies whether "x" will be calculated as the minimum, maximum, average or median of the multiple measurements.
Save the entry by clicking the checkmark.